SMART Base, published by WHO. This guide is not an authorized publication; it is the continuous build for version 0.3.0 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/WorldHealthOrganization/smart-base/ and changes regularly. See the Directory of published versions

• Content
• Detailed Descriptions
• Mappings
• XML
• JSON
• TTL

Resource Profile: SMART Guidelines ConceptMap

Defines the minimum expectations for ConceptMap resources used in SMART Guidelines

Usages:

• Refer to this Profile: SMART Guidelines ImplementationGuide

You can also check for usages in the FHIR IG Statistics

Formal Views of Profile Content

Description of Profiles, Differentials, Snapshots and how the different presentations work.

• Key Elements Table
• Differential Table
• Snapshot Table
• Statistics/References
• All

Name	Flags	Card.	Type	Description & Constraints    Filter: Bindings Constraints Obligations
ConceptMap	C	1..1	CRMIShareableConceptMap	A map from one set of concepts to one or more other concepts Constraints: cmd-0, shr-1
ConceptMap.implicitRules	?! This element is a modifier element. Σ This element is included in summaries.	0..1	uri	A set of rules under which this content was created
ConceptMap.Slices for extension				Content/Rules for all slices
ConceptMap.Slices for extension.extension:knowledgeCapability	S This element must be supported. C	0..*	code	shareable | computable | publishable | executable URL: http://hl7.org/fhir/StructureDefinition/cqf-knowledgeCapability Binding: KnowledgeCapability (required)
ConceptMap.Slices for extension.extension:versionAlgorithm	S This element must be supported.	0..1	Coding	How to compare versions URL: http://hl7.org/fhir/StructureDefinition/artifact-versionAlgorithm Binding: VersionAlgorithm (extensible)
ConceptMap.Slices for extension.extension:versionPolicy		0..1	CodeableConcept	metadata | strict URL: http://hl7.org/fhir/StructureDefinition/artifact-versionPolicy Binding: ValueSet Artifact Version Policy (extensible): The versioning policy of the artifact
ConceptMap.Slices for extension.extension:webSource	S This element must be supported.	0..1	url	web-source URL: http://hl7.org/fhir/StructureDefinition/web-source
ConceptMap.modifierExtension	?! This element is a modifier element.	0..*	Extension	Extensions that cannot be ignored
ConceptMap.url	S This element must be supported. Σ This element is included in summaries.	1..1	uri	Canonical identifier for this concept map, represented as a URI (globally unique)
ConceptMap.version	S This element must be supported. Σ This element is included in summaries.	1..1	string	Business version of the concept map
ConceptMap.name	S This element must be supported. Σ This element is included in summaries. C	1..1	string	Name for this concept map (computer friendly)
ConceptMap.title	S This element must be supported. Σ This element is included in summaries.	1..1	string	Name for this concept map (human friendly)
ConceptMap.status	?! This element is a modifier element. S This element must be supported. Σ This element is included in summaries.	1..1	code	draft | active | retired | unknown Binding: PublicationStatus (required): The lifecycle status of an artifact.
ConceptMap.experimental	S This element must be supported. Σ This element is included in summaries.	1..1	boolean	For testing purposes, not real usage
ConceptMap.publisher	S This element must be supported. Σ This element is included in summaries.	1..1	string	Name of the publisher (organization or individual)
ConceptMap.description	S This element must be supported.	1..1	markdown	Natural language description of the concept map
Documentation for this format

Terminology Bindings

Path	Status	Usage	ValueSet	Version	Source
ConceptMap.status	Base	required	PublicationStatus	📍4.0.1	FHIR Std.

Constraints

