FHIR Transformation Activity

Use the FHIR Transformation activity to transform health data in legacy formats to FHIR format by using FHIR mapping tools.

Example

Refer to the associated example:

General

The General tab contains the following fields:

Field Literal Value/Module Property/Process Property? Description
Name No The name to be displayed as the label for the activity in the process.
Mapping Tool No The tool used to transform health data in legacy formats to FHIR format.

You can select the following options:

  • FHIRMappingLanguage: Describes how one set of Directed Acyclic Graphs is transformed to another set of directed acyclic graphs.

  • FHIRConverter: Enables conversion of health data from legacy formats to FHIR. Currently it supports two types of converter engines - Handlebars and LiquidEngine.

Output Type No

Type of the output format; JSON or XML.

You can see this option when you select FHIRMappingLanguage.

Converter URL No

URL of the FHIR converter service.

You can see this option when you select FHIRConverter as the Handlebars.

FHIR converter path No Path of the FHIR converter service.

For more information about installing the FHIR Converter API, see Installing the FHIR Converter API.

You can see this option when you select FHIRConverter as the LiquidEngine.

Conversion No The type of conversion to be performed.

You can see the following conversion types when you select FHIRConverter as Handlebars:

  • CDA to FHIR
  • HL7v2 to FHIR

You can see the conversion types when you select FHIRConverter as LiquidEngine:

  • CDA to FHIR
  • HL7v2 to FHIR
  • JSON to FHIR
  • STU3 to R4
Template No Templates define the mappings between different data formats. This field shows the ready-to-use templates that are available for HL7v2 to FHIR, CDA to FHIR conversion, JSON to FHIR, and STU3 to R4.

You can see this option when you select FHIRConverter.

Implementation Guide No

Implementation Guide defines either be a package id, a canonical URL, a filename, a local directory, or a URL.

Note:

The filename can reference a FHIR Mapping Language file, not just a StructureMap instance.

Version No

Current version of the FHIR service in use.

Only mention the version dstu3 and r4.

Note:

This field is optional.

Description

The Description tab is used to provide a short description of the activity.

Input

On the Input tab, provide all text input.

Mapinstruction No You can select Mapinstruction as an option to map.

Output

Output Item Datatype Description
Output string A transformed FHIR resource in JSON format.

Fault

The Fault tab lists errors that might occur when you use this activity.

Error Schema Element Datatype Description
msg string Error message description.
msgCode string The error code.

It represents ActiveMatrix BusinessWorks Plug-in for HL7 with FHIR errors. For more information about error codes, see FHIR Error Codes.