Skip to main content

ConceptMap

Trial Use 3 Terminology

A statement of relationships from one set of concepts to one or more other concepts - either concepts in code systems, or data element/data element concepts, or classes in class models.

Endpoints

devhttps://api.sandbox.ovok.com/fhir/R5/ConceptMap
InteractionMethodPath
ReadGET/fhir/R5/ConceptMap/[id]
VreadGET/fhir/R5/ConceptMap/[id]/_history/[vid]
UpdatePUT/fhir/R5/ConceptMap/[id]
PatchPATCH/fhir/R5/ConceptMap/[id]
DeleteDELETE/fhir/R5/ConceptMap/[id]
CreatePOST/fhir/R5/ConceptMap
SearchGET/fhir/R5/ConceptMap?...
HistoryGET/fhir/R5/ConceptMap/[id]/_history
Type-historyGET/fhir/R5/ConceptMap/_history

Top-level elements

ElementType(s)CardinalityDescription
urluri0..1Canonical identifier for this concept map, represented as a URI (globally unique)
identifierIdentifier0..*Additional identifier for the concept map
versionstring0..1Business version of the concept map
versionAlgorithm[x]string / Coding0..1How to compare versions
namestring0..1Name for this concept map (computer friendly)
titlestring0..1Name for this concept map (human friendly)
statuscode1..1draft
experimentalboolean0..1For testing purposes, not real usage
datedateTime0..1Date last changed
publisherstring0..1Name of the publisher/steward (organization or individual)
contactContactDetail0..*Contact details for the publisher
descriptionmarkdown0..1Natural language description of the concept map
useContextUsageContext0..*The context that the content is intended to support
jurisdictionCodeableConcept0..*Intended jurisdiction for concept map (if applicable)
purposemarkdown0..1Why this concept map is defined
copyrightmarkdown0..1Use and/or publishing restrictions
copyrightLabelstring0..1Copyright holder and year(s)
approvalDatedate0..1When the ConceptMap was approved by publisher
lastReviewDatedate0..1When the ConceptMap was last reviewed by the publisher
effectivePeriodPeriod0..1When the ConceptMap is expected to be used
topicCodeableConcept0..*E.g. Education, Treatment, Assessment, etc
authorContactDetail0..*Who authored the ConceptMap
editorContactDetail0..*Who edited the ConceptMap
reviewerContactDetail0..*Who reviewed the ConceptMap
endorserContactDetail0..*Who endorsed the ConceptMap
relatedArtifactRelatedArtifact0..*Additional documentation, citations, etc
propertyBackboneElement0..*Additional properties of the mapping
additionalAttributeBackboneElement0..*Definition of an additional attribute to act as a data source or target
sourceScope[x]uri / canonical0..1The source value set that contains the concepts that are being mapped
targetScope[x]uri / canonical0..1The target value set which provides context for the mappings
groupBackboneElement0..*Same source and target systems

Resource-specific search parameters

ParameterTypeDescription
contexttokenA use context assigned to the activity definition
context-quantityquantityA quantity- or range-valued use context assigned to the activity definition
context-typetokenA type of use context assigned to the activity definition
context-type-quantitycompositeA use context type and quantity- or range-based value assigned to the activity definition
context-type-valuecompositeA use context type and value assigned to the activity definition
datedateThe activity definition publication date
derived-fromreferenceWhat resource is being referenced
descriptionstringThe description of the activity definition
effectivedateThe time during which the activity definition is intended to be in use
identifiertokenExternal identifier for the activity definition
jurisdictiontokenIntended jurisdiction for the activity definition
mapping-propertyuriOther properties required for this mapping
namestringComputationally friendly name of the activity definition
other-mapreferencecanonical reference to an additional ConceptMap to use for mapping if the source concept is unmapped
predecessorreferenceWhat resource is being referenced
publisherstringName of the publisher of the activity definition
source-codetokenIdentifies elements being mapped
source-group-systemreferenceSource system where concepts to be mapped are defined
source-scopereferenceThe source value set that contains the concepts that are being mapped
source-scope-uriuriThe URI for the source value set that contains the concepts being mapped
statustokenThe current status of the activity definition
target-codetokenCode that identifies the target element
target-group-systemreferenceTarget system that the concepts are to be mapped to
target-scopereferenceThe target value set which provides context for the mappings
target-scope-uriuriThe URI for the target value set that contains the concepts being mapped.
titlestringThe human-friendly name of the activity definition
topictokenTopics associated with the module
urluriThe uri that identifies the activity definition
versiontokenThe business version of the activity definition

Reference

  • Official FHIR R5 spec: ConceptMap
  • Maturity: Trial Use 3 (FMM 3).