Metadata
Title Supporting Evidence Example
Version 2.0.0-ballot
Identifier urn:oid:2.16.840.1.113883.4.642.40.61.29.28
Status Draft
Experimental true
Jurisdiction 001 from http://unstats.un.org/unsd/methods/m49/m49.htm
Topic Health Quality Measure Document
Steward (Publisher) HL7 International / Clinical Quality Information
Description

Example measure illustrating the use of supporting evidence as a way to exchange additional information about particular populations within a measure.
Measure Scoring ratio from http://terminology.hl7.org/CodeSystem/measure-scoring
Measure Group (Rate) (ID: group-1)
Basis boolean
Measure Logic
Primary Library Supporting Evidence Example
Contents Population Criteria
Logic Definitions
Terminology
Dependencies
Data Requirements
Parameters
Population Criteria
Measure Group (Rate) (ID: group-1)
Logic Definitions
Logic Definition Library Name: SupportingEvidenceExample 
// main criteria logic

define "All Encounters":
     [Encounter] E
Logic Definition Library Name: SupportingEvidenceExample 
// boolean population results
// has matching encounter

define "Initial Population Boolean":
  exists "All Encounters"
Logic Definition Library Name: SupportingEvidenceExample 
define "Denominator Boolean":
    "Initial Population Boolean"
Logic Definition Library Name: SupportingEvidenceExample 
define "Encounter Arrived":
    [Encounter] E
       where E.status = 'arrived'
Logic Definition Library Name: SupportingEvidenceExample 
define "Numerator Exclusion Boolean":
  exists "Encounter Arrived"
Logic Definition Library Name: SupportingEvidenceExample 
define "Encounters in Period":
     [Encounter] E
       where E.period during "Measurement Period" and E.status='finished'
Logic Definition Library Name: SupportingEvidenceExample 
define "Numerator Boolean":
  exists "Encounters in Period"
Logic Definition Library Name: SupportingEvidenceExample 
define "Encounter Cancelled":
    [Encounter] E
       where E.status = 'cancelled'
Logic Definition Library Name: SupportingEvidenceExample 
define "Denominator Exclusion Boolean":
  exists "Encounter Cancelled"
Logic Definition Library Name: FHIRHelpers 
define function ToString(value EncounterStatus): value.value
Logic Definition Library Name: FHIRHelpers 
/*
@description: Converts the given [Period](https://hl7.org/fhir/datatypes.html#Period)
value to a CQL DateTime Interval
@comment: If the start value of the given period is unspecified, the starting
boundary of the resulting interval will be open (meaning the start of the interval
is unknown, as opposed to interpreted as the beginning of time).
*/
define function ToInterval(period FHIR.Period):
    if period is null then
        null
    else
        if period."start" is null then
            Interval(period."start".value, period."end".value]
        else
            Interval[period."start".value, period."end".value]
