...
To get translations for at ValueSet, use $expand as follows:
Call
$expandon the ValueSetGET <base-url>/fhir/ValueSet/$expand?url=<ValueSet url>&property=designation
Determine best translation:
Choose designation with “da” (for Danish) if available, otherwise
Choose display (as best alternative - this will be in whatever language the concept is defined with)
In the example below, this is the case for code assessment
| Info |
|---|
Example request and response on $expand on topic-type Request:
Response: { "resourceType": "ValueSet", "status": "active", … { "system": "http://hl7.org/fhir/definition-topic", "code": "assessment", "display": "Assessment" }, … { "system": "http://ehealth.sundhed.dk/cs/topic-type", "code": "self-treatment", "display": "Self-treatment", "designation": [ { "language": "da", "value": "Selvbehandling" } ] } … |
...
For supported operations on concept lookups and decomposition, please see the supported operations on CodeSystem at httphttps://www.hl7.org/fhir/STU3R4/codesystem-operations.html . Designations targeted consumers/citizens will eg. contain the following data in the designation:
...
To get values forQuantity.codeandQuantity.system use the ConceptMap conceptmap-obs-code-to-ucum as follows:
Call
$translateon the givencodeandsystem:GET <base-url>/fhir/ConceptMap/$translate?system=<system>&code=<code>
On match found, the values to use in
Quantity.codeandQuantity.systemare the matching concept’scodeandsystem, respectively, where the source ConceptMap is “http://ehealth.sundhed.dk/ConceptMap/conceptmap-obs-code-to-ucum” (see example response below):
| Info |
|---|
Example request and response on $translate on conceptmap-obs-code-to-ucum Request:
Response: { "resourceType": "Parameters", "parameter": [ { "name": "result", "valueBoolean": true }, { "name": "message", "valueString": "Matches found!" }, { "name": "match", "part": [ { "name": "equivalence", "valueCode": "specializes" }, { "name": "concept", "valueCoding": { "system": "http://unitsofmeasure.org", "code": "kg", "display": "kilogram" } }, { "name": "source", "valueUri": "http://ehealth.sundhed.dk/ConceptMap/conceptmap-obs-code-to-ucum" } ] } ] } |
...
To get the corresponding and printable value for Quantity.unit, use the ConceptMap conceptmap-ucum-to-printsymbol as follows:
Call
$translateon the givensystemandcodedetermined in the response above:GET <base-url>/fhir/ConceptMap/$translate?target=http://ehealth.sundhed.dk/vs/ehealth-ucum-printsymbol-supplement&code=<code>&system=<system>
On match found, extract the matching concept (see example response below).
Call
$lookupon the matching (CodeSystem)systemandcode:GET <base-url>/fhir/CodeSystem/$lookup?system=http://ehealth.sundhed.dk/cs/ehealth-ucum-printsymbol-supplement&code=<code>
On match found, the value to use in
Quantity.unitis the matching concept’sdesignation.valuewhere thedesignation.language=da(see example response below). If there is no such designation, the printable value inQuantity.unitshall be left empty.
| Note |
|---|
The $lookup does not return designation on eHealth Infrastructure Release 4 and other releases prior to Release 5. |
...
To determine whether to use integer or decimal, use the ConceptMap conceptmap-obs-code-to-value-type as follows:
Call
$translateon the givencodeandsystem:GET <base-url>/fhir/ConceptMap/$translate?system=<system>&code=<code>&target=http://hl7.org/fhir/ValueSet/data-types
On match found, indication of whether to use integer or decimal are the matching concept’s
codeandsystem, respectively, where the source ConceptMap is “http://ehealth.sundhed.dk/ConceptMap/conceptmap-obs-code-to-value-type” (see example response below).The codes
integeranddecimalinsystem http://hl7.org/fhir/data-typessignify that the observed value or reference range shall be given as integer and decimal, respectively.
| Info |
|---|
Example request and response on $translate on conceptmap-obs-code-to-value-type Request:
Response: { |
...