FHIR Mapping Language Testing Tool

About the tool

The FHIR Mapping Language is a language for defining computable data mappings (data transformation logic). Its mainly applied in the context of FHIR, but can be used with other data models as well.

I've created this tool as an online playground for the FHIR Mapping Language. It allows you to write your own mapping definitions and test them against sample data. It's a great environment for learning the FHIR Mapping Language.

To run the mapping, you need to provide the source and target structure definitions and the input JSON and click Transform. The tool will then run the mapping and display the results.

The mapping is executed on the server side and uses 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.b = 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.b = a "rule_a";
12
}

Source structure definition

{
  "resourceType": "StructureDefinition",
  "id": "TLeft",
  "url": "http://example.org/fhir/StructureDefinition/left",
  "name": "TLeft",
  "status": "draft",
  "fhirVersion": "5.0.0",
  "kind": "logical",
  "abstract": true,
  "type": "TLeft",
  "baseDefinition": "http://hl7.org/fhir/StructureDefinition/Element",
  "derivation": "specialization",
  "differential": {
    "element": [
      {
        "id": "TLeft",
        "path": "TLeft",
        "definition": "TLeft definition",
        "min": 1,
        "max": "1"
      },
      {
        "id": "TLeft.a",
        "path": "TLeft.a",
        "definition": "TLeft.a definition",
        "min": 1,
        "max": "1",
        "type": [
          {
            "code": "string"
          }
        ]
      }
    ]
  }
}1
{
2
  "resourceType": "StructureDefinition",
3
  "id": "TLeft",
4
  "url": "http://example.org/fhir/StructureDefinition/left",
5
  "name": "TLeft",
6
  "status": "draft",
7
  "fhirVersion": "5.0.0",
8
  "kind": "logical",
9
  "abstract": true,
10
  "type": "TLeft",
11
  "baseDefinition": "http://hl7.org/fhir/StructureDefinition/Element",
12
  "derivation": "specialization",
13
  "differential": {
14
    "element": [
15
      {
16
        "id": "TLeft",
17
        "path": "TLeft",
18
        "definition": "TLeft definition",
19
        "min": 1,
20
        "max": "1"
21
      },
22
      {
23
        "id": "TLeft.a",
24
        "path": "TLeft.a",
25
        "definition": "TLeft.a definition",
26
        "min": 1,
27
        "max": "1",
28
        "type": [
29
          {
30
            "code": "string"
31
          }
32
        ]
33
      }
34
    ]
35
  }
36
}

Target structure definition

{
  "resourceType": "StructureDefinition",
  "id": "TRight",
  "url": "http://example.org/fhir/StructureDefinition/right",
  "name": "TRight",
  "status": "draft",
  "fhirVersion": "5.0.0",
  "kind": "logical",
  "abstract": true,
  "type": "TRight",
  "baseDefinition": "http://hl7.org/fhir/StructureDefinition/Element",
  "derivation": "specialization",
  "differential": {
    "element": [
      {
        "id": "TRight",
        "path": "TRight",
        "definition": "TRight definition",
        "min": 1,
        "max": "1"
      },
      {
        "id": "TRight.b",
        "path": "TRight.b",
        "definition": "TRight.b definition",
        "min": 1,
        "max": "1",
        "type": [
          {
            "code": "string"
          }
        ]
      }
    ]
  }
}1
{
2
  "resourceType": "StructureDefinition",
3
  "id": "TRight",
4
  "url": "http://example.org/fhir/StructureDefinition/right",
5
  "name": "TRight",
6
  "status": "draft",
7
  "fhirVersion": "5.0.0",
8
  "kind": "logical",
9
  "abstract": true,
10
  "type": "TRight",
11
  "baseDefinition": "http://hl7.org/fhir/StructureDefinition/Element",
12
  "derivation": "specialization",
13
  "differential": {
14
    "element": [
15
      {
16
        "id": "TRight",
17
        "path": "TRight",
18
        "definition": "TRight definition",
19
        "min": 1,
20
        "max": "1"
21
      },
22
      {
23
        "id": "TRight.b",
24
        "path": "TRight.b",
25
        "definition": "TRight.b definition",
26
        "min": 1,
27
        "max": "1",
28
        "type": [
29
          {
30
            "code": "string"
31
          }
32
        ]
33
      }
34
    ]
35
  }
36
}

Source JSON

{
  "resourceType": "TLeft",
  "a": "blah"
}1
{
2
  "resourceType": "TLeft",
3
  "a": "blah"
4
}

Target JSON

Press Transform to see the result.

FHIR Mapping Language Testing Tool

About the tool

Demo

See also