Id	Grade	Path(s)	Description	Expression
cmd-0	warning	ConceptMap	Name should be usable as an identifier for the module by machine processing applications such as code generation	name.matches('[A-Z]([A-Za-z0-9_]){0,254}')
dom-2	error	ConceptMap	If the resource is contained in another resource, it SHALL NOT contain nested Resources	contained.contained.empty()
dom-3	error	ConceptMap	If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource	contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty()
dom-4	error	ConceptMap	If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated	contained.meta.versionId.empty() and contained.meta.lastUpdated.empty()
dom-5	error	ConceptMap	If a resource is contained in another resource, it SHALL NOT have a security label	contained.meta.security.empty()
dom-6	best practice	ConceptMap	A resource should have narrative for robust management	text.`div`.exists()
ele-1	error	**ALL** elements	All FHIR elements must have a @value or children	hasValue() or (children().count() > id.count())
ext-1	error	**ALL** extensions	Must have either extensions or value[x], not both	extension.exists() != value.exists()
shr-1	error	ConceptMap	If knowledge capabilities are stated, they SHALL include shareable	extension('http://hl7.org/fhir/StructureDefinition/cqf-knowledgeCapability').exists() implies extension('http://hl7.org/fhir/StructureDefinition/cqf-knowledgeCapability').where(value = 'shareable').exists()

This structure is derived from CRMIShareableConceptMap

Name	Flags	Card.	Type	Description & Constraints    Filter: Bindings Constraints Obligations
ConceptMap		1..1	CRMIShareableConceptMap	A map from one set of concepts to one or more other concepts
ConceptMap.name		1..1	string	Name for this concept map (computer friendly)
ConceptMap.publisher		1..1	string	Name of the publisher (organization or individual)
Documentation for this format

