This page is part of the FHIR Specification (v0.4.0: DSTU 2 Draft). 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
This resource has 2 operations associated with it. For more information about operations, including how they are invoked, see Operations.
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 outcome is an operationOutcome with hints, warnings, or errors, or the translated code in an extension
Formal Definition (as a OperationDefinition).
URL: [base]/ConceptMap/$translate
URL: [base]/ConceptMap/[id]/$translate
In Parameters: | ||||
Name | Cardinality | Type | Profile | Documentation |
code | 0..1 | code | The code that is to be translated. If a code is provided, a system must be provided | |
system | 0..1 | uri | The system for the code that is to be translated | |
version | 0..1 | string | The version of the system, if one was provided in the source data | |
valueSet | 0..1 | uri | Identifies the value set used when the concept (system/code pair) was chosen. May be a logical id, or an absolute or relative location | |
coding | 0..1 | Coding | A coding to translate | |
codeableConcept | 0..1 | CodeableConcept | A full codeableConcept to validate. The server can translate any of the coding values as it chooses | |
target | 1..1 | uri | Identifies the value set in which a translation is sought. May be a logical id, or an absolute or relative location | |
Out Parameters: | ||||
Name | Cardinality | Type | Profile | Documentation |
result | 1..1 | boolean | True if the concept could be translated | |
message | 0..1 | string | Error details, if result = false. If this is provided when result = true, the message carries hints and wanrings | |
outcome | 0..1 | Coding | The translation outcome |
This operation provides support for ongoing maintenance of a client-side closure table based on server-side terminological logic. For details of how this is used, see Maintaining a Closure Table
Formal Definition (as a OperationDefinition).
URL: [base]/$closure
In Parameters: | ||||
Name | Cardinality | Type | Profile | Documentation |
name | 1..1 | string | The name that defines the particular context for the subsumption based closure table | |
concept | 0..* | Coding | Concepts to add to the closure table | |
version | 0..1 | id | A request to resynchronise - request to send all new entries since the nominated version was sent by the server | |
Out Parameters: | ||||
Name | Cardinality | Type | Profile | Documentation |
return | 1..1 | ConceptMap | A list of new entries (code / system --> code/system) that the client should add to it's closure table. The only kind of entry mapping equivalences that can be returned are equal, narrower, wider, and unmatched Note: as this the only out parameter, it is a resource, and it has the name 'return', the result of this operation is returned directly as a resource |