Da Vinci - Documentation Templates and Rules
2.1.0 - STU 2.1 United States of America flag

Da Vinci - Documentation Templates and Rules, published by HL7 International / Clinical Decision Support. This guide is not an authorized publication; it is the continuous build for version 2.1.0 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/HL7/davinci-dtr/ and changes regularly. See the Directory of published versions

Reading this IG

Page standards status: Informative

Underlying Technologies

This guide is based on the HL7 FHIR standard, the US Core 3.1.1 and 6.1 Implementation Guides, as well as the SMART on FHIR, Clinical Quality Language (CQL), and Structured Data Capture (SDC) specifications which build additional capabilities on top of FHIR. This architecture is intended to maximize the number of provider systems that conform to this guide, as well as to allow for easy growth and extensibility of system capabilities in the future.

Implementers of this specification therefore need to understand some basic information about these specifications.

FHIR

This IG uses terminology, notations, and design principles that are specific to FHIR. It's important to be familiar with some of the basic principles of FHIR as well as general guidance on how to read FHIR specifications. Readers who are unfamiliar with FHIR are encouraged to read the following prior to reading the rest of this IG.

This IG supports the R4 version of the FHIR standard.

This IG leverages and builds on the US Core 3.1.1, 6.1, and 7.0 IGs defined by HL7 for sharing human EHR data in the US. Implementers need to familiarize themselves with the profiles in US Core, as well as the underlying Structured Data Capture (SDC) profiles being used.

FHIR Version: FHIR R4 (4.0.1)
US Core: Release 7.0
Release 6.1
Release 3.1.1
Profiles: Standard Questionnaire
Adaptive Questionnaire
QuestionnaireResponse
Task (PAS)


Other resources may also be accessed as part of the CQL rules.

This IG also draws on content from the Davinci Health Record Exchange (HRex) and Structured Data Capture (SDC) implementation guides.

Implementers should also familiarize themselves with the FHIR resources used within the guide:

Resource Relevance
Bundle Used when delivering collections of resources for Questionnaires and also used for queries
CapabilityStatement Used to define conformance expectations for this guide
CodeSystem Used to define custom codes specific to this guide
Coverage Used to identify the member and the relevant insurance coverage to a payer
Library Used to encapsulate the necessary CQL returned by the Questionnaire Package operation
OperationDefinition Used to define the necessary operations in this guide
Parameters Supporting information for the input and output for operations
Patient Demographic information relevant to all requests
Practitioner Used when identifying providers in Encounters, Tasks, and all requests
Questionnaire Used to support the question structure to be answered
QuestionnaireResponse Used to support the capture of answers to a corresponding Questionnaire
SearchParameter Used in finding QuestionnaireResponses that contain information relevant to a particular appointment, encounter or order
ServiceRequest One of the resources that can be involved in DTR context
StructureDefinition Used when profiling resource and defining extensions
ValueSet Used to define collections of codes used by DTR profiles

US Core Implementation Guide

Implementers will need the knowledge of US Core 3.1.1, 6.1, and 7.0 IGs to access information for pre-population via CQL calls to 21st Century compliant FHIR APIs. Some of the implementations will need to support US Core requirements. (Refer to the CapabilityStatements.)

SMART on FHIR and Native Applications

Guidance is being provided to allow DTR functionality to be invoked outside of regular EHR clinical workflows using a SMART on FHIR app or an EHR-based "Native" app to provide a consistent way of evaluating payer rules and documentation requirements across EHR implementations. As such client implementers creating a SMART App will also need to be familiar with the SMART on FHIR specification. (Payer implementers only need to be familiar with the SMART on FHIR specification if they plan to develop SMART apps for launch by CDS Hooks or other purposes.)

In some cases, staff may wish to invoke DTR in a "what-if" scenario based on recommendations/plans for an upcoming visit. Such recommendations might be from decision support (such as ImmunizationRecommendation or a CarePlan with an intent of 'proposed') or from standard protocols (e.g., "this patient is due for a pap smear"). In such cases, the EHR can support automated generation of 'draft' requests based on the descision support or protocol resources and use them when invoking DTR.

CQL

Clinical Quality Language (CQL) is used to query the Electronic Health Record (EHR) FHIR server to pre-populate the DTR Questionnaire and may also be used to guide which questions need to be answered. DTR Servers will need to construct Questionnaires containing CQL references and CQL libraries that perform the necessary logic. DTR clients will need to be able to execute the proved CQL.

Architectural approach

This IG leverages several architectural to FHIR data exchange:

  • RESTful access from SMART app to EHR data and storage of QuestionnaireResponses
  • Operation for next question
  • Operation to retrieve the Questionnaire packages from payers
  • Operation to submit errors related to the Questionnaire packages retrieved

The choice of using REST to access and store data from the SMART app is driven by the SMART on FHIR architecture.

The choice of using operations for $next-question for adaptive forms was made by the SDC implementation guide.

The decision tree navigation in the HRex Approaches to Exchanging Data decision tree that led to these approaches where decisions needed to be made as part of DTR are as follows:

Access to payer Questionnaire package -

  • Data retrieval is initiated by the consumer (SMART app/EHR).
  • The app/EHR will have a direct connection to the payer – there is required to be a single defined endpoint for the payer. Any routing will be behind the scenes.
  • No human intervention in return of data.
  • CDS Hooks doesn’t make sense given that the calls aren’t really decision support for a user action.
  • Data is not necessarily pre-existing. The questionnaire could be assembled on the fly based on context.
  • There’s no need for routing. This isn’t a standard message or operation. This must be synchronous. In the end, choose the ‘lighter’ approach which is an operation.

Reporting of Questionnaire issues -

  • Data sharing is initiated by a data source (EHR or app that has found the Questionnaire issue).
  • The transmission of the data isn’t configured by the payer – polling or subscription wouldn’t really work.
  • The app/EHR will have a direct connection to the payer – there is required to be a single defined endpoint for the payer. Any routing will be behind the scenes.
  • The data source doesn’t control how (or if) the reported error is stored.