Name	Flags	Card.	Type	Description & Constraints    Filter: Bindings Constraints Obligations
ConceptMap	C	1..1	CRMIShareableConceptMap	A map from one set of concepts to one or more other concepts Constraints: cmd-0, shr-1
ConceptMap.id	Σ This element is included in summaries.	0..1	id	Logical id of this artifact
ConceptMap.meta	Σ This element is included in summaries.	0..1	Meta	Metadata about the resource
ConceptMap.implicitRules	?! This element is a modifier element. Σ This element is included in summaries.	0..1	uri	A set of rules under which this content was created
ConceptMap.language		0..1	code	Language of the resource content Binding: CommonLanguages (preferred): A human language. Additional Bindings Purpose AllLanguages Max Binding
ConceptMap.text		0..1	Narrative	Text summary of the resource, for human interpretation This profile does not constrain the narrative in regard to content, language, or traceability to data elements
ConceptMap.contained		0..*	Resource	Contained, inline Resources
ConceptMap.Slices for extension		0..*	Extension	Extension Slice: Unordered, Open by value:url
ConceptMap.Slices for extension.extension:knowledgeCapability	S This element must be supported. C	0..*	code	shareable | computable | publishable | executable URL: http://hl7.org/fhir/StructureDefinition/cqf-knowledgeCapability Binding: KnowledgeCapability (required)
ConceptMap.Slices for extension.extension:versionAlgorithm	S This element must be supported.	0..1	Coding	How to compare versions URL: http://hl7.org/fhir/StructureDefinition/artifact-versionAlgorithm Binding: VersionAlgorithm (extensible)
ConceptMap.Slices for extension.extension:versionPolicy		0..1	CodeableConcept	metadata | strict URL: http://hl7.org/fhir/StructureDefinition/artifact-versionPolicy Binding: ValueSet Artifact Version Policy (extensible): The versioning policy of the artifact
ConceptMap.Slices for extension.extension:webSource	S This element must be supported.	0..1	url	web-source URL: http://hl7.org/fhir/StructureDefinition/web-source
ConceptMap.modifierExtension	?! This element is a modifier element.	0..*	Extension	Extensions that cannot be ignored
ConceptMap.url	S This element must be supported. Σ This element is included in summaries.	1..1	uri	Canonical identifier for this concept map, represented as a URI (globally unique)
ConceptMap.identifier	Σ This element is included in summaries.	0..1	Identifier	Additional identifier for the concept map
ConceptMap.version	S This element must be supported. Σ This element is included in summaries.	1..1	string	Business version of the concept map
ConceptMap.name	S This element must be supported. Σ This element is included in summaries. C	1..1	string	Name for this concept map (computer friendly)
ConceptMap.title	S This element must be supported. Σ This element is included in summaries.	1..1	string	Name for this concept map (human friendly)
ConceptMap.status	?! This element is a modifier element. S This element must be supported. Σ This element is included in summaries.	1..1	code	draft | active | retired | unknown Binding: PublicationStatus (required): The lifecycle status of an artifact.
ConceptMap.experimental	S This element must be supported. Σ This element is included in summaries.	1..1	boolean	For testing purposes, not real usage
ConceptMap.date	Σ This element is included in summaries.	0..1	dateTime	Date last changed
ConceptMap.publisher	S This element must be supported. Σ This element is included in summaries.	1..1	string	Name of the publisher (organization or individual)
ConceptMap.contact	Σ This element is included in summaries.	0..*	ContactDetail	Contact details for the publisher
ConceptMap.description	S This element must be supported.	1..1	markdown	Natural language description of the concept map
ConceptMap.useContext	Σ This element is included in summaries.	0..*	UsageContext	The context that the content is intended to support
ConceptMap.jurisdiction	Σ This element is included in summaries.	0..*	CodeableConcept	Intended jurisdiction for concept map (if applicable) Binding: Jurisdiction ValueSet (extensible): Countries and regions within which this artifact is targeted for use.
ConceptMap.purpose		0..1	markdown	Why this concept map is defined
ConceptMap.copyright		0..1	markdown	Use and/or publishing restrictions
ConceptMap.source[x]	Σ This element is included in summaries.	0..1		The source value set that contains the concepts that are being mapped
ConceptMap.source[x].sourceUri			uri
ConceptMap.source[x].sourceCanonical			canonical(ValueSet)
ConceptMap.target[x]	Σ This element is included in summaries.	0..1		The target value set which provides context for the mappings
ConceptMap.target[x].targetUri			uri
ConceptMap.target[x].targetCanonical			canonical(ValueSet)
ConceptMap.group		0..*	BackboneElement	Same source and target systems
ConceptMap.group.id		0..1	string	Unique id for inter-element referencing
ConceptMap.group.extension		0..*	Extension	Additional content defined by implementations
ConceptMap.group.modifierExtension	?! This element is a modifier element. Σ This element is included in summaries.	0..*	Extension	Extensions that cannot be ignored even if unrecognized
ConceptMap.group.source		0..1	uri	Source system where concepts to be mapped are defined
ConceptMap.group.sourceVersion		0..1	string	Specific version of the code system
ConceptMap.group.target		0..1	uri	Target system that the concepts are to be mapped to
ConceptMap.group.targetVersion		0..1	string	Specific version of the code system
ConceptMap.group.element		1..*	BackboneElement	Mappings for a concept from the source set
ConceptMap.group.element.id		0..1	string	Unique id for inter-element referencing
ConceptMap.group.element.extension		0..*	Extension	Additional content defined by implementations
ConceptMap.group.element.modifierExtension	?! This element is a modifier element. Σ This element is included in summaries.	0..*	Extension	Extensions that cannot be ignored even if unrecognized
ConceptMap.group.element.code		0..1	code	Identifies element being mapped
ConceptMap.group.element.display		0..1	string	Display for the code
ConceptMap.group.element.target	C	0..*	BackboneElement	Concept in target system for element Constraints: cmd-1
ConceptMap.group.element.target.id		0..1	string	Unique id for inter-element referencing
ConceptMap.group.element.target.extension		0..*	Extension	Additional content defined by implementations
ConceptMap.group.element.target.modifierExtension	?! This element is a modifier element. Σ This element is included in summaries.	0..*	Extension	Extensions that cannot be ignored even if unrecognized
ConceptMap.group.element.target.code		0..1	code	Code that identifies the target element
ConceptMap.group.element.target.display		0..1	string	Display for the code
ConceptMap.group.element.target.equivalence	?! This element is a modifier element.	1..1	code	relatedto | equivalent | equal | wider | subsumes | narrower | specializes | inexact | unmatched | disjoint Binding: ConceptMapEquivalence (required): The degree of equivalence between concepts.
ConceptMap.group.element.target.comment	C	0..1	string	Description of status/issues in mapping
ConceptMap.group.element.target.dependsOn		0..*	BackboneElement	Other elements required for this mapping (from context)
ConceptMap.group.element.target.dependsOn.id		0..1	string	Unique id for inter-element referencing
ConceptMap.group.element.target.dependsOn.extension		0..*	Extension	Additional content defined by implementations
ConceptMap.group.element.target.dependsOn.modifierExtension	?! This element is a modifier element. Σ This element is included in summaries.	0..*	Extension	Extensions that cannot be ignored even if unrecognized
ConceptMap.group.element.target.dependsOn.property		1..1	uri	Reference to property mapping depends on
ConceptMap.group.element.target.dependsOn.system		0..1	canonical(CodeSystem)	Code System (if necessary)
ConceptMap.group.element.target.dependsOn.value		1..1	string	Value of the referenced element
ConceptMap.group.element.target.dependsOn.display		0..1	string	Display for the code (if value is a code)
ConceptMap.group.element.target.product		0..*	See dependsOn (ConceptMap)	Other concepts that this mapping also produces
ConceptMap.group.unmapped	C	0..1	BackboneElement	What to do when there is no mapping for the source concept Constraints: cmd-2, cmd-3
ConceptMap.group.unmapped.id		0..1	string	Unique id for inter-element referencing
ConceptMap.group.unmapped.extension		0..*	Extension	Additional content defined by implementations
ConceptMap.group.unmapped.modifierExtension	?! This element is a modifier element. Σ This element is included in summaries.	0..*	Extension	Extensions that cannot be ignored even if unrecognized
ConceptMap.group.unmapped.mode		1..1	code	provided | fixed | other-map Binding: ConceptMapGroupUnmappedMode (required): Defines which action to take if there is no match in the group.
ConceptMap.group.unmapped.code		0..1	code	Fixed code when mode = fixed
ConceptMap.group.unmapped.display		0..1	string	Display for the code
ConceptMap.group.unmapped.url		0..1	canonical(ConceptMap)	canonical reference to an additional ConceptMap to use for mapping if the source concept is unmapped
Documentation for this format

