{ "resourceType" : "ConceptMap", "id" : "datatype-xpn-to-humanname", "text" : { "status" : "generated", "div" : "

Generated Narrative: ConceptMap datatype-xpn-to-humanname

Mapping from (not specified) to (not specified)


Group 1 Mapping from unspecified code system to unspecified code system

Source Concept DetailsRelationshipTarget Concept DetailsComment
Codes from NarrativeConditionComputableANTLRCodes from
XPN.1Family Nameis equivalent to[1].family[1].family
XPN.2Given Nameis equivalent to[1].given[1][1].given[1]The requirement for XPN.2 being the first iteration of HumanName.given critical when it's an "official" name
XPN.3Second and Further Given Names or Initials Thereofis equivalent to[1].given[2][1].given[2]Consideration must be given if XPN.3 contains multiple names separated by a space. Should these be a single iteration of HumanName.given or is each name an iteration? For example, if XPN.3 is "Mary Anne", is that one name or two?
XPN.4Suffix (e.g., JR or III)is equivalent to[1].suffix[1][1].suffix[1]
XPN.5Prefix (e.g., DR)is equivalent to[1].prefix[1].prefix
XPN.6Degree (e.g., MD)is equivalent to[1].suffix[2][1].suffix[2]
XPN.7Name Type Codeis equivalent to[1].use[1].use
XPN.10Name Validity RangeIF XPN.12 NOT VALUED AND XPN.13 NOT VALUEDis equivalent to[1].period[1].period
XPN.11Name Assembly Orderis equivalent to[1].extension.url[1].extension.url
XPN.11Name Assembly Orderis equivalent to[1].extension.valueCode[1].extension.valueCode
XPN.12Effective Dateis equivalent to[1].period.start[1].period.start
XPN.13Expiration Dateis equivalent to[1].period.end[1].period.end
XPN.14Professional Suffixis equivalent to[1].suffix[3][1].suffix[3]
XPN.15Called Byif the resource attribute using the HumanName datatype allows for multiple namesis equivalent to[2].given[2].givenOne possibility is to put this in HumanName.given where HumanName.use="usual". When XPN.7 does not map to "usual" a new occurence of Patient.name should be created\nAlternative a new extension could be created for HumanName.family.#ext-called-by#\\
XPN.15Called Byif the resource attribute using the HumanName datatype allows for multiple namesis equivalent to[2].use[2].use
" }, "extension" : [{ "extension" : [{ "url" : "type", "valueCode" : "derived-from" }, { "url" : "label", "valueString" : "Datatype XPN to HumanName.fsh" }, { "url" : "url", "valueUri" : "https://docs.google.com/spreadsheets/d/1z8_nsSAHtkBLV0vPQuYJ50lLuh0p3Kv1dAkecl-f7oM/edit#gid=0" }], "url" : "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/RelatedArtifact" }, { "url" : "http://hl7.org/fhir/StructureDefinition/structuredefinition-wg", "valueCode" : "oo" }, { "url" : "http://hl7.org/fhir/StructureDefinition/structuredefinition-standards-status", "valueCode" : "informative", "_valueCode" : { "extension" : [{ "url" : "http://hl7.org/fhir/StructureDefinition/structuredefinition-conformance-derivedFrom", "valueCanonical" : "http://hl7.org/fhir/uv/v2mappings/ImplementationGuide/hl7.fhir.uv.v2mappings" }] } }], "url" : "http://hl7.org/fhir/uv/v2mappings/ConceptMap/datatype-xpn-to-humanname", "version" : "1.0.0", "name" : "DatatypeXPNToHumanName", "title" : "Datatype XPN to HumanName Map", "status" : "active", "experimental" : true, "date" : "2025-08-25", "publisher" : "HL7 International / Orders and Observations", "contact" : [{ "name" : "HL7 Orders and Observations Workgroup", "telecom" : [{ "system" : "url", "value" : "http://www.hl7.org/Special/committees/orders" }] }], "description" : "This ConceptMap represents a mapping from the HL7 V2 Datatype XPN to the FHIR HumanName Data Type.", "jurisdiction" : [{ "coding" : [{ "system" : "http://unstats.un.org/unsd/methods/m49/m49.htm", "code" : "001" }] }], "copyright" : "Copyright (c) 2025, HL7 International, Inc., All Rights Reserved.", "group" : [{ "element" : [{ "extension" : [{ "extension" : [{ "url" : "type", "valueCode" : "FN" }, { "url" : "cardinalityMin", "valueInteger" : 0 }, { "url" : "cardinalityMax", "valueInteger" : 1 }], "url" : "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo" }], "code" : "XPN.1", "display" : "Family Name", "target" : [{ "extension" : [{ "extension" : [{ "url" : "type", "valueCode" : "string" }, { "url" : "cardinalityMin", "valueInteger" : 1 }, { "url" : "cardinalityMax", "valueInteger" : 1 }], "url" : "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo" }], "code" : "[1].family", "display" : "[1].family", "equivalence" : "equivalent" }] }, { "extension" : [{ "extension" : [{ "url" : "type", "valueCode" : "ST" }, { "url" : "cardinalityMin", "valueInteger" : 0 }, { "url" : "cardinalityMax", "valueInteger" : 1 }], "url" : "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo" }], "code" : "XPN.2", "display" : "Given Name", "target" : [{ "extension" : [{ "extension" : [{ "url" : "type", "valueCode" : "string" }, { "url" : "cardinalityMin", "valueInteger" : -1 }, { "url" : "cardinalityMax", "valueInteger" : -1 }], "url" : "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo" }], "code" : "[1].given[1]", "display" : "[1].given[1]", "equivalence" : "equivalent", "comment" : "The requirement for XPN.2 being the first iteration of HumanName.given critical when it's an \"official\" name" }] }, { "extension" : [{ "extension" : [{ "url" : "type", "valueCode" : "ST" }, { "url" : "cardinalityMin", "valueInteger" : 0 }, { "url" : "cardinalityMax", "valueInteger" : 1 }], "url" : "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo" }], "code" : "XPN.3", "display" : "Second and Further Given Names or Initials Thereof", "target" : [{ "extension" : [{ "extension" : [{ "url" : "type", "valueCode" : "string" }, { "url" : "cardinalityMin", "valueInteger" : -1 }, { "url" : "cardinalityMax", "valueInteger" : -1 }], "url" : "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo" }], "code" : "[1].given[2]", "display" : "[1].given[2]", "equivalence" : "equivalent", "comment" : "Consideration must be given if XPN.3 contains multiple names separated by a space. Should these be a single iteration of HumanName.given or is each name an iteration? For example, if XPN.3 is \"Mary Anne\", is that one name or two?" }] }, { "extension" : [{ "extension" : [{ "url" : "type", "valueCode" : "ST" }, { "url" : "cardinalityMin", "valueInteger" : 0 }, { "url" : "cardinalityMax", "valueInteger" : 1 }], "url" : "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo" }], "code" : "XPN.4", "display" : "Suffix (e.g., JR or III)", "target" : [{ "extension" : [{ "extension" : [{ "url" : "type", "valueCode" : "string" }, { "url" : "cardinalityMin", "valueInteger" : -1 }, { "url" : "cardinalityMax", "valueInteger" : -1 }], "url" : "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo" }], "code" : "[1].suffix[1]", "display" : "[1].suffix[1]", "equivalence" : "equivalent" }] }, { "extension" : [{ "extension" : [{ "url" : "type", "valueCode" : "ST" }, { "url" : "cardinalityMin", "valueInteger" : 0 }, { "url" : "cardinalityMax", "valueInteger" : 1 }], "url" : "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo" }], "code" : "XPN.5", "display" : "Prefix (e.g., DR)", "target" : [{ "extension" : [{ "extension" : [{ "url" : "type", "valueCode" : "string" }, { "url" : "cardinalityMin", "valueInteger" : -1 }, { "url" : "cardinalityMax", "valueInteger" : -1 }], "url" : "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo" }], "code" : "[1].prefix", "display" : "[1].prefix", "equivalence" : "equivalent" }] }, { "extension" : [{ "extension" : [{ "url" : "cardinalityMin", "valueInteger" : 0 }, { "url" : "cardinalityMax", "valueInteger" : 1 }], "url" : "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo" }], "code" : "XPN.6", "display" : "Degree (e.g., MD)", "target" : [{ "extension" : [{ "extension" : [{ "url" : "type", "valueCode" : "string" }, { "url" : "cardinalityMin", "valueInteger" : -1 }, { "url" : "cardinalityMax", "valueInteger" : -1 }], "url" : "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo" }], "code" : "[1].suffix[2]", "display" : "[1].suffix[2]", "equivalence" : "equivalent" }] }, { "extension" : [{ "extension" : [{ "url" : "type", "valueCode" : "ID" }, { "url" : "cardinalityMin", "valueInteger" : 0 }, { "url" : "cardinalityMax", "valueInteger" : 1 }], "url" : "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo" }], "code" : "XPN.7", "display" : "Name Type Code", "target" : [{ "extension" : [{ "extension" : [{ "url" : "type", "valueCode" : "code" }, { "url" : "cardinalityMin", "valueInteger" : 1 }, { "url" : "cardinalityMax", "valueInteger" : 1 }, { "url" : "mappedVia", "valueUrl" : "ConceptMap/table-hl70200-to-name-use" }], "url" : "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo" }], "code" : "[1].use", "display" : "[1].use", "equivalence" : "equivalent" }] }, { "extension" : [{ "extension" : [{ "url" : "type", "valueCode" : "DR" }, { "url" : "cardinalityMin", "valueInteger" : 0 }, { "url" : "cardinalityMax", "valueInteger" : 1 }], "url" : "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo" }], "code" : "XPN.10", "display" : "Name Validity Range", "target" : [{ "extension" : [{ "extension" : [{ "url" : "type", "valueCode" : "Period" }, { "url" : "cardinalityMin", "valueInteger" : 1 }, { "url" : "cardinalityMax", "valueInteger" : 1 }], "url" : "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo" }], "code" : "[1].period", "display" : "[1].period", "equivalence" : "equivalent", "dependsOn" : [{ "property" : "Computable-ANTLR", "value" : "IF XPN.12 NOT VALUED AND XPN.13 NOT VALUED" }] }] }, { "extension" : [{ "extension" : [{ "url" : "type", "valueCode" : "ID" }, { "url" : "cardinalityMin", "valueInteger" : 0 }, { "url" : "cardinalityMax", "valueInteger" : 1 }], "url" : "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo" }], "code" : "XPN.11", "display" : "Name Assembly Order", "target" : [{ "extension" : [{ "extension" : [{ "url" : "type", "valueCode" : "uri" }, { "url" : "cardinalityMin", "valueInteger" : 1 }, { "url" : "cardinalityMax", "valueInteger" : 1 }, { "url" : "assignment", "valueString" : "\"http://hl7.org/fhir/StructureDefinition/humanname-assembly-order\"" }], "url" : "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo" }], "code" : "[1].extension.url", "display" : "[1].extension.url", "equivalence" : "equivalent" }] }, { "extension" : [{ "extension" : [{ "url" : "type", "valueCode" : "ID" }, { "url" : "cardinalityMin", "valueInteger" : 0 }, { "url" : "cardinalityMax", "valueInteger" : 1 }], "url" : "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo" }], "code" : "XPN.11", "display" : "Name Assembly Order", "target" : [{ "extension" : [{ "extension" : [{ "url" : "type", "valueCode" : "code" }, { "url" : "cardinalityMin", "valueInteger" : 1 }, { "url" : "cardinalityMax", "valueInteger" : 1 }, { "url" : "mappedVia", "valueUrl" : "ConceptMap/table-hl70444-to-v2-0444" }], "url" : "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo" }], "code" : "[1].extension.valueCode", "display" : "[1].extension.valueCode", "equivalence" : "equivalent" }] }, { "extension" : [{ "extension" : [{ "url" : "type", "valueCode" : "DTM" }, { "url" : "cardinalityMin", "valueInteger" : 0 }, { "url" : "cardinalityMax", "valueInteger" : 1 }], "url" : "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo" }], "code" : "XPN.12", "display" : "Effective Date", "target" : [{ "extension" : [{ "extension" : [{ "url" : "type", "valueCode" : "dateTime" }, { "url" : "cardinalityMin", "valueInteger" : 1 }, { "url" : "cardinalityMax", "valueInteger" : 1 }], "url" : "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo" }], "code" : "[1].period.start", "display" : "[1].period.start", "equivalence" : "equivalent" }] }, { "extension" : [{ "extension" : [{ "url" : "type", "valueCode" : "DTM" }, { "url" : "cardinalityMin", "valueInteger" : 0 }, { "url" : "cardinalityMax", "valueInteger" : 1 }], "url" : "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo" }], "code" : "XPN.13", "display" : "Expiration Date", "target" : [{ "extension" : [{ "extension" : [{ "url" : "type", "valueCode" : "dateTime" }, { "url" : "cardinalityMin", "valueInteger" : 1 }, { "url" : "cardinalityMax", "valueInteger" : 1 }], "url" : "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo" }], "code" : "[1].period.end", "display" : "[1].period.end", "equivalence" : "equivalent" }] }, { "extension" : [{ "extension" : [{ "url" : "type", "valueCode" : "ST" }, { "url" : "cardinalityMin", "valueInteger" : 0 }, { "url" : "cardinalityMax", "valueInteger" : 1 }], "url" : "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo" }], "code" : "XPN.14", "display" : "Professional Suffix", "target" : [{ "extension" : [{ "extension" : [{ "url" : "type", "valueCode" : "string" }, { "url" : "cardinalityMin", "valueInteger" : -1 }, { "url" : "cardinalityMax", "valueInteger" : -1 }], "url" : "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo" }], "code" : "[1].suffix[3]", "display" : "[1].suffix[3]", "equivalence" : "equivalent" }] }, { "extension" : [{ "extension" : [{ "url" : "type", "valueCode" : "ST" }, { "url" : "cardinalityMin", "valueInteger" : 0 }, { "url" : "cardinalityMax", "valueInteger" : 1 }], "url" : "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo" }], "code" : "XPN.15", "display" : "Called By", "target" : [{ "extension" : [{ "extension" : [{ "url" : "type", "valueCode" : "string" }, { "url" : "cardinalityMin", "valueInteger" : -1 }, { "url" : "cardinalityMax", "valueInteger" : -1 }], "url" : "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo" }], "code" : "[2].given", "display" : "[2].given", "equivalence" : "equivalent", "comment" : "One possibility is to put this in HumanName.given where HumanName.use=\"usual\". When XPN.7 does not map to \"usual\" a new occurence of Patient.name should be created\nAlternative a new extension could be created for HumanName.family.#ext-called-by#\\", "dependsOn" : [{ "property" : "Narrative-Condition", "value" : "if the resource attribute using the HumanName datatype allows for multiple names" }] }] }, { "extension" : [{ "extension" : [{ "url" : "type", "valueCode" : "ST" }, { "url" : "cardinalityMin", "valueInteger" : 0 }, { "url" : "cardinalityMax", "valueInteger" : 1 }], "url" : "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo" }], "code" : "XPN.15", "display" : "Called By", "target" : [{ "extension" : [{ "extension" : [{ "url" : "type", "valueCode" : "code" }, { "url" : "cardinalityMin", "valueInteger" : 1 }, { "url" : "cardinalityMax", "valueInteger" : 1 }, { "url" : "assignment", "valueString" : "\"nickname\"" }], "url" : "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo" }], "code" : "[2].use", "display" : "[2].use", "equivalence" : "equivalent", "dependsOn" : [{ "property" : "Narrative-Condition", "value" : "if the resource attribute using the HumanName datatype allows for multiple names" }] }] }] }] }