Connecting to an HL7 Data Source

Overview

ROMA Connect can use HL7 (a health information exchange standard) as a data source for data integration tasks. Before using the HL7 data source, you need to connect it to ROMA Connect.

Prerequisites

Each connected data source must belong to an integration application. Ensure that an integration application is available before connecting a data source, or create one first.

Procedure

1. Log in to the ROMA Connect console. On the Instances page, click View Console of an instance.
2. In the navigation pane on the left, choose Data Sources. In the upper right corner of the page, click Access Data Source.
3. On the Default tab page, select HL7 and click Next.
4. Configure the data source connection information.

   Table 1 Data source connection information

   Parameter	Description
   Name	Enter a data source name. Using naming rules facilitates future search.
   Encoding Format	Default: utf-8
   Integration Application	Select the integration application to which the data source belongs.
   Description	Enter a brief description of the data source.
   Direction	Select the direction of the HL7 data source used in data integration. The options are Source and Destination.
   SSL Authentication	Determine whether to use SSL authentication for the connection between ROMA Connect and HL7.
   Keystore	This parameter is mandatory only if SSL Authentication is set to Enable and Direction is set to Source. This parameter specifies the keystore used by the server (ROMA Connect) during SSL two-way authentication. It must match the public key used by the client (HL7).
   Keystore Password	This parameter is mandatory only if SSL Authentication is set to Enable and Direction is set to Source. Enter the password of the keystore.
   Keystore Key Password	This parameter is mandatory only if SSL Authentication is set to Enable and Direction is set to Source. Enter the password of the keystore key.
   Trust Store	This parameter is mandatory only if SSL Authentication is set to Enable and Direction is set to Destination. This parameter specifies the trust store used by the client (ROMA Connect) during SSL authentication. It must match the private key used by the server (HL7).
   Trust Store Password	This parameter is mandatory only if SSL Authentication is set to Enable and Direction is set to Destination. Enter the password of the trust store.
   Whitelist	This parameter is mandatory only if Direction is set to Source. Determine whether to allow data to be synchronized to the source HL7 server in the whitelist.
   Whitelist Host Server	This parameter is mandatory only if Direction is set to Source and Whitelist is set to Enable. Enter the IP address of the HL7 server that is allowed for data synchronization.
   Connection Address	This parameter is mandatory only if Direction is set to Destination. Enter the IP address and port number for accessing HL7. To obtain the IP address, locate a data integration task whose source is HL7, view the task details, and view Access Address in the source information. To obtain the port, locate a data integration task whose source is HL7, view the task details, and view Access Port in the source information.

   The following figure shows an example of the data source connection configuration when the data source is the destination and SSL authentication is enabled. A trust store file needs to be uploaded.

   Figure 1 HL7 data source configuration example
   
5. Click Create.