Clinical Quality Language Specification
2.0.0-ballot - R2 STU 1 (Ballot)
Clinical Quality Language Specification
2.0.0-ballot - R2 STU 1 (Ballot)
This page is part of the Clinical Quality Language Specification (v2.0.0-ballot: R2 STU 1) based on FHIR (HL7® FHIR® Standard) R4. This version is a pre-release. The current official version is 1.5.3. For a full list of available versions, see the Directory of published versions
| Page standards status: Informative | Maturity Level: N/A |
Unit tests for Clinical Quality Language functionality are maintained as part of a test suite alongside tooling and reference implementations in the following repository:
These tests were initially published as part of the specification with the intent to informatively demonstrate exhaustive behavior of the specification. Since December of 2023, as part of the Digital Quality Implementers Community, these tests have been the focus of an industry-wide effort to demonstrate consistency of CQL engines by providing a test runner as well as a forum for testing and discussion of results.
The test runner is a simple Node application that makes use of the Using CQL With FHIR implementation guide's $cql operation to support evaluating the tests against any engine that surfaces functionality as a CQL Evaluation Service:
The tests are expressed in a simple XML format describing the expression and its expected outcome.
Some tests cover functionality related to calculation and string representation of times, and are built to be run with an evaluation request timestamp in UTC, to avoid introducing any location dependence to the tests.
Note that this is the same test format used by the FHIRPath specification.
The tests cover the following sections of the specification:
The tests defined here are informative, not normative aspects of the specification. If there is a discrepancy between the behavior of a test and the specification, the specification should be considered the source of truth.