Sending and receiving HL7 messages

Sending 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 the + button 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.

Receiving messages over MLLP

Step 1. Create an HL7 MLLP Listener.

When configuring the HL7 MLLP Listener, make sure that you are using a unique port for each listener. If you are running Integrator on premises, make sure that the ports configured for the listener are open. If you are using 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 the + button 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.

Sending 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 the + button 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.

Receiving messages over HTTP

Step 1. Create HTTP Listener.

When configuring HTTP Listener make sure that your are using 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 an HL7 flows in the Flows window by clicking the + button 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.

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

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