DSTU2

This page is part of the FHIR Specification (v1.0.2: DSTU 2). The current version which supercedes this version is 5.0.0. For a full list of available versions, see the Directory of published versions . Page versions: R5 R4B R4 R3 R2

Operation-conceptmap-translate

This is the narrative for the resource. See also the XML or JSON format.


Concept Translation

OPERATION: Concept Translation

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. || One (and only one) of the in parameters (code, coding, codeableConcept) must be provided, to identify the code that is to be translated. || 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

URL: [base]/ConceptMap/$translate

URL: [base]/ConceptMap/[id]/$translate

Parameters

UseNameCardinalityTypeBindingDocumentation
INcode0..1code

The code that is to be translated. If a code is provided, a system must be provided

INsystem0..1uri

The system for the code that is to be translated

INversion0..1string

The version of the system, if one was provided in the source data

INvalueSet0..1uri

Identifies the value set used when the concept (system/code pair) was chosen. May be a logical id, or an absolute or relative location

INcoding0..1Coding

A coding to translate

INcodeableConcept0..1CodeableConcept

A full codeableConcept to validate. The server can translate any of the coding values (e.g. existing translations) as it chooses

INtarget1..1uri

Identifies the value set in which a translation is sought. May be a logical id, or an absolute or relative location

INdependency0..*

Another element that may help produce the correct mapping

INdependency.element0..1uri

The element for this dependency

INdependency.concept0..1CodeableConcept

The value for this dependency

OUTresult1..1boolean

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

OUTmessage0..1string

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)

OUTmatch0..*

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

OUTmatch.equivalence0..1code

A code indicating the equivalence of the translation, using values from [ConceptMapEquivalence]{concept-map-equivalence.html}

OUTmatch.concept0..1Coding

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)

OUTmatch.product0..*

Another element that is the product of this mapping

OUTmatch.product.element0..1uri

The element for this product

OUTmatch.product.concept0..1Coding

The value for this product


 

 

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.