Downloads

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

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

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 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

HL7 v2.x to FHIR Conversions

Along with the FHIR Example Channel, we're also providing some sample code templates, transformers, and channels to help you kickstart any HL7 v2.x to FHIR conversions you need to do. Note: The code made available here is not guaranteed to work 100% in all cases! As with any HL7 interface, some extra tweaks are usually needed to ensure that it fits your specific workflow. This section includes the following topics: Downloads Overview Convert HL7 to FHIR Patient - Example 1 Convert HL7 to FHIR Patient - Example 2 Next Steps Downloads Overview Convert HL7 to FHIR Patient - Example 1 Convert HL7 to FHIR Patient - Example 2 Next Steps

Mirth® Connect by NextGen Healthcare FHIR Connector User Guide

Importing the Example Channel

Log on to Success Community and download the FHIR Example Channel zip file, which can be found in Mirth Connect Download Central. Unzip the file to a desired location. Then open the Mirth® Connect Administrator, navigate to the Channels view, and click on Import Channel to the left. Select the channel XML file, and then click Open(You can import it into versions 4.6 and later). The channel comes bundled with a couple of code template libraries, so make sure to choose Yes and then Import when it prompts you: Then you'll be taken to the edit channel view: Image of the Edit Channel view. Click on Save Changes to save the channel. Parent topic: FHIR Example Channel

Downloads

Recommendations

Convert HL7 to FHIR Patient - Example 2

Convert HL7 to FHIR Patient - Example 1

Overview

Next Steps

HL7 v2.x to FHIR Conversions

Importing the Example Channel

Convert HL7 to FHIR Patient - Example 2

Convert HL7 to FHIR Patient - Example 1

Overview

Next Steps

HL7 v2.x to FHIR Conversions

Importing the Example Channel