Clinical Practice Guidelines, published by HL7 International / Clinical Decision Support. This guide is not an authorized publication; it is the continuous build for version 2.0.0 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/HL7/cqf-recommendations/ and changes regularly. See the Directory of published versions
Related Artifacts
Parameters
Patient | out | 0 | 1 | Patient |
Medication Order | out | 0 | * | MedicationRequest |
Inclusion Criteria | out | 0 | 1 | boolean |
Active or Completed Medication Statement | out | 0 | * | MedicationStatement |
Medication Statement Not Taken | out | 0 | * | MedicationStatement |
Document Proposal | out | 0 | * | Task |
Document Proposal Rejected | out | 0 | * | Task |
Is Recommendation Applicable | out | 0 | 1 | boolean |
Data Requirements
Contents
text/cql
library DocumentMedication
using FHIR version '4.0.1'
include FHIRHelpers version '4.0.1'
codesystem "Activity Type": 'http://hl7.org/fhir/uv/cpg/CodeSystem/cpg-activity-type-cs'
code "Document medication": 'document-medication' from "Activity Type"
context Patient
/* Recommendation to document an existing order for a medication */
/*
Positive recommendation:
If the medication has been ordered but has not been documented
Propose documenting the medication
Given a proposal, the user can:
Accept the proposal
Ignore the proposal
Reject the proposal without reason
Reject the proposal with reason
Scenario 1: No event, no request, decision support should propose
Scenario 2: No event, active proposal, decision support should not propose
Scenario 3: No event, rejected proposal, decision support should not propose
Scenario 4: Event, no proposal, decision support should not propose
Scenario 5: Event, active proposal, decision support should not propose
Scenario 6: Event not done, no proposal, decision support should not propose
Scenario 7: Event not done, proposal, decision support should not propose
*/
define "Inclusion Criteria":
Patient.active
and exists ("Medication Order")
define "Active or Completed Medication Statement":
[MedicationStatement] M
where M.status in { 'active', 'completed', 'intended', 'on-hold' }
define "Medication Statement Not Taken":
[MedicationStatement] M
where M.status in { 'not-taken', 'stopped' } // TODO: Is 'stopped' appropriate here?
define "Medication Order":
[MedicationRequest] M
where M.status in { 'draft', 'active', 'on-hold', 'completed' }
and M.intent = 'order'
and M.doNotPerform is not true
define "Document Proposal":
[Task] R
where R.code ~ "Document medication"
and R.status in { 'draft', 'requested', 'received', 'accepted', 'ready' }
and doNotPerform(R) is not true
define "Document Proposal Rejected":
[Task] R
where R.code ~ "Document medication"
and R.status in { 'rejected' }
and doNotPerform(R) is not true
define "Is Recommendation Applicable":
"Inclusion Criteria"
and not exists (
"Active or Completed Medication Statement"
union "Medication Statement Not Taken"
)
and not exists (
"Document Proposal"
union "Document Proposal Rejected"
)
define function doNotPerform(task Task):
singleton from (
task.modifierExtension E
where E.url = 'http://hl7.org/fhir/StructureDefinition/request-doNotPerform'
).value as boolean
Content not shown - (
application/elm+xml
, size = 39Kb )
Content not shown - (
application/elm+json
, size = 72Kb )