Person-Centered Outcomes (PCO) Implementation Guide
1.0.0-ballot - STU 1 Ballot United States of America flag

This page is part of the Person-Centered Outcomes (PCO) Implementation Guide (v1.0.0-ballot: STU 1 Ballot 1) based on FHIR (HL7® FHIR® Standard) R4. No current official version has been published yet. For a full list of available versions, see the Directory of published versions

Library: GoalIdentificationMeasure

Official URL: http://hl7.org/fhir/us/pco/Library/GoalIdentificationMeasure Version: 1.0.0-ballot
Standards status: Draft Maturity Level: 2 Computable Name: GoalIdentificationMeasure

CQL logic for the Goal Identification Measure

Id: GoalIdentificationMeasure
Version: 1.0.0-ballot
Url: GoalIdentificationMeasure
Status: draft
Type:

system: http://terminology.hl7.org/CodeSystem/library-type

code: logic-library

Date: 2025-03-28 21:02:54+0000
Publisher: HL7 International / Patient Care
Description:

CQL logic for the Goal Identification Measure
Jurisdiction: US
Related Artifacts:

Dependencies
Parameters:
NameTypeMinMaxIn/Out
Measurement PeriodPeriod01In
Follow-Up IntervalRange01In
PatientPatient01Out
Initial PopulationPatient0*Out
DenominatorPatient0*Out
Denominator ExclusionsResource01Out
Denominator ExceptionsResource01Out
NumeratorPatient0*Out
Data Requirements:
TypeProfileMSCode Filter
Patient http://hl7.org/fhir/StructureDefinition/Patient
Observation http://hl7.org/fhir/StructureDefinition/Observation ;;;
Observation http://hl7.org/fhir/StructureDefinition/Observation ; code filter:
path: code
value set: http://hl7.org/fhir/us/pco/ValueSet/goal-attainment-scaling-score
Observation http://hl7.org/fhir/StructureDefinition/Observation ; code filter:
path: code
value set: http://hl7.org/fhir/us/pco/ValueSet/prom-target-measures
Goal http://hl7.org/fhir/StructureDefinition/Goal ;;;;;
CarePlan http://hl7.org/fhir/StructureDefinition/CarePlan ;
Content: text/cql
library GoalIdentificationMeasure version '0.1.0'

using FHIR version '4.0.1'

include FHIRHelpers version '4.4.000' called FHIRHelpers
include PCOCommon version '0.1.0' called PC
include GoalAttainmentLogic version '0.1.0' called PCOLogic

parameter "Measurement Period" Interval<DateTime>
    default Interval[@2024-01-01T00:00:00.000Z, @2024-12-31T23:59:59.999Z]

parameter "Follow-Up Interval" Interval<System.Quantity>
  default Interval[2 weeks, 26 weeks]

context Patient

/*
Goal Identification: % of individuals 18 years of age and older with a complex care need 
who had a PCO goal identified resulting in completion of goal attainment scaling (GAS) 
or a Patient-Reported Outcome Measure (PROM) and development of an action plan.
*/

/*
@description: Includes individuals 18 years of age and older.
*/
define "Initial Population": {
  Patient person
    where AgeInYearsAt(start of "Measurement Period") >= 18
}

/*
@description: Initial Population individuals with a complex care need.
@comment: TODO - How do we determine "complex care need?"
*/
define "Denominator":
  "Initial Population"

define "Denominator Exclusions":
  null

define "Denominator Exceptions":
  null

/* 
... has a PCO goal identified resulting in completion of goal attainment scaling (GAS)
or a Patient-Reported Outcome Measure (PROM) and development of an action plan.
*/
define "Numerator":
  "Denominator" person where
    exists PCOLogic."PCO Goals During Measurement Period"
      and exists PCOLogic."Baseline Scores Before Follow-Up Period"
Content: application/elm+xml
Encoded data (21600 characters)
Content: application/elm+json
Encoded data (38924 characters)