Quality Measure Implementation Guide (STU4)
4.0.0 - STU4 United States of America flag

This page is part of the Quality Measure STU2 for FHIR R4 Implementation Guide (v4.0.0: STU4 (v4.0.0)) based on FHIR R4. This is the current published version in its permanent home (it will always be available at this URL). For a full list of available versions, see the Directory of published versions

Example Measure: Cervical Cancer Screening

Draft as of 2022-02-22
Id: CCSComponent
Download cql: CCSComponent.cql
Url: Cervical Cancer Screening
Version: 0.0.001
Name: CCSComponent
Title: Cervical Cancer Screening
Status: draft
Experimental: true
Scoring:

Proportion

Improvement Notation:

increase

Type:

process

Date: 2022-02-22 11:37:03-0600
Publisher: Clinical Quality Information WG
Description:

This is only an example.

Jurisdiction: US
Effective Period: 2022-01-01..2022-12-31
Supplemental Data Elements: SDE Ethnicity SDE Payer SDE Race SDE Sex
Libraries:
CCS Component Library
Related Artifact Dependencies:
  • Supplemental Data Elements Library
  • http://fhir.org/guides/cqf/common/Library/FHIRHelpers|4.0.1
  • MAT Global Common Functions FHIR Library
  • Adult Outpatient Encounters Common Library
  • Hospice FHIR Library
  • Advanced Illness and Frailty Exclusion Library
  • http://snomed.info/sct|http://snomed.info/sct/731000124108/version/201709
  • Colonoscopy
  • Fecal Occult Blood Test (FOBT)
  • Flexible Sigmoidoscopy
  • FIT DNA
  • CT Colonography
  • Office Visit
  • Annual Wellness Visit
  • Preventive Care Services Established Office Visit, 18 and Up
  • Preventive Care Services Initial Office Visit, 18 and Up
  • Home Healthcare Services
  • Payer
  • Encounter Inpatient
  • Hospice Care Ambulatory
  • Malignant Neoplasm of Colon
  • Total Colectomy
  • Frailty Device
  • Frailty Diagnosis
  • Frailty Encounter
  • Frailty Symptom
  • Outpatient
  • Observation
  • ED
  • Nonacute Inpatient
  • Advanced Illness
  • Acute Inpatient
  • Dementia Medications
  • Care Services in Long Term Residential Facility
  • Nursing Facility Visit
  • Parameters:
    nameuseminmaxtype
    Measurement Period in 0 1 Period
    SDE Sex out 0 1 Coding
    Numerator out 0 1 boolean
    Denominator out 0 1 boolean
    SDE Payer out 0 * Resource
    Initial Population out 0 1 boolean
    SDE Ethnicity out 0 * Coding
    Denominator Exclusion out 0 1 boolean
    SDE Race out 0 * Coding
    DataRequirements:
    TypeMust SupportValueset NameValueset
    Coverage period type Payer Payer
    Patient extension value url
    Encounter type Care Services in Long-Term Residential Facility Care Services in Long Term Residential Facility
    Encounter type Nursing Facility Visit Nursing Facility Visit
    Encounter type Office Visit Office Visit
    Encounter type Annual Wellness Visit Annual Wellness Visit
    Encounter type Preventive Care Services - Established Office Visit, 18 and Up Preventive Care Services Established Office Visit, 18 and Up
    Encounter type Preventive Care Services-Initial Office Visit, 18 and Up Preventive Care Services Initial Office Visit, 18 and Up
    Encounter type Home Healthcare Services Home Healthcare Services
    Encounter period diagnosis type Acute Inpatient Acute Inpatient
    Encounter period hospitalization hospitalization.dischargeDisposition type status Encounter Inpatient Encounter Inpatient
    Encounter type Outpatient Outpatient
    Encounter type Observation Observation
    Encounter type ED ED
    Encounter type Nonacute Inpatient Nonacute Inpatient
    Encounter period type Frailty Encounter Frailty Encounter
    Condition code Malignant Neoplasm of Colon Malignant Neoplasm of Colon
    Condition code id Advanced Illness Advanced Illness
    Condition code Frailty Diagnosis Frailty Diagnosis
    Procedure code performed status Total Colectomy Total Colectomy
    Procedure code performed status Flexible Sigmoidoscopy Flexible Sigmoidoscopy
    Procedure code performed status CT Colonography CT Colonography
    Procedure code performed status Colonoscopy Colonoscopy
    Procedure code performed status Hospice care ambulatory Hospice Care Ambulatory
    Observation effective code value status FIT DNA FIT DNA
    Observation effective code Frailty Symptom Frailty Symptom
    Observation effective code value status Fecal Occult Blood Test (FOBT) Fecal Occult Blood Test (FOBT)
    ServiceRequest code authoredOn intent Hospice care ambulatory Hospice Care Ambulatory
    DeviceRequest code authoredOn Frailty Device Frailty Device
    MedicationDispense whenHandedOver medication Dementia Medications Dementia Medications
    Direct Reference Codes:
    displaycodesystem
    Discharge to home for hospice care (procedure) 428361000124107 SNOMED CT (all versions)
    Discharge to healthcare facility for hospice care (procedure) 428371000124100 SNOMED CT (all versions)
    Logic Definitions:
    GroupScoringPopulation CriteriaExpression
    Measure scoring:

    Proportion

    Initial Population
    define "Initial Population":   Global."CalendarAgeInYearsAt" ( FHIRHelpers.ToDate ( Patient.birthDate ), start of "Measurement Period" ) in Interval[50, 75]       and exists AdultOutpatientEncounters."Qualifying Encounters"
    Denominator
    define "Denominator":   "Initial Population"
    Denominator Exclusion
    define "Denominator Exclusion":   Hospice."Has Hospice"       or exists "Malignant Neoplasm"       or exists "Total Colectomy Performed"       or Frailty."Advanced Illness and Frailty Exclusion Not Including Over Age 80"         and Frailty."Long Term Care Periods Longer Than 90 Consecutive Days"
    Numerator
    define "Numerator":   exists "Colonoscopy Performed"       or exists "Fecal Occult Blood Test Performed"       or exists "Flexible Sigmoidoscopy Performed"       or exists "Fecal Immunochemical Test DNA"       or exists "CT Colonography Performed"
    Library NameName
    SupplementalDataElements SDE Sex
    define "SDE Sex":   case       when Patient.gender = 'male' then Code { code: 'M', system: 'http://hl7.org/fhir/v3/AdministrativeGender', display: 'Male' }       when Patient.gender = 'female' then Code { code: 'F', system: 'http://hl7.org/fhir/v3/AdministrativeGender', display: 'Female' }       else null     end
    Library NameName
    CCSComponent SDE Sex
    define "SDE Sex":   SDE."SDE Sex"
    Library NameName
    CCSComponent Colonoscopy Performed
    define "Colonoscopy Performed":   [Procedure: "Colonoscopy"] Colonoscopy       where Colonoscopy.status = 'completed'         and Global."Normalize Interval" ( Colonoscopy.performed ) ends 10 years or less on or before         end of "Measurement Period"
    Library NameName
    CCSComponent Fecal Occult Blood Test Performed
    define "Fecal Occult Blood Test Performed":   [Observation: "Fecal Occult Blood Test (FOBT)"] FecalOccultResult       where FecalOccultResult.status in { 'final', 'amended', 'corrected', 'preliminary' }         and FecalOccultResult.value is not null         and Global."Normalize Interval" ( FecalOccultResult.effective ) during day of "Measurement Period"
    Library NameName
    CCSComponent Flexible Sigmoidoscopy Performed
    define "Flexible Sigmoidoscopy Performed":   [Procedure: "Flexible Sigmoidoscopy"] FlexibleSigmoidoscopy       where FlexibleSigmoidoscopy.status = 'completed'         and Global."Normalize Interval" ( FlexibleSigmoidoscopy.performed ) ends 5 years or less on or before         end of "Measurement Period"
    Library NameName
    CCSComponent Fecal Immunochemical Test DNA
    define "Fecal Immunochemical Test DNA":   [Observation: "FIT DNA"] FitDNA       where FitDNA.status in { 'final', 'amended', 'corrected', 'preliminary' }         and FitDNA.value is not null         and Global."Normalize Interval" ( FitDNA.effective ) occurs 3 years or less on or before day of         end of "Measurement Period"
    Library NameName
    CCSComponent CT Colonography Performed
    define "CT Colonography Performed":   [Procedure: "CT Colonography"] Colonography       where Colonography.status = 'completed'         and Global."Normalize Interval" ( Colonography.performed ) ends 5 years or less on or before         end of "Measurement Period"
    Library NameName
    CCSComponent Numerator
    define "Numerator":   exists "Colonoscopy Performed"       or exists "Fecal Occult Blood Test Performed"       or exists "Flexible Sigmoidoscopy Performed"       or exists "Fecal Immunochemical Test DNA"       or exists "CT Colonography Performed"
    Library NameName
    AdultOutpatientEncounters Qualifying Encounters
    define "Qualifying Encounters":  (     [Encounter: "Office Visit"]     union [Encounter: "Annual Wellness Visit"]     union [Encounter: "Preventive Care Services - Established Office Visit, 18 and Up"]     union [Encounter: "Preventive Care Services-Initial Office Visit, 18 and Up"]     union [Encounter: "Home Healthcare Services"]   ) ValidEncounter   where ValidEncounter.period during "Measurement Period"     and ValidEncounter.status  = 'finished'
    Library NameName
    CCSComponent Initial Population
    define "Initial Population":   Global."CalendarAgeInYearsAt" ( FHIRHelpers.ToDate ( Patient.birthDate ), start of "Measurement Period" ) in Interval[50, 75]       and exists AdultOutpatientEncounters."Qualifying Encounters"
    Library NameName
    CCSComponent Denominator
    define "Denominator":   "Initial Population"
    Library NameName
    SupplementalDataElements SDE Payer
    define "SDE Payer":   [Coverage: type in "Payer"] Payer         return {           code: Payer.type,           period: Payer.period         }
    Library NameName
    CCSComponent SDE Payer
    define "SDE Payer":   SDE."SDE Payer"
    Library NameName
    SupplementalDataElements SDE Ethnicity
    define "SDE Ethnicity":   (flatten (       Patient.extension Extension         where Extension.url = 'http://hl7.org/fhir/us/core/StructureDefinition/us-core-ethnicity'           return Extension.extension     )) E       where E.url = 'ombCategory'         or E.url = 'detailed'       return E.value as Coding
    Library NameName
    CCSComponent SDE Ethnicity
    define "SDE Ethnicity":   SDE."SDE Ethnicity"
    Library NameName
    Hospice Has Hospice
    define "Has Hospice":  exists (     [Encounter: "Encounter Inpatient"] DischargeHospice    where DischargeHospice.status = 'finished'       and (          DischargeHospice.hospitalization.dischargeDisposition ~ "Discharge to home for hospice care (procedure)"         or DischargeHospice.hospitalization.dischargeDisposition ~ "Discharge to healthcare facility for hospice care (procedure)"       )     and DischargeHospice.period ends during "Measurement Period"  )     or exists (       [ServiceRequest: "Hospice care ambulatory"] HospiceOrder         where HospiceOrder.intent = 'order'             and HospiceOrder.authoredOn in "Measurement Period"     )     or exists (       [Procedure: "Hospice care ambulatory"] HospicePerformed         where HospicePerformed.status = 'completed'           and Global."Normalize Interval"(HospicePerformed.performed) overlaps "Measurement Period"     )
    Library NameName
    CCSComponent Malignant Neoplasm
    define "Malignant Neoplasm":   [Condition: "Malignant Neoplasm of Colon"] ColorectalCancer       where Global."Prevalence Period" ( ColorectalCancer ) starts on or before       end of "Measurement Period"
    Library NameName
    CCSComponent Total Colectomy Performed
    define "Total Colectomy Performed":   [Procedure: "Total Colectomy"] Colectomy       where Colectomy.status = 'completed'         and Global."Normalize Interval" ( Colectomy.performed ) starts on or before         end of "Measurement Period"
    Library NameName
    AdvancedIllnessandFrailtyExclusion Has Criteria Indicating Frailty
    define "Has Criteria Indicating Frailty":   //Ask Bryn about devices        exists ( [DeviceRequest: "Frailty Device"] FrailtyDeviceOrder          where FrailtyDeviceOrder.authoredOn during "Measurement Period"        )           // DeviceUseStatement has a known issue with the publication tooling           // so it is removed to allow this IG to publish until that is fixed         //or exists ( [DeviceUseStatement: "Frailty Device"] FrailtyDeviceUse         //  where Global."Normalize Interval"(FrailtyDeviceUse.timing) overlaps "Measurement Period"         //)         or exists ( [Condition: "Frailty Diagnosis"] FrailtyDiagnosis           where Global."Prevalence Period"(FrailtyDiagnosis) overlaps "Measurement Period"         )         or exists ( [Encounter: "Frailty Encounter"] FrailtyEncounter           where FrailtyEncounter.period overlaps "Measurement Period"         )         or exists ( [Observation: "Frailty Symptom"] FrailtySymptomObservation           where Global."Normalize Interval"(FrailtySymptomObservation.effective) overlaps "Measurement Period"         )
    Library NameName
    AdvancedIllnessandFrailtyExclusion Outpatient Encounters with Advanced Illness
    define "Outpatient Encounters with Advanced Illness":   ( [Encounter: "Outpatient"]         union [Encounter: "Observation"]         union [Encounter: "ED"]         union [Encounter: "Nonacute Inpatient"] ) OutpatientEncounter          with [Condition: "Advanced Illness"] AdvancedIllnessDiagnosis                   such that exists (                       OutpatientEncounter.diagnosis.condition EncounterDiagnosis                           where EndsWith(EncounterDiagnosis.reference, AdvancedIllnessDiagnosis.id)                   )                   and OutpatientEncounter.period starts 2 years or less on or before          end of "Measurement Period"
    Library NameName
    AdvancedIllnessandFrailtyExclusion Inpatient Encounter with Advanced Illness
    define "Inpatient Encounter with Advanced Illness":   [Encounter: "Acute Inpatient"] InpatientEncounter         with [Condition: "Advanced Illness"] AdvancedIllnessDiagnosis                   such that exists (                       InpatientEncounter.diagnosis.condition EncounterDiagnosis                           where EndsWith(EncounterDiagnosis.reference, AdvancedIllnessDiagnosis.id)                   )          and InpatientEncounter.period starts 2 years or less on or before          end of "Measurement Period"
    Library NameName
    AdvancedIllnessandFrailtyExclusion Dementia Medications In Year Before or During Measurement Period
    define "Dementia Medications In Year Before or During Measurement Period":   ["MedicationDispense": "Dementia Medications"] DementiaMed         where DementiaMed.whenHandedOver during Interval[                   ( start of "Measurement Period" - 1 year ), end of "Measurement Period"               ]
    Library NameName
    AdvancedIllnessandFrailtyExclusion Advanced Illness and Frailty Exclusion Not Including Over Age 80
    define "Advanced Illness and Frailty Exclusion Not Including Over Age 80":   //If the measure does NOT include populations age 80 and older, then use this logic:        Global."CalendarAgeInYearsAt"(FHIRHelpers.ToDate(Patient.birthDate), start of "Measurement Period")>= 65               and "Has Criteria Indicating Frailty"               and ( Count("Outpatient Encounters with Advanced Illness")>= 2                   or exists ( "Inpatient Encounter with Advanced Illness" )                   or exists "Dementia Medications In Year Before or During Measurement Period"               )
    Library NameName
    AdvancedIllnessandFrailtyExclusion Long Term Care Periods During Measurement Period
    // start here define "Long Term Care Periods During Measurement Period":   ( [Encounter: "Care Services in Long-Term Residential Facility"]                 union [Encounter: "Nursing Facility Visit"] ) LongTermFacilityEncounter                 where LongTermFacilityEncounter.period overlaps "Measurement Period"                 return LongTermFacilityEncounter.period                  intersect "Measurement Period"
    Library NameName
    AdvancedIllnessandFrailtyExclusion Long Term Care Periods Longer Than 90 Consecutive Days
    define "Long Term Care Periods Longer Than 90 Consecutive Days":   exists ( "Long Term Care Periods During Measurement Period" LongTermCareDuringMP         where duration in days of LongTermCareDuringMP > 90     )
    Library NameName
    CCSComponent Denominator Exclusion
    define "Denominator Exclusion":   Hospice."Has Hospice"       or exists "Malignant Neoplasm"       or exists "Total Colectomy Performed"       or Frailty."Advanced Illness and Frailty Exclusion Not Including Over Age 80"         and Frailty."Long Term Care Periods Longer Than 90 Consecutive Days"
    Library NameName
    SupplementalDataElements SDE Race
    define "SDE Race":   (flatten (       Patient.extension Extension         where Extension.url = 'http://hl7.org/fhir/us/core/StructureDefinition/us-core-race'           return Extension.extension     )) E       where E.url = 'ombCategory'         or E.url = 'detailed'       return E.value as Coding
    Library NameName
    CCSComponent SDE Race
    define "SDE Race":   SDE."SDE Race"

    Contained resources