Common CQL Assets for FHIR (US-Based)
1.0.0-ballot - STU 1 Ballot United States of America flag

This page is part of the Common CQL Assets for FHIR (US-Based) (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

Home

Official URL: http://hl7.org/fhir/us/cql/ImplementationGuide/hl7.fhir.us.cql Version: 1.0.0-ballot
IG Standards status: Trial-use Maturity Level: 1 Computable Name: CQLUSCommon

Introduction

This implementation guide contains architectural guidance and re-usable libraries that facilitate the use of Clinical Quality Language (CQL) with FHIR in the US Realm, with an initial use case of Prior Authorization Support Questionnaires as described in the DaVinci Documentation Templates and Rules (DTR) implementation guide. Much of the guidance and content presented here is built on work done in the quality measurement domain, including patterns established by measure developers as part of testing and developing quality measures for use with FHIR. These patterns have been generalized to support US Core as well as harmonized to be usable across use cases.

Scope of Use

The intent of this guide is to support the use of CQL with FHIR in the US Realm with a focus on:

  • Providing architectural guidance for the evaluation of CQL expressions in the context of artifacts such as questionnaires, quality measures, and decision support rules.
  • Providing re-usable libraries of CQL expressions to retrieve data for common use cases in the US Realm
  • Providing guidance for managing CQL expressions that may involve retrieval of data from multiple versions of the US Core implementation guide
  • Gathering requirements for tooling to simplify the authoring of questionnaires that use CQL

Out of Scope

This implementation guide does not:

  • Define or mandate the use of any particular subsets of CQL
  • Define functions for the retrieval of simple elements from already retrieved FHIR resources (e.g. Patient.birthDate)
  • Define expectations for certification that require the use of any of the helper libraries provided in this implementation guide

Contents

Acknowledgements

This Implementation Guide was made possible by the thoughtful contributions of the following people and organizations:

  • The DaVinci Project Member Organizations
  • Raj Godavarthi, MCG Health
  • Mike Gould, Zeomega
  • Yan Heras, Optimum eHealth
  • Kyle Johnsen, Epic
  • Crystal Kallem, Point of Care Partners
  • Lloyd McKenzie, Dogwood Consulting
  • Viet Nguyen, HL7
  • Rob Reynolds, Smile Digital Health
  • Brenin Rhodes, Smile Digital Health
  • Bryn Rhodes, Smile Digital Health
  • Raleigh Thompson, Smile Digital Health

Dependencies

Cross Version Analysis

This is an R4 IG. None of the features it uses are changed in R4B, so it can be used as is with R4B systems. Packages for both R4 (hl7.fhir.us.cql.r4) and R4B (hl7.fhir.us.cql.r4b) are available.

Global Profiles

There are no Global profiles defined

IP Statements

This publication includes IP covered under the following statements.