HL7 v2.x to FHIR Conversions

Mirth® Connect by NextGen Healthcare FHIR Connector User Guide

Next Steps

As with the FHIR Listener FHIR Example Channel, these sample code templates and channels are only meant to be a starting point. You will likely need to tweak them in order to fit your specific use-cases. The FHIR documentation pages are a great starting place to see how the HL7 to FHIR mapping should take place. Perhaps try building on these examples to also create an associated Encounter resource from the ADT! Parent topic: HL7 v2.x to FHIR Conversions

Mirth® Connect by NextGen Healthcare FHIR Connector User Guide

Convert HL7 to FHIR Patient - Example 1

Download the "Convert HL7 to FHIR Patient - Example 1.xml" file from Downloads, and import the channel Convert HL7 to FHIR Patient - Example 1.xml into your Mirth® Connect server. This channel includes the "HL7 v2.x to FHIR Helper Functions" code template library. If you already have that library imported, you may see a dialog asking whether or not you want to overwrite the library. To overwrite the library and all of its code templates, click the "Overwrite: All" link in the top-right, and then click Import. If you don't want to overwrite any libraries or code templates, click Cancel, then Yes when prompted to continue without importing. Then make sure the library is enabled for your newly imported channel: Once you've imported the channel, go to the Source tab, and click Edit Transformer to view the source transformer. You will see quite a few Iterator steps with FHIR Resource Builders. These are dynamically creating the identifiers, names, telecoms, etc. that will go into the final

Mirth® Connect by NextGen Healthcare FHIR Connector User Guide

Convert HL7 to FHIR Patient - Example 2

The first example channel used the FHIR Resource Builder transformer step to create a FHIR Patient resource from an HL7 ADT. This next channel will do the same thing, but using code templates instead. The advantage to using code templates is that you can re-use the same code/builder across multiple transformers, connectors, and channels. Download the "Convert HL7 to FHIR Patient - Example 2.xml" file from the Download section, and import the channel Convert HL7 to FHIR Patient - Example 2.xml into your Mirth® Connect server. This channel includes both the "HL7 v2.x to FHIR Helper Functions" and "HL7 v2.x to FHIR Creation Functions" code template libraries. If you already have that library imported, you may see a dialog asking whether or not you want to overwrite the library. To overwrite the library and all of its code templates, click the Overwrite: All link in the top-right and then click Import. Note: This channel includes both the "HL7 v2.x to FHIR Helper Functions" and "HL7 v2.x t

Mirth® Connect by NextGen Healthcare FHIR Connector User Guide

Downloads

Log on to Success Community and download the FHIR Example Channel zip file found in Mirth Connect Download Central. Unzip the file to a desired location. The following xml files can be found in various folders of the unzipped file. Code Template Libraries HL7 v2.x to FHIR Helper Functions.xml HL7 v2.x to FHIR Creation Functions.xml Transformer Transformer - Convert HL7 v2.x to FHIR Patient.xml Channels Convert HL7 to FHIR Patient - Example 1.xml Convert HL7 to FHIR Patient - Example 2.xml Example FHIR Listener.xml Parent topic: HL7 v2.x to FHIR Conversions

Mirth® Connect by NextGen Healthcare FHIR Connector User Guide

Overview

If you've never worked with FHIR before, converting HL7 v2.x messages to FHIR resources may seem a daunting task. However the FHIR documentation actually provides a lot of useful information that can cover most of the broad strokes. For the examples in this section, we're going to be looking at taking an HL7 v2.x ADT, and creating a FHIR Patient resource that represents the demographic information present in the message. From the Patient documentation page, click on Mappings, and search for "HL7 v2". Or go directly to this link: http://hl7.org/fhir/R4/patient-mappings.html#v2 You will see that most of the FHIR resource properties have corresponding HL7 v2.x segment and field mappings. For example, the Patient.identifier property is mapped to the PID-3 field. But how exactly does each individual PID-3 component map into the identifier property? Return to the Content tab, and look at the structure of the resource. You will see that the "identifier" property is of type Identifier. Click o

Mirth® Connect by NextGen Healthcare User Guide

FHIR Connector

This extension provides FHIR Listener and FHIR Sender connectors, a new FHIR data type, a FHIR Resource Builder available as both a transformer step and code template type, and some helper/utility classes for working with responses. Fast Healthcare Interoperability Resources (FHIR) is a new set of HL7 healthcare standards. Its main focus is on the ease of implementation, based on RESTful HTTP using XML or JSON. Components called "resources" are used to store and exchange data between systems. The resources are XML or JSON documents following a standard definition, and include the actual resource data (like patient demographics), metadata, tags, and a human-readable description. However, they are also fully extensible, meaning that additional implementation-specific data elements can be added if needed. This extension provides FHIR Listener and FHIR Sender connectors, a new FHIR data type, a FHIR Resource Builder available as both a transformer step and code template type, and some help

HL7 v2.x to FHIR Conversions

Recommendations

Next Steps

Convert HL7 to FHIR Patient - Example 1

Convert HL7 to FHIR Patient - Example 2

Downloads

Overview

FHIR Connector

Next Steps

Convert HL7 to FHIR Patient - Example 1

Convert HL7 to FHIR Patient - Example 2

Downloads

Overview

FHIR Connector