Difference between revisions of "Library FHIR Resource Proposal"
Bryn rhodes (talk | contribs) |
Bryn rhodes (talk | contribs) |
||
| (8 intermediate revisions by 2 users not shown) | |||
| Line 3: | Line 3: | ||
<div style="float: left;">[[Image:OpenHotTopic.GIF|35px| ]]</div> | <div style="float: left;">[[Image:OpenHotTopic.GIF|35px| ]]</div> | ||
<div style="background:#F0F0F0"> | <div style="background:#F0F0F0"> | ||
| − | This page documents a [[:category:Pending FHIR Resource Proposal| | + | This page documents a [[:category:Pending FHIR Resource Proposal|Approved]] [[:category:FHIR Resource Proposal|FHIR Resource Proposal]] |
</div> | </div> | ||
</div> | </div> | ||
[[Category:FHIR Resource Proposal]] | [[Category:FHIR Resource Proposal]] | ||
| − | [[Category: | + | [[Category:Approved FHIR Resource Proposal]] |
| Line 27: | Line 27: | ||
--> | --> | ||
| − | The Library resource | + | The Library resource is a general purpose container for clinical knowledge that is defined using a non-FHIR representation. For example, a shareable library of clinical logic, written in Clinical Quality Language (CQL), or the XML Schema for an information model. In addition to representing the metadata of the library, the resource has elements for tracking dependencies, as well as for representing the parameters and data requirements for any expression functionality provided by the library. |
| + | |||
| + | The actual content of the library is represented using the RelatedResource data type, which may reference a FHIR Resource, or an Attachment, which is either referenced with a url, or embedded as a base-64 encoded string. Either way, the contentType element of the attachment is used to indicate the representation of the library content. | ||
| + | |||
| + | The intent of the resource is to establish a standard mechanism to enable the sharing of clinical knowledge content that is not represented in FHIR resources. It is used throughout the clinical reasoning module to allow CQL to be referenced and incorporated into clinical artifacts. | ||
==Owning committee name== | ==Owning committee name== | ||
[[Clinical_Decision_Support_Workgroup|Clinical Decision Support Work Group]] | [[Clinical_Decision_Support_Workgroup|Clinical Decision Support Work Group]] | ||
| + | |||
| + | ==Committee Approval Date:== | ||
| + | * 2016-02-24 - [http://wiki.hl7.org/index.php?title=File:2016-02-24_CDS_WG_Call_Minutes.docx Meeting Minutes] | ||
| + | * STU3 Ballot Submission: 2016-08-03 | ||
==Contributing or Reviewing Work Groups== | ==Contributing or Reviewing Work Groups== | ||
| Line 41: | Line 49: | ||
==FHIR Resource Development Project Insight ID== | ==FHIR Resource Development Project Insight ID== | ||
| − | [http://www.hl7.org/Special/committees/dss/projects.cfm?action=edit&ProjectNumber= | + | [http://www.hl7.org/Special/committees/dss/projects.cfm?action=edit&ProjectNumber=1234 1234: FHIR-Based Clinical Quality Framework (CQF-on-FHIR)] |
==Scope of coverage== | ==Scope of coverage== | ||
| Line 55: | Line 63: | ||
As a rule, resources should encompass all of these aspects. | As a rule, resources should encompass all of these aspects. | ||
--> | --> | ||
| + | |||
| + | A Library is a knowledge artifact that enables automated sharing of non-FHIR-based clinical knowledge. Because it is definitional in nature, it is not a patient-specific resource. The resource describes metadata and content and is flexible enough to be used for any discipline and locale. It is intended to be used by decision support and quality improvement content providers as a means of distributing computable representations of clinical logic, as well as by health care delivery and reporting systems as a means of automtically integrating clinical logic. | ||
| + | |||
| + | Although Library resources are capable of being used independently (to distribute shared logic, for example), they will often be packaged with other knowledge artifacts such as ActivityDefinition, PlanDefinition, and Measure. | ||
==RIM scope== | ==RIM scope== | ||
| Line 74: | Line 86: | ||
* Have the characteristics of high cohesion & low coupling – need to explore whether coupling is good some places, not elsewhere – layers from Bo’s document | * Have the characteristics of high cohesion & low coupling – need to explore whether coupling is good some places, not elsewhere – layers from Bo’s document | ||
--> | --> | ||
| + | |||
| + | Clinical quality measurement and improvement is a broad domain encompassing many aspects of overall healthcare. From decision support services and functionality to quality measurement and reporting, all these aspects make extensive use of logic to describe behavior and reasoning. Several existing HL7 Standards make use of Clinical Quality Language to represent this logic in various knowledge artifacts, and enabling that content to be published as a FHIR resource will extend the reach of that content. In addition, defining a general purpose Library resource will enable another potential role of a FHIR server as a Knowledge Repository. | ||
==Expected implementations== | ==Expected implementations== | ||
<!--Key resources are justified by CCDA, for resources not deemed "key", what interest is there by implementers in using this particular resource. Provide named implementations if possible - ideally provide multiple independent implementations. --> | <!--Key resources are justified by CCDA, for resources not deemed "key", what interest is there by implementers in using this particular resource. Provide named implementations if possible - ideally provide multiple independent implementations. --> | ||
| + | |||
| + | Multiple decision support and quality measurement content providers have expressed interest in using the Library resource to enable standards-based distribution of Clinical Quality Language libraries. | ||
==Content sources== | ==Content sources== | ||
| Line 94: | Line 110: | ||
<!-- Provide a listing of the types of scenarios to be represented in the examples produced for this resource. They should demonstrate the full scope of the resource and allow exercising of the resources capabilities (full element coverage, inclusion & omission of optional elements, repeating and singleton repeating elements, etc.) --> | <!-- Provide a listing of the types of scenarios to be represented in the examples produced for this resource. They should demonstrate the full scope of the resource and allow exercising of the resources capabilities (full element coverage, inclusion & omission of optional elements, repeating and singleton repeating elements, etc.) --> | ||
| + | |||
| + | ===Exclusive Breastfeeding=== | ||
| + | Numerous studies document the benefits of exclusive breastfeeding for the first six months of life. A quality measure (CMS9v4) has been developed to attempt to determine the extent to which exclusive breastfeeding takes place. This measure has been translated into CQL and several derived decision support rules have been developed with the intention of ensuring that appropriate education regarding the benefits of exclusive breastfeeding is provided to all new mothers. In combination with the Measure and DecisionSupportRule resources, this codified clinical knowledge can be distributed to and integrated in various healthcare delivery systems to support improved outcomes for this guideline. | ||
| + | |||
| + | This scenario is a focus of the CQF-on-FHIR track at the September 2016 connectathon. | ||
==Resource Relationships== | ==Resource Relationships== | ||
| Line 105: | Line 126: | ||
Reference to resources is really only relevant at the "same or higher level" (Bo – fix this wording) | Reference to resources is really only relevant at the "same or higher level" (Bo – fix this wording) | ||
--> | --> | ||
| + | |||
| + | The Library resource is used by the following resources: | ||
| + | |||
| + | * [http://hl7-fhir/github.io/activitydefinition.html ActivityDefinition] | ||
| + | * [http://hl7-fhir/github.io/plandefinition.html PlanDefinition] | ||
| + | * [http://hl7-fhir/github.io/measure.html Measure] | ||
| + | |||
| + | In addition, the resource makes use of the following common data types: | ||
| + | |||
| + | * [http://hl7.org/fhir/2016Sept/parameterdefinition.html ParameterDefinition] | ||
| + | * [http://hl7.org/fhir/2016Sept/datarequirement.html DataRequirement] | ||
==Timelines== | ==Timelines== | ||
<!-- Indicate the target date for having the resource complete from a committee perspective and ready for vetting and voting --> | <!-- Indicate the target date for having the resource complete from a committee perspective and ready for vetting and voting --> | ||
| + | |||
| + | September 2016 Ballot Cycle in support of the [http://hl7.org/fhir/2016Sept/cqif/cqif.html CQF IG]. | ||
==gForge Users== | ==gForge Users== | ||
<!-- Identify the userids who will require commit access to gForge to maintain the resource. (Ensure all users have registered for gForge.) --> | <!-- Identify the userids who will require commit access to gForge to maintain the resource. (Ensure all users have registered for gForge.) --> | ||
| − | |||
brynrhodes | brynrhodes | ||
Latest revision as of 14:52, 21 August 2017
This page documents a Approved FHIR Resource Proposal
Contents
- 1 Library
- 1.1 Owning committee name
- 1.2 Committee Approval Date:
- 1.3 Contributing or Reviewing Work Groups
- 1.4 FHIR Resource Development Project Insight ID
- 1.5 Scope of coverage
- 1.6 RIM scope
- 1.7 Resource appropriateness
- 1.8 Expected implementations
- 1.9 Content sources
- 1.10 Example Scenarios
- 1.11 Resource Relationships
- 1.12 Timelines
- 1.13 gForge Users
Library
The Library resource is a general purpose container for clinical knowledge that is defined using a non-FHIR representation. For example, a shareable library of clinical logic, written in Clinical Quality Language (CQL), or the XML Schema for an information model. In addition to representing the metadata of the library, the resource has elements for tracking dependencies, as well as for representing the parameters and data requirements for any expression functionality provided by the library.
The actual content of the library is represented using the RelatedResource data type, which may reference a FHIR Resource, or an Attachment, which is either referenced with a url, or embedded as a base-64 encoded string. Either way, the contentType element of the attachment is used to indicate the representation of the library content.
The intent of the resource is to establish a standard mechanism to enable the sharing of clinical knowledge content that is not represented in FHIR resources. It is used throughout the clinical reasoning module to allow CQL to be referenced and incorporated into clinical artifacts.
Owning committee name
Clinical Decision Support Work Group
Committee Approval Date:
- 2016-02-24 - Meeting Minutes
- STU3 Ballot Submission: 2016-08-03
Contributing or Reviewing Work Groups
- Clinical Quality Information Work Group
- FHIR Management Group
- Service Oriented Architecture Work Group
FHIR Resource Development Project Insight ID
1234: FHIR-Based Clinical Quality Framework (CQF-on-FHIR)
Scope of coverage
A Library is a knowledge artifact that enables automated sharing of non-FHIR-based clinical knowledge. Because it is definitional in nature, it is not a patient-specific resource. The resource describes metadata and content and is flexible enough to be used for any discipline and locale. It is intended to be used by decision support and quality improvement content providers as a means of distributing computable representations of clinical logic, as well as by health care delivery and reporting systems as a means of automtically integrating clinical logic.
Although Library resources are capable of being used independently (to distribute shared logic, for example), they will often be packaged with other knowledge artifacts such as ActivityDefinition, PlanDefinition, and Measure.
RIM scope
Resource appropriateness
Clinical quality measurement and improvement is a broad domain encompassing many aspects of overall healthcare. From decision support services and functionality to quality measurement and reporting, all these aspects make extensive use of logic to describe behavior and reasoning. Several existing HL7 Standards make use of Clinical Quality Language to represent this logic in various knowledge artifacts, and enabling that content to be published as a FHIR resource will extend the reach of that content. In addition, defining a general purpose Library resource will enable another potential role of a FHIR server as a Knowledge Repository.
Expected implementations
Multiple decision support and quality measurement content providers have expressed interest in using the Library resource to enable standards-based distribution of Clinical Quality Language libraries.
Content sources
- Clinical Quality Common Metadata Conceptual Model
- Clinical Decision Support Knowledge Artifact Specification
- Clinical Quality Language
- Health Quality Measure Format
- Decision Support Service
- Decision Support Service Implementation Guide
Example Scenarios
Exclusive Breastfeeding
Numerous studies document the benefits of exclusive breastfeeding for the first six months of life. A quality measure (CMS9v4) has been developed to attempt to determine the extent to which exclusive breastfeeding takes place. This measure has been translated into CQL and several derived decision support rules have been developed with the intention of ensuring that appropriate education regarding the benefits of exclusive breastfeeding is provided to all new mothers. In combination with the Measure and DecisionSupportRule resources, this codified clinical knowledge can be distributed to and integrated in various healthcare delivery systems to support improved outcomes for this guideline.
This scenario is a focus of the CQF-on-FHIR track at the September 2016 connectathon.
Resource Relationships
The Library resource is used by the following resources:
In addition, the resource makes use of the following common data types:
Timelines
September 2016 Ballot Cycle in support of the CQF IG.
gForge Users
brynrhodes
