Industry Solutions for Healthcare

Back Next

Step 3. Configure the mapping

Data Integration

, use the mapping template called "Process incoming HL7 messages" and configure the mapping.

The mapping template uses a Data Services transformation that accesses a pre-built data service from the data services repository to parse HL7 messages. You can populate the mapping template with source and target data using the source and target connections that you created.

The following image shows the transformations in the mapping template:

The mapping template contains the following transformations:

1. Source transformation: The Source transformation reads an HL7 file as a source. You can use a flat file connection, an SFTP connection to a remote server, or a Kafka connection to access the HL7 data.

The source can be one of the following types:

Single object
File list to process multiple files
Command if the files are stored on the same Linux machine that runs the Secure Agent
Parameter if you want to specify the source in the
mapping
task

The source is parameterized in the mapping template, so you can perform one of the following tasks:

Replace the parameter with a specific connection and source object in the Source transformation.
Leave the parameter in the Source transformation and specify a source in the
mapping
task or use a parameter file.
2. Expression transformation: The Expression transformation uses the data in the HL7 file to construct the name of the data service.

Data services use the following naming convention:

<industry standard>_<version>_<message type>_<usage type>

For example, hl7_2_6_adt_A01_parser.
3. Filter transformation: The Filter transformation filters the incoming data from the Expression transformation to output only the final name of the data service that the Expression transformation constructs.
4. Data Services transformation: The Data Services transformation uses the name of the HL7 parser data service to access the data service in the data services repository. The HL7 parser reads the incoming patient and health information in the HL7 file and converts the data to XML format.

The mapping template sets the output type to buffer by default. If the output data is larger than the output precision, change the output type from buffer to file to avoid truncating the data.
5. Filter transformations: The Filter transformations filter the upstream fields to pass only the relevant fields to each target.
6. Target transformations: The Target transformations write the successful messages, failure messages, status codes, errors, and error flags to the target files. To write the data to the target files, you can use any target connection that writes XML data, such as a flat file, relational, or MLLP connection.

The target is parameterized in the mapping template, so you can perform one of the following tasks:

Replace the parameter with a specific connection and target object in the Target transformation.
Leave the parameter in the Target transformation and specify a target in the
mapping
task or use a parameter file.