Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Background

The AQL MATCHES statement may perform a request to a terminology server for performing some operation over a value set or code system (here used as a synonym of terminology). Several operations may be possible, being the most common ones: the expansion of a ValueSet (or Reference Set), checking that a concept belongs to a value set or code system, testing if one concept subsumes another one, or the translation of concepts across different terminologies.

...

A less cumbersome approach has been agreed by usingĀ  a keyword (TERMINOLOGY) in the AQL syntax. The TERMINOLOGY keyword indicates that the three sections inside its parenthesis correspond to the operation, the driver or adapter for the external terminology server (e.g. HL7 FHIR TS, Ocean CTS, DTS2), and the driver identifiers. These identifiers should provide the necessary information for invoking external terminology servers to perform an operation. In addition, the AQL TERMINOLOGY operand should also provide the necessary information for allowing the processing system to parse back the response from the terminology server.

The MATCHES syntax should allow to directly use the TERMINOLOGY statement for indicating that the set will be resolved by the internal representation. This is already allowed by some implementers.

...

Operation type

Example in operation parameter

Expand

?url=http://snomed.info/sct?fhir_vs=refset/142321000036106&count=10&filter=met

Validate

?code=A&url=http://terminology.hl7.org/ValueSet/v2-0323&system=http://terminology.hl7.org/CodeSystem/v2-0323&url=http://terminology.hl7.org/ValueSet/v2-0323

?code=A&system=http://terminology.hl7.org/CodeSystem/v2-0323

$validate-code?code=D&system=http://terminology.hl7.org/CodeSystem/v2-0323&display=Delete&url=http://terminology.hl7.org/ValueSet/v2-0323

Translate

/ConceptMap/snomed-icd-map/$translate?code=10138007&system=http://snomed.info/sct&target=http://icd10.who.org

/ConceptMap/dinamicrelreduced/$translate?code=59320-2&system=http://loinc.org&target=url=http::/snomed.info/sct?code=59320-2 how do we provide the concept map id?

?system=http://hl7.org/fhir/composition-status&code=preliminary&source=http://hl7.org/fhir/ValueSet/composition-status&target=http://terminology.hl7.org/ValueSet/v3-ActStatus

?source=http://snomed.info/sct?fhir_vs&system=http://snomed.info/sct&code=90260006&target=http://hl7.org/fhir/ValueSet/substance-category

https://ontoserver.csiro.au/stu3-latest/ConceptMap/102/$translate?code=ACNE&system=http://hl7.org/fhir/v2/0487&target=http:/snomed.info/sct how do we provide the concept map id?

https://ontoserver.csiro.au/stu3-latest/ConceptMap/102/$translate?code=309068002&system=http://snomed.info/sct&reverse=true&target=http://hl7.org/fhir/v2/0487how do we provide the concept map id?

Subsumes

?system=http://hl7.org/fhir/sid/icd-10-en&codeA=A20&codeB=A20.1

?system=http://hl7.org/fhir/sid/icd-10-en&codeA=B81&codeB=B81.4

?system=http://snomed.info/sct&codeA=235856003&codeB=3738000

Look-up

?system=http://loinc.org&code=1963-8&property=code&property=display&property=designations

?system=http://highmed.org/germanLabCodes2&code=489&_format=json

?system=http://hl7.org/fhir/sid/icd-10-en&code=D70.0&_format=json

...