Terminology Bindings

Path	Status	Usage	ValueSet	Version	Source
ConceptMap.language	Base	preferred	Common Languages	📍4.0.1	FHIR Std.
ConceptMap.status	Base	required	PublicationStatus	📍4.0.1	FHIR Std.
ConceptMap.jurisdiction	Base	extensible	Jurisdiction	📍4.0.1	FHIR Std.
ConceptMap.group.element.​target.equivalence	Base	required	ConceptMapEquivalence	📍4.0.1	FHIR Std.
ConceptMap.group.unmapped.​mode	Base	required	ConceptMapGroupUnmappedMode	📍4.0.1	FHIR Std.

Constraints

Id	Grade	Path(s)	Description	Expression
cmd-0	warning	ConceptMap	Name should be usable as an identifier for the module by machine processing applications such as code generation	name.matches('[A-Z]([A-Za-z0-9_]){0,254}')
cmd-1	error	ConceptMap.group.element.target	If the map is narrower or inexact, there SHALL be some comments	comment.exists() or equivalence.empty() or ((equivalence != 'narrower') and (equivalence != 'inexact'))
cmd-2	error	ConceptMap.group.unmapped	If the mode is 'fixed', a code must be provided	(mode = 'fixed') implies code.exists()
cmd-3	error	ConceptMap.group.unmapped	If the mode is 'other-map', a url must be provided	(mode = 'other-map') implies url.exists()
dom-2	error	ConceptMap	If the resource is contained in another resource, it SHALL NOT contain nested Resources	contained.contained.empty()
dom-3	error	ConceptMap	If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource	contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty()
dom-4	error	ConceptMap	If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated	contained.meta.versionId.empty() and contained.meta.lastUpdated.empty()
dom-5	error	ConceptMap	If a resource is contained in another resource, it SHALL NOT have a security label	contained.meta.security.empty()
dom-6	best practice	ConceptMap	A resource should have narrative for robust management	text.`div`.exists()
ele-1	error	**ALL** elements	All FHIR elements must have a @value or children	hasValue() or (children().count() > id.count())
ext-1	error	**ALL** extensions	Must have either extensions or value[x], not both	extension.exists() != value.exists()
shr-1	error	ConceptMap	If knowledge capabilities are stated, they SHALL include shareable	extension('http://hl7.org/fhir/StructureDefinition/cqf-knowledgeCapability').exists() implies extension('http://hl7.org/fhir/StructureDefinition/cqf-knowledgeCapability').where(value = 'shareable').exists()

