Using CQL with FHIR
1.0.0 - STU1 International flag

Using CQL with FHIR, published by HL7 International / Clinical Decision Support. This guide is not an authorized publication; it is the continuous build for version 1.0.0 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/HL7/cql-ig/ and changes regularly. See the Directory of published versions

Example Parameters: Example Type Mapping Evaluation Result Parameters

Parameters

Patient

Patient/example

Generated Narrative: Patient

Resource Patient "example"

identifier: Medical record number/12345 (use: usual, period: 2001-05-06 --> (ongoing))

active: true

name: Peter James Chalmers (Official), Jim Chalmers , Peter James Windsor (Name changed for Marriage)

telecom: ph: (03) 5555 6473(WORK), ph: (03) 3410 5613(MOBILE), ph: (03) 5555 8834(OLD)

gender: male

birthDate: 1974-12-25

deceased: false

address: 534 Erewhon St PeasantVille, Utah 84414(home)

maritalStatus: Married (MaritalStatus#M)

Contacts

-RelationshipNameTelecomAddressGenderPeriod
*Next-of-Kin (contactRole2#N)Bénédicte du Marché +33 (237) 998327534 Erewhon St PleasantVille VT 3999 (home)female2012 --> (ongoing)
CQLBooleanExampletrue
CQLCodeExampleCQL IG Example Code System example-code: Example Code
CQLCodeSystemExampleCQL IG Example Code System
CQLConceptExampleExample Code
CQLDateExample2024-01-01
CQLDateTimeExample2024-01-01 10:30:00+0000
CQLDecimalExample10.0
CQLLongExample10
CQLIntegerExample10
CQLQuantityExample10 mg
CQLRatioExampleNo display for Ratio
CQLStringExampleJohn
CQLTimeExample10:30:00
CQLValueSetExampleExample Specific health concern(s) Codes
CQLVocabularyExamplehttp://example.org/test/npe-preventer
CQLDateIntervalExample2024-01-01 --> 2024-01-31
CQLDateTimeIntervalExample2024-01-01 10:30:00+0000 --> 2024-01-31 10:30:00+0000
CQLTimeIntervalExample
 low10:30:00
 high11:30:00
CQLIntegerIntervalExample5-10
CQLQuantityIntervalExample5-10
CQLListExample1
CQLListExample2
CQLListExample3
CQLListExample4
CQLListExample5
CQLTupleExample
 X1
 Y1
CQLChoiceListExample1
CQLChoiceListExample1.0
CQLTupleListExample
 X1
 Y1
CQLTupleListExample
 X1
 Y2
CQLTupleListExample
 X1
 Y3
CQLComplexTupleExample
 id1
 namePatrick
 address
 street123 Spinning Ave
 cityDayton
 stateOH
CQLComplexTupleListExample
 id1
 namePatrick
 address
 street123 Spinning Ave
 cityDayton
 stateOH
CQLEmptyListExample
FHIRBooleanExampletrue
FHIRStringExampleChalmers
FHIRQuantityExample76.0 mg/dL
FHIRPeriodExample1974-12-25 --> (ongoing)
FHIRRangeExample40.0-109.0 mg/dL
FHIRObservationExample

Observation/blood-glucose

Generated Narrative: Observation

Resource Observation "blood-glucose"

status: final

category: Laboratory (Observation Category Codes#laboratory)

code: Glucose Bld-mCnc (LOINC#2339-0)

subject: See on this page: Patient/example: Amy Shaw

effective: 2005-07-05

value: 76.0 mg/dL

ReferenceRanges

-LowHighAppliesTo
*40.0 mg/dL (Details: UCUM code mg/dL = 'mg/dL')109.0 mg/dL (Details: UCUM code mg/dL = 'mg/dL')Normal Range (Observation Reference Range Meaning Codes#normal)
FHIRObservationListExample

Observation/blood-glucose

Generated Narrative: Observation

Resource Observation "blood-glucose"

status: final

category: Laboratory (Observation Category Codes#laboratory)

code: Glucose Bld-mCnc (LOINC#2339-0)

subject: See on this page: Patient/example: Amy Shaw

effective: 2005-07-05

value: 76.0 mg/dL

ReferenceRanges

-LowHighAppliesTo
*40.0 mg/dL (Details: UCUM code mg/dL = 'mg/dL')109.0 mg/dL (Details: UCUM code mg/dL = 'mg/dL')Normal Range (Observation Reference Range Meaning Codes#normal)
FHIRObservationListExample

Observation/blood-pressure

Generated Narrative: Observation

Resource Observation "blood-pressure"

status: final

category: Vital Signs (Observation Category Codes#vital-signs)

code: Blood pressure systolic and diastolic (LOINC#85354-9 "Blood pressure panel with all children optional")

subject: See on this page: Patient/example: Amy Shaw

encounter: : GP Visit

effective: 1999-07-02

component

code: Systolic blood pressure (LOINC#8480-6)

value: 109 mmHg (Details: UCUM code mm[Hg] = 'mm[Hg]')

component

code: Diastolic blood pressure (LOINC#8462-4)

value: 44 mmHg (Details: UCUM code mm[Hg] = 'mm[Hg]')

FHIRObservationListExample

Observation/bmi

Generated Narrative: Observation

Resource Observation "bmi"

status: final

category: Vital Signs (Observation Category Codes#vital-signs)

code: BMI (LOINC#39156-5 "Body mass index (BMI) [Ratio]")

subject: See on this page: Patient/example: Amy Shaw

encounter: : GP Visit

effective: 1999-07-02

value: 16.2 kg/m2 (Details: UCUM code kg/m2 = 'kg/m2')

FHIRObservationEmptyListExample