ConceptMap - FHIR Resource (stu3)
This ConceptMap Resource uses the FHIR API standard for access and structure.
Validate an ConceptMap FHIR Resource (stu3)
ConceptMap Attributes
AttributeField is listTypeDescription
Description: draft | active | retired | unknown
FHIR Version: stu3
Attribute Type : code
Required: N/A
Countability: Singleton
Flags: N/A
Terminology bindings: N/A
Requirements: N/A
Comments: N/A
Example:
"status": "draft"Learn more about the (ConceptMap) status FHIR attribute
Description: Name of the publisher (organization or individual)
FHIR Version: stu3
Attribute Type : string
Required: N/A
Countability: Singleton
Flags: N/A
Terminology bindings: N/A
Requirements: N/A
Comments: N/A
Example:
"publisher": "HL7, Inc"Learn more about the (ConceptMap) publisher FHIR attribute
Description: Same source and target systems
FHIR Version: stu3
Attribute Type : Data Type
Required: N/A
Countability: Array
Flags: N/A
Terminology bindings: N/A
Requirements: N/A
Comments: N/A
Example:
"group": [
{
"unmapped": {
"code": "temp",
"mode": "fixed",
"display": "temp"
},
"source": "http://hl7.org/fhir/address-use",
"target": "http://hl7.org/fhir/v3/AddressUse",
"element": [
{
"code": "home",
"display": "home",
"target": [
{
"code": "H",
"display": "home"
}
]
},
{
"code": "work",
"display": "work",
"target": [
{
"code": "WP",
"display": "work place"
}
]
},
{
"code": "temp",
"display": "temp",
"target": [
{
"code": "TMP",
"display": "temporary address"
}
]
},
{
"code": "old",
"display": "old",
"target": [
{
"comment": "In the HL7 v3 AD, old is handled by the usablePeriod element, but you have to provide a time, there's no simple equivalent of flagging an address as old",
"equivalence": "disjoint",
"code": "BAD",
"display": "bad address"
}
]
}
]
}
]Learn more about the (ConceptMap) group FHIR attribute
Description: Name for this concept map (computer friendly)
FHIR Version: stu3
Attribute Type : string
Required: N/A
Countability: Singleton
Flags: N/A
Terminology bindings: N/A
Requirements: N/A
Comments: N/A
Example:
"name": "FHIR-v3-Address-Use"Learn more about the (ConceptMap) name FHIR attribute
Description: Use and/or publishing restrictions
FHIR Version: stu3
Attribute Type : markdown
Required: N/A
Countability: Singleton
Flags: N/A
Terminology bindings: N/A
Requirements: N/A
Comments: N/A
Example:
"copyright": "Creative Commons 0"Learn more about the (ConceptMap) copyright FHIR attribute
Description: Name for this concept map (human friendly)
FHIR Version: stu3
Attribute Type : string
Required: N/A
Countability: Singleton
Flags: N/A
Terminology bindings: N/A
Requirements: N/A
Comments: N/A
Example:
"title": "FHIR/v3 Address Use Mapping"Learn more about the (ConceptMap) title FHIR attribute
Description: Logical URI to reference this concept map (globally unique)
FHIR Version: stu3
Attribute Type : uri
Required: N/A
Countability: Singleton
Flags: N/A
Terminology bindings: N/A
Requirements: N/A
Comments: N/A
Example:
"url": "http://hl7.org/fhir/ConceptMap/101"Learn more about the (ConceptMap) url FHIR attribute
Description: Intended jurisdiction for concept map (if applicable)
FHIR Version: stu3
Attribute Type : CodeableConcept
Required: N/A
Countability: Array
Flags: N/A
Terminology bindings: N/A
Requirements: N/A
Comments: N/A
Example:
"jurisdiction": Learn more about the (ConceptMap) jurisdiction FHIR attribute
Description: "targetReference" : { Reference(ValueSet) },
FHIR Version: stu3
Attribute Type : Reference
Required: N/A
Countability: Singleton
Flags: N/A
Terminology bindings: N/A
Requirements: N/A
Comments: N/A
Example:
"targetReference": Learn more about the (ConceptMap) targetReference FHIR attribute
Description: "sourceUri" : "<uri>",
FHIR Version: stu3
Attribute Type : uri
Required: N/A
Countability: Singleton
Flags: N/A
Terminology bindings: N/A
Requirements: N/A
Comments: N/A
Example:
"sourceUri": "http://hl7.org/fhir/ValueSet/address-use"Learn more about the (ConceptMap) sourceUri FHIR attribute
Description: "targetUri" : "<uri>",
FHIR Version: stu3
Attribute Type : uri
Required: N/A
Countability: Singleton
Flags: N/A
Terminology bindings: N/A
Requirements: N/A
Comments: N/A
Example:
"targetUri": "http://hl7.org/fhir/ValueSet/v3-AddressUse"Learn more about the (ConceptMap) targetUri FHIR attribute
Description: Contact details for the publisher
FHIR Version: stu3
Attribute Type : ContactDetail
Required: N/A
Countability: Array
Flags: N/A
Terminology bindings: N/A
Requirements: N/A
Comments: N/A
Example:
"contact": [
{
"telecom": [
{
"system": "url",
"value": "http://hl7.org/fhir"
}
],
"name": "FHIR project team (example)"
}
]Learn more about the (ConceptMap) contact FHIR attribute
Description: Context the content is intended to support
FHIR Version: stu3
Attribute Type : UsageContext
Required: N/A
Countability: Array
Flags: N/A
Terminology bindings: N/A
Requirements: N/A
Comments: N/A
Example:
"useContext": [
{
"valueCodeableConcept": {
"text": "for CDA Usage"
},
"code": {
"code": "venue",
"system": "http://hl7.org/fhir/usage-context-type"
}
}
]Learn more about the (ConceptMap) useContext FHIR attribute
Description: Why this concept map is defined
FHIR Version: stu3
Attribute Type : markdown
Required: N/A
Countability: Singleton
Flags: N/A
Terminology bindings: N/A
Requirements: N/A
Comments: N/A
Example:
"purpose": "To help implementers map from HL7 v3/CDA to FHIR"Learn more about the (ConceptMap) purpose FHIR attribute
Description: Business version of the concept map
FHIR Version: stu3
Attribute Type : string
Required: N/A
Countability: Singleton
Flags: N/A
Terminology bindings: N/A
Requirements: N/A
Comments: N/A
Example:
"version": "20120613"Learn more about the (ConceptMap) version FHIR attribute
Description: Date this was last changed
FHIR Version: stu3
Attribute Type : dateTime
Required: N/A
Countability: Singleton
Flags: N/A
Terminology bindings: N/A
Requirements: N/A
Comments: N/A
Example:
"date": "2012-06-13"Learn more about the (ConceptMap) date FHIR attribute
Description: "sourceReference" : { Reference(ValueSet) },
FHIR Version: stu3
Attribute Type : Reference
Required: N/A
Countability: Singleton
Flags: N/A
Terminology bindings: N/A
Requirements: N/A
Comments: N/A
Example:
"sourceReference": Learn more about the (ConceptMap) sourceReference FHIR attribute
Description: Additional identifier for the concept map
FHIR Version: stu3
Attribute Type : Identifier
Required: N/A
Countability: Singleton
Flags: N/A
Terminology bindings: N/A
Requirements: N/A
Comments: N/A
Example:
"identifier": {
"system": "urn:ietf:rfc:3986",
"value": "urn:uuid:53cd62ee-033e-414c-9f58-3ca97b5ffc3b"
}Learn more about the (ConceptMap) identifier FHIR attribute
Description: For testing purposes, not real usage
FHIR Version: stu3
Attribute Type : boolean
Required: N/A
Countability: Singleton
Flags: N/A
Terminology bindings: N/A
Requirements: N/A
Comments: N/A
Example:
"experimental": trueLearn more about the (ConceptMap) experimental FHIR attribute
Description: Natural language description of the concept map
FHIR Version: stu3
Attribute Type : markdown
Required: N/A
Countability: Singleton
Flags: N/A
Terminology bindings: N/A
Requirements: N/A
Comments: N/A
Example:
"description": "A mapping between the FHIR and HL7 v3 AddressUse Code systems"Learn more about the (ConceptMap) description FHIR attribute
ConceptMap Example
{
"status": "draft",
"publisher": "HL7, Inc",
"sourceUri": "http://hl7.org/fhir/ValueSet/address-use",
"name": "FHIR-v3-Address-Use",
"copyright": "Creative Commons 0",
"title": "FHIR/v3 Address Use Mapping",
"resourceType": "ConceptMap",
"text": {
"status": "generated",
"div": "<div xmlns=\"http://www.w3.org/1999/xhtml\">\n <h2>FHIR-v3-Address-Use (http://hl7.org/fhir/ConceptMap/101)</h2>\n <p>Mapping from \n <a href=\"valueset-address-use.html\">http://hl7.org/fhir/ValueSet/address-use</a> to \n <a href=\"v3/AddressUse/vs.html\">http://hl7.org/fhir/ValueSet/v3-AddressUse</a>\n </p>\n <p>DRAFT (not intended for production usage). Published on 13/06/2012 by HL7, Inc (FHIR project team (example): \n <a href=\"http://hl7.org/fhir\">http://hl7.org/fhir</a>). Creative Commons 0\n </p>\n <div>\n <p>A mapping between the FHIR and HL7 v3 AddressUse Code systems</p>\n\n </div>\n <br/>\n <table class=\"grid\">\n <tr>\n <td>\n <b>Source Code</b>\n </td>\n <td>\n <b>Equivalence</b>\n </td>\n <td>\n <b>Destination Code</b>\n </td>\n <td>\n <b>Comment</b>\n </td>\n </tr>\n <tr>\n <td>home (Home)</td>\n <td/>\n <td>H (home address)</td>\n <td/>\n </tr>\n <tr>\n <td>work (Work)</td>\n <td/>\n <td>WP (work place)</td>\n <td/>\n </tr>\n <tr>\n <td>temp (Temporary)</td>\n <td/>\n <td>TMP (temporary address)</td>\n <td/>\n </tr>\n <tr>\n <td>old (Old / Incorrect)</td>\n <td>disjoint</td>\n <td>BAD (bad address)</td>\n <td>In the HL7 v3 AD, old is handled by the usablePeriod element, but you have to provide a time, there's no simple equivalent of flagging an address as old</td>\n </tr>\n </table>\n </div>"
},
"contact": [
{
"telecom": [
{
"system": "url",
"value": "http://hl7.org/fhir"
}
],
"name": "FHIR project team (example)"
}
],
"url": "http://hl7.org/fhir/ConceptMap/101",
"targetUri": "http://hl7.org/fhir/ValueSet/v3-AddressUse",
"version": "20120613",
"useContext": [
{
"valueCodeableConcept": {
"text": "for CDA Usage"
},
"code": {
"code": "venue",
"system": "http://hl7.org/fhir/usage-context-type"
}
}
],
"purpose": "To help implementers map from HL7 v3/CDA to FHIR",
"date": "2012-06-13",
"group": [
{
"unmapped": {
"code": "temp",
"mode": "fixed",
"display": "temp"
},
"source": "http://hl7.org/fhir/address-use",
"target": "http://hl7.org/fhir/v3/AddressUse",
"element": [
{
"code": "home",
"display": "home",
"target": [
{
"code": "H",
"display": "home"
}
]
},
{
"code": "work",
"display": "work",
"target": [
{
"code": "WP",
"display": "work place"
}
]
},
{
"code": "temp",
"display": "temp",
"target": [
{
"code": "TMP",
"display": "temporary address"
}
]
},
{
"code": "old",
"display": "old",
"target": [
{
"comment": "In the HL7 v3 AD, old is handled by the usablePeriod element, but you have to provide a time, there's no simple equivalent of flagging an address as old",
"equivalence": "disjoint",
"code": "BAD",
"display": "bad address"
}
]
}
]
}
],
"identifier": {
"system": "urn:ietf:rfc:3986",
"value": "urn:uuid:53cd62ee-033e-414c-9f58-3ca97b5ffc3b"
},
"id": "101",
"experimental": true,
"description": "A mapping between the FHIR and HL7 v3 AddressUse Code systems"
}ConceptMap Structure
{
"resourceType" : "ConceptMap",
// from Resource: id, meta, implicitRules, and language
// from DomainResource: text, contained, extension, and modifierExtension
"url" : "<uri>", // Logical URI to reference this concept map (globally unique)
"identifier" : { Identifier }, // Additional identifier for the concept map
"version" : "<string>", // Business version of the concept map
"name" : "<string>", // Name for this concept map (computer friendly)
"title" : "<string>", // Name for this concept map (human friendly)
"status" : "<code>", // R! draft | active | retired | unknown
"experimental" : <boolean>, // For testing purposes, not real usage
"date" : "<dateTime>", // Date this was last changed
"publisher" : "<string>", // Name of the publisher (organization or individual)
"contact" : [{ ContactDetail }], // Contact details for the publisher
"description" : "<markdown>", // Natural language description of the concept map
"useContext" : [{ UsageContext }], // Context the content is intended to support
"jurisdiction" : [{ CodeableConcept }], // Intended jurisdiction for concept map (if applicable)
"purpose" : "<markdown>", // Why this concept map is defined
"copyright" : "<markdown>", // Use and/or publishing restrictions
// source[x]: Identifies the source of the concepts which are being mapped. One of these 2:
"sourceUri" : "<uri>",
"sourceReference" : { Reference(ValueSet) },
// target[x]: Provides context to the mappings. One of these 2:
"targetUri" : "<uri>",
"targetReference" : { Reference(ValueSet) },
"group" : [{ // Same source and target systems
"source" : "<uri>", // Code System (if value set crosses code systems)
"sourceVersion" : "<string>", // Specific version of the code system
"target" : "<uri>", // System of the target (if necessary)
"targetVersion" : "<string>", // Specific version of the code system
"element" : [{ // R! Mappings for a concept from the source set
"code" : "<code>", // Identifies element being mapped
"display" : "<string>", // Display for the code
"target" : [{ // Concept in target system for element
"code" : "<code>", // Code that identifies the target element
"display" : "<string>", // Display for the code
"equivalence" : "<code>", // relatedto | equivalent | equal | wider | subsumes | narrower | specializes | inexact | unmatched | disjoint
"comment" : "<string>", // C? Description of status/issues in mapping
"dependsOn" : [{ // Other elements required for this mapping (from context)
"property" : "<uri>", // R! Reference to property mapping depends on
"system" : "<uri>", // Code System (if necessary)
"code" : "<string>", // R! Value of the referenced element
"display" : "<string>" // Display for the code
}],
"product" : [{ Content as for ConceptMap.group.element.target.dependsOn }] // Other concepts that this mapping also produces
}]
}],
"unmapped" : { // When no match in the mappings
"mode" : "<code>", // R! provided | fixed | other-map
"code" : "<code>", // Fixed code when mode = fixed
"display" : "<string>", // Display for the code
"url" : "<uri>" // Canonical URL for other concept map
}
}]
}
ConceptMap Search Parameters
The following search parameters can be used to query ConceptMap resources. Just submit them like so:
https://api.1up.health/fhir/stu3/ConceptMap?query-param=queryvalue| Search Parameter | Field Type | Resource Fields Searched |
|---|---|---|
date | date | date |
dependson | uri | group.element.target.dependsOn.property |
description | text | description |
identifier | text | identifier |
jurisdiction | text | jurisdiction |
name | text | name |
other | uri | group.unmapped.url |
product | uri | group.element.target.product.property |
publisher | text | publisher |
source | reference | source.as |
source-code | text | group.element.code |
source-system | uri | group.source |
source-uri | reference | source.as |
status | text | status |
target | reference | target.as |
target-code | text | group.element.target.code |
target-system | uri | group.target |
target-uri | reference | target.as |
title | text | title |
url | uri | url |
version | text | version |
