FHIR Release 3 (STU) CI-Build

This page is part of the FHIR Specification (v3.0.2: STU 3). The current version which supercedes this version is 5.0.0 . For a full list Continuous Integration Build of available versions, see FHIR (will be incorrect/inconsistent at times).
See the Directory of published versions . Page versions: R5 R4B R4 R3

Cm-name-use-v2.json

Example ConceptMap/cm-name-use-v2 (JSON)

Maturity Level : N/A
Responsible Owner: Vocabulary Terminology Infrastructure Work Group Ballot Standards Status : Informative

Raw JSON ( canonical form + also see JSON Format Specification )

v2 map for NameUse v2.NameUse

{
  "resourceType": "ConceptMap",
  "id": "cm-name-use-v2",
  "text": {
    "status": "generated",
    "div": "<div>!-- Snipped for Brevity --></div>"

  "resourceType" : "ConceptMap",
  "id" : "cm-name-use-v2",
  "text" : {
    "status" : "generated",
    "div" : "<div xmlns=\"http://www.w3.org/1999/xhtml\"><p class=\"res-header-id\"><b>Generated Narrative: ConceptMap cm-name-use-v2</b></p><a name=\"cm-name-use-v2\"> </a><a name=\"hccm-name-use-v2\"> </a><p>Mapping from <a href=\"valueset-name-use.html\">NameUse</a> to <a href=\"http://terminology.hl7.org/6.5.0/ValueSet-v2-0200.html\">hl7VS-nameType</a></p><br/><p><b>Group 1 </b>Mapping from <a href=\"codesystem-name-use.html\">NameUse</a> to <a href=\"http://terminology.hl7.org/6.5.0/CodeSystem-v2-0200.html\">nameType2</a></p><table class=\"grid\"><tr><td colspan=\"2\"><b>Source Concept Details</b></td><td><b>Relationship</b></td><td colspan=\"2\"><b>Target Concept Details</b></td><td><b>Comment</b></td></tr><tr><td colspan=\"2\"><b>Codes</b> from <a href=\"codesystem-name-use.html\" title=\"http://hl7.org/fhir/name-use\">NameUse</a></td><td/><td colspan=\"2\"><b>Codes</b> from <a href=\"http://terminology.hl7.org/6.5.0/CodeSystem-v2-0200.html\" title=\"http://terminology.hl7.org/CodeSystem/v2-0200\">nameType2</a></td><td/></tr><tr><td style=\"border-right-width: 0px\">usual</td><td style=\"border-left-width: 0px\">Usual</td><td><a href=\"codesystem-concept-map-relationship.html#equivalent\" title=\"equivalent\">is equivalent to</a></td><td style=\"border-right-width: 0px\">D</td><td style=\"border-left-width: 0px\"></td><td/></tr><tr><td style=\"border-right-width: 0px\">official</td><td style=\"border-left-width: 0px\">Official</td><td><a href=\"codesystem-concept-map-relationship.html#equivalent\" title=\"equivalent\">is equivalent to</a></td><td style=\"border-right-width: 0px\">L</td><td style=\"border-left-width: 0px\"></td><td/></tr><tr><td style=\"border-right-width: 0px\">temp</td><td style=\"border-left-width: 0px\">Temp</td><td><a href=\"codesystem-concept-map-relationship.html#equivalent\" title=\"equivalent\">is equivalent to</a></td><td style=\"border-right-width: 0px\">TEMP</td><td style=\"border-left-width: 0px\"></td><td/></tr><tr><td style=\"border-right-width: 0px\">nickname</td><td style=\"border-left-width: 0px\">Nickname</td><td><a href=\"codesystem-concept-map-relationship.html#equivalent\" title=\"equivalent\">is equivalent to</a></td><td style=\"border-right-width: 0px\">N</td><td style=\"border-left-width: 0px\"></td><td/></tr><tr><td style=\"border-right-width: 0px\">anonymous</td><td style=\"border-left-width: 0px\">Anonymous</td><td><a href=\"codesystem-concept-map-relationship.html#equivalent\" title=\"equivalent\">is equivalent to</a></td><td style=\"border-right-width: 0px\">S</td><td style=\"border-left-width: 0px\"></td><td/></tr><tr><td style=\"border-right-width: 0px; border-bottom-style: none\">old</td><td style=\"border-left-width: 0px; border-bottom-style: none\">Old</td><td><a href=\"codesystem-concept-map-relationship.html#source-is-broader-than-target\" title=\"source-is-broader-than-target\">is broader than</a></td><td style=\"border-right-width: 0px\">NOUSE</td><td style=\"border-left-width: 0px\"></td><td>No Use Addresses are considered to be old records</td></tr><tr><td style=\"border-right-width: 0px; border-top-style: none\"/><td style=\"border-top-style: none; border-left-width: 0px\"/><td><a href=\"codesystem-concept-map-relationship.html#source-is-broader-than-target\" title=\"source-is-broader-than-target\">is broader than</a></td><td style=\"border-right-width: 0px\">BAD</td><td style=\"border-left-width: 0px\"></td><td>bad addresses are old records</td></tr><tr><td style=\"border-right-width: 0px\">maiden</td><td style=\"border-left-width: 0px\">Name changed for Marriage</td><td><a href=\"codesystem-concept-map-relationship.html#equivalent\" title=\"equivalent\">is equivalent to</a></td><td style=\"border-right-width: 0px\">M</td><td style=\"border-left-width: 0px\"></td><td/></tr></table></div>"

  },
  "url": "http://hl7.org/fhir/ConceptMap/cm-name-use-v2",
  "name": "v2 map for NameUse",
  "status": "draft",
  "date": "2019-10-24T11:53:00+11:00",
  "publisher": "HL7 (FHIR Project)",
  "contact": [

  "url" : "http://hl7.org/fhir/ConceptMap/cm-name-use-v2",
  "version" : "6.0.0-ballot3",
  "name" : "v2.NameUse",
  "title" : "v2 map for NameUse",
  "status" : "draft",
  "experimental" : false,
  "date" : "2025-11-09T20:40:27+00:00",
  "publisher" : "HL7 (FHIR Project)",
  "contact" : [{
    "telecom" : [{
      "system" : "url",
      "value" : "http://hl7.org/fhir"
    },

    {
      "telecom": [
        {
          "system": "url",
          "value": "http://hl7.org/fhir"
        },
        {
          "system": "email",
          "value": "fhir@lists.hl7.org"
        }
      ]
    }
  ],
  "sourceReference": {
    "reference": "http://hl7.org/fhir/ValueSet/name-use"
  },
  "targetReference": {
    "reference": "http://hl7.org/fhir/ValueSet/v2-0200"

      "system" : "email",
      "value" : "fhir@lists.hl7.org"
    }]

  },
  "group": [

  {
    "telecom" : [{
      "system" : "url",
      "value" : "http://www.hl7.org/Special/committees/fiwg"
    }]
  }],
  "jurisdiction" : [{
    "coding" : [{
      "system" : "http://unstats.un.org/unsd/methods/m49/m49.htm",
      "code" : "001",
      "display" : "World"
    }]
  }],
  "sourceScopeCanonical" : "http://hl7.org/fhir/ValueSet/name-use",
  "targetScopeCanonical" : "http://terminology.hl7.org/ValueSet/v2-0200",
  "group" : [{
    "source" : "http://hl7.org/fhir/name-use",
    "target" : "http://terminology.hl7.org/CodeSystem/v2-0200",
    "element" : [{
      "code" : "usual",
      "target" : [{
        "code" : "D",
        "relationship" : "equivalent"
      }]
    },

    {
      "source": "http://hl7.org/fhir/name-use",
      "target": "http://hl7.org/fhir/v2/0200",
      "element": [
        {
          "code": "usual",
          "target": [
            {
              "code": "D",
              "equivalence": "equivalent"
            }
          ]
        },
        {
          "code": "official",
          "target": [
            {
              "code": "L",
              "equivalence": "equivalent"
            }
          ]
        },
        {
          "code": "temp",
          "target": [
            {
              "code": "TEMP",
              "equivalence": "equivalent"
            }
          ]
        },
        {
          "code": "nickname",
          "target": [
            {
              "code": "N",
              "equivalence": "equivalent"
            }
          ]
        },
        {
          "code": "anonymous",
          "target": [
            {
              "code": "S",
              "equivalence": "equivalent"
            }
          ]
        },
        {
          "code": "old",
          "target": [
            {
              "code": "NOUSE",
              "equivalence": "wider"
            },
            {
              "code": "BAD",
              "equivalence": "wider"
            }
          ]
        },
        {
          "code": "maiden",
          "target": [
            {
              "code": "M",
              "equivalence": "equivalent"
            }
          ]
        }
      ]
    }
  ]

      "code" : "official",
      "target" : [{
        "code" : "L",
        "relationship" : "equivalent"
      }]
    },
    {
      "code" : "temp",
      "target" : [{
        "code" : "TEMP",
        "relationship" : "equivalent"
      }]
    },
    {
      "code" : "nickname",
      "target" : [{
        "code" : "N",
        "relationship" : "equivalent"
      }]
    },
    {
      "code" : "anonymous",
      "target" : [{
        "code" : "S",
        "relationship" : "equivalent"
      }]
    },
    {
      "code" : "old",
      "target" : [{
        "code" : "NOUSE",
        "relationship" : "source-is-broader-than-target",
        "comment" : "No Use Addresses are considered to be old records"
      },
      {
        "code" : "BAD",
        "relationship" : "source-is-broader-than-target",
        "comment" : "bad addresses are old records"
      }]
    },
    {
      "code" : "maiden",
      "target" : [{
        "code" : "M",
        "relationship" : "equivalent"
      }]
    }]
  }]

}

Usage note: every effort has been made to ensure that the examples are correct and useful, but they are not a normative part of the specification.