Clinical Practice Guidelines
2.0.0-ballot - ballot International flag

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-ballot built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of and changes regularly. See the Directory of published versions

Version History

This page details changes made in each version of the Clinical Guidelines implementation guide.

STU2 Ballot (version 2.0.0-ballot)

This ballot of the Clinical Guidelines implementation guides incorporates feedback that has been received during the trial-use implementation period. Feedback from production implementations of clinical reasoning capability as well as multiple content development projects covering various aspects of computable guideline content development and implementation has been included.

Major changes include:

  • Removed Shareable/Publishable/Executable profiles and referenced the CRMI IG for those capabilities instead (see Profiles)
  • Removed the Using CQL and Libraries conformance requirements and referenced the Using CQL with FHIR IG for those capabilities instead (see Libraries)
  • Detailed descriptions of activity flow (see Activity Flow)
  • Recommend an Immunization activity now uses MedicationRequest
  • Added L1 checklist from GIN-NA working group (see L1 Checklist)
  • Moved most example IGs to cqframework (see Examples)

The following sections detail the changes that were applied for this ballot.

  • Applied: Add extensions to identify the packaging and testing tooling for an artifact(FHIR-25741)
  • Applied: Better definitions for each activity(FHIR-38743)
  • Applied: Add support for specifying CQL options in CQL/ELM libraries and projects(FHIR-32672)
  • Applied: Add a CPG Packaging Like the Measure Packaging Operation(FHIR-35796)
  • Applied: Ability to specify supported CQL versions(FHIR-32676)
  • Applied: Add guidance on when available ELM can be used(FHIR-40486)
  • Applied: Add description of types of artifacts(FHIR-26607)
  • Applied: Unable to file issues against 1.0 version in HL7 JIRA(FHIR-40964)
  • Applied: Add more detailed description of activity flow(FHIR-43074)
  • Applied: ImmunizationRecommendation example does not point at meta.profile(FHIR-34350)
  • Applied: Change Immunization action(FHIR-40298)
  • Applied: Refactor to use CRMI profiles(FHIR-42973)

In addition, the implementation guide source was completely updated to run on the latest IG publication tooling, which included numerous typographical and technical corrections throughout.

STU1 Publication (version 1.0.0)

J#23945: Changed protocol and workflow to pathway and strategy definitions J#24177: Improved activity catalog J#24087: Moved recommendation-specific extensions to recommendation definition J#26612: Defined shareable, computable, publishable, and executable knowledge capabilities and profiles J#23954: Added support for case features J#27154: Formalized $cql and Library/$evaluate operations J#27151: Removed rating extensions from instance profiles J#23951: Formalized strategy behavior J#23952: Formalized case behavior J#23960: Formalized care plan behavior J#26875: Relaxed url requirement in related artifacts J#23968: Formalized request proposal/plan/order behavior J#23964: Formalized eligibility and enrollment behavior J#24163: Added testing and packaging support and documentation J#24161: Clarified rating systems conformance requirements J#23956: Formalized metric behavior J#23959: Added support for clinical impressions J#23957: Added case summary support J#23963: Added case plan summary support J#23958: Added case plan progressing note support J#23949: Completed examples for all activity types J#24221: Formalized activity processing semantics J#24217: Formalized triggering behavior J#23940: Added patient safety discussion to conformance page J#24165: Added Development/methodology documentation and walkthroughs J#24236: Added a complete example for Congestive Heart Failure pathway J#24227: Updated narratives for examples throughout J#24156: Updated topic binding to preferred for all artifact types J#30007: Support for images in questionnaire questions and answers J#26885: Formalized conformance requirements for input and output of CQL libraries J#26621: Clarified conformance requirements for Library resolution and naming/namespacing J#24150: Separated examples vs artifacts and provided index for both J#23991: Added a glossary of key terms J#24223: Added history of attempts to background section J#23948: Reorganized overall guide content and navigation

In addition, numerous corrections and clarifications were made throughout, as well as substantial expansion of approach and methodology documentation. Refer to the HL7 JIRA for a complete description of changes applied to the 1.0.0 version.

STU1 Ballot (version 0.1.0)

The initial ballot combines experience gained from multiple guideline representation projects, including Opioid Prescribing Support, Chronic Kidney Disease Management, Antenatal Care, HIV/HBV Screening, Prevention, and Treatment, and Immunization Decision Support.