Application Overview |
The generated application's main components are:
- One Generate class for each message defined in the VMD file;
- A socket connection object;
- A client object.
Each Generate class creates a new Message object, fills it with data, and calls its GenerateMessage method to generate an HL7 message. This message is returned as a string. In the tutorial example, GenerateLabResult is the Generate class that is created:
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.ObservationRequest().AddRow();
aMessage.ObservationRequest(0).OrderID = "OrderID Dummy Value";
aMessage.ObservationRequest(0).OrderDescription = "OrderDescription Dummy Value";
aMessage.ObservationRequest(0).OrderDateTime = ChameleonDateTime.Now();
aMessage.ObservationRequest(0).ObservationResultStatus = "ObservationResultStatus Dummy Value";
aMessage.ObservationResult().AddRow();
aMessage.ObservationResult(0).SequenceNumber = "SequenceNumber Dummy Value";
aMessage.ObservationResult(0).ObservationID = "ObservationID Dummy Value";
aMessage.ObservationResult(0).ObservationResultStatus = "ObservationResultStatus Dummy Value";
aMessage.ObservationResult(0).ObservationType = "ObservationType Dummy Value";
aMessage.ObservationResult(0).Observation = "Observation Dummy Value";
return aMessage.GenerateMessage();
}
}
|
The socket connection object connects to a specified host and port in order to send messages. It also monitors that connection for any incoming messages and, if one is received, invokes an onMessage method. The default behavior of onMessage is to display the message.
This message-receiving functionality is important even in a message-generating application, since you expect to receive an ACK (acknowledgement) message from the party who receives the message that you generate. For more information on ACK messages, see Auto ACKnowledgments.
The client object directs its socket connection object to send messages to a particular host and port. It also provides a user interface.
After generating the code, you will have a working application; no additional programming is required. In the remainder of this section, you will test the application.