*All screenshots are from the UltraPort HL7 Postmaster

 

 

 

 

 

How to Transform HL7 Messages

 

Step 1: Edit (or create) a Postmaster Destination

 

Step 2: Click in the 'Transformation Instructions' tab.

 

Step 3: Add macros to your transformation script (click 'New Transformation Instruction' on the toolbar), or open a Transformation script you have previously saved (NOTE: You can also use Transformation Scripts exported from the UltraPort HL7 Notepad).  To remove a macro from the script click the 'Delete' button in the macro list (to clear all transformation macros click the button on the toolbar). To change a macro click the 'Edit' button in the macro list. To disable a macro from being executed simply uncheck the 'Enabled' box in the script macro list. See below for more information.

 

Step 4: Click the button on the toolbar to test your script. See Testing Your Transformations for more.

 

Step 5 (Optional): Click the Tbutton on the toolbar to change the order in which your Transformation Instructions are executed.

 

Step 6: Your Transformation Instructions are saved when you save the Postmaster Destination.

 

How To Edit and Add New Transformation Macros

 

Step 1: Click New Transformation Instruction button on the toolbar to add a new macro or click 'Edit' in the macro list to change an existing macro. This will open up the Transformation Macro Window.

 

 

Step 2: Select (or enter) the Segment, Field Number and Component Number you wish to alter with this macro.

 

 

Step 3: Choose which UltraPort HL7 Notepad Transformation Macro you wish to execute against the component you selected. For a reference of all macros see the macro reference. Some macros require that you enter 1 or more parameters in the parameters section. You will see detailed instructions on how to complete each macros required and optional parameters across the bottom.

 

 

Step 4: (Optional). If you wish to make the macro "conditional" you can click on the 'Conditional Instructions' tab and select

 

 

 

Step 5: Click 'Ok' and you're done. Don't forget that you can EXPORT and IMPORT Transformation Scripts from the Transformation Instructions Menu (see below).