This structure is derived from CRMIShareableConceptMap

Summary

Mandatory: 2 elements

Key Elements View

Name	Flags	Card.	Type	Description & Constraints    Filter: Bindings Constraints Obligations
ConceptMap	C	1..1	CRMIShareableConceptMap	A map from one set of concepts to one or more other concepts Constraints: cmd-0, shr-1
ConceptMap.implicitRules	?! This element is a modifier element. Σ This element is included in summaries.	0..1	uri	A set of rules under which this content was created
ConceptMap.Slices for extension				Content/Rules for all slices
ConceptMap.Slices for extension.extension:knowledgeCapability	S This element must be supported. C	0..*	code	shareable | computable | publishable | executable URL: http://hl7.org/fhir/StructureDefinition/cqf-knowledgeCapability Binding: KnowledgeCapability (required)
ConceptMap.Slices for extension.extension:versionAlgorithm	S This element must be supported.	0..1	Coding	How to compare versions URL: http://hl7.org/fhir/StructureDefinition/artifact-versionAlgorithm Binding: VersionAlgorithm (extensible)
ConceptMap.Slices for extension.extension:versionPolicy		0..1	CodeableConcept	metadata | strict URL: http://hl7.org/fhir/StructureDefinition/artifact-versionPolicy Binding: ValueSet Artifact Version Policy (extensible): The versioning policy of the artifact
ConceptMap.Slices for extension.extension:webSource	S This element must be supported.	0..1	url	web-source URL: http://hl7.org/fhir/StructureDefinition/web-source
ConceptMap.modifierExtension	?! This element is a modifier element.	0..*	Extension	Extensions that cannot be ignored
ConceptMap.url	S This element must be supported. Σ This element is included in summaries.	1..1	uri	Canonical identifier for this concept map, represented as a URI (globally unique)
ConceptMap.version	S This element must be supported. Σ This element is included in summaries.	1..1	string	Business version of the concept map
ConceptMap.name	S This element must be supported. Σ This element is included in summaries. C	1..1	string	Name for this concept map (computer friendly)
ConceptMap.title	S This element must be supported. Σ This element is included in summaries.	1..1	string	Name for this concept map (human friendly)
ConceptMap.status	?! This element is a modifier element. S This element must be supported. Σ This element is included in summaries.	1..1	code	draft | active | retired | unknown Binding: PublicationStatus (required): The lifecycle status of an artifact.
ConceptMap.experimental	S This element must be supported. Σ This element is included in summaries.	1..1	boolean	For testing purposes, not real usage
ConceptMap.publisher	S This element must be supported. Σ This element is included in summaries.	1..1	string	Name of the publisher (organization or individual)
ConceptMap.description	S This element must be supported.	1..1	markdown	Natural language description of the concept map
Documentation for this format

Terminology Bindings

Path	Status	Usage	ValueSet	Version	Source
ConceptMap.status	Base	required	PublicationStatus	📍4.0.1	FHIR Std.

Constraints

Id	Grade	Path(s)	Description	Expression
cmd-0	warning	ConceptMap	Name should be usable as an identifier for the module by machine processing applications such as code generation	name.matches('[A-Z]([A-Za-z0-9_]){0,254}')
dom-2	error	ConceptMap	If the resource is contained in another resource, it SHALL NOT contain nested Resources	contained.contained.empty()
dom-3	error	ConceptMap	If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource	contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty()
dom-4	error	ConceptMap	If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated	contained.meta.versionId.empty() and contained.meta.lastUpdated.empty()
dom-5	error	ConceptMap	If a resource is contained in another resource, it SHALL NOT have a security label	contained.meta.security.empty()
dom-6	best practice	ConceptMap	A resource should have narrative for robust management	text.`div`.exists()
ele-1	error	**ALL** elements	All FHIR elements must have a @value or children	hasValue() or (children().count() > id.count())
ext-1	error	**ALL** extensions	Must have either extensions or value[x], not both	extension.exists() != value.exists()
shr-1	error	ConceptMap	If knowledge capabilities are stated, they SHALL include shareable	extension('http://hl7.org/fhir/StructureDefinition/cqf-knowledgeCapability').exists() implies extension('http://hl7.org/fhir/StructureDefinition/cqf-knowledgeCapability').where(value = 'shareable').exists()

