Looking for Iguana v.5 or v.6? Learn More or see the Help Center.
Step 2 - Creating the VMD File |
Once you have created a form for your application, the next step is to define the VMD file that the application will use. To do this, you must use Chameleon to create a VMD file that contains the necessary message information.
To create the VMD file:
- Start Chameleon.
- Select Options from the toolbar, click the Misc tab, and select the Use .NET properties when generating .NET code check box. If this check box is not selected, your VB.NET application may not work properly.
- Use the sample message to import the ADT^A04 message and its segments from the Chameleon library. (This sample message is the output generated by the sample VB.NET client application.) The message definition you create should be named PatientRegister.
- Create a segment grammar consisting of the MSH, PID and NK1 segments.
- Create a table named MessageInfo, and define fields for it named SendingApplication, SendingFacility, DateTime, MessageControlID, ProcessingID and VersionID. All of these fields are of type String except DateTime, which is of type Date Time.
- Create a table named Patient, and define fields for it named PatientID, Surname, FirstName and SocialSecurityNumber. All of these fields are of type String.
- Create a table named NextOfKin, and define fields for it named Surname, FirstName, Relationship and IDNumber. All of these fields are of type String.
- Add the MessageInfo table to the Table Grammar, and specify Message as the grammar root.
- Use the following mappings to map fields in the MessageInfo table to fields in the MSH segment:
| MessageInfo Table Field | Field in MSH Segment |
|---|---|
| SendingApplication | Expand field 3, and use its first subfield (1 - Namespace ID) |
| SendingFacility | Expand field 4, and use its first subfield (1 - Namespace ID) |
| DateTime | Expand field 5, and use its first subfield (1 - Time) |
| MessageControlID | Use field 10 (10 - Message Control ID) |
| ProcessingID | Expand field 11, and use its first subfield (1 - Processing ID) |
| VersionID | Expand field 12, and use its first subfield (1 - Version ID) |
- Add the Patient table to the Table Grammar, and specify Message as the grammar root.
- Use the following mappings to map fields in the Patient table to fields in the PID segment:
| Patient Table Field | Field in PID Segment |
|---|---|
| PatientID | Expand field 3, and use its first subfield (1 - ID Number) |
| Surname | Expand field 5 and subfield 1, and use its first subsubfield (1 - Surname) |
| FirstName | Expand field 5, and use its second subfield (2 - Given Name) |
| SocialSecurityNumber | Use field 19 (19 - Ssn Number - Patient) |
- Add the NextOfKin table to the Table Grammar, and specify the NK1 segment as the grammar root.
- Use the following mappings to map fields in the NextOfKin table to fields in the NK1 segment:
| NextOfKin Table Field | Field in NK1 Segment |
|---|---|
| Surname | Expand field 2 and subfield 1, and use its first subsubfield (1 - Surname) |
| FirstName | Expand field 2, and use its second subfield (2 - Given Name) |
| Relationship | Expand field 3, and use its first subfield (1 - Identifier) |
| SocialSecurityNumber | Use field 1 (1 - Set ID - Nk1) |
When you have completed these steps, save the VMD file and remember its location. You will need to supply this location to your application so that it can process messages.
 | ||
|
A copy of the VMD file for this tutorial is located in vbnet_clientserver.vmd. For more details on how to create a VMD file for parsing HL7 messages, see HL7 to Application. | ||
 |
Once you have created the VMD file, the next step is to use this file to create stubcode for your application.