...
Use the toolbar buttons to reorder the list of paths, copy, paste, activate single-step mode (see Troubleshooting below), and pause the selected transform path.
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.
...
| Tip |
|---|
Clearing the Enabled box is equivalent to setting the Condition to "Never." |
Adding a transform
The toolbar at the top of the transform lists allows you to add various types of transform operations to the device.
...
Transforms are evaluated sequentially, in the order in which they appear in the table. The following transforms are available.
Expressions
The Expression Transform uses simple expressions to transform a message path. Click the button to add a new row. In the Path column, enter the message path you want to transform (e.g., MSH-3).
...
Enter an optional description for the expression transformer in the Description field.
Tables
The Table transform maps existing HL7 path values to new values. Click the Add Table Transformer button to add the transformer, then click the icon to launch the popup window. In the Path column, enter the HL7 path to be transformed. Add a condition (see Condiions below), and then click the text in the Transform field to show the Table Editor popup window.
...
| Tip |
|---|
Once you have created a mapping table, you can use that table in other table transforms within the HL7 Transform device. |
Custom Code
Us the Custom Code transform to write a message-transforming function in C#. Click on the Add C# Transformer button and then click the Function(<Name>) text to launch the popup window.
...
Again, you can set a condition for the transform and add an optional description
Adding References
To add an assembly reference to your custom code transform, click the References button.
...
You can add .NET assembly references or references from other devices. Click on the appropriate tab to see a list of references.
.NET References
The .NET tab contains the following:
- Filter: Use this to filter the list of available assemblies.
- Include: Check this box to include the reference in the device. You can select multiple assemblies.
- Assembly Name: The GAC assembly name.
- Version: The version number associated with the reference. Note that some assemblies may have multiple versions; be sure to select the version that targets .NET version 4.5.1.
- Path: The path of the assembly file.
- Browse: Click the button to browse for a specific non-GAC assembly file.
Device References
You can also reference assemblies from another device in your custom code transform. Click the Devices tab to see a list of available devices.
...
When you are finished, click OK.
Filters
Use the Filter Transform to filter any unwanted HL7 messages out of the incoming feed before they are passed to the next device in the channel. For example, you may want to filter out messages if a specific field contains a certain value.
...
Click the "X" to close the window.
Segment Filters
Sometimes, you may want to let a message through, but exclude (or only include) certain portions of the message. To do this, use the Segment Filter Transformer. Click the Add Segment Filter Transform button and then launch the popup window.
...
When you are finished, close the popup window.
Conditions
A condition is an expression that, when it evaluates to True, triggers the execution of a transform. You can set a condition for any transform.
...
- Always: Returns true and the transform will always be executed.
- Never: Returns false, and the transform will never be executed (this is equivalent to unchecking the Enabled option).
- <path>=<value>: Does the specified HL7 path equal the specified value (e.g., PV1-8.1.1=99999 - does the value of the PV1-8.1.1 path equal 99999).
- <path>!=<value>: Does the specified HL7 path no equal the specified value (e.g., PV1-8.1.1!=99999 - does the value of the PV1-8.1.1 path NOT equal 99999).
- <path='': Is the specified HL7 path empty (e.g., OBR-3.1='' - is the OBR-3.1 path empty).
Deleting a transform
If you want to temporarily stop using a transform, uncheck the box in the Enabled column. But there may be times you want to completely delete the transform. This cannot be undone, so use with caution.
- Highlight the row containing the transform you want to delete.
- Click the Delete the current HL7 path icon.
- Confirm the deletion.
Troubleshooting the HL7 Transform device
The best way to diagnose problems with a transform is to compare the incoming message with the transformed message. Connexion displays this if you click on the message in the Queue.
...
By default, clicking on a message displays the changes that will be performed by every transform executed by the HL7 Transform device. If you want to see the changes for each transform individually, use Connexion's Single Stepping functionality.
Single Stepping
Single-stepping is a standard code convention that allows you to view individual transform changes line by line. To activate single-stepping, click the toolbar button.
...