Clinical Quality Language (CQL) is an HL7 specification for the expression of clinical knowledge that can be used within both the Clinical Decision Support (CDS) and Clinical Quality Measurement (CQM) domains. This repository contains complementary tooling in support of that specification.
While looking at the ELM of CMS130FHIR-v0.1.000 from the January 2024 Connectathon bundles, we noticed a peculiar translation of a retrieve on MedicationRequest.
The AdvancedIllnessandFrailty 1.8.000 CQL Library has the following define statement:
define "Has Dementia Medications in Year Before or During Measurement Period":
exists (( ([MedicationRequest: "Dementia Medications"]).isMedicationActive()) DementiaMedication
where DementiaMedication.doNotPerform is not true and
CMD."MedicationRequestPeriod" ( DementiaMedication ) overlaps day of Interval[start of "Measurement Period" - 1 year,
end of "Measurement Period"]
In this define statement the [MedicationRequest: "Dementia Medications"] appears to be translated into ELM with extra logic to handle MedicationRequests which reference a Medication resource to grab the actual code for the medication.
[MedicationRequest: "Dementia Medications"]
union ([MedicationRequest] MR
with [Medication] M
such that M.id = Last(Split(MR.medication.reference, '/')) and code in "Dementia Medications")
There is a bit of a bug here that would prevent it from working in the case of referencing a Medication. The InValueSet expression seen towards the end of the ELM snippet compares against a Property expression that does not have a scope or source defined. This would not return any value or error out and will not be able to compare the Medication type. This should have a scope of M. Making the equivalent CQL M.code in "Dementia Medication"
There is also a concern with the efficiency of this logic. It currently is asking for EVERY MedicationRequest and with each MedicationRequest it is asking for EVERY Medication and then looking for the one with the matching id. Since we know the referenced id it could be used to directly fetch the Medication resource with the id field of the Retrieve expression. There doesn't appear to be a way do do this in CQL at the moment.
While looking at the ELM of CMS130FHIR-v0.1.000 from the January 2024 Connectathon bundles, we noticed a peculiar translation of a retrieve on
MedicationRequest.The AdvancedIllnessandFrailty 1.8.000 CQL Library has the following define statement:
In this define statement the
[MedicationRequest: "Dementia Medications"]appears to be translated into ELM with extra logic to handle MedicationRequests which reference a Medication resource to grab the actual code for the medication.In CQL this looks like:
There is a bit of a bug here that would prevent it from working in the case of referencing a Medication. The InValueSet expression seen towards the end of the ELM snippet compares against a Property expression that does not have a
scopeorsourcedefined. This would not return any value or error out and will not be able to compare the Medication type. This should have ascopeofM. Making the equivalent CQLM.code in "Dementia Medication"There is also a concern with the efficiency of this logic. It currently is asking for EVERY
MedicationRequestand with eachMedicationRequestit is asking for EVERYMedicationand then looking for the one with the matchingid. Since we know the referencedidit could be used to directly fetch theMedicationresource with theidfield of the Retrieve expression. There doesn't appear to be a way do do this in CQL at the moment.