Conformance
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
|
Responsible
Owner:
|
|
|
Raw
Turtle
,
JSON-LD
(+
also
see
Turtle/RDF
Format
Specification
)
Operation Definition
@prefix fhir: <http://hl7.org/fhir/> . @prefix owl: <http://www.w3.org/2002/07/owl#> . @prefix rdf: <http://www.w3.org/1999/02/22-rdf-syntax-ns#> . @prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> . @prefix xsd: <http://www.w3.org/2001/XMLSchema#> . # - resource -------------------------------------------------------------------[] a fhir:OperationDefinition; fhir:Resource.id [ fhir:value "ConceptMap-translate"]; fhir:DomainResource.text [ fhir:Narrative.status [ fhir:value "generated" ] ]; fhir:OperationDefinition.url [ fhir:value "http://hl7.org/fhir/OperationDefinition/ConceptMap-translate"]; fhir:OperationDefinition.name [ fhir:value "Concept Translation"]; fhir:OperationDefinition.status [ fhir:value "draft"]; fhir:OperationDefinition.kind [ fhir:value "operation"]; fhir:OperationDefinition.date [ fhir:value "2019-10-24T11:53:00+11:00"]; fhir:OperationDefinition.publisher [ fhir:value "HL7 (FHIR Project)"]; fhir:OperationDefinition.contact [ fhir:index 0; fhir:ContactDetail.telecom [ fhir:index 0; fhir:ContactPoint.system [ fhir:value "url" ]; fhir:ContactPoint.value [ fhir:value "http://hl7.org/fhir" ] ], [ fhir:index 1; fhir:ContactPoint.system [ fhir:value "email" ]; fhir:ContactPoint.value [ fhir:value "fhir@lists.hl7.org" ]<http://hl7.org/fhir/OperationDefinition/ConceptMap-translate> a fhir:OperationDefinition ; fhir:nodeRole fhir:treeRoot ; fhir:id [ fhir:v "ConceptMap-translate"] ; # fhir:text [ fhir:status [ fhir:v "generated" ] ; fhir:div [ fhir:v "<div xmlns=\"http://www.w3.org/1999/xhtml\"><p class=\"res-header-id\"><b>Generated Narrative: OperationDefinition ConceptMap-translate</b></p><a name=\"ConceptMap-translate\"> </a><a name=\"hcConceptMap-translate\"> </a><p>URL: [base]/ConceptMap/$translate</p><p>URL: [base]/ConceptMap/[id]/$translate</p><h3>Parameters</h3><table class=\"grid\"><tr><td><b>Use</b></td><td><b>Name</b></td><td><b>Scope</b></td><td><b>Cardinality</b></td><td><b>Type</b></td><td><b>Binding</b></td><td><b>Documentation</b></td></tr><tr><td>IN</td><td>url</td><td>type</td><td>0..1</td><td><a href=\"datatypes.html#uri\">uri</a></td><td/><td><div><p>A canonical URL for a concept map. The server must know the concept map (e.g. it is defined explicitly in the server's concept maps, or it is defined implicitly by some code system known to the server.</p>\n</div></td></tr><tr><td>IN</td><td>conceptMap</td><td>type</td><td>0..1</td><td><a href=\"conceptmap.html\">ConceptMap</a></td><td/><td><div><p>The concept map is provided directly as part of the request. Servers may choose not to accept concept maps in this fashion.</p>\n</div></td></tr><tr><td>IN</td><td>conceptMapVersion</td><td>type</td><td>0..1</td><td><a href=\"datatypes.html#string\">string</a></td><td/><td><div><p>The identifier that is used to identify a specific version of the concept map to be used for the translation. This is an arbitrary value managed by the concept map author and is not expected to be globally unique. For example, it might be a timestamp (e.g. yyyymmdd) if a managed version is not available.</p>\n</div></td></tr><tr><td>IN</td><td>sourceCode</td><td/><td>0..1</td><td><a href=\"datatypes.html#code\">code</a></td><td/><td><div><p>The code that is to be translated. If a code is provided, a system must be provided</p>\n</div></td></tr><tr><td>IN</td><td>sourceSystem</td><td/><td>0..1</td><td><a href=\"datatypes.html#uri\">uri</a></td><td/><td><div><p>The system for the sourceCode to be translated. Note: the previous name of this input parameter was <code>system</code>, and servers MAY choose to still accept that name</p>\n</div></td></tr><tr><td>IN</td><td>sourceVersion</td><td/><td>0..1</td><td><a href=\"datatypes.html#string\">string</a></td><td/><td><div><p>The version for the system of the sourceCode to be translated. Note: the previous name of this input parameter was <code>version</code>, and servers MAY choose to still accept that name.</p>\n</div></td></tr><tr><td>IN</td><td>sourceScope</td><td/><td>0..1</td><td><a href=\"datatypes.html#uri\">uri</a></td><td/><td><div><p>Limits the scope of the $translate operation to source codes (ConceptMap.group.element.code) that are members of this value set.</p>\n</div></td></tr><tr><td>IN</td><td>sourceCoding</td><td/><td>0..1</td><td><a href=\"datatypes.html#Coding\">Coding</a></td><td/><td><div><p>A coding to translate</p>\n</div></td></tr><tr><td>IN</td><td>sourceCodeableConcept</td><td/><td>0..1</td><td><a href=\"datatypes.html#CodeableConcept\">CodeableConcept</a></td><td/><td><div><p>A full codeableConcept to validate. The server can translate any of the coding values (e.g. existing translations) as it chooses</p>\n</div></td></tr><tr><td>IN</td><td>targetCode</td><td/><td>0..1</td><td><a href=\"datatypes.html#code\">code</a></td><td/><td><div><p>The target code that is to be translated to. If a code is provided, a system must be provided</p>\n</div></td></tr><tr><td>IN</td><td>targetCoding</td><td/><td>0..1</td><td><a href=\"datatypes.html#Coding\">Coding</a></td><td/><td><div><p>A target coding to translate to</p>\n</div></td></tr><tr><td>IN</td><td>targetCodeableConcept</td><td/><td>0..1</td><td><a href=\"datatypes.html#CodeableConcept\">CodeableConcept</a></td><td/><td><div><p>A full codeableConcept to validate. The server can translate any of the coding values (e.g. existing translations) as it chooses</p>\n</div></td></tr><tr><td>IN</td><td>targetScope</td><td/><td>0..1</td><td><a href=\"datatypes.html#uri\">uri</a></td><td/><td><div><p>Limits the scope of the $translate operation to target codes (ConceptMap.group.element.target.code) that are members of this value set.</p>\n</div></td></tr><tr><td>IN</td><td>targetSystem</td><td/><td>0..1</td><td><a href=\"datatypes.html#uri\">uri</a></td><td/><td><div><p>identifies a target code system in which a mapping is sought. This parameter is an alternative to the targetScope parameter - only one is required. Searching for any translation to a target code system irrespective of the context (e.g. target valueset) may lead to unsafe results, and it is at the discretion of the server to decide when to support this operation</p>\n</div></td></tr><tr><td>IN</td><td>dependency</td><td/><td>0..*</td><td></td><td/><td><div><p>Data from another attribute that may help produce the correct mapping</p>\n</div></td></tr><tr><td>IN</td><td>dependency.attribute</td><td/><td>0..1</td><td><a href=\"datatypes.html#uri\">uri</a></td><td/><td><div><p>The attribute for this dependency</p>\n</div></td></tr><tr><td>IN</td><td>dependency.value</td><td/><td>0..1</td><td><a href=\"types.html#Element\">Element</a></td><td/><td><div><p>The data value for this dependency</p>\n</div></td></tr><tr><td>OUT</td><td>result</td><td/><td>1..1</td><td><a href=\"datatypes.html#boolean\">boolean</a></td><td/><td><div><p>True if the concept could be translated successfully. The value can only be true if at least one returned match has a relationship other than 'not-related-to'.</p>\n</div></td></tr><tr><td>OUT</td><td>message</td><td/><td>0..1</td><td><a href=\"datatypes.html#string\">string</a></td><td/><td><div><p>Error details, for display to a human. If this is provided when result = true, the message carries hints and warnings (e.g. a note that the matches could be improved by providing additional detail)</p>\n</div></td></tr><tr><td>OUT</td><td>match</td><td/><td>0..*</td><td></td><td/><td><div><p>A concept in the target value set with a relationship. Note that there may be multiple matches of equal or differing relationships, and the matches may include the 'not-related-to' relationship value which means that there is no translation</p>\n</div></td></tr><tr><td>OUT</td><td>match.relationship</td><td/><td>0..1</td><td><a href=\"datatypes.html#code\">code</a></td><td/><td><div><p>A code indicating the relationship (e.g., equivalent) of the translation, using values from <a href=\"valueset-concept-map-relationship.html\">ConceptMapRelationship</a></p>\n</div></td></tr><tr><td>OUT</td><td>match.concept</td><td/><td>0..1</td><td><a href=\"datatypes.html#Coding\">Coding</a></td><td/><td><div><p>The translation outcome. Note that this would never have userSelected = true, since the process of translations implies that the user is not selecting the code (and only the client could know differently)</p>\n</div></td></tr><tr><td>OUT</td><td>match.property</td><td/><td>0..*</td><td></td><td/><td><div><p>A property of this mapping (may be used to supply for example, mapping priority, provenance, presentation hints, flag as experimental, and additional documentation)</p>\n</div></td></tr><tr><td>OUT</td><td>match.property.uri</td><td/><td>1..1</td><td><a href=\"datatypes.html#uri\">uri</a></td><td/><td><div><p>The uri that identifies the property</p>\n</div></td></tr><tr><td>OUT</td><td>match.property.value</td><td/><td>1..1</td><td><a href=\"types.html#Element\">Element</a></td><td/><td><div><p>The value of the property</p>\n</div></td></tr><tr><td>OUT</td><td>match.product</td><td/><td>0..*</td><td></td><td/><td><div><p>A data value to go in an attribute that is the product of this mapping</p>\n</div></td></tr><tr><td>OUT</td><td>match.product.attribute</td><td/><td>1..1</td><td><a href=\"datatypes.html#uri\">uri</a></td><td/><td><div><p>The attribute for this product</p>\n</div></td></tr><tr><td>OUT</td><td>match.product.value</td><td/><td>1..1</td><td><a href=\"types.html#Element\">Element</a></td><td/><td><div><p>The value for this product</p>\n</div></td></tr><tr><td>OUT</td><td>match.dependsOn</td><td/><td>0..*</td><td></td><td/><td><div><p>An data value in an additional attribute that this mapping depends on</p>\n</div></td></tr><tr><td>OUT</td><td>match.dependsOn.attribute</td><td/><td>1..1</td><td><a href=\"datatypes.html#uri\">uri</a></td><td/><td><div><p>The attribute that this mapping depends on</p>\n</div></td></tr><tr><td>OUT</td><td>match.dependsOn.value</td><td/><td>1..1</td><td><a href=\"types.html#Element\">Element</a></td><td/><td><div><p>The value of the attribute that this mapping depends on</p>\n</div></td></tr><tr><td>OUT</td><td>match.originMap</td><td/><td>0..1</td><td><a href=\"datatypes.html#uri\">uri</a></td><td/><td><div><p>The canonical reference to the concept map from which this mapping comes from</p>\n</div></td></tr></table></div>"^^rdf:XMLLiteral ] ] ; # fhir:extension ( [ fhir:url [ fhir:v "http://hl7.org/fhir/StructureDefinition/structuredefinition-fmm"^^xsd:anyURI ; fhir:l <http://hl7.org/fhir/StructureDefinition/structuredefinition-fmm> ] ; fhir:value [ a fhir:Integer ; fhir:v 1 ]]; fhir:OperationDefinition.description [ fhir:value "Translate a code from one value set to another, based on the existing value set and concept maps resources, and/or other additional knowledge available to the server. \r\n\r\n One (and only one) of the in parameters (code, coding, codeableConcept) must be provided, to identify the code that is to be translated. \r\n\r\n The operation returns a set of parameters including a 'result' for whether there is an acceptable match, and a list of possible matches. Note that the list of matches may include notes of codes for which mapping is specifically excluded, so implementers have to check the match.equivalence for each match"]; fhir:OperationDefinition.code [ fhir:value "translate"]; fhir:OperationDefinition.resource [ fhir:value "ConceptMap"; fhir:index 0 ]; fhir:OperationDefinition.system [ fhir:value "false"]; fhir:OperationDefinition.type [ fhir:value "true"]; fhir:OperationDefinition.instance [ fhir:value "true"]; fhir:OperationDefinition.parameter [ fhir:index 0; fhir:OperationDefinition.name [ fhir:value "code" ]; fhir:OperationDefinition.use [ fhir:value "in" ]; fhir:OperationDefinition.min [ fhir:value "0" ]; fhir:OperationDefinition.max [ fhir:value "1" ]; fhir:OperationDefinition.documentation [ fhir:value "The code that is to be translated. If a code is provided, a system must be provided" ]; fhir:OperationDefinition.type [ fhir:value "code" ] ], [ fhir:index 1; fhir:OperationDefinition.name [ fhir:value "system" ]; fhir:OperationDefinition.use [ fhir:value "in" ]; fhir:OperationDefinition.min [ fhir:value "0" ]; fhir:OperationDefinition.max [ fhir:value "1" ]; fhir:OperationDefinition.documentation [ fhir:value "The system for the code that is to be translated" ]; fhir:OperationDefinition.type [ fhir:value "uri" ] ], [ fhir:index 2; fhir:OperationDefinition.name [ fhir:value "version" ]; fhir:OperationDefinition.use [ fhir:value "in" ]; fhir:OperationDefinition.min [ fhir:value "0" ]; fhir:OperationDefinition.max [ fhir:value "1" ]; fhir:OperationDefinition.documentation [ fhir:value "The version of the system, if one was provided in the source data" ]; fhir:OperationDefinition.type [ fhir:value "string" ] ], [ fhir:index 3; fhir:OperationDefinition.name [ fhir:value "source" ]; fhir:OperationDefinition.use [ fhir:value "in" ]; fhir:OperationDefinition.min [ fhir:value "0" ]; fhir:OperationDefinition.max [ fhir:value "1" ]; fhir:OperationDefinition.documentation [ fhir:value "Identifies the value set used when the concept (system/code pair) was chosen. May be a logical id, or an absolute or relative location. The source value set is an optional parameter because in some cases, the client cannot know what the source value set is. However, without a source value set, the server may be unable to safely identify an applicable concept map, and would return an error. For this reason, a source value set SHOULD always be provided. Note that servers may be able to identify an appropriate concept map without a source value set if there is a full mapping for the entire code system in the concept map, or by manual intervention" ]; fhir:OperationDefinition.type [ fhir:value "uri" ] ], [ fhir:index 4; fhir:OperationDefinition.name [ fhir:value "coding" ]; fhir:OperationDefinition.use [ fhir:value "in" ]; fhir:OperationDefinition.min [ fhir:value "0" ]; fhir:OperationDefinition.max [ fhir:value "1" ]; fhir:OperationDefinition.documentation [ fhir:value "A coding to translate" ]; fhir:OperationDefinition.type [ fhir:value "Coding" ] ], [ fhir:index 5; fhir:OperationDefinition.name [ fhir:value "codeableConcept" ]; fhir:OperationDefinition.use [ fhir:value "in" ]; fhir:OperationDefinition.min [ fhir:value "0" ]; fhir:OperationDefinition.max [ fhir:value "1" ]; fhir:OperationDefinition.documentation [ fhir:value "A full codeableConcept to validate. The server can translate any of the coding values (e.g. existing translations) as it chooses" ]; fhir:OperationDefinition.type [ fhir:value "CodeableConcept" ] ], [ fhir:index 6; fhir:OperationDefinition.name [ fhir:value "target" ]; fhir:OperationDefinition.use [ fhir:value "in" ]; fhir:OperationDefinition.min [ fhir:value "0" ]; fhir:OperationDefinition.max [ fhir:value "1" ]; fhir:OperationDefinition.documentation [ fhir:value "Identifies the value set in which a translation is sought. May be a logical id, or an absolute or relative location. If there's no target specified, the server should return all known translations, along with their source" ]; fhir:OperationDefinition.type [ fhir:value "uri" ] ], [ fhir:index 7; fhir:OperationDefinition.name [ fhir:value "targetsystem" ]; fhir:OperationDefinition.use [ fhir:value "in" ]; fhir:OperationDefinition.min [ fhir:value "0" ]; fhir:OperationDefinition.max [ fhir:value "1" ]; fhir:OperationDefinition.documentation [ fhir:value "identifies a target code system in which a mapping is sought. This parameter is an alternative to the target parameter - only one is required. Searching for any translation to a target code system irrespective of the context (e.g. target valueset) may lead to unsafe results, and it is at the discretion of the server to decide when to support this operation" ]; fhir:OperationDefinition.type [ fhir:value "uri" ] ], [ fhir:index 8; fhir:OperationDefinition.name [ fhir:value "dependency" ]; fhir:OperationDefinition.use [ fhir:value "in" ]; fhir:OperationDefinition.min [ fhir:value "0" ]; fhir:OperationDefinition.max [ fhir:value "*" ]; fhir:OperationDefinition.documentation [ fhir:value "Another element that may help produce the correct mapping" ]; fhir:OperationDefinition.part [ fhir:index 0; fhir:OperationDefinition.name [ fhir:value "element" ]; fhir:OperationDefinition.use [ fhir:value "in" ]; fhir:OperationDefinition.min [ fhir:value "0" ]; fhir:OperationDefinition.max [ fhir:value "1" ]; fhir:OperationDefinition.documentation [ fhir:value "The element for this dependency" ]; fhir:OperationDefinition.type [ fhir:value "uri" ] ], [ fhir:index 1; fhir:OperationDefinition.name [ fhir:value "concept" ]; fhir:OperationDefinition.use [ fhir:value "in" ]; fhir:OperationDefinition.min [ fhir:value "0" ]; fhir:OperationDefinition.max [ fhir:value "1" ]; fhir:OperationDefinition.documentation [ fhir:value "The value for this dependency" ]; fhir:OperationDefinition.type [ fhir:value "CodeableConcept" ]] [ fhir:url [ fhir:v "http://hl7.org/fhir/StructureDefinition/structuredefinition-standards-status"^^xsd:anyURI ; fhir:l <http://hl7.org/fhir/StructureDefinition/structuredefinition-standards-status> ] ; fhir:value [ a fhir:Code ; fhir:v "normative" ]], [ fhir:index 9; fhir:OperationDefinition.name [ fhir:value "reverse" ]; fhir:OperationDefinition.use [ fhir:value "in" ]; fhir:OperationDefinition.min [ fhir:value "0" ]; fhir:OperationDefinition.max [ fhir:value "1" ]; fhir:OperationDefinition.documentation [ fhir:value "if this is true, then the operation should return all the codes that might be mapped to this code. This parameter reverses the meaning of the source and target parameters" ]; fhir:OperationDefinition.type [ fhir:value "boolean" ] ], [ fhir:index 10; fhir:OperationDefinition.name [ fhir:value "result" ]; fhir:OperationDefinition.use [ fhir:value "out" ]; fhir:OperationDefinition.min [ fhir:value "1" ]; fhir:OperationDefinition.max [ fhir:value "1" ]; fhir:OperationDefinition.documentation [ fhir:value "True if the concept could be translated successfully. The value can only be true if at least one returned match has an equivalence which is not unmatched or disjoint" ]; fhir:OperationDefinition.type [ fhir:value "boolean" ] ], [ fhir:index 11; fhir:OperationDefinition.name [ fhir:value "message" ]; fhir:OperationDefinition.use [ fhir:value "out" ]; fhir:OperationDefinition.min [ fhir:value "0" ]; fhir:OperationDefinition.max [ fhir:value "1" ]; fhir:OperationDefinition.documentation [ fhir:value "Error details, for display to a human. If this is provided when result = true, the message carries hints and warnings (e.g. a note that the matches could be improved by providing additional detail)" ]; fhir:OperationDefinition.type [ fhir:value "string" ] ], [ fhir:index 12; fhir:OperationDefinition.name [ fhir:value "match" ]; fhir:OperationDefinition.use [ fhir:value "out" ]; fhir:OperationDefinition.min [ fhir:value "0" ]; fhir:OperationDefinition.max [ fhir:value "*" ]; fhir:OperationDefinition.documentation [ fhir:value "A concept in the target value set with an equivalence. Note that there may be multiple matches of equal or differing equivalence, and the matches may include equivalence values that mean that there is no match" ]; fhir:OperationDefinition.part [ fhir:index 0; fhir:OperationDefinition.name [ fhir:value "equivalence" ]; fhir:OperationDefinition.use [ fhir:value "out" ]; fhir:OperationDefinition.min [ fhir:value "0" ]; fhir:OperationDefinition.max [ fhir:value "1" ]; fhir:OperationDefinition.documentation [ fhir:value "A code indicating the equivalence of the translation, using values from [ConceptMapEquivalence]{concept-map-equivalence.html}" ]; fhir:OperationDefinition.type [ fhir:value "code" ] ], [ fhir:index 1; fhir:OperationDefinition.name [ fhir:value "concept" ]; fhir:OperationDefinition.use [ fhir:value "out" ]; fhir:OperationDefinition.min [ fhir:value "0" ]; fhir:OperationDefinition.max [ fhir:value "1" ]; fhir:OperationDefinition.documentation [ fhir:value "The translation outcome. Note that this would never have userSelected = true, since the process of translations implies that the user is not selecting the code (and only the client could know differently)" ]; fhir:OperationDefinition.type [ fhir:value "Coding" ] ], [ fhir:index 2; fhir:OperationDefinition.name [ fhir:value "product" ]; fhir:OperationDefinition.use [ fhir:value "out" ]; fhir:OperationDefinition.min [ fhir:value "0" ]; fhir:OperationDefinition.max [ fhir:value "*" ]; fhir:OperationDefinition.documentation [ fhir:value "Another element that is the product of this mapping" ]; fhir:OperationDefinition.part [ fhir:index 0; fhir:OperationDefinition.name [ fhir:value "element" ]; fhir:OperationDefinition.use [ fhir:value "out" ]; fhir:OperationDefinition.min [ fhir:value "0" ]; fhir:OperationDefinition.max [ fhir:value "1" ]; fhir:OperationDefinition.documentation [ fhir:value "The element for this product" ]; fhir:OperationDefinition.type [ fhir:value "uri" ] ], [ fhir:index 1; fhir:OperationDefinition.name [ fhir:value "concept" ]; fhir:OperationDefinition.use [ fhir:value "out" ]; fhir:OperationDefinition.min [ fhir:value "0" ]; fhir:OperationDefinition.max [ fhir:value "1" ]; fhir:OperationDefinition.documentation [ fhir:value "The value for this product" ]; fhir:OperationDefinition.type [ fhir:value "Coding" ] ] ], [ fhir:index 3; fhir:OperationDefinition.name [ fhir:value "source" ]; fhir:OperationDefinition.use [ fhir:value "out" ]; fhir:OperationDefinition.min [ fhir:value "0" ]; fhir:OperationDefinition.max [ fhir:value "1" ]; fhir:OperationDefinition.documentation [ fhir:value "The canonical URI for the concept map from which this mapping comes from" ]; fhir:OperationDefinition.type [ fhir:value "uri" ]] [ fhir:url [ fhir:v "http://hl7.org/fhir/StructureDefinition/structuredefinition-wg"^^xsd:anyURI ; fhir:l <http://hl7.org/fhir/StructureDefinition/structuredefinition-wg> ] ; fhir:value [ a fhir:Code ; fhir:v "vocab" ]] .] ) ; # fhir:url [ fhir:v "http://hl7.org/fhir/OperationDefinition/ConceptMap-translate"^^xsd:anyURI ; fhir:l <http://hl7.org/fhir/OperationDefinition/ConceptMap-translate> ] ; # fhir:version [ fhir:v "6.0.0-ballot3"] ; # fhir:name [ fhir:v "Translate"] ; # fhir:title [ fhir:v "Concept Translation"] ; # fhir:status [ fhir:v "active"] ; # fhir:kind [ fhir:v "operation"] ; # fhir:experimental [ fhir:v false] ; # fhir:date [ fhir:v "2025-11-20T23:56:49+00:00"^^xsd:dateTime] ; # fhir:publisher [ fhir:v "HL7 International / Terminology Infrastructure"] ; # fhir:contact ( [ fhir:telecom ( [ fhir:system [ fhir:v "url" ] ; fhir:value [ fhir:v "http://hl7.org/fhir" ] ] [ fhir:system [ fhir:v "email" ] ; fhir:value [ fhir:v "fhir@lists.hl7.org" ] ] ) ] [ fhir:telecom ( [ fhir:system [ fhir:v "url" ] ; fhir:value [ fhir:v "http://www.hl7.org/Special/committees/Vocab" ] ] ) ] ) ; # fhir:description [ fhir:v "Translate a code from one value set to another, based on the specified ConceptMap resource. If no ConceptMap resource is specified, then other additional knowledge available to the server may be used. \r\n\r\n One (and only one) of the in parameters (sourceCode, sourceCoding, sourceCodeableConcept, targetCode, targetCoding, or targetCodeableConcept) SHALL be provided, to identify the code that is to be translated. \r\n\r\n The operation returns a set of parameters including a 'result' for whether there is an acceptable match, and a list of possible matches. Note that the list of matches may include notes of codes for which mapping is specifically excluded (i.e. 'not-related-to'), so implementers have to check the target.relationship for each match. If a source* parameter is provided, the $translate operation will return all matches whereby the provided source concept is the source of a mapping relationship (in a specified ConceptMap or otherwise known to the server). If a target* parameter is provided, the $translate operation will return all matches whereby the provided target concept is the target of a mapping relationship (in a specified ConceptMap or otherwise known to the server). Note: The source value set is an optional parameter because in some cases, the client cannot know what the source value set is. However, without a source value set, the server may be unable to safely identify an applicable concept map, and would return an error. For this reason, a source value set SHOULD always be provided. Note that servers may be able to identify an appropriate concept map without a source value set if there is a full mapping for the entire code system in the concept map, or by manual intervention."] ; # fhir:jurisdiction ( [ fhir:coding ( [ fhir:system [ fhir:v "http://unstats.un.org/unsd/methods/m49/m49.htm"^^xsd:anyURI ; fhir:l <http://unstats.un.org/unsd/methods/m49/m49.htm> ] ; fhir:code [ fhir:v "001" ] ; fhir:display [ fhir:v "World" ] ] ) ] ) ; # fhir:affectsState [ fhir:v false] ; # fhir:code [ fhir:v "translate"] ; # fhir:resource ( [ fhir:v "ConceptMap"] ) ; # fhir:system [ fhir:v false] ; # fhir:type [ fhir:v true] ; # fhir:instance [ fhir:v true] ; # fhir:parameter ( [ fhir:name [ fhir:v "url" ] ; fhir:use [ fhir:v "in" ] ; fhir:scope ( [ fhir:v "type" ] ) ; fhir:min [ fhir:v "0"^^xsd:nonNegativeInteger ] ; fhir:max [ fhir:v "1" ] ; fhir:documentation [ fhir:v "A canonical URL for a concept map. The server must know the concept map (e.g. it is defined explicitly in the server's concept maps, or it is defined implicitly by some code system known to the server." ] ; fhir:type [ fhir:v "uri" ] ] [ fhir:name [ fhir:v "conceptMap" ] ; fhir:use [ fhir:v "in" ] ; fhir:scope ( [ fhir:v "type" ] ) ; fhir:min [ fhir:v "0"^^xsd:nonNegativeInteger ] ; fhir:max [ fhir:v "1" ] ; fhir:documentation [ fhir:v "The concept map is provided directly as part of the request. Servers may choose not to accept concept maps in this fashion." ] ; fhir:type [ fhir:v "ConceptMap" ] ] [ fhir:name [ fhir:v "conceptMapVersion" ] ; fhir:use [ fhir:v "in" ] ; fhir:scope ( [ fhir:v "type" ] ) ; fhir:min [ fhir:v "0"^^xsd:nonNegativeInteger ] ; fhir:max [ fhir:v "1" ] ; fhir:documentation [ fhir:v "The identifier that is used to identify a specific version of the concept map to be used for the translation. This is an arbitrary value managed by the concept map author and is not expected to be globally unique. For example, it might be a timestamp (e.g. yyyymmdd) if a managed version is not available." ] ; fhir:type [ fhir:v "string" ] ] [ fhir:name [ fhir:v "sourceCode" ] ; fhir:use [ fhir:v "in" ] ; fhir:min [ fhir:v "0"^^xsd:nonNegativeInteger ] ; fhir:max [ fhir:v "1" ] ; fhir:documentation [ fhir:v "The code that is to be translated. If a code is provided, a system must be provided" ] ; fhir:type [ fhir:v "code" ] ] [ fhir:name [ fhir:v "sourceSystem" ] ; fhir:use [ fhir:v "in" ] ; fhir:min [ fhir:v "0"^^xsd:nonNegativeInteger ] ; fhir:max [ fhir:v "1" ] ; fhir:documentation [ fhir:v "The system for the sourceCode to be translated. Note: the previous name of this input parameter was `system`, and servers MAY choose to still accept that name" ] ; fhir:type [ fhir:v "uri" ] ] [ fhir:name [ fhir:v "sourceVersion" ] ; fhir:use [ fhir:v "in" ] ; fhir:min [ fhir:v "0"^^xsd:nonNegativeInteger ] ; fhir:max [ fhir:v "1" ] ; fhir:documentation [ fhir:v "The version for the system of the sourceCode to be translated. Note: the previous name of this input parameter was `version`, and servers MAY choose to still accept that name." ] ; fhir:type [ fhir:v "string" ] ] [ fhir:name [ fhir:v "sourceScope" ] ; fhir:use [ fhir:v "in" ] ; fhir:min [ fhir:v "0"^^xsd:nonNegativeInteger ] ; fhir:max [ fhir:v "1" ] ; fhir:documentation [ fhir:v "Limits the scope of the $translate operation to source codes (ConceptMap.group.element.code) that are members of this value set." ] ; fhir:type [ fhir:v "uri" ] ] [ fhir:name [ fhir:v "sourceCoding" ] ; fhir:use [ fhir:v "in" ] ; fhir:min [ fhir:v "0"^^xsd:nonNegativeInteger ] ; fhir:max [ fhir:v "1" ] ; fhir:documentation [ fhir:v "A coding to translate" ] ; fhir:type [ fhir:v "Coding" ] ] [ fhir:name [ fhir:v "sourceCodeableConcept" ] ; fhir:use [ fhir:v "in" ] ; fhir:min [ fhir:v "0"^^xsd:nonNegativeInteger ] ; fhir:max [ fhir:v "1" ] ; fhir:documentation [ fhir:v "A full codeableConcept to validate. The server can translate any of the coding values (e.g. existing translations) as it chooses" ] ; fhir:type [ fhir:v "CodeableConcept" ] ] [ fhir:name [ fhir:v "targetCode" ] ; fhir:use [ fhir:v "in" ] ; fhir:min [ fhir:v "0"^^xsd:nonNegativeInteger ] ; fhir:max [ fhir:v "1" ] ; fhir:documentation [ fhir:v "The target code that is to be translated to. If a code is provided, a system must be provided" ] ; fhir:type [ fhir:v "code" ] ] [ fhir:name [ fhir:v "targetCoding" ] ; fhir:use [ fhir:v "in" ] ; fhir:min [ fhir:v "0"^^xsd:nonNegativeInteger ] ; fhir:max [ fhir:v "1" ] ; fhir:documentation [ fhir:v "A target coding to translate to" ] ; fhir:type [ fhir:v "Coding" ] ] [ fhir:name [ fhir:v "targetCodeableConcept" ] ; fhir:use [ fhir:v "in" ] ; fhir:min [ fhir:v "0"^^xsd:nonNegativeInteger ] ; fhir:max [ fhir:v "1" ] ; fhir:documentation [ fhir:v "A full codeableConcept to validate. The server can translate any of the coding values (e.g. existing translations) as it chooses" ] ; fhir:type [ fhir:v "CodeableConcept" ] ] [ fhir:name [ fhir:v "targetScope" ] ; fhir:use [ fhir:v "in" ] ; fhir:min [ fhir:v "0"^^xsd:nonNegativeInteger ] ; fhir:max [ fhir:v "1" ] ; fhir:documentation [ fhir:v "Limits the scope of the $translate operation to target codes (ConceptMap.group.element.target.code) that are members of this value set." ] ; fhir:type [ fhir:v "uri" ] ] [ fhir:name [ fhir:v "targetSystem" ] ; fhir:use [ fhir:v "in" ] ; fhir:min [ fhir:v "0"^^xsd:nonNegativeInteger ] ; fhir:max [ fhir:v "1" ] ; fhir:documentation [ fhir:v "identifies a target code system in which a mapping is sought. This parameter is an alternative to the targetScope parameter - only one is required. Searching for any translation to a target code system irrespective of the context (e.g. target valueset) may lead to unsafe results, and it is at the discretion of the server to decide when to support this operation" ] ; fhir:type [ fhir:v "uri" ] ] [ fhir:name [ fhir:v "dependency" ] ; fhir:use [ fhir:v "in" ] ; fhir:min [ fhir:v "0"^^xsd:nonNegativeInteger ] ; fhir:max [ fhir:v "*" ] ; fhir:documentation [ fhir:v "Data from another attribute that may help produce the correct mapping" ] ; fhir:type [ ] ; fhir:part ( [ fhir:name [ fhir:v "attribute" ] ; fhir:use [ fhir:v "in" ] ; fhir:min [ fhir:v "0"^^xsd:nonNegativeInteger ] ; fhir:max [ fhir:v "1" ] ; fhir:documentation [ fhir:v "The attribute for this dependency" ] ; fhir:type [ fhir:v "uri" ] ] [ fhir:name [ fhir:v "value" ] ; fhir:use [ fhir:v "in" ] ; fhir:min [ fhir:v "0"^^xsd:nonNegativeInteger ] ; fhir:max [ fhir:v "1" ] ; fhir:documentation [ fhir:v "The data value for this dependency" ] ; fhir:type [ fhir:v "Element" ] ] ) ] [ fhir:name [ fhir:v "result" ] ; fhir:use [ fhir:v "out" ] ; fhir:min [ fhir:v "1"^^xsd:nonNegativeInteger ] ; fhir:max [ fhir:v "1" ] ; fhir:documentation [ fhir:v "True if the concept could be translated successfully. The value can only be true if at least one returned match has a relationship other than 'not-related-to'." ] ; fhir:type [ fhir:v "boolean" ] ] [ fhir:name [ fhir:v "message" ] ; fhir:use [ fhir:v "out" ] ; fhir:min [ fhir:v "0"^^xsd:nonNegativeInteger ] ; fhir:max [ fhir:v "1" ] ; fhir:documentation [ fhir:v "Error details, for display to a human. If this is provided when result = true, the message carries hints and warnings (e.g. a note that the matches could be improved by providing additional detail)" ] ; fhir:type [ fhir:v "string" ] ] [ fhir:name [ fhir:v "match" ] ; fhir:use [ fhir:v "out" ] ; fhir:min [ fhir:v "0"^^xsd:nonNegativeInteger ] ; fhir:max [ fhir:v "*" ] ; fhir:documentation [ fhir:v "A concept in the target value set with a relationship. Note that there may be multiple matches of equal or differing relationships, and the matches may include the 'not-related-to' relationship value which means that there is no translation" ] ; fhir:type [ ] ; fhir:part ( [ fhir:name [ fhir:v "relationship" ] ; fhir:use [ fhir:v "out" ] ; fhir:min [ fhir:v "0"^^xsd:nonNegativeInteger ] ; fhir:max [ fhir:v "1" ] ; fhir:documentation [ fhir:v "A code indicating the relationship (e.g., equivalent) of the translation, using values from [ConceptMapRelationship](valueset-concept-map-relationship.html)" ] ; fhir:type [ fhir:v "code" ] ] [ fhir:name [ fhir:v "concept" ] ; fhir:use [ fhir:v "out" ] ; fhir:min [ fhir:v "0"^^xsd:nonNegativeInteger ] ; fhir:max [ fhir:v "1" ] ; fhir:documentation [ fhir:v "The translation outcome. Note that this would never have userSelected = true, since the process of translations implies that the user is not selecting the code (and only the client could know differently)" ] ; fhir:type [ fhir:v "Coding" ] ] [ fhir:name [ fhir:v "property" ] ; fhir:use [ fhir:v "out" ] ; fhir:min [ fhir:v "0"^^xsd:nonNegativeInteger ] ; fhir:max [ fhir:v "*" ] ; fhir:documentation [ fhir:v "A property of this mapping (may be used to supply for example, mapping priority, provenance, presentation hints, flag as experimental, and additional documentation)" ] ; fhir:type [ ] ; fhir:part ( [ fhir:name [ fhir:v "uri" ] ; fhir:use [ fhir:v "out" ] ; fhir:min [ fhir:v "1"^^xsd:nonNegativeInteger ] ; fhir:max [ fhir:v "1" ] ; fhir:documentation [ fhir:v "The uri that identifies the property" ] ; fhir:type [ fhir:v "uri" ] ] [ fhir:name [ fhir:v "value" ] ; fhir:use [ fhir:v "out" ] ; fhir:min [ fhir:v "1"^^xsd:nonNegativeInteger ] ; fhir:max [ fhir:v "1" ] ; fhir:documentation [ fhir:v "The value of the property" ] ; fhir:type [ fhir:v "Element" ] ] ) ] [ fhir:name [ fhir:v "product" ] ; fhir:use [ fhir:v "out" ] ; fhir:min [ fhir:v "0"^^xsd:nonNegativeInteger ] ; fhir:max [ fhir:v "*" ] ; fhir:documentation [ fhir:v "A data value to go in an attribute that is the product of this mapping" ] ; fhir:type [ ] ; fhir:part ( [ fhir:name [ fhir:v "attribute" ] ; fhir:use [ fhir:v "out" ] ; fhir:min [ fhir:v "1"^^xsd:nonNegativeInteger ] ; fhir:max [ fhir:v "1" ] ; fhir:documentation [ fhir:v "The attribute for this product" ] ; fhir:type [ fhir:v "uri" ] ] [ fhir:name [ fhir:v "value" ] ; fhir:use [ fhir:v "out" ] ; fhir:min [ fhir:v "1"^^xsd:nonNegativeInteger ] ; fhir:max [ fhir:v "1" ] ; fhir:documentation [ fhir:v "The value for this product" ] ; fhir:type [ fhir:v "Element" ] ] ) ] [ fhir:name [ fhir:v "dependsOn" ] ; fhir:use [ fhir:v "out" ] ; fhir:min [ fhir:v "0"^^xsd:nonNegativeInteger ] ; fhir:max [ fhir:v "*" ] ; fhir:documentation [ fhir:v "An data value in an additional attribute that this mapping depends on" ] ; fhir:type [ ] ; fhir:part ( [ fhir:name [ fhir:v "attribute" ] ; fhir:use [ fhir:v "out" ] ; fhir:min [ fhir:v "1"^^xsd:nonNegativeInteger ] ; fhir:max [ fhir:v "1" ] ; fhir:documentation [ fhir:v "The attribute that this mapping depends on" ] ; fhir:type [ fhir:v "uri" ] ] [ fhir:name [ fhir:v "value" ] ; fhir:use [ fhir:v "out" ] ; fhir:min [ fhir:v "1"^^xsd:nonNegativeInteger ] ; fhir:max [ fhir:v "1" ] ; fhir:documentation [ fhir:v "The value of the attribute that this mapping depends on" ] ; fhir:type [ fhir:v "Element" ] ] ) ] [ fhir:name [ fhir:v "originMap" ] ; fhir:use [ fhir:v "out" ] ; fhir:min [ fhir:v "0"^^xsd:nonNegativeInteger ] ; fhir:max [ fhir:v "1" ] ; fhir:documentation [ fhir:v "The canonical reference to the concept map from which this mapping comes from" ] ; fhir:type [ fhir:v "uri" ] ] ) ] ) . # # -------------------------------------------------------------------------------------
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.
FHIR
®©
HL7.org
2011+.
FHIR
Release
3
(STU;
v3.0.2-11200)
R6
hl7.fhir.core#6.0.0-ballot3
generated
on
Thurs,
Oct
24,
2019
11:53+1100.
QA
Page
Fri,
Nov
21,
2025
00:01+0000.
Links:
Search
|
Version
History
|
Table
of
Contents
|
Credits
Glossary
|
QA
|
Compare
to
DSTU2
R4
|
Compare
to
R5
|
Compare
to
Last
Ballot
|
|
Propose
a
change