Common CQL Assets for FHIR (US-Based)
1.0.0-ballot - STU 1 Ballot
This page is part of the Common CQL Assets for FHIR (US-Based) (v1.0.0-ballot: STU 1 Ballot 1) based on FHIR (HL7® FHIR® Standard) R4. No current official version has been published yet. For a full list of available versions, see the Directory of published versions
Page standards status: Informative |
The inclusion and support of the Prior Authorization Questionnaire use case in this implementation guide is made possible by the thoughtful contribution of the Da Vinci member organizations.
The following links provide general background information about prior-authorization scenarios:
This topic is focused on how CQL is used to support this use case.
The questionnaire examples and associated libraries for population expressions in this IG are expected to be used in the following data flow:
As described in the Documentation Templates and Rules (DTR) implementation guide, the DTR process can be used for a broad range of use cases, including launching from a Coverage Requirements Discovery (CRD) response, as well as requesting documents as described in the Relationship to Clinical Data Exchange topic.
This diagram is a simplification of the overall DTR Overview Sequence Diagram. This diagram is focusing on the interactions from the perspective of Clinical Quality Language (CQL) authoring and evaluation.
Structured Data Capture (SDC) documents the use of several extensions for supporting CQL-based calculation and form behavior within a Questionnaire in the Form Behavior and Calculation topic.
In addition, the DTR specification provides additional guidance and conformance requirements on the use of CQL within DTR Questionnaires in the Use of CQL topic.
The content and questionnaires in this IG are expected to already have resolved the question of coverage determination, and are focused on a particular individual represented as a Patient. If prior authorization is not required then the DTR process will not occur.
Following the above data flow, there are two key contexts in which CQL expressions may be used to populate questionnaire responses:
Note: Implementations of $questionnaire-package may pre-populate elements of the QuestionnaireResponse; however, how that pre-population occurs payer-side is out of scope from both the CRD and DTR perspectives.
As part of the process of filling out a DTR questionnaire, the DTR application may use CQL expressions specified in the Questionnaire to evaluate the context data to determine the initial value for items in the QuestionnaireResponse.
CQL used in this operation:
patient
and a type of Patient
, and thereby established as the Patient context for the CQL expressions specified in the Questionnaire. It would be the responsibility of the DTR application to reconcile such launch contexts.sdc-questionnaire-launchContext
extension with a name of encounter
and a type of Encounter
, and thereby passed as a named parameter to CQL expressions specified in the Questionnaire.sdc-questionnaire-launchContext
extension with a name of PrimaryCoverage
and a type of Coverage
, and thereby passed as a named parameter to CQL expressions specified in the Questionnaire.Generally, the SDC Initial Expression extension will be used to pre-populate a given item in the QuestionnaireResponse. This is how CQL expressions are specified in the Questionnaire.
Additionally, the SDC Item Population Context extension can be used with a CQL expression to provide context when populating group items (i.e. group items whose sub-items are populated with the values of sub-elements of a value with multiple elements (e.g. HumanName, Address, or BackboneElement)).
While a user is filling out the answers to a questionnaire, the DTR application may use CQL expressions specified in the questionnaire to control form behavior (such as enableWhen logic or calculation logic).