Adding HL7 Business Operations

To send HL7 messages from a production, you must add an HL7 business operation. To add an HL7 business operation to a production, you must create it, integrate it into the production, and configure it as needed. The following subsections provide the details.

Creating an HL7 Business Operation

To add an HL7 business operation to a production:

Display the production in the Production Configuration page of the Management Portal (Ensemble > Configure > Production from the Home page).
In the Operations column, click the Add button (a plus sign).
Ensemble displays a dialog box.
Click HL7 Output.
Click one of the following from the Output type list:
- TCP
- File
- FTP
- HTTP
- SOAP
This selection determines the host class for this business operation.
For Operation Name, type the name of this business operation. The name should be unique among the business operations. Do not use periods or spaces.
The default is the name of the class on which this operation is based.
Click OK.

In addition to the HL7 business operations used here, Ensemble provides two simple business operations: EnsLib.File.PassthroughOperationOpens in a new tab and EnsLib.FTP.PassthroughOperationOpens in a new tab.. You can select either of these if you simply need to pass a file through the production, and do not want to parse or format the file as HL7.

If you want the production to send data that is not an HL7 message, see “Defining Business Operations” in Developing Ensemble Productions. Also see “Connectivity Options” in Introducing Ensemble.

Integrating and Configuring an HL7 Business Operation

To integrate a new HL7 business operation into an Ensemble production, simply identify it as a target that receives messages. To do this, you must configure the item that sends messages to the HL7 business operation and enter the configured Name of the HL7 business operation into the appropriate field:

For a routing interface, enter the name in the Target field of the routing rule set.
If your design uses a pass-through interface that simply relays messages from the incoming business service to the outgoing business operation, enter the name in the Target Config Names field of the HL7 business service.
Configure additional settings of the business operation, as needed. For details, see “Settings for HL7 Routing Operations” in the “Reference.”