Quality Measure Implementation Guide
1.0.0-ballot - ballot International flag

Quality Measure Implementation Guide, published by HL7 International / Clinical Quality Information. This guide is not an authorized publication; it is the continuous build for version 1.0.0-ballot built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/HL7/cqf-measures/ and changes regularly. See the Directory of published versions

Profiles

Capability Profiles

To define the exchange expectations for measure and library artifacts at different points along the content lifecycle, this implementation guide uses four general categories of profiles, aligned with those established by the Canonical Resource Management Infrastructure (CRMI) implementation guide:

  • Shareable - Define the minimum expectations for systems that exchange measure and library artifacts
  • Computable - Define elements that are important for the computable representation of a measure (i.e. design-time characteristics and authoring-level concerns)
  • Publishable - Define elements that are relevant for publishing and distribution concerns
  • Executable - Define elements that are important for the run-time and implementation-level concerns

Measure Profiles

Measure profiles supported in this IG are defined to allow for use independently or in combination with each other to support a wide range of use cases. The diagram depicts these capability profiles and their relationships to the profiles defined in CRMI and the Using CQL With FHIR IGs:

Figure 7-1: Measure Profiles Relationship Diagram

profile-diagram.png

Capability Profile Description
Shareable CRMIShareableMeasure The shareable measure profile defines minimal expectations for exchanging a measure.
Computable CQFMComputableMeasure The computable measure profile defines the elements and constraints that are required to represent the calculation of a measure score, regardless of the specific language used to communicate the criteria expressions
Publishable CQFMPublishableMeasure The publishable measure profile defines the expectations and constraints for metadata associated with formal publication of a measure specification.
Executable CQFMExecutableMeasure The executable measure profile defines the elements that are required to support execution of a measure in an implementation environment.

In addition to conforming to profiles to support appropriate function or representation, measures are required to conform to the appropriate measure profile based on their scoring type:

Scoring TypeProfile
CohortCQFMCohortMeasure
ProportionCQFMProportionMeasure
RatioCQFMRatioMeasure
Continuous VariableCQFMContinuousVariableMeasure
CompositeCQFMCompositeMeasure
AttestationCQFMAttestationMeasure

As well, the profiles are designed to separate communication of the computable aspects from the specific expression language used to communicate criteria. This implementation guide supports specification of expression criteria using Clinical Quality Language (CQL) and Expression Logical Model (ELM) (i.e. compiled CQL), but other expression languages could be used with this IG if desired:

LanguageProfile
CQLCQLMeasure
ELMELMMeasure

Library Profile Usage

This implementation guide makes use of Library resources in two ways:

  1. As the container for computable and/or executable representations of expression logic used as criteria in quality measure specifications.
  2. As a manifest for communicating the information required to make use of a set of measure specifications, including dependency and version information.

Logic Library Profile Usage

This implementation guide does not introduce any new logic library profiles, but makes use of library profiles defined in the Canonical Resource Management Infrastructure and Using CQL With FHIR implementation guides:

Shareable Computable Publishable Executable
CRMIShareableLibrary CRMIComputableLibrary CRMIPublishableLibrary CRMIExecutableLibrary

For measures that use Clinical Quality Language to represent expression logic, the following profiles are used:

Shareable Computable Publishable Executable
N/A CQLLibrary N/A ELM JSON Library
ELM XML Library

Manifest Library Profile Usage

Shareable Publishable
CRMIShareableLibrary CRMIPublishableLibrary
CRMIManifestLibrary

Terminology Profile Usage

This implementation guide does not introduce any new terminology profiles, but makes use of terminology profiles defined in the Canonical Resource Management Infrastructure implementation guide:

Artifact Shareable Computable Publishable Executable
CodeSystem CRMIShareableCodeSystem N/A (no requirements) CRMIPublishableCodeSytems N/A (no requirements)
ValueSet CRMIShareableValueSet CRMIComputableValueSet CRMIPublishableValueSet CRMIExpandedValueSet
  • Note that due to the varying terminology capabilities of target environments, terminology profiles do not necessarily correspond to the capabilities of the measure and library resources. For example, a Computable measure package may include both Computable and Expanded value set resources, depending on the expected capabilities of the target environment with respect to each code system involved.

Additional Profiles

To support packaging, testing, and distribution of measure and library artifacts, this implementation guide defines the following additional profiles:

Profile Description
CRMISoftwareSystemDevice A software device used in the creation, validation, evaluation, packaging, and/or testing of a library or measure artifact.
CRMIManifestLibrary Used to establish a set of measures together with the version information for code system and value sets referenced by those measures. See the Manifest topic for more information.
CQFMTestCase A measure report profile that allows definition and exchange of test cases for a measure.

Alphabetical Listing

See the Artifact Index - Structures: Resource Profiles for an alphabetical index of profiles defined in this implementation guide.