Snapshot 3: Connectathon 32 Base

This is Snapshot #3 for FHIR R5, released to support Connectathon 32. For a full list of available versions, see the Directory of published versions.

Example PlanDefinition/opioidcds-04 (Turtle)

Clinical Decision Support Work GroupMaturity Level: N/AStandards Status: InformativeCompartments: Not linked to any defined compartments

Raw Turtle (+ also see Turtle/RDF Format Specification)

Opioid CDS Recommendation 4 ECA Rule

@prefix fhir: <http://hl7.org/fhir/> .
@prefix owl: <http://www.w3.org/2002/07/owl#> .
@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> .
@prefix sct: <http://snomed.info/id/> .
@prefix xsd: <http://www.w3.org/2001/XMLSchema#> .

# - resource -------------------------------------------------------------------

[a fhir:PlanDefinition;
  fhir:nodeRole fhir:treeRoot;
  fhir:Resource.id [ fhir:value "opioidcds-04"]; # 
  fhir:DomainResource.text [
     fhir:Narrative.status [ fhir:value "generated" ];
     fhir:Narrative.div "<div xmlns=\"http://www.w3.org/1999/xhtml\"><p><b>Generated Narrative: PlanDefinition</b><a name=\"opioidcds-04\"> </a></p><div style=\"display: inline-block; background-color: #d9e0e7; padding: 6px; margin: 4px; border: 1px solid #8da1b4; border-radius: 5px; line-height: 60%\"><p style=\"margin-bottom: 0px\">Resource PlanDefinition &quot;opioidcds-04&quot; </p></div><p><b>url</b>: <code>http://hl7.org/fhir/ig/opioid-cds/PlanDefinition/opioidcds-04</code></p><p><b>identifier</b>: id: urn:oid:2.16.840.1.113883.4.642.11.4, id: cdc-opioid-guidance (use: OFFICIAL)</p><p><b>version</b>: 0.1.0</p><p><b>name</b>: cdc-opioid-04</p><p><b>title</b>: CDC Opioid Prescribing Guideline Recommendation #4</p><p><b>type</b>: ECA Rule <span style=\"background: LightGoldenRodYellow; margin: 4px; border: 1px solid khaki\"> (<a href=\"http://terminology.hl7.org/4.0.0/CodeSystem-plan-definition-type.html\">PlanDefinitionType</a>#eca-rule)</span></p><p><b>status</b>: draft</p><p><b>date</b>: 2018-03-19</p><p><b>publisher</b>: Centers for Disease Control and Prevention (CDC)</p><p><b>description</b>: When starting opioid therapy for chronic pain, clinicians should prescribe immediate-release opioids instead of extended-release/long-acting (ER/LA) opioids.</p><h3>UseContexts</h3><table class=\"grid\"><tr><td>-</td><td><b>Code</b></td><td><b>Value[x]</b></td></tr><tr><td>*</td><td>Clinical Focus (Details: http://terminology.hl7.org/CodeSystem/usage-context-type code focus = 'Clinical Focus', stated as 'Clinical Focus')</td><td>Medication requested (situation) <span style=\"background: LightGoldenRodYellow; margin: 4px; border: 1px solid khaki\"> (<a href=\"https://browser.ihtsdotools.org/\">SNOMED CT</a>#182888003)</span></td></tr><tr><td>*</td><td>Clinical Focus (Details: http://terminology.hl7.org/CodeSystem/usage-context-type code focus = 'Clinical Focus', stated as 'Clinical Focus')</td><td>Chronic pain (finding) <span style=\"background: LightGoldenRodYellow; margin: 4px; border: 1px solid khaki\"> (<a href=\"https://browser.ihtsdotools.org/\">SNOMED CT</a>#82423001)</span></td></tr></table><p><b>jurisdiction</b>: United States of America <span style=\"background: LightGoldenRodYellow; margin: 4px; border: 1px solid khaki\"> (<a href=\"http://terminology.hl7.org/4.0.0/CodeSystem-ISO3166Part1.html\">ISO 3166-1 Codes for the representation of names of countries and their subdivisions — Part 1: Country code</a>#US)</span></p><p><b>purpose</b>: CDC’s Guideline for Prescribing Opioids for Chronic Pain is intended to improve communication between providers and patients about the risks and benefits of opioid therapy for chronic pain, improve the safety and effectiveness of pain treatment, and reduce the risks associated with long-term opioid therapy, including opioid use disorder and overdose. The Guideline is not intended for patients who are in active cancer treatment, palliative care, or end-of-life care.</p><p><b>usage</b>: Providers should use caution when prescribing extended-release/long-acting (ER/LA) opioids as they carry a higher risk and negligible benefit compared to immediate-release opioids.</p><p><b>copyright</b>: © CDC 2016+.</p><p><b>topic</b>: Opioid Prescribing <span style=\"background: LightGoldenRodYellow; margin: 4px; border: 1px solid khaki\"> ()</span></p><p><b>author</b>: Kensaku Kawamoto, MD, PhD, MHS: , Bryn Rhodes: , Floyd Eisenberg, MD, MPH: , Robert McClure, MD, MPH: </p><blockquote><p><b>relatedArtifact</b></p><p><b>type</b>: documentation</p><p><b>display</b>: CDC guideline for prescribing opioids for chronic pain</p></blockquote><blockquote><p><b>relatedArtifact</b></p><p><b>type</b>: documentation</p><p><b>display</b>: MME Conversion Tables</p></blockquote><p><b>library</b>: <a href=\"http://example.org/fhir/Library/opioidcds-recommendation-04\">http://example.org/fhir/Library/opioidcds-recommendation-04</a></p><blockquote><p><b>action</b></p><p><b>title</b>: <span title=\"  non-dynamic card summary  \">Extended-release opioid prescription triggered.</span></p><p><b>description</b>: Checking if the trigger prescription meets the inclusion criteria for recommendation #4 workflow.</p><blockquote><p><b>documentation</b></p><p><b>type</b>: documentation</p></blockquote><h3>Triggers</h3><table class=\"grid\"><tr><td>-</td><td><b>Type</b></td><td><b>Name</b></td></tr><tr><td>*</td><td>named-event</td><td>medication-prescribe</td></tr></table><blockquote><p><b>condition</b></p><p><b>kind</b>: applicability</p><h3>Expressions</h3><table class=\"grid\"><tr><td>-</td><td><b>Description</b></td><td><b>Language</b></td><td><b>Expression</b></td></tr><tr><td>*</td><td>Check whether the opioid prescription for the existing patient is extended-release without any opioids-with-abuse-potential prescribed in the past 90 days.</td><td>text/cql</td><td>Inclusion Criteria</td></tr></table></blockquote><p><b>groupingBehavior</b>: visual-group</p><p><b>selectionBehavior</b>: exactly-one</p><blockquote><p><b>dynamicValue</b></p><p><b>path</b>: action.title</p><h3>Expressions</h3><table class=\"grid\"><tr><td>-</td><td><b>Language</b></td><td><b>Expression</b></td></tr><tr><td>*</td><td>text/cql</td><td>Get Summary</td></tr></table></blockquote><blockquote><p><b>dynamicValue</b></p><p><b>path</b>: action.description</p><h3>Expressions</h3><table class=\"grid\"><tr><td>-</td><td><b>Language</b></td><td><b>Expression</b></td></tr><tr><td>*</td><td>text/cql</td><td>Get Detail</td></tr></table></blockquote><blockquote><p><b>dynamicValue</b></p><p><b>path</b>: activity.extension</p><h3>Expressions</h3><table class=\"grid\"><tr><td>-</td><td><b>Language</b></td><td><b>Expression</b></td></tr><tr><td>*</td><td>text/cql</td><td>Get Indicator</td></tr></table></blockquote><h3>Actions</h3><table class=\"grid\"><tr><td>-</td><td><b>Description</b></td></tr><tr><td>*</td><td>Will precribe immediate release</td></tr><tr><td>*</td><td>Risk of overdose carefully considered and outweighed by benefit; snooze 3 mo</td></tr><tr><td>*</td><td>N/A - see comment; snooze 3 mo</td></tr></table></blockquote></div>"
  ]; # 
  fhir:PlanDefinition.url [ fhir:value "http://hl7.org/fhir/ig/opioid-cds/PlanDefinition/opioidcds-04"]; # 
  fhir:PlanDefinition.identifier [
     fhir:index 0;
     fhir:Identifier.system [ fhir:value "urn:ietf:rfc:3986" ];
     fhir:Identifier.value [ fhir:value "urn:oid:2.16.840.1.113883.4.642.11.4" ]
  ], [
     fhir:index 1;
     fhir:Identifier.use [ fhir:value "official" ];
     fhir:Identifier.value [ fhir:value "cdc-opioid-guidance" ]
  ]; # 
  fhir:PlanDefinition.version [ fhir:value "0.1.0"]; # 
  fhir:PlanDefinition.name [ fhir:value "cdc-opioid-04"]; # 
  fhir:PlanDefinition.title [ fhir:value "CDC Opioid Prescribing Guideline Recommendation #4"]; # 
  fhir:PlanDefinition.type [
     fhir:CodeableConcept.coding [
       fhir:index 0;
       fhir:Coding.system [ fhir:value "http://terminology.hl7.org/CodeSystem/plan-definition-type" ];
       fhir:Coding.code [ fhir:value "eca-rule" ];
       fhir:Coding.display [ fhir:value "ECA Rule" ]
     ]
  ]; # 
  fhir:PlanDefinition.status [ fhir:value "draft"]; # 
  fhir:PlanDefinition.date [ fhir:value "2018-03-19"^^xsd:date]; # 
  fhir:PlanDefinition.publisher [ fhir:value "Centers for Disease Control and Prevention (CDC)"]; # 
  fhir:PlanDefinition.description [ fhir:value "When starting opioid therapy for chronic pain, clinicians should prescribe immediate-release opioids instead of extended-release/long-acting (ER/LA) opioids."]; # 
  fhir:PlanDefinition.useContext [
     fhir:index 0;
     fhir:UsageContext.code [
       fhir:Coding.system [ fhir:value "http://terminology.hl7.org/CodeSystem/usage-context-type" ];
       fhir:Coding.code [ fhir:value "focus" ];
       fhir:Coding.display [ fhir:value "Clinical Focus" ]
     ];
     fhir:UsageContext.valueCodeableConcept [
       fhir:CodeableConcept.coding [
         fhir:index 0;
         a sct:182888003;
         fhir:Coding.system [ fhir:value "http://snomed.info/sct" ];
         fhir:Coding.code [ fhir:value "182888003" ];
         fhir:Coding.display [ fhir:value "Medication requested (situation)" ]
       ]
     ]
  ], [
     fhir:index 1;
     fhir:UsageContext.code [
       fhir:Coding.system [ fhir:value "http://terminology.hl7.org/CodeSystem/usage-context-type" ];
       fhir:Coding.code [ fhir:value "focus" ];
       fhir:Coding.display [ fhir:value "Clinical Focus" ]
     ];
     fhir:UsageContext.valueCodeableConcept [
       fhir:CodeableConcept.coding [
         fhir:index 0;
         a sct:82423001;
         fhir:Coding.system [ fhir:value "http://snomed.info/sct" ];
         fhir:Coding.code [ fhir:value "82423001" ];
         fhir:Coding.display [ fhir:value "Chronic pain (finding)" ]
       ]
     ]
  ]; # 
  fhir:PlanDefinition.jurisdiction [
     fhir:index 0;
     fhir:CodeableConcept.coding [
       fhir:index 0;
       fhir:Coding.system [ fhir:value "urn:iso:std:iso:3166" ];
       fhir:Coding.code [ fhir:value "US" ];
       fhir:Coding.display [ fhir:value "United States of America" ]
     ]
  ]; # 
  fhir:PlanDefinition.purpose [ fhir:value "CDC’s Guideline for Prescribing Opioids for Chronic Pain is intended to improve communication between providers and patients about the risks and benefits of opioid therapy for chronic pain, improve the safety and effectiveness of pain treatment, and reduce the risks associated with long-term opioid therapy, including opioid use disorder and overdose. The Guideline is not intended for patients who are in active cancer treatment, palliative care, or end-of-life care."]; # 
  fhir:PlanDefinition.usage [ fhir:value "Providers should use caution when prescribing extended-release/long-acting (ER/LA) opioids as they carry a higher risk and negligible benefit compared to immediate-release opioids."]; # 
  fhir:PlanDefinition.copyright [ fhir:value "© CDC 2016+."]; # 
  fhir:PlanDefinition.topic [
     fhir:index 0;
     fhir:CodeableConcept.text [ fhir:value "Opioid Prescribing" ]
  ]; # 
  fhir:PlanDefinition.author [
     fhir:index 0;
     fhir:ContactDetail.name [ fhir:value "Kensaku Kawamoto, MD, PhD, MHS" ]
  ], [
     fhir:index 1;
     fhir:ContactDetail.name [ fhir:value "Bryn Rhodes" ]
  ], [
     fhir:index 2;
     fhir:ContactDetail.name [ fhir:value "Floyd Eisenberg, MD, MPH" ]
  ], [
     fhir:index 3;
     fhir:ContactDetail.name [ fhir:value "Robert McClure, MD, MPH" ]
  ]; # 
  fhir:PlanDefinition.relatedArtifact [
     fhir:index 0;
     fhir:RelatedArtifact.type [ fhir:value "documentation" ];
     fhir:RelatedArtifact.display [ fhir:value "CDC guideline for prescribing opioids for chronic pain" ];
     fhir:RelatedArtifact.document [
       fhir:Attachment.url [ fhir:value "https://guidelines.gov/summaries/summary/50153/cdc-guideline-for-prescribing-opioids-for-chronic-pain---united-states-2016#420" ]
     ]
  ], [
     fhir:index 1;
     fhir:RelatedArtifact.type [ fhir:value "documentation" ];
     fhir:RelatedArtifact.display [ fhir:value "MME Conversion Tables" ];
     fhir:RelatedArtifact.document [
       fhir:Attachment.url [ fhir:value "https://www.cdc.gov/drugoverdose/pdf/calculating_total_daily_dose-a.pdf" ]
     ]
  ]; # 
  fhir:PlanDefinition.library [
     fhir:value "http://example.org/fhir/Library/opioidcds-recommendation-04";
     fhir:index 0;
     fhir:link <http://example.org/fhir/Library/opioidcds-recommendation-04>
  ]; # 
  fhir:PlanDefinition.action [
     fhir:index 0;
     fhir:PlanDefinition.action.title [ fhir:value "Extended-release opioid prescription triggered." ]; #    non-dynamic card summary   
     fhir:PlanDefinition.action.description [ fhir:value "Checking if the trigger prescription meets the inclusion criteria for recommendation #4 workflow." ];
     fhir:PlanDefinition.action.documentation [
       fhir:index 0;
       fhir:RelatedArtifact.type [ fhir:value "documentation" ];
       fhir:RelatedArtifact.document [
         fhir:Element.extension [
           fhir:index 0;
           fhir:Extension.url [ fhir:value "http://hl7.org/fhir/StructureDefinition/cqf-strengthOfRecommendation" ];
           fhir:Extension.valueCodeableConcept [
             fhir:CodeableConcept.coding [
               fhir:index 0;
               fhir:Coding.system [ fhir:value "http://terminology.hl7.org/CodeSystem/recommendation-strength" ];
               fhir:Coding.code [ fhir:value "strong" ];
               fhir:Coding.display [ fhir:value "Strong" ]
             ]
           ]
         ], [
           fhir:index 1;
           fhir:Extension.url [ fhir:value "http://hl7.org/fhir/StructureDefinition/cqf-qualityOfEvidence" ];
           fhir:Extension.valueCodeableConcept [
             fhir:CodeableConcept.coding [
               fhir:index 0;
               fhir:Coding.system [ fhir:value "http://terminology.hl7.org/CodeSystem/evidence-quality" ];
               fhir:Coding.code [ fhir:value "low" ];
               fhir:Coding.display [ fhir:value "Low quality" ]
             ]
           ]
         ] #    We can use the example code systems from the FHIR CLinical Reasoning Module, or we can define GRADE specific code systems and use those here   
       ]
     ];
     fhir:PlanDefinition.action.trigger [
       fhir:index 0;
       fhir:TriggerDefinition.type [ fhir:value "named-event" ];
       fhir:TriggerDefinition.name [ fhir:value "medication-prescribe" ]
     ];
     fhir:PlanDefinition.action.condition [
       fhir:index 0;
       fhir:PlanDefinition.action.condition.kind [ fhir:value "applicability" ];
       fhir:PlanDefinition.action.condition.expression [
         fhir:Expression.description [ fhir:value "Check whether the opioid prescription for the existing patient is extended-release without any opioids-with-abuse-potential prescribed in the past 90 days." ];
         fhir:Expression.language [ fhir:value "text/cql" ];
         fhir:Expression.expression [ fhir:value "Inclusion Criteria" ]
       ]
     ];
     fhir:PlanDefinition.action.groupingBehavior [ fhir:value "visual-group" ];
     fhir:PlanDefinition.action.selectionBehavior [ fhir:value "exactly-one" ];
     fhir:PlanDefinition.action.dynamicValue [
       fhir:index 0;
       fhir:PlanDefinition.action.dynamicValue.path [ fhir:value "action.title" ];
       fhir:PlanDefinition.action.dynamicValue.expression [
         fhir:Expression.language [ fhir:value "text/cql" ];
         fhir:Expression.expression [ fhir:value "Get Summary" ]
       ]
     ], [
       fhir:index 1;
       fhir:PlanDefinition.action.dynamicValue.path [ fhir:value "action.description" ];
       fhir:PlanDefinition.action.dynamicValue.expression [
         fhir:Expression.language [ fhir:value "text/cql" ];
         fhir:Expression.expression [ fhir:value "Get Detail" ]
       ]
     ], [
       fhir:index 2;
       fhir:PlanDefinition.action.dynamicValue.path [ fhir:value "activity.extension" ];
       fhir:PlanDefinition.action.dynamicValue.expression [
         fhir:Expression.language [ fhir:value "text/cql" ];
         fhir:Expression.expression [ fhir:value "Get Indicator" ]
       ]
     ]; #    dynamic card detail   
     fhir:PlanDefinition.action.action [
       fhir:index 0;
       fhir:PlanDefinition.action.description [ fhir:value "Will precribe immediate release" ]
     ], [
       fhir:index 1;
       fhir:PlanDefinition.action.description [ fhir:value "Risk of overdose carefully considered and outweighed by benefit; snooze 3 mo" ]
     ], [
       fhir:index 2;
       fhir:PlanDefinition.action.description [ fhir:value "N/A - see comment; snooze 3 mo" ]
     ] #    Open Order Set, where available   
  ]] . # 

# - ontology header ------------------------------------------------------------

[a owl:Ontology;
  owl:imports fhir:fhir.ttl] .

# -------------------------------------------------------------------------------------


Usage note: every effort has been made to ensure that the examples are correct and useful, but they are not a normative part of the specification.