iNTERFACEWARE™ Inc.
Previous iNTERFACEWARE Products Manual > Chameleon > Using the Tools and Utility Applications > Command Line Tools > msgxml Next

msgxml

The msgxml command line tool is a way that you can programmatically call the Chameleon xml translation technology 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 xml operation you wish to apply. Other operations can be also be tested as this table summarizes:

FlagOperation
--versionOutput information about this computer.
--toxsdGenerate an xsd from the vmd file.
--toxmlTransform messages using Message -> XML translation. The output files will be prefixed with the message number.
--forceformatForce the format of the log file to a certain value. Available formats are:
  • HL7Standard : HL7 Standard Format, CR delimiting segments, CRLF delimiting messages
  • HL7CRLF : HL7 files with segments delimited by CRLF
  • HL7CR : HL7 files with segments and messages delimited by CR (no LFs)
  • HL7LF : HL7 files with segments delimited by LF (No CRs)
  • CRLF : Non XML message formats delimited by CRLF
  • SingleMessage : File contains only one message, whole file is read in.
--fromxmlTransform messages using XML -> Message translation. The input file will be prefixed with the message number.

To XML

When using --toxml, the output files will be created with a numbered prefix. So if the output file is specified as output.xml, and the input file has 50 messages, there will be 50 output files called 00001output.xml to 00050output.xml.

From XML

When using --fromxml, the input is assumed to be a sequence of files prefixed the same way --toxml prefixes file. So if the input is input.xml, files of the form 00001input.xml are expected. Conversion stops when no more files of this form are encountered. Each file contains exactly one xml message.

Combining this tool with msgdiff, you can determine if your forward and reverse conversion of XML is correct, by comparing the input message file with a file containing the reverse xml converted messages. This can show you if your conversion is lossy or not.

Previous iNTERFACEWARE Products Manual > Chameleon > Using the Tools and Utility Applications > Command Line Tools > msgxml Next