Uploaded image for project: 'FHIR Specification Feedback'
  1. FHIR Specification Feedback
  2. FHIR-26561

Add general guidance on terminology usage for measure authors

    XMLWordPrintableJSON

Details

    • Icon: Change Request Change Request
    • Resolution: Persuasive
    • Icon: Medium Medium
    • US Quality Measures (FHIR)
    • 0.1 [deprecated]
    • Clinical Quality Information
    • CQL Basics [deprecated]
    • Hide

      FHIR supports various types of terminology-valued elements, including:

      These types correspond directly to the CQL primitive types:

      In addition to the type of element, FHIR provides the ability to bind these elements to specific codes, in the form of a direct-reference code (constraint to a specific code in a [CodeSystem](http://hl7.org/fhir/codesystem.html)), or a binding to a [ValueSet](http://hl7.org/fhir/valueset.html). These bindings can be different [binding strengths](http://hl7.org/fhir/codesystem-binding-strength.html)

      • [required](http://hl7.org/fhir/terminologies.html#required) - To be conformant, the concept in this element SHALL be from the specified value set.
      • [extensible](http://hl7.org/fhir/terminologies.html#extensible) - To be conformant, the concept in this element SHALL be from the specified value set if any of the codes within the value set can apply to the concept being communicated. If the value set does not cover the concept (based on human review), alternate codings (or, data type allowing, text) may be included instead.
      • [preferred](http://hl7.org/fhir/terminologies.html#preferred) - Instances are encouraged to draw from the specified codes for interoperability purposes but are not required to do so to be considered conformant.
      • [example](http://hl7.org/fhir/terminologies.html#example) - Instances are not expected or even encouraged to draw from the specified value set. The value set merely provides examples of the types of concepts intended to be included.

      Within CQL, references to terminology code systems, value sets, codes, and concepts are directly supported, and all such usages are declared within CQL libraries, as described in the [Terminology](https://cql.hl7.org/02-authorsguide.html#terminology) section of the CQL Author's Guide.

      When referencing terminology-valued elements within CQL, the following comparison operations are supported:

       

      Show
      FHIR supports various types of terminology-valued elements, including: [code] ( http://hl7.org/fhir/datatypes.html#code ) [Coding] ( http://hl7.org/fhir/datatypes.html#Coding ) [CodeableConcept( http://hl7.org/fhir/datatypes.html#CodeableConcept ) These types correspond directly to the CQL primitive types: [String] ( https://cql.hl7.org/09-b-cqlreference.html#string-1 ) [Code] ( https://cql.hl7.org/09-b-cqlreference.html#code-1 ) [Concept] ( https://cql.hl7.org/09-b-cqlreference.html#concept-1 ) In addition to the type of element, FHIR provides the ability to bind these elements to specific codes, in the form of a direct-reference code (constraint to a specific code in a [CodeSystem] ( http://hl7.org/fhir/codesystem.html )), or a binding to a [ValueSet] ( http://hl7.org/fhir/valueset.html ). These bindings can be different [binding strengths] ( http://hl7.org/fhir/codesystem-binding-strength.html ) [required] ( http://hl7.org/fhir/terminologies.html#required ) - To be conformant, the concept in this element SHALL be from the specified value set. [extensible] ( http://hl7.org/fhir/terminologies.html#extensible ) - To be conformant, the concept in this element SHALL be from the specified value set if any of the codes within the value set can apply to the concept being communicated. If the value set does not cover the concept (based on human review), alternate codings (or, data type allowing, text) may be included instead. [preferred] ( http://hl7.org/fhir/terminologies.html#preferred ) - Instances are encouraged to draw from the specified codes for interoperability purposes but are not required to do so to be considered conformant. [example] ( http://hl7.org/fhir/terminologies.html#example ) - Instances are not expected or even encouraged to draw from the specified value set. The value set merely provides examples of the types of concepts intended to be included. Within CQL, references to terminology code systems, value sets, codes, and concepts are directly supported, and all such usages are declared within CQL libraries, as described in the [Terminology] ( https://cql.hl7.org/02-authorsguide.html#terminology ) section of the CQL Author's Guide. When referencing terminology-valued elements within CQL, the following comparison operations are supported: [Equal (`=`)] ( https://cql.hl7.org/09-b-cqlreference.html#equal-3 ) [Equivalent (`~`)] ( https://cql.hl7.org/09-b-cqlreference.html#equivalent-3 ) [In (`in`)] ( https://cql.hl7.org/09-b-cqlreference.html#in-valueset )  
    • Floyd Eisenberg/Rob Samples: 27-0-1
    • Clarification
    • Non-substantive

    Description

      Add guidance on the use of terminologies from a CQL authoring perspective:

      1. The types of terminology-valued elements in FHIR
      2. How each of those types are referenced/compared
        Refer to guidance in CPG-on-FHIR here: https://jira.hl7.org/browse/FHIR-26560

       

      Attachments

        Activity

          People

            bryn.rhodes Bryn Rhodes
            bryn.rhodes Bryn Rhodes
            Watchers:
            2 Start watching this issue

            Dates

              Created:
              Updated:
              Resolved: