Industry solutions for healthcare include pre-built data services that allow you to provide message data in XML format and translate it to an HL7 message. These data services are called serializers and you can find the XSD file that each serializer requires in the data services repository.
To send patient data or any other healthcare data through HL7, you create a mapping that generates the required XML structure and passes it to the Data Services transformation. The Data Services transformation uses the appropriate serializer data service, such as HL7_2_1_ADT_A01_Serializer, to format and output the HL7 message. Then, you write the message to a target.
Perform the following tasks:
1Download the XSD file for the serializer data service.
2Create a source connection.
3Create a target connection.
4Create a mapping.
5Create and run a mapping task.
Step 1. Download the XSD file for the serializer data service
To identify the XML structure that the HL7 serializer data service requires to convert XML data to an HL7 message, download the XSD file for the serializer data service from the data services repository in Administrator.
To determine the name of the serializer data service, you can find the information in a sample HL7 file. The data service name uses the following format:
When you download the serializer data service, use the XSD file to determine the XML structure that the data service requires.
Step 2. Create the source connection
To read the XML data, create a source connection that accesses the XML files.
If the data is already formatted in the expected XML structure, you can create any source connection that reads an XML file as a source, such as a flat file connection or an SFTP connection to a remote server.
If the data is in relational format, create a source connection that reads a relational source. In this case, you also need to create a mapping that uses a Hierarchy Builder transformation to map the relational data to the XML structure that the serializer data service requires.
Step 3. Create the target connection
To send the HL7 messages, create a target connection to write the HL7 messages to a target.
You can use one of the following types of connections:
•A flat file or an SFTP connection to a remote server
•An MLLP connection that uses an MLLP server to write the HL7 messages to a flat file
If you use an MLLP connection, you need to enable and configure an MLLP server before you create the connection.
To enable and configure the MLLP server, use the File Servers page in Administrator. You can set the target type to write HL7 messages to a flat file or to a Kafka queue. For more information, see File Transfer in the Administrator help.
Step 4. Create the mapping
In Data Integration, create a mapping to read the XML data and write the data as HL7 messages to a target.
The following image shows the data flow in the mapping:
The mapping contains the following transformations:
1. Source transformation
The Source transformation reads an XML file as a source. You can use a flat file connection or an SFTP connection to a remote server.
2. Data Services transformation
The Data Services transformation uses an HL7 serializer data service from the data services repository. The HL7 serializer reads the incoming patient and health information in the XML file and converts the data to an HL7 message.
You can get the name of the HL7 serializer data service by using the following format:
The Target transformation writes the HL7 messages to a target. You can use a flat file connection, an SFTP connection to a remote server, or an MLLP connection to write the HL7 messages to a flat file.
Step 5. Create and run a mapping task
After you configure the mapping, create and run a mapping task to process the data flow logic in the mapping.
