Transformation Instructions

*All screenshots are from the UltraPort HL7 Postmaster

 

Click to zoom

Use Transformation Instructions to dynamically alter HL7 messages at run-time as they are delivered to a particular Postmaster Destination.

 

 

Transformation Script Toolbar

Transformation Script Toolbar

 

hmtoggle_plus1Toolbar Reference

 

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 DeleteA16 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 IMAGELIST_LIGHTNING button on the toolbar to test your script. See Testing Your Transformations for more.

 

Step 5 (Optional): Click the SortAscending16 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 Plus16 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.

 

Transformation Macro Window

Transformation Macro Window

 

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

 

Choosing which component you wish to change

Choosing which component you wish to change

 

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.

 

Choose a macro and enter the parameters (if required)

Choose a macro and enter the parameters (if required)

 

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

 

Enter conditional instructions

Enter conditional instructions

 

 

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).

 

 

faq-icon2a

Q:

If I use Transformation Instructions to change the message and ALSO use Matching Instructions WHEN are the Matching Instructions evaluated? Before the Transformation Instructions change the message or after?

A:

Matching Instructions are always evaluated against the 'original' HL7 message BEFORE any Transformation Instructions are applied.

 

 

hmtoggle_plus1Transformation Instructions Menu Reference

 

 

HL7+ - Putting HL7 to work for you!
© 2018 HermeTech International
(a Division of TransWorld Scribes)