Send and receive HL7 messages

Send messages over MLLP

Step 1. Create an HL7 MLLP Sender Connection.

Step 2. Create an HL7 Format that you are going to be using for the destination (TO).

Step 3. Start creating an HL7 Flow on the Flows page by clicking + and typing hl7 into the search box.

Step 4. Depending on your source (FROM), choose either file to HL7 or HL7 to HL7.

Step 5. Continue by defining the source (FROM) and destination (TO).

Step 6. For the destination (TO), use the Connection created in Step 1 and the Format created in Step 2.

Step 7. Continue by adding new transformations and defining the parameters.

Receive messages over MLLP

Step 1. Create an HL7 MLLP Listener.

When configuring the HL7 MLLP Listener, make sure that you use a unique port for each Listener. If you are running the Etlworks Integrator on-premises, make sure that the ports configured for the Listener are open. If you are using the Etlworks Integrator that is deployed on a cloud, please contact Etlworks support.

Step 2. Create the HL7 Format you are going to be using for the source (TO).

Step 3. Start creating an HL7 Flow in the Flows page by clicking + and typing hl7 into the search box.

Step 4. Depending on your destination (TO), choose either HL7 to file,  HL7 to HL7 or HL7 to database. 

Step 5. Continue by defining the source (FROM) and destination (TO).

Step 6. For the source (FROM), use the Connection created in Step 1 and the Format created in Step 2.

Step 7. Continue by adding new transformations and defining the parameters.

Step 8. Schedule an event-driven Flow.

All messages received by the MLLP listener can be found in Messages.

Send messages over HTTP

Step 1. Create an HTTP Connection. The former is more generic and supports more options, while the latter is specific to HL7 but has some stability issues (hence the beta tag).

Step 2. Create the HL7 Format you are going to be using for the destination (TO).

Step 3. Start creating an HL7 Flow in the Flows window by clicking + and typing hl7 into the search box.

Step 4. Depending on your source (FROM), choose either Extract from files, create HL7 message or Read HL7 messages, create different HL7 messages. 

Step 5. Continue by defining the source (FROM) and destination (TO).

Step 6. For the destination (TO), use the Connection created in Step 1 and the Format created in Step 2.

Step 7. Continue by adding new transformations and defining parameters.

Receive messages over HTTP

Step 1. Create HTTP Listener.

When configuring HTTP Listener, make sure that you are using a unique URL Ending for each Listener.

Step 2. Create HL7 Format you are going to be using for the source (TO).

Step 3. Start creating HL7 Flows in the Flows window by clicking + and typing in hl7 in the search box.

Step 4. Depending on your destination (TO), choose either HL7 to file,  HL7 to HL7 or HL7 to database. 

Step 5. Continue by defining source (FROM) and destination (TO).

Step 6. For the source (FROM), use Connection created in Step 1 and Format created in Step 2.

Step 7. Continue by adding new transformations and defining parameters.

Step 8. Schedule an event-driven Flow.

You can find all messages received by the MLLP Listener in Messages.

Read about how to build an API in the Etlworks Integrator so that the third-party application can send HTTP requests to trigger the data integration Flows.