Terminology
Terminology None
Dependencies
Dependency Description: FHIR model information
Resource: http://hl7.org/fhir/uv/cql/Library/FHIR-ModelInfo|4.0.1
Canonical URL: http://hl7.org/fhir/uv/cql/Library/FHIR-ModelInfo|4.0.1
Dependency Description: Library FHIRHelpers
Resource: http://hl7.org/fhir/uv/cql/Library/FHIRHelpers|4.0.1
Canonical URL: http://hl7.org/fhir/uv/cql/Library/FHIRHelpers|4.0.1
Data Requirements
Data Requirement Type: Encounter
Profile(s): Encounter
Must Support Elements: status, period
Parameters
Name Use Card. Type Documentation
Measurement Period In 0..1 Period
Denominator Boolean Out 0..1 boolean
Numerator Exclusion Boolean Out 0..1 boolean
Initial Population Boolean Out 0..1 boolean
Numerator Boolean Out 0..1 boolean
Denominator Exclusion Boolean Out 0..1 boolean
Generated using version 0.5.4 of the sample-content-ig Liquid templates
<status value="draft"/> <experimental value="true"/> <date value="2025-08-13"/> <publisher value="HL7 International / Clinical Quality Information"/> <contact> <telecom> <system value="url"/> <value value="http://www.hl7.org/Special/committees/cqi"/> </telecom> </contact> <description value="Example measure illustrating the use of supporting evidence as a way to exchange additional information about particular populations within a measure."/> <jurisdiction> <coding> <system value="http://unstats.un.org/unsd/methods/m49/m49.htm"/> <code value="001"/> </coding> </jurisdiction> <topic> <coding> <system value="http://loinc.org"/> <code value="57024-2"/> <display value="Health Quality Measure Document"/> </coding> </topic> <library value="http://hl7.org/fhir/uv/cqm/Library/SupportingEvidenceExample"/> <scoring> <coding> <system value="http://terminology.hl7.org/CodeSystem/measure-scoring"/> <code value="ratio"/> </coding> </scoring> <group id="group-1"> <extension url="http://hl7.org/fhir/uv/cqm/StructureDefinition/cqm-populationBasis"> <valueCode value="boolean"/> </extension> <population id="initial-population"> <code> <coding> <system value="http://terminology.hl7.org/CodeSystem/measure-population"/> <code value="initial-population"/> <display value="Initial Population"/> </coding> </code> <criteria> <language value="text/cql-identifier"/> <expression value="Initial Population Boolean"/> </criteria> </population> <population id="denominator"> <extension url="http://hl7.org/fhir/StructureDefinition/cqf-supportingEvidenceDefinition"> <valueExpression> <extension url="http://hl7.org/fhir/StructureDefinition/expression-coding"> <valueCoding> <system value="http://example.org/fhir/CodeSystem/example-supporting-evidence-codes"/> <code value="always-true"/> <display value="Always True"/> </valueCoding> </extension> <description value="Example of supporting evidence that is always true"/> <name value="AlwaysTrue"/> <language value="text/cql-identifier"/> <expression value="always true"/> </valueExpression> </extension> <extension url="http://hl7.org/fhir/StructureDefinition/cqf-supportingEvidenceDefinition"> <valueExpression> <extension url="http://hl7.org/fhir/StructureDefinition/expression-coding"> <valueCoding> <system value="http://example.org/fhir/CodeSystem/example-supporting-evidence-codes"/> <code value="denominator-resource"/> <display value="Denominator Resource"/> </valueCoding> </extension> <description value="Example of supporting evidence that is a Denominator Resource"/> <name value="DenominatorResource"/> <language value="text/cql-identifier"/> <expression value="Denominator Resource"/> </valueExpression> </extension> <extension url="http://hl7.org/fhir/StructureDefinition/cqf-supportingEvidenceDefinition"> <valueExpression> <extension url="http://hl7.org/fhir/StructureDefinition/expression-coding"> <valueCoding> <system value="http://example.org/fhir/CodeSystem/example-supporting-evidence-codes"/> <code value="list-of-boolean"/> <display value="List of Boolean"/> </valueCoding> </extension> <description value="Example of supporting evidence that is a list of boolean"/> <name value="ListOfBoolean"/> <language value="text/cql-identifier"/> <expression value="list of boolean"/> </valueExpression> </extension> <extension url="http://hl7.org/fhir/StructureDefinition/cqf-supportingEvidenceDefinition"> <valueExpression> <extension url="http://hl7.org/fhir/StructureDefinition/expression-coding"> <valueCoding> <system value="http://example.org/fhir/CodeSystem/example-supporting-evidence-codes"/> <code value="string"/> <display value="String"/> </valueCoding> </extension> <description value="Example of supporting evidence that is a string"/> <name value="String"/> <language value="text/cql-identifier"/> <expression value="string"/> </valueExpression> </extension> <extension url="http://hl7.org/fhir/StructureDefinition/cqf-supportingEvidenceDefinition"> <valueExpression> <extension url="http://hl7.org/fhir/StructureDefinition/expression-coding"> <valueCoding> <system value="http://example.org/fhir/CodeSystem/example-supporting-evidence-codes"/> <code value="date"/> <display value="Date"/> </valueCoding> </extension> <description value="Example of supporting evidence that is a date"/> <name value="Date"/> <language value="text/cql-identifier"/> <expression value="date"/> </valueExpression> </extension> <extension url="http://hl7.org/fhir/StructureDefinition/cqf-supportingEvidenceDefinition"> <valueExpression> <extension url="http://hl7.org/fhir/StructureDefinition/expression-coding"> <valueCoding> <system value="http://example.org/fhir/CodeSystem/example-supporting-evidence-codes"/> <code value="decimal"/> <display value="Decimal"/> </valueCoding> </extension> <description value="Example of supporting evidence that is a decimal"/> <name value="Decimal"/> <language value="text/cql-identifier"/> <expression value="decimal"/> </valueExpression> </extension> <extension url="http://hl7.org/fhir/StructureDefinition/cqf-supportingEvidenceDefinition"> <valueExpression> <extension url="http://hl7.org/fhir/StructureDefinition/expression-coding"> <valueCoding> <system value="http://example.org/fhir/CodeSystem/example-supporting-evidence-codes"/> <code value="number"/> <display value="Number"/> </valueCoding> </extension> <description value="Example of supporting evidence that is a number"/> <name value="Number"/> <language value="text/cql-identifier"/> <expression value="number"/> </valueExpression> </extension> <extension url="http://hl7.org/fhir/StructureDefinition/cqf-supportingEvidenceDefinition"> <valueExpression> <extension url="http://hl7.org/fhir/StructureDefinition/expression-coding"> <valueCoding> <system value="http://example.org/fhir/CodeSystem/example-supporting-evidence-codes"/> <code value="list-of-dates"/> <display value="List of Dates"/> </valueCoding> </extension> <description value="Example of supporting evidence that is a list of dates"/> <name value="ListOfDates"/> <language value="text/cql-identifier"/> <expression value="list of dates"/> </valueExpression> </extension> <extension url="http://hl7.org/fhir/StructureDefinition/cqf-supportingEvidenceDefinition"> <valueExpression> <extension url="http://hl7.org/fhir/StructureDefinition/expression-coding"> <valueCoding> <system value="http://example.org/fhir/CodeSystem/example-supporting-evidence-codes"/> <code value="list-of-numbers"/> <display value="List of Numbers"/> </valueCoding> </extension> <description value="Example of supporting evidence that is a list of numbers"/> <name value="ListOfNumbers"/> <language value="text/cql-identifier"/> <expression value="list of numbers"/> </valueExpression> </extension> <extension url="http://hl7.org/fhir/StructureDefinition/cqf-supportingEvidenceDefinition"> <valueExpression> <extension url="http://hl7.org/fhir/StructureDefinition/expression-coding"> <valueCoding> <system value="http://example.org/fhir/CodeSystem/example-supporting-evidence-codes"/> <code value="list-of-string"/> <display value="List of String"/> </valueCoding> </extension> <description value="Example of supporting evidence that is a list of string"/> <name value="ListOfString"/> <language value="text/cql-identifier"/> <expression value="list of string"/> </valueExpression> </extension> <extension url="http://hl7.org/fhir/StructureDefinition/cqf-supportingEvidenceDefinition"> <valueExpression> <extension url="http://hl7.org/fhir/StructureDefinition/expression-coding"> <valueCoding> <system value="http://example.org/fhir/CodeSystem/example-supporting-evidence-codes"/> <code value="test-tuple"/> <display value="Test Tuple"/> </valueCoding> </extension> <description value="Example of supporting evidence that is a tuple"/> <name value="TestTuple"/> <language value="text/cql-identifier"/> <expression value="test tuple"/> </valueExpression> </extension> <extension url="http://hl7.org/fhir/StructureDefinition/cqf-supportingEvidenceDefinition"> <valueExpression> <extension url="http://hl7.org/fhir/StructureDefinition/expression-coding"> <valueCoding> <system value="http://example.org/fhir/CodeSystem/example-supporting-evidence-codes"/> <code value="interval"/> <display value="Interval"/> </valueCoding> </extension> <description value="Example of supporting evidence that is an interval"/> <name value="Interval"/> <language value="text/cql-identifier"/> <expression value="interval"/> </valueExpression> </extension> <extension url="http://hl7.org/fhir/StructureDefinition/cqf-supportingEvidenceDefinition"> <valueExpression> <extension url="http://hl7.org/fhir/StructureDefinition/expression-coding"> <valueCoding> <system value="http://example.org/fhir/CodeSystem/example-supporting-evidence-codes"/> <code value="test-interval-list"/> <display value="Test Interval List"/> </valueCoding> </extension> <description value="Example of supporting evidence that is a list of intervals"/> <name value="TestIntervalList"/> <language value="text/cql-identifier"/> <expression value="TestIntervalList"/> </valueExpression> </extension> <extension url="http://hl7.org/fhir/StructureDefinition/cqf-supportingEvidenceDefinition"> <valueExpression> <extension url="http://hl7.org/fhir/StructureDefinition/expression-coding"> <valueCoding> <system value="http://example.org/fhir/CodeSystem/example-supporting-evidence-codes"/> <code value="test-decimal-list"/> <display value="Test Decimal List"/> </valueCoding> </extension> <description value="Example of supporting evidence that is a list of decimals"/> <name value="TestDecimalList"/> <language value="text/cql-identifier"/> <expression value="TestDecimalList"/> </valueExpression> </extension> <extension url="http://hl7.org/fhir/StructureDefinition/cqf-supportingEvidenceDefinition"> <valueExpression> <extension url="http://hl7.org/fhir/StructureDefinition/expression-coding"> <valueCoding> <system value="http://example.org/fhir/CodeSystem/example-supporting-evidence-codes"/> <code value="test-code"/> <display value="Test Code"/> </valueCoding> </extension> <description value="Example of supporting evidence that is a code"/> <name value="TestCode"/> <language value="text/cql-identifier"/> <expression value="test code"/> </valueExpression> </extension> <extension url="http://hl7.org/fhir/StructureDefinition/cqf-supportingEvidenceDefinition"> <valueExpression> <extension url="http://hl7.org/fhir/StructureDefinition/expression-coding"> <valueCoding> <system value="http://example.org/fhir/CodeSystem/example-supporting-evidence-codes"/> <code value="empty-list-example"/> <display value="Empty List Example"/> </valueCoding> </extension> <description value="Example of supporting evidence that is an empty list"/> <name value="EmptyListExample"/> <language value="text/cql-identifier"/> <expression value="EmptyListExample"/> </valueExpression> </extension> <extension url="http://hl7.org/fhir/StructureDefinition/cqf-supportingEvidenceDefinition"> <valueExpression> <extension url="http://hl7.org/fhir/StructureDefinition/expression-coding"> <valueCoding> <system value="http://example.org/fhir/CodeSystem/example-supporting-evidence-codes"/> <code value="null-example"/> <display value="Null Example"/> </valueCoding> </extension> <description value="Example of supporting evidence that is a null"/> <name value="NullExample"/> <language value="text/cql-identifier"/> <expression value="NullExample"/> </valueExpression> </extension> <extension url="http://hl7.org/fhir/StructureDefinition/cqf-supportingEvidenceDefinition"> <valueExpression> <extension url="http://hl7.org/fhir/StructureDefinition/expression-coding"> <valueCoding> <system value="http://example.org/fhir/CodeSystem/example-supporting-evidence-codes"/> <code value="patient-resource"/> <display value="Patient Resource"/> </valueCoding> </extension> <description value="Example of supporting evidence that is a Patient Resource"/> <name value="PatientResource"/> <language value="text/cql-identifier"/> <expression value="PatientRes"/> </valueExpression> </extension> <extension url="http://hl7.org/fhir/StructureDefinition/cqf-supportingEvidenceDefinition"> <valueExpression> <extension url="http://hl7.org/fhir/StructureDefinition/expression-coding"> <valueCoding> <system value="http://example.org/fhir/CodeSystem/example-supporting-evidence-codes"/> <code value="list-test-tuple"/> <display value="List Test Tuple"/> </valueCoding> </extension> <description value="Example of supporting evidence that is a list of tuples"/> <name value="ListTestTuple"/> <language value="text/cql-identifier"/> <expression value="list test tuple"/> </valueExpression> </extension> <code> <coding> <system value="http://terminology.hl7.org/CodeSystem/measure-population"/> <code value="denominator"/> <display value="Denominator"/> </coding> </code> <criteria> <language value="text/cql-identifier"/> <expression value="Denominator Boolean"/> </criteria> </population> <population id="denominator-exclusion"> <code> <coding> <system value="http://terminology.hl7.org/CodeSystem/measure-population"/> <code value="denominator-exclusion"/> <display value="Denominator Exclusion"/> </coding> </code> <criteria> <language value="text/cql-identifier"/> <expression value="Denominator Exclusion Boolean"/> </criteria> </population> <population id="numerator-exclusion"> <code> <coding> <system value="http://terminology.hl7.org/CodeSystem/measure-population"/> <code value="numerator-exclusion"/> <display value="Numerator Exclusion"/> </coding> </code> <criteria> <language value="text/cql-identifier"/> <expression value="Numerator Exclusion Boolean"/> </criteria> </population> <population id="numerator"> <code> <coding> <system value="http://terminology.hl7.org/CodeSystem/measure-population"/> <code value="numerator"/> <display value="Numerator"/> </coding> </code> <criteria> <language value="text/cql-identifier"/> <expression value="Numerator Boolean"/> </criteria> </population> </group> </Measure>