Looking for Iguana v.5 or v.6? Learn More or see the Help Center.
Testing the Application |
The final step of this tutorial is to investigate how the new classes can be incorporated into the application. The easiest way to do this is to regenerate the entire application from Chameleon.
To regenerate the application:
- Click the Stubcode icon in the toolbar. The Stubcode Generation Wizard appears.
- In the Prefix field, specify the string you specified last time. If you used the default of HL7, you can leave this unchanged.
- In the Language drop-down menu, select C# - Visual Studio .NET 2005.
- In the Project Type drop-down menu, select Stubcode and Client Example.
- Click Generate to create the stubcode.
- An information box appears, warning you that you are about to overwrite any existing stubcode. Click Yes to continue.
- View the Progress bar to track the progress of the stubcode generation. The stubcode generation is complete when the Progress bar is filled and the message Done! is displayed in the wizard's information panel.
- When you are asked whether you want to open the project, click No for now.
- Click Close to close the window when done.
When you are finished generating the stubcode, look at the set of files that were generated, and locate the code where the message's tables are filled with dummy data. In this C# example, this file is called GenerateLabResult.cs. The code looks like this:
using System;
using iNTERFACEWARE.Chameleon;
using HL7;
class GenerateLabResult : GenerateMessage
{
public string Description()
{
return "LabResult(Unsolicited Observation Message)";
}
public string GenerateMessage(Engine aEngine)
{
LabResultMessage aMessage = new LabResultMessage(aEngine);
aMessage.MessageInfo().AddRow();
aMessage.MessageInfo(0).SendingApplication = "SendingApplication Dummy Value";
aMessage.MessageInfo(0).SendingFacility = "SendingFacility Dummy Value";
aMessage.MessageInfo(0).GenerationDateTime = ChameleonDateTime.Now();
aMessage.MessageInfo(0).MessageControlID = "MessageControlID Dummy Value";
aMessage.MessageInfo(0).ProcessingID = "ProcessingID Dummy Value";
aMessage.MessageInfo(0).VersionID = "VersionID Dummy Value";
aMessage.Patient().AddRow();
aMessage.Patient(0).PatientID = "PatientID Dummy Value";
aMessage.Patient(0).FirstName = "FirstName Dummy Value";
aMessage.Patient(0).Surname = "Surname Dummy Value";
aMessage.Patient(0).DateOfBirth = ChameleonDateTime.Now();
aMessage.Patient(0).SocialSecurityNumber = "SocialSecurityNumber Dummy Value";
aMessage.Observation().AddRow();
aMessage.Observation(0).ObservationRequest().AddRow();
aMessage.Observation(0).ObservationRequest(0).OrderID = "OrderID Dummy Value";
aMessage.Observation(0).ObservationRequest(0).OrderDescription = "OrderDescription Dummy Value";
aMessage.Observation(0).ObservationRequest(0).OrderDateTime = ChameleonDateTime.Now();
aMessage.Observation(0).ObservationRequest(0).ObservationResultStatus = "ObservationResultStatus Dummy Value";
aMessage.Observation(0).ObservationResult().AddRow();
aMessage.Observation(0).ObservationResult(0).SequenceNumber = "SequenceNumber Dummy Value";
aMessage.Observation(0).ObservationResult(0).ObservationID = "ObservationID Dummy Value";
aMessage.Observation(0).ObservationResult(0).ObservationResultStatus = "ObservationResultStatus Dummy Value";
aMessage.Observation(0).ObservationResult(0).ObservationType = "ObservationType Dummy Value";
aMessage.Observation(0).ObservationResult(0).Observation = "Observation Dummy Value";
return aMessage.GenerateMessage();
}
}
|
This looks much like the generated code you saw earlier in Application Overview. Notice, however, that only the MessageInfo and Patient tables are filled with data; the tables inside the table group are absent. This is because the Stubcode Generation Wizard that produces this default implementation is not equipped to handle table groups.
For the purposes of this tutorial, you can replace the code above with this improved version:
using System;
using iNTERFACEWARE.Chameleon;
using HL7;
using System.Collections;
class GenerateLabResult : GenerateMessage
{
public string Description()
{
return "LabResult(Unsolicited Observation Message)";
}
public string GenerateMessage(Engine aEngine)
{
LabResultMessage aMessage = new LabResultMessage(aEngine);
aMessage.MessageInfo().AddRow();
aMessage.MessageInfo(0).SendingApplication = "SendingApplication Dummy Value";
aMessage.MessageInfo(0).SendingFacility = "SendingFacility Dummy Value";
aMessage.MessageInfo(0).GenerationDateTime = ChameleonDateTime.Now();
aMessage.MessageInfo(0).MessageControlID = "MessageControlID Dummy Value";
aMessage.MessageInfo(0).ProcessingID = "ProcessingID Dummy Value";
aMessage.MessageInfo(0).VersionID = "VersionID Dummy Value";
aMessage.Patient().AddRow();
aMessage.Patient(0).PatientID = "PatientID Dummy Value";
aMessage.Patient(0).FirstName = "FirstName Dummy Value";
aMessage.Patient(0).Surname = "Surname Dummy Value";
aMessage.Patient(0).DateOfBirth = ChameleonDateTime.Now();
aMessage.Patient(0).SocialSecurityNumber = "SocialSecurityNumber Dummy Value";
ArrayList CountOfOBXsegment = new ArrayList();
CountOfOBXsegment.Add(2);
CountOfOBXsegment.Add(3);
for (int GroupIndex = 0; GroupIndex < CountOfOBXsegment.Count; GroupIndex++)
{
aMessage.Observation().AddRow();
aMessage.Observation(GroupIndex).ObservationRequest().AddRow();
aMessage.Observation(GroupIndex).ObservationRequest(0).OrderID = "OrderID Dummy Value";
aMessage.Observation(GroupIndex).ObservationRequest(0).OrderDescription = "OrderDescription Dummy Value";
aMessage.Observation(GroupIndex).ObservationRequest(0).OrderDateTime = ChameleonDateTime.Now();
aMessage.Observation(GroupIndex).ObservationRequest(0).ObservationResultStatus = "ObservationResultStatus Dummy Value";
for (int OBXsegmentIndex = 0; OBXsegmentIndex < (int)CountOfOBXsegment[GroupIndex]; OBXsegmentIndex++)
{
int SequenceNumber;
aMessage.Observation(GroupIndex).ObservationResult().AddRow();
SequenceNumber = OBXsegmentIndex + 1;
aMessage.Observation(GroupIndex).ObservationResult(OBXsegmentIndex).SequenceNumber = SequenceNumber.ToString();
aMessage.Observation(GroupIndex).ObservationResult(OBXsegmentIndex).ObservationID = "ObservationID Dummy Value";
aMessage.Observation(GroupIndex).ObservationResult(OBXsegmentIndex).ObservationType = "ObservationType Dummy Value";
aMessage.Observation(GroupIndex).ObservationResult(OBXsegmentIndex).ObservationResultStatus = "ObservationResultStatus Dummy Value";
aMessage.Observation(GroupIndex).ObservationResult(OBXsegmentIndex).Observation = "Observation Dummy Value";
}
}
return aMessage.GenerateMessage();
}
}
|
You have now added code to populate the Observation table group. This example will generate two OBR {OBX} segment groups. The first segment group will have two OBX segments and the second will have three.
To test this new application:
- Open the project you have built using the Stubcode Generation Wizard. If you are using C#, as described in this tutorial, the project file is named Client.csproj.
- Compile this file. This creates the application, which is located in Client.exe.
- Double-click Client.exe to start the application.
- Start the HL7 Listener, and send a message to it. The generated message will look like this:
MSH|^~\&|TEST CLIENT|ACME, INC.|||20080428155923+0000||ORU^R01|MessageControlID Dummy Value|P|2.5| PID|||PatientID Dummy Value||Surname Dummy Value^FirstName Dummy Value||20080428155923+0000||||||||||||SocialSecurityNumber Dummy Value| OBR||||OrderID Dummy Value^OrderDescription Dummy Value|||20080428155923+0000||||||||||||||||||F| OBX|1|TX|ObservationID Dummy Value||Observation Dummy Value||||||F| OBX|2|TX|ObservationID Dummy Value||Observation Dummy Value||||||F| OBR||||OrderID Dummy Value^OrderDescription Dummy Value|||20080428155923+0000||||||||||||||||||F| OBX|1|TX|ObservationID Dummy Value||Observation Dummy Value||||||F| OBX|2|TX|ObservationID Dummy Value||Observation Dummy Value||||||F| OBX|3|TX|ObservationID Dummy Value||Observation Dummy Value||||||F| |
There are a few things to note about this message:
- It contains two OBR {OBX} segment groups.
- The first group contains two OBX segments, and the second contains three.
- The Python scripts have replaced some of the dummy values assigned in the code shown above, just as they did previously.
This concludes the tutorial on generating HL7 messages with Chameleon.