The HL7 Transform device allows you to make changes to an HL7 message before sending it to the next device in the channel. For example, you may convert a code to plain text or replace a patient identifier with a name.

Configuring the HL7 Transform device

Select the HL7 Transform device in the channel to see all of the transform actions and conditions associated with the device.

The device can have one or more transform functions. The check box in the Enabled column tells whether or not the condition is in use.

Adding a transform

The toolbar at the top of the transform lists allows you to add various types of transform operations to the device.

The following transform options are available.

Expression Transformer

The Expression Transformer lets you write a regular expression to make changes to message data. Click the button to add a new row. In the Path column, enter the message field you want to transform (e.g., MSH-3). Click on the expression symbol to see a list of possible expressions. You can also start typing to see a list of matching expression possibilities.

Enter the parameters for the expression. Connexion will display an error message if the expression is invalid.

You can set the conditions under which the expression is run in the Conditions column. By default, expressions are always run. However, you could choose to only execute the expression when the value of the selected field matches something specific (e.g., when MSH-9.2 = RO1).

Enter an optional description for the expression transformer in the Description field.

Expressions are automatically saved.