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.

Using the 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.

Using the Table Transformer

Use the Table Transformer to map existing HL7 path values to new ones. Click the Add Table Transformer button to add the transformer, then click the icon to launch the popup window.

Set the Assignment Path for the transformer and the Source Path (where the data will come from). In the Table Name field, specify the table to which the information should be written. You can create a new table or write to an existing table.

Set the value that should be used for an Empty value (the default is to leave it empty) and what should be used if the source value cannot be matched (the default is to leave it unchanged).

On the Mappings tab, list the In values and the corresponding Out values (that is, what matches for each value is). Optionally, enter a description. You can also specify that matches be case-sensitive by checking the box.

When you are finished, close the popup window. The list of transformers will show the new table transformer. Set any conditions for the transformer or add an optional description.

Using the C# transformer

If you know C#, you can write custom C# code to execute your transformer function. Click on the Add C# Transformer button and then click to launch the popup window.

Enter a name for the transformer. In the popup, write the C# code to execute the desired function. When you are finished, close the popup window.

Set any conditions for the transformer or add an optional description.