Differential View

This structure is derived from CRMIShareableConceptMap

Name	Flags	Card.	Type	Description & Constraints    Filter: Bindings Constraints Obligations
ConceptMap		1..1	CRMIShareableConceptMap	A map from one set of concepts to one or more other concepts
ConceptMap.name		1..1	string	Name for this concept map (computer friendly)
ConceptMap.publisher		1..1	string	Name of the publisher (organization or individual)
Documentation for this format

Snapshot View

Name	Flags	Card.	Type	Description & Constraints    Filter: Bindings Constraints Obligations
ConceptMap	C	1..1	CRMIShareableConceptMap	A map from one set of concepts to one or more other concepts Constraints: cmd-0, shr-1
ConceptMap.id	Σ This element is included in summaries.	0..1	id	Logical id of this artifact
ConceptMap.meta	Σ This element is included in summaries.	0..1	Meta	Metadata about the resource
ConceptMap.implicitRules	?! This element is a modifier element. Σ This element is included in summaries.	0..1	uri	A set of rules under which this content was created
ConceptMap.language		0..1	code	Language of the resource content Binding: CommonLanguages (preferred): A human language. Additional Bindings Purpose AllLanguages Max Binding
ConceptMap.text		0..1	Narrative	Text summary of the resource, for human interpretation This profile does not constrain the narrative in regard to content, language, or traceability to data elements
ConceptMap.contained		0..*	Resource	Contained, inline Resources
ConceptMap.Slices for extension		0..*	Extension	Extension Slice: Unordered, Open by value:url
ConceptMap.Slices for extension.extension:knowledgeCapability	S This element must be supported. C	0..*	code	shareable | computable | publishable | executable URL: http://hl7.org/fhir/StructureDefinition/cqf-knowledgeCapability Binding: KnowledgeCapability (required)
ConceptMap.Slices for extension.extension:versionAlgorithm	S This element must be supported.	0..1	Coding	How to compare versions URL: http://hl7.org/fhir/StructureDefinition/artifact-versionAlgorithm Binding: VersionAlgorithm (extensible)
ConceptMap.Slices for extension.extension:versionPolicy		0..1	CodeableConcept	metadata | strict URL: http://hl7.org/fhir/StructureDefinition/artifact-versionPolicy Binding: ValueSet Artifact Version Policy (extensible): The versioning policy of the artifact
ConceptMap.Slices for extension.extension:webSource	S This element must be supported.	0..1	url	web-source URL: http://hl7.org/fhir/StructureDefinition/web-source
ConceptMap.modifierExtension	?! This element is a modifier element.	0..*	Extension	Extensions that cannot be ignored
ConceptMap.url	S This element must be supported. Σ This element is included in summaries.	1..1	uri	Canonical identifier for this concept map, represented as a URI (globally unique)
ConceptMap.identifier	Σ This element is included in summaries.	0..1	Identifier	Additional identifier for the concept map
ConceptMap.version	S This element must be supported. Σ This element is included in summaries.	1..1	string	Business version of the concept map
ConceptMap.name	S This element must be supported. Σ This element is included in summaries. C	1..1	string	Name for this concept map (computer friendly)
ConceptMap.title	S This element must be supported. Σ This element is included in summaries.	1..1	string	Name for this concept map (human friendly)
ConceptMap.status	?! This element is a modifier element. S This element must be supported. Σ This element is included in summaries.	1..1	code	draft | active | retired | unknown Binding: PublicationStatus (required): The lifecycle status of an artifact.
ConceptMap.experimental	S This element must be supported. Σ This element is included in summaries.	1..1	boolean	For testing purposes, not real usage
ConceptMap.date	Σ This element is included in summaries.	0..1	dateTime	Date last changed
ConceptMap.publisher	S This element must be supported. Σ This element is included in summaries.	1..1	string	Name of the publisher (organization or individual)
ConceptMap.contact	Σ This element is included in summaries.	0..*	ContactDetail	Contact details for the publisher
ConceptMap.description	S This element must be supported.	1..1	markdown	Natural language description of the concept map
ConceptMap.useContext	Σ This element is included in summaries.	0..*	UsageContext	The context that the content is intended to support
ConceptMap.jurisdiction	Σ This element is included in summaries.	0..*	CodeableConcept	Intended jurisdiction for concept map (if applicable) Binding: Jurisdiction ValueSet (extensible): Countries and regions within which this artifact is targeted for use.
ConceptMap.purpose		0..1	markdown	Why this concept map is defined
ConceptMap.copyright		0..1	markdown	Use and/or publishing restrictions
ConceptMap.source[x]	Σ This element is included in summaries.	0..1		The source value set that contains the concepts that are being mapped
ConceptMap.source[x].sourceUri			uri
ConceptMap.source[x].sourceCanonical			canonical(ValueSet)
ConceptMap.target[x]	Σ This element is included in summaries.	0..1		The target value set which provides context for the mappings
ConceptMap.target[x].targetUri			uri
ConceptMap.target[x].targetCanonical			canonical(ValueSet)
ConceptMap.group		0..*	BackboneElement	Same source and target systems
ConceptMap.group.id		0..1	string	Unique id for inter-element referencing
ConceptMap.group.extension		0..*	Extension	Additional content defined by implementations
ConceptMap.group.modifierExtension	?! This element is a modifier element. Σ This element is included in summaries.	0..*	Extension	Extensions that cannot be ignored even if unrecognized
ConceptMap.group.source		0..1	uri	Source system where concepts to be mapped are defined
ConceptMap.group.sourceVersion		0..1	string	Specific version of the code system
ConceptMap.group.target		0..1	uri	Target system that the concepts are to be mapped to
ConceptMap.group.targetVersion		0..1	string	Specific version of the code system
ConceptMap.group.element		1..*	BackboneElement	Mappings for a concept from the source set
ConceptMap.group.element.id		0..1	string	Unique id for inter-element referencing
ConceptMap.group.element.extension		0..*	Extension	Additional content defined by implementations
ConceptMap.group.element.modifierExtension	?! This element is a modifier element. Σ This element is included in summaries.	0..*	Extension	Extensions that cannot be ignored even if unrecognized
ConceptMap.group.element.code		0..1	code	Identifies element being mapped
ConceptMap.group.element.display		0..1	string	Display for the code
ConceptMap.group.element.target	C	0..*	BackboneElement	Concept in target system for element Constraints: cmd-1
ConceptMap.group.element.target.id		0..1	string	Unique id for inter-element referencing
ConceptMap.group.element.target.extension		0..*	Extension	Additional content defined by implementations
ConceptMap.group.element.target.modifierExtension	?! This element is a modifier element. Σ This element is included in summaries.	0..*	Extension	Extensions that cannot be ignored even if unrecognized
ConceptMap.group.element.target.code		0..1	code	Code that identifies the target element
ConceptMap.group.element.target.display		0..1	string	Display for the code
ConceptMap.group.element.target.equivalence	?! This element is a modifier element.	1..1	code	relatedto | equivalent | equal | wider | subsumes | narrower | specializes | inexact | unmatched | disjoint Binding: ConceptMapEquivalence (required): The degree of equivalence between concepts.
ConceptMap.group.element.target.comment	C	0..1	string	Description of status/issues in mapping
ConceptMap.group.element.target.dependsOn		0..*	BackboneElement	Other elements required for this mapping (from context)
ConceptMap.group.element.target.dependsOn.id		0..1	string	Unique id for inter-element referencing
ConceptMap.group.element.target.dependsOn.extension		0..*	Extension	Additional content defined by implementations
ConceptMap.group.element.target.dependsOn.modifierExtension	?! This element is a modifier element. Σ This element is included in summaries.	0..*	Extension	Extensions that cannot be ignored even if unrecognized
ConceptMap.group.element.target.dependsOn.property		1..1	uri	Reference to property mapping depends on
ConceptMap.group.element.target.dependsOn.system		0..1	canonical(CodeSystem)	Code System (if necessary)
ConceptMap.group.element.target.dependsOn.value		1..1	string	Value of the referenced element
ConceptMap.group.element.target.dependsOn.display		0..1	string	Display for the code (if value is a code)
ConceptMap.group.element.target.product		0..*	See dependsOn (ConceptMap)	Other concepts that this mapping also produces
ConceptMap.group.unmapped	C	0..1	BackboneElement	What to do when there is no mapping for the source concept Constraints: cmd-2, cmd-3
ConceptMap.group.unmapped.id		0..1	string	Unique id for inter-element referencing
ConceptMap.group.unmapped.extension		0..*	Extension	Additional content defined by implementations
ConceptMap.group.unmapped.modifierExtension	?! This element is a modifier element. Σ This element is included in summaries.	0..*	Extension	Extensions that cannot be ignored even if unrecognized
ConceptMap.group.unmapped.mode		1..1	code	provided | fixed | other-map Binding: ConceptMapGroupUnmappedMode (required): Defines which action to take if there is no match in the group.
ConceptMap.group.unmapped.code		0..1	code	Fixed code when mode = fixed
ConceptMap.group.unmapped.display		0..1	string	Display for the code
ConceptMap.group.unmapped.url		0..1	canonical(ConceptMap)	canonical reference to an additional ConceptMap to use for mapping if the source concept is unmapped
Documentation for this format

