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. Before connecting a data source, ensure that an integration application is available. Otherwise, create an integration application in advance.

Procedure

1. Log in to the ROMA Connect console. On the Instances page, click View Console next to a specific 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. It is recommended that you enter a name based on naming rules to facilitate search.
   Integration Application	Select the integration application to which the data source belongs.
   Description	Enter the descriptive information.
   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.

5. Click Check Connectivity to check the connectivity between ROMA Connect and the data source.
   • If the test result is Data source connected successfully, go to the next step.
   • If the test result is Failed to connect to the data source, check the data source status and connection parameters, and click Recheck until the connection is successful.
6. Click Create.