fhir-mapping-language-compiler

FHIR Mapping Language Compiler

About the tool

The FHIR Mapping Language is a part of the FHIR specification used to describe the transformation logic from one data structure (data model, directed acyclic graph) to another. It can handle transformations that involve both structural and content/format changes between source and target structures.

In order to execute the mapping instructions expressed in the FHIR Mapping Language, you need to first compile it to an instance of a FHIR StructureMap resource. To do this, you can use the $convert operation on a FHIR server that supports the FHIR Mapping Language or use the HAPI FHIR library directly.

I've built this online tool to provide a hassle-free alternative to the above steps. You can use it to easily compile your FHIR Mapping Language code and pick up the resulting StructureMap JSON, which you can then use to execute the data transformation.

The tool runs the compilation process server-side using the Java HAPI FHIR library.

Demo

FHIR Mapping Language

/// url = 'http://example.org/fhir/StructureMap/my-map'
/// name = 'MyMap'
/// title = 'My Map'

map "http://example.org/fhir/StructureMap/my-map" = "MyMap"

uses "http://example.org/fhir/StructureDefinition/left" alias TLeft as source
uses "http://example.org/fhir/StructureDefinition/right" alias TRight as target

group groupOne(source src : TLeft, target tgt : TRight) {
    src.a as a -> tgt.a = a "rule_a";
}1
/// url = 'http://example.org/fhir/StructureMap/my-map'
2
/// name = 'MyMap'
3
/// title = 'My Map'
4

5
map "http://example.org/fhir/StructureMap/my-map" = "MyMap"
6

7
uses "http://example.org/fhir/StructureDefinition/left" alias TLeft as source
8
uses "http://example.org/fhir/StructureDefinition/right" alias TRight as target
9

10
group groupOne(source src : TLeft, target tgt : TRight) {
11
    src.a as a -> tgt.a = a "rule_a";
12
}

StructureMap JSON

Click Compile to generate the StructureMap JSON.

Thanks for stopping by my digital playground! If you want to say hi, you can reach out to me on LinkedIn or via email. I'm always keen to chat and connect.

If you really-really like my work, you can support me by buying me a coffee.