Terminology Bindings

Path	Status	Usage	ValueSet	Version	Source
ConceptMap.language	Base	preferred	Common Languages	📍4.0.1	FHIR Std.
ConceptMap.status	Base	required	PublicationStatus	📍4.0.1	FHIR Std.
ConceptMap.jurisdiction	Base	extensible	Jurisdiction	📍4.0.1	FHIR Std.
ConceptMap.group.element.​target.equivalence	Base	required	ConceptMapEquivalence	📍4.0.1	FHIR Std.
ConceptMap.group.unmapped.​mode	Base	required	ConceptMapGroupUnmappedMode	📍4.0.1	FHIR Std.

Constraints

Id	Grade	Path(s)	Description	Expression
cmd-0	warning	ConceptMap	Name should be usable as an identifier for the module by machine processing applications such as code generation	name.matches('[A-Z]([A-Za-z0-9_]){0,254}')
cmd-1	error	ConceptMap.group.element.target	If the map is narrower or inexact, there SHALL be some comments	comment.exists() or equivalence.empty() or ((equivalence != 'narrower') and (equivalence != 'inexact'))
cmd-2	error	ConceptMap.group.unmapped	If the mode is 'fixed', a code must be provided	(mode = 'fixed') implies code.exists()
cmd-3	error	ConceptMap.group.unmapped	If the mode is 'other-map', a url must be provided	(mode = 'other-map') implies url.exists()
dom-2	error	ConceptMap	If the resource is contained in another resource, it SHALL NOT contain nested Resources	contained.contained.empty()
dom-3	error	ConceptMap	If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource	contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty()
dom-4	error	ConceptMap	If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated	contained.meta.versionId.empty() and contained.meta.lastUpdated.empty()
dom-5	error	ConceptMap	If a resource is contained in another resource, it SHALL NOT have a security label	contained.meta.security.empty()
dom-6	best practice	ConceptMap	A resource should have narrative for robust management	text.`div`.exists()
ele-1	error	**ALL** elements	All FHIR elements must have a @value or children	hasValue() or (children().count() > id.count())
ext-1	error	**ALL** extensions	Must have either extensions or value[x], not both	extension.exists() != value.exists()
shr-1	error	ConceptMap	If knowledge capabilities are stated, they SHALL include shareable	extension('http://hl7.org/fhir/StructureDefinition/cqf-knowledgeCapability').exists() implies extension('http://hl7.org/fhir/StructureDefinition/cqf-knowledgeCapability').where(value = 'shareable').exists()

This structure is derived from CRMIShareableConceptMap

Summary

Mandatory: 2 elements

Other representations of profile: CSV, Excel, Schematron