...

Insert a Branch Device by editing the channel, then choosing HL7 > HL7 Branch Device.

Configuring the device

Once the Branch Device is added to the channel, several options must be configured:

...

• To add a destination, click the Add new expression condition button.
• Set the destination of the message if it does not match the condition. You can send an unmatched message to the Error Queue, let it Pass Through to the next device in the current channel, or send it to another channel.
• Click the Enabled check box to "turn on" the destination.
• Set the Condition that will fire off the branching. For example, if the MSH-3 path equals a specific value, the message will be branched. You can also choose to Always use the branch, or Never use it (this option is equivalent to unchecking the Enabled option).
• Choose a Destination Queue for the message. This is the channel that the message should be sent to upon branching. The drop-down list is populated with all available channels, as well as the Pass Through option, which simply sends the message to the next device in the current channel.
• Enter an optional Description for the destination.

Branching example

In this example, we are sending the incoming message to a different channel based on the contents of the MSH-9 path. If MSH-9 is ADT, the message will be sent to the Development channel. If the value of MSH-9 is ORU it will be sent to the Production channel. Messages that do not match either condition will be passed through to the next device in the current channel.

Joining example

In this example, messages can come from any one or more of three origination points. Four channels have been configured. Three are "listening" on different ports for incoming messages. Any messages are then passed to a Destination channel that handles additional processing and sends the messages to the final destination.

...

In this example, any transformations that need to occur would be handled by an HL7 Transform device in the Destination channel.

Troubleshooting the device

If your messages are not getting branched correctly, there are a couple things to check:

...