Da Vinci Risk Adjustment Implementation Guide
2.0.0-ballot - STU2 Ballot

Publication Build: This will be filled in by the publication tooling

## OperationDefinition: Evaluate Measure

Official URL: http://hl7.org/fhir/us/davinci-ra/OperationDefinition/ra.evaluate-measure | Version: 2.0.0-ballot
Draft as of 2023-03-28 | Computable Name: RAEvaluateMeasure
Copyright/Legal: Used by permission of HL7 International - Clinical Quality Information Work Group, all rights reserved Creative Commons License

The ra.evaluate-measure operation is used to evaluate Digital Condition Category and obtain the results.

The $ra.evaluate-measure is DRAFT and open for review.

This operation executes digital condition category (dCC) measures specified in Clinical Quality Language (CQL) against the patient data to produce a Risk Adjustment Coding Gap Report Bundle. Patient data, dCC measures, and CQL libraries are pre-populated on FHIR server.

Conformance Requirement 1:

- If the operation is invoked at the instance level, the parameters `measureId`, `measureIdentifier`, and `measureUrl` is not allowed
- If the operation is invoked at the type level, one of the `measureId`, `measureIdentifier`, and `measureUrl` parameters is required

URL: [base]/Measure/$ra.evaluate-measure

URL: [base]/Measure/[id]/$ra.evaluate-measure

Parameters

Use | Name | Scope | Cardinality | Type | Binding | Documentation
IN | periodStart |  | 1..1 | date |  | The start of a clinical evaluation period. The periodStart and periodEnd parameters will be compared with the clinical evaluation period (`MeasureReport.period.start` and `MeasureReport.period.end`) of a Risk Adjustment Coding Gap MeasureReport available on the Server. The MeasureReport will be returned if there is an overlap of the two periods.
IN | periodEnd |  | 1..1 | date |  | The end of a clinical evaluation period.
IN | subject |  | 1..1 | string (reference) |  | Subject will be a reference to either Patient (US Core Patient) or Group (Patient Group). Must provide either Patient/123 or Group/123, cannot simply provide 123. If only 123 is provided, then the operation would not know if it is a Patient reference or a Group reference.
IN | measureId |  | 0..* | id |  | The id of a Measure resource for risk adjustment model, e.g., CMS HCC v24
IN | measureIdentifier |  | 0..* | string (token) |  | The business identifier of a Measure resource for risk adjustment model, e.g., CMS HCC v24.
IN | measureUrl |  | 0..* | canonical |  | This the URL of a Measure resource for risk adjustment model, e.g., CMS HCC v24
OUT | return |  | 0..1 | Bundle |  | The $ra.evaluate-measure operation will always return one Parameters whether the subject is a single patient or a group of patients. Risk Adjustment Coding Gap Report Bundle for a patient is in a `Parameters.parameter` element. A Risk Adjustment Coding Gap Report Bundle contains the Risk Adjustment Coding Gap Reports for the same patient. For example, if a Group has 10 valid patients, then a Parameters will contain 10 `Parameters.parameter`elements, with each `Parameters.parameter` for a unique patient.