FHIR🔥 API Extensions

ConceptMap R5 features (since V6.7)

In the R5 version of ConceptMap, ConceptMap.group.element.target.dependsOn and ConceptMap.group.element.target.product have been enhanced to support typed values. Specifically, any of the following types may be used for the value[x]:

  • code
  • Coding
  • string
  • integer
  • decimal
  • boolean
  • dateTime
  • uri
  • id

The following is an example of its use for a dateTime value:

{
  "resourceType": "ConceptMap",
  ...
  "group": [
    {
      "source": "https://dmd.nhs.uk",
      "sourceVersion": "202107.1.0",
      "target": "https://www.gs1.org/gtin",
      "element": [
        {
          "code": "23907311000001104",
          "target": [
            {
              "code": "5060182170231",
              "relationship": "related-to",
              "product": [
                {
                  "attribute": "start",
                  "valueDateTime": "2015-03-13"
                }
              ]
            }
          ]
        }
      ]
    }
  ]
}

In the case of a Coding typed value, the token syntax should be used. Hence "http://snomed.info/sct|12345678" would be the corresponding string representation of the valueCoding:

{
  "system": "http://snomed.info/sct",
  "code": "12345678",
  "display": "preferred term"
}

The following extract shows how the product would appear in the result of a FHIR R5 $translate request:

{
    "resourceType": "Parameters",
    "parameter": [{
        "name": "result",
        "valueBoolean": true
    }, {
        "name": "match",
        "part": [{
            "name": "relationship",
            "valueCode": "related-to"
        }, {
            "name": "concept",
            "valueCoding": {
                "system": "https://www.gs1.org/gtin",
                "code": "5060182170231"
            }
        }, {
            "name": "originalMap",
            "valueString": "https://dmd.nhs.uk/conceptmap/gtin"
        }, {
            "name": "product",
            "part": [{
                "name": "attribute",
                "valueUri": "mapping_status"
            }, {
                "name": "value",
                "valueCoding": {
                    "code": "active"
                }
            }]
        }, {
            "name": "product",
            "part": [{
                "name": "attribute",
                "valueUri": "start"
            }, {
                "name": "value",
                "valueDateTime": "2015-03-13"
            }]
        }]
    }]
}