This wiki has undergone a migration to Confluence found Here
<meta name="googlebot" content="noindex">

Difference between revisions of "Guidance Response FHIR Resource Proposal"

From HL7Wiki
Jump to navigation Jump to search
(Created page with "{{subst::Template:FHIR Resource Proposal}}")
 
 
(6 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|Pending]] [[:category:FHIR Resource Proposal|FHIR Resource Proposal]]
+
This page documents a [[:category:Approved FHIR Resource Proposal|Approved]] [[:category:FHIR Resource Proposal|FHIR Resource Proposal]]
 
</div>
 
</div>
 
</div>
 
</div>
 
[[Category:FHIR Resource Proposal]]
 
[[Category:FHIR Resource Proposal]]
[[Category:Pending FHIR Resource Proposal]]
+
[[Category:Approved FHIR Resource Proposal]]
  
  
 
<!-- For additional guidance on considerations for resource creation, refer to [[FHIR Resource Considerations]] -->
 
<!-- For additional guidance on considerations for resource creation, refer to [[FHIR Resource Considerations]] -->
  
 
+
=GuidanceResponse=
=PutProposedResourceNameHere=
 
  
 
<!-- Resource names should meet the following characteristics:
 
<!-- Resource names should meet the following characteristics:
Line 26: Line 25:
 
* Be consistent with other similar resources
 
* Be consistent with other similar resources
 
  -->
 
  -->
 +
 +
The GuidanceResponse resource provides a container to describe the results of a particular evaluation of a decision support artifact. It is used to capture the results of the _evaluate_ operation of both the DecisionSupportRule and DecisionSupportServiceModule resources.
 +
 +
In addition to describing the results of a decision support invocation, the resource supports the implementation of a conversational interface between decision support consumers and providers, allowing the provider to indicate that more data is required in order to achieve a correct evaluation, or that more data is requested in order to obtain a potentially more accurate result. This interface pattern supports a broad variety of decision support use cases, as well as enabling dynamic tuning of payload sizes to facilitate real-time clinical decision support.
 +
 +
