msgtransform |
The msgtransform command line tool allows you to programmatically call the Chameleon mapping logic on a group of messages stored in the HL7 log file format that the HL7 Listener supports.
To invoke it you simply need to pass it three parameters on its command line:
- Message definition file;
- Input message log filename; and
- Output transformed message log filename.
You can also supply a flag indicating the type of mapping operation you wish to apply. The default operation is to run each message through scripted transformation as defined in the message definition file. Other operations can also be tested as this table summarizes:
| Flag | Operation |
|---|---|
| --version | Output information about this computer. |
| --machineinfo | Output information about this computer. |
| --sort | Sort the incoming message file into separate message files. The output file will contain a listing for the identity of the corresponding input messages. |
| --table | Invoke full table parse - i.e. table grammar mapping. |
| --autoack | Generate ACKs from input message file using auto-acknowledgement. |
| --transform | Transform each message using scripted transformation or mapping translation (default). |
For example if you had your mapping defined in the message definition file hl7tohl7.vmd, the input message file was called "before.txt", and you wished to write the transformed messages to a file called "transformed.txt" then the following would work:
msgtransform --transform hl7tohl7.vmd before.txt transformed.txt |
The transformed.txt and before.txt can both be used as inputs into msgdiff which is described in the next section.
 | ||
|
The msgtransform utility is very useful for performing automated regression tests. To learn more, see Performing Regression Tests Using msgtransform. | ||
 |