{ "resourceType": "OperationDefinition", "id": "report", "text": { "status": "extensions", "div": "

Report

OPERATION: Report

The official URL for this operation definition is: 

http://hl7.org/fhir/us/davinci-ra/OperationDefinition/report

Generate a measure report

\n

URL: [base]/MeasureReport/$report

Parameters

UseNameCardinalityTypeBindingDocumentation
INperiodStart1..1date

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.

\n
INperiodEnd1..1date

The end of a clinical evaluation period.

\n
INsubject1..1string
(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.

\n
OUTreturn0..*Bundle

The $report 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.parameterelements, with each Parameters.parameter for a unique patient.

\n
OUToutcome0..*OperationOutcome

If subject is a patient and the patient is not found on the Server, or if subject is a Group and the group is not found on the Server, then the $report returns a Parameters.parameter with an OperationOutcome. If subject is a Group, the group is valid but one or more patients within the Group can not be found on the Server, then the $report returns a separate Parameters.parameter with an OperationOutcome for each of the invalid patients. For example, if a Group has 10 patients and two of the patients cannot be found on the Server, then the $report returns a Parameters resource containing 10 parameter elements (two parameter elements containing OperationOutcome for the two invalid patients and eight parameter elements containing Risk Adjustment Coding Gap Report Bundle for the eight valid patients).

\n
" }, "url": "http://hl7.org/fhir/us/davinci-ra/OperationDefinition/report", "version": "1.0.0", "name": "Report", "title": "Report Operation", "status": "active", "kind": "operation", "date": "2022-06-16T14:25:19+00:00", "publisher": "HL7 Clinical Quality Information Work Group", "contact": [ { "name": "HL7 Clinical Quality Information Work Group", "telecom": [ { "system": "url", "value": "http://www.hl7.org/Special/committees/cqi" } ] } ], "description": "Generate a measure report", "jurisdiction": [ { "coding": [ { "system": "urn:iso:std:iso:3166", "code": "US", "display": "United States of America" } ] } ], "code": "report", "resource": [ "MeasureReport" ], "system": false, "type": true, "instance": false, "parameter": [ { "name": "periodStart", "use": "in", "min": 1, "max": "1", "documentation": "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](StructureDefinition-ra-measurereport.html) available on the Server. The MeasureReport will be returned if there is an overlap of the two periods.", "type": "date" }, { "name": "periodEnd", "use": "in", "min": 1, "max": "1", "documentation": "The end of a clinical evaluation period.", "type": "date" }, { "name": "subject", "use": "in", "min": 1, "max": "1", "documentation": "Subject will be a reference to either Patient ([US Core Patient](http://hl7.org/fhir/us/core/STU3.1.1/StructureDefinition-us-core-patient.html)) or Group ([Patient Group](StructureDefinition-ra-patient-group.html)). 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.", "type": "string", "searchType": "reference" }, { "name": "return", "use": "out", "min": 0, "max": "*", "documentation": "The $report operation will always return one [Parameters](https://www.hl7.org/fhir/parameters.html) whether the subject is a single patient or a group of patients. [Risk Adjustment Coding Gap Report Bundle](StructureDefinition-ra-measurereport-bundle.html) 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](https://www.hl7.org/fhir/parameters.html) will contain 10 `Parameters.parameter`elements, with each `Parameters.parameter` for a unique patient.", "type": "Bundle" }, { "name": "outcome", "use": "out", "min": 0, "max": "*", "documentation": "If subject is a patient and the patient is not found on the Server, or if subject is a Group and the group is not found on the Server, then the $report returns a `Parameters.parameter` with an [OperationOutcome](https://www.hl7.org/fhir/operationOutcome.html). If subject is a Group, the group is valid but one or more patients within the Group can not be found on the Server, then the $report returns a separate `Parameters.parameter` with an OperationOutcome for each of the invalid patients. For example, if a Group has 10 patients and two of the patients cannot be found on the Server, then the $report returns a Parameters resource containing 10 `parameter` elements (two `parameter` elements containing OperationOutcome for the two invalid patients and eight `parameter` elements containing [Risk Adjustment Coding Gap Report Bundle](StructureDefinition-ra-measurereport-bundle.html) for the eight valid patients).", "type": "OperationOutcome" } ] }