The resource is derived from both the [http://www.hl7.org/implement/standards/product_brief.cfm?product_id=337 HL7 Standard: Clinical Decision Support Knowledge Artifact Specification] (specifically the _Action_ component) and the [http://www.hl7.org/implement/standards/product_brief.cfm?product_id=12 HL7 Version 3 Standard: Decision Support Service (DSS), Release 2].
  
 
==Owning committee name==
 
==Owning committee name==
  
<!-- The name of the committee that is proposed to have responsibility for developing and maintaining the resources. -->
+
[[Clinical_Decision_Support_Workgroup|Clinical Decision Support Work Group]]
[[YourCommitteeName]]
+
 
 +
==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==
  
<!-- Additional work groups that may have an interest in contributing to, or reviewing  the content of the resource (optional) -->
+
*[[Clinical_Quality_Information_Work_Group|Clinical Quality Information Work Group]]
* Work Group Name
+
*[[FHIR_Management_Group|FHIR Management Group]]
* or link
+
*[[Service_Oriented_Architecture|Service Oriented Architecture Work Group]]
* or "None"
 
  
 
==FHIR Resource Development Project Insight ID==
 
==FHIR Resource Development Project Insight ID==
  
<!-- Please specify the id of your work group’s PSS for doing FHIR work.  (If submitted but not yet approved, just write “pending”.) The link to the PSS template can be found here: http://gforge.hl7.org/gf/download/docmanfileversion/6832/9398/HL7FHIR_DSTUballotPSS-20120529.doc -->
+
[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 62:
 
As a rule, resources should encompass all of these aspects.
 
As a rule, resources should encompass all of these aspects.
 
  -->
 
  -->
 +
 +
A GuidanceResponse is a structured representation of the result of an invocation of the _evaluate_ operation of both the DecisionSupportRule and DecisionSupportServiceModule resources. As with those resources, the GuidanceResponse is flexible enough to be used to describe behaviors for a broad range of decision support applications and could potentially be used in any discipline and locale. It is intended to be used by Decision Support Service Provides as part of the public interface for their service definition.
  
 
==RIM scope==
 
==RIM scope==
  
 
<!-- Identify the formal RIM mapping for the root concept of the resource.  The expectation is that the RIM mapping will be sufficiently precise so as to not overlap with any other resource definition. -->
 
<!-- Identify the formal RIM mapping for the root concept of the resource.  The expectation is that the RIM mapping will be sufficiently precise so as to not overlap with any other resource definition. -->
 +
 +
<!-- I do not believe there is a direct counterpart for this resource in the RIM. -->
  
 
==Resource appropriateness==
 
==Resource appropriateness==
Line 74: Line 85:
 
* 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  
 
  -->
 
  -->
 +
 +
Decision Support Services are a critical aspect of healthcare delivery with numerous products in the space, both as stand-alone quality improvement services, as well as built-in rule-engine deployments within EHRs.
 +
 +
The Decision Support Service Specification defines a standard, production-level mechanism for exposing a decision support service, and enabling that mechanism to be realized as FHIR resources and operations will extend the reach of that standard, as well as allow implementers to use the FHIR stack and all its associated tooling and specifications to expose the content, effectively enabling another potential role of a FHIR server as a Decision Support Service.
  
 
==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. -->
 +
 +
In addition to general interest from the Clinical Quality and Decision Support communities, the CQF initiative has several pilot projects in various phases of completion:
 +
 +
[http://wiki.siframework.org/Clinical+Quality+Framework+Pilots Clinical Quality Framework Pilots]
  
 
==Content sources==
 
==Content sources==
Line 84: Line 103:
  
 
Are there any source specifications that you wish to consult but are concerned about access to or expertise to consider? -->
 
Are there any source specifications that you wish to consult but are concerned about access to or expertise to consider? -->
 +
 +
*[http://www.hl7.org/implement/standards/product_brief.cfm?product_id=391 Clinical Quality Common Metadata Conceptual Model]
 +
*[http://www.hl7.org/implement/standards/product_brief.cfm?product_id=337 Clinical Decision Support Knowledge Artifact Specification]
 +
*[http://www.hl7.org/implement/standards/product_brief.cfm?product_id=12 Decision Support Service]
 +
*[http://www.hl7.org/implement/standards/product_brief.cfm?product_id=334 Decision Support Service Implementation Guide]
 +
*[http://www.hl7.org/implement/standards/product_brief.cfm?product_id=208 Infobutton Specification]
 +
*[http://www.hl7.org/implement/standards/product_brief.cfm?product_id=22 Infobutton Implementation Guide]
 +
*[http://www.hl7.org/implement/standards/product_brief.cfm?product_id=283 SOA Infobutton Implementation Guide]
  
 
==Example Scenarios==
 
==Example Scenarios==
  
 
<!-- 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.) -->
 +
 +
See the example scenarios for the [http://wiki.hl7.org/index.php?title=DecisionSupportServiceModule_FHIR_Resource_Proposal DecisionSupportServiceModule] and [http://wiki.hl7.org/index.php?title=DecisionSupportRule_FHIR_Resource_Proposal DecisionSupportRule] resource proposals.
 +
 +
This resource was tested as part of the January 2016 Connectathon CDS-on-FHIR track, and will be used to support the CQF-on-FHIR track at the May 2016 Connectathon.
  
 
==Resource Relationships==
 
==Resource Relationships==
Line 99: Line 130:
 
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)
 
  -->
 
  -->
 +
 +
Each GuidanceResponse will reference a single [http://hl7.org/fhir/2016May/decisionsupportrule.html DecisionSupportRule] or [http://hl7.org/fhir/2016May/decisionsupportservicemodule.html DecisionSupportServiceModule] to identify the artifact describing the guidance being returned.
 +
 +
The resource uses the [http://hl7.org/fhir/2016May/operationoutcome.html OperationOutcome] resource to describe any warning or informational messages returned by the service as part of a successful evaluation.
 +
 +
The resource uses the [http://hl7.org/fhir/2016May/parameters.html Parameters] resource to communicate any specific output parameters returned by the service.
 +
 +
In addition, the resource makes use of the following common data types:
 +
 +
* [http://hl7.org/fhir/2016May/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 -->
 +
 +
May 2016 Ballot Cycle in support of the [http://hl7.org/fhir/2016May/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

Latest revision as of 14:52, 21 August 2017


GuidanceResponse

The GuidanceResponse resource provides a container to describe the results of a particular evaluation of a decision support artifact. It is used to capture the results of the _evaluate_ operation of both the DecisionSupportRule and DecisionSupportServiceModule resources.

In addition to describing the results of a decision support invocation, the resource supports the implementation of a conversational interface between decision support consumers and providers, allowing the provider to indicate that more data is required in order to achieve a correct evaluation, or that more data is requested in order to obtain a potentially more accurate result. This interface pattern supports a broad variety of decision support use cases, as well as enabling dynamic tuning of payload sizes to facilitate real-time clinical decision support.

The resource is derived from both the HL7 Standard: Clinical Decision Support Knowledge Artifact Specification (specifically the _Action_ component) and the HL7 Version 3 Standard: Decision Support Service (DSS), Release 2.

Owning committee name

Clinical Decision Support Work Group

Committee Approval Date:

Contributing or Reviewing Work Groups

FHIR Resource Development Project Insight ID

1234: FHIR-Based Clinical Quality Framework (CQF-on-FHIR)

Scope of coverage

A GuidanceResponse is a structured representation of the result of an invocation of the _evaluate_ operation of both the DecisionSupportRule and DecisionSupportServiceModule resources. As with those resources, the GuidanceResponse is flexible enough to be used to describe behaviors for a broad range of decision support applications and could potentially be used in any discipline and locale. It is intended to be used by Decision Support Service Provides as part of the public interface for their service definition.

RIM scope

Resource appropriateness

Decision Support Services are a critical aspect of healthcare delivery with numerous products in the space, both as stand-alone quality improvement services, as well as built-in rule-engine deployments within EHRs.

The Decision Support Service Specification defines a standard, production-level mechanism for exposing a decision support service, and enabling that mechanism to be realized as FHIR resources and operations will extend the reach of that standard, as well as allow implementers to use the FHIR stack and all its associated tooling and specifications to expose the content, effectively enabling another potential role of a FHIR server as a Decision Support Service.

Expected implementations

In addition to general interest from the Clinical Quality and Decision Support communities, the CQF initiative has several pilot projects in various phases of completion:

Clinical Quality Framework Pilots

Content sources

Example Scenarios

See the example scenarios for the DecisionSupportServiceModule and DecisionSupportRule resource proposals.

This resource was tested as part of the January 2016 Connectathon CDS-on-FHIR track, and will be used to support the CQF-on-FHIR track at the May 2016 Connectathon.

Resource Relationships

Each GuidanceResponse will reference a single DecisionSupportRule or DecisionSupportServiceModule to identify the artifact describing the guidance being returned.

The resource uses the OperationOutcome resource to describe any warning or informational messages returned by the service as part of a successful evaluation.

The resource uses the Parameters resource to communicate any specific output parameters returned by the service.

In addition, the resource makes use of the following common data types:

Timelines

May 2016 Ballot Cycle in support of the CQF IG.

gForge Users

brynrhodes