Situational Awareness for Novel Epidemic Response, published by HL7 International / Public Health. This guide is not an authorized publication; it is the continuous build for version 1.0.1 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/HL7/fhir-saner/ and changes regularly. See the Directory of published versions
Compute Measure
This section describes the COMPUTE-MX of this guide. This transaction is used by the Measure Source, Measure Consumer, Measure Computer and Data Source actors.
Scope
The Compute Measure transaction describes the behavior of the Measure Computer actor in periodically computing
and reporting on measures.
This transaction enables automatic computing of measure reports and manual retriggering of report generation for
diagnostics or error recovery.
Actors Roles
Measure Source Measure Consumer Measure Computer Data Source Compute Measure
Figure 2.4-1: Compute Measure Use Case Diagram
Table 2.4-1: Actor Roles
|Actor|Role|
|—-|—-|
|Measure Source ||
|Measure Consumer ||
|Measure Computer |Pull data for, computes and reports a measure.|
|Data Source |Responds to queries for data used to compute measures or collect supplemental data.|
Referenced Standards
Table 3.71.3-1: Referenced Standards
|Standard|Name|
|—|—|
|FHIR-R4|HL7 FHIR Release 4.0 |
|RFC-7230|Hypertext Transfer Protocol - HTTP/1.1 |
|NDJSON|Newline Delimited JSON |
Interactions
Measure Computer Data Source Measure Source Measure Consumer 1. Compute Measure 2. Search FHIR Resources 3. Search Response 4. Report Measure 5. Query Measure
Figure 2.4-2: Compute Measure Interactions
#### Compute Measure
The Measure Computer computes the measure report for the current reporting period.
##### Trigger Event - Reporting Period Elapsed
The current reporting period has elapsed, or the operation is triggered by automation (e.g. for manual testing, diagnostics or error recovery).
See the [Reporting Period](StructureDefinition-ReportingPeriod.html) extension.
##### Message Semantics
The Measure Computer prepares a Measure Report.
##### Expected Actions
###### Compute Measure
When the reporting period has elapsed, or the operation is externally triggered, a MeasureReport for the specified Measure is computed from available data and the grouped MeasureSource is invoked below to store the created or updated MeasureReport resource
#### Search FHIR Resources
##### Trigger Event - Data Query
Data is needed to compute a measure.
##### Message Semantics
The Measure Computer sends a query using an HTTP GET or POST to a Data Source supporting the [FHIR Search](https://www.hl7.org/fhir/search.html) capabilities using an appropriate national implementation guide.
##### Expected Actions
###### Search for Data
Measure Computer requests data from a Data Source.
The Measure Computer performs a FHIR Search operation to retrieve the selected resources.
#### Search Response
The Data Source returns the requested data.
##### Trigger Event - Resources have been requested by a Measure Computer.
##### Message Semantics
The Data Source responds with requested resources.
The resources will conform to the profiles specified in a national or regional Implementation Guide
##### Expected Actions
###### Returns Matching Resources
The Data Source returns the requested resources.
#### Report Measure
The Measure Computer reports the newly computed measure for the current reporting period.
##### Trigger Event - MeasureReport Available
A new MeasureReport resource is available for reporting.
##### Message Semantics
The Measure Computer reports the computed result via the grouped MeasureSource actor.
##### Expected Actions
###### Send MeasureReport Resource
The MeasureSource stores the MeasureReport by creating or updating it on the MeasureConsumer
###### Accept MeasureReport Resource
The MeasureConsumer processes the MeasureReport given in the create/update interaction.
#### Query Measure
The Measure Computer responds to a query for a Measure Report with the newly computed report for the current reporting period.
##### Trigger Event - MeasureReport Requested
The Measure Consumer has requested measure reports with criteria matching the newly created report.
##### Message Semantics
The Measure Computer reports the computed result via the grouped MeasureSource actor.
##### Expected Actions
###### Store MeasureReport Resource
The MeasureSource stores the MeasureReport and is prepared to respond to queries for the MeasureReport resource by the MeasureConsumer
###### Query for MeasureReport Resource
The MeasureConsumer queries for the MeasureReport from the MeasureSource
### Conformance
See the following CapabilityStatement resources for conformance requirements:
* [CapabilityStatement-MeasureComputer-ComputeMeasure](CapabilityStatement-MeasureComputer-ComputeMeasure.html) Defines the requirements for the Measure Computer implementing the Compute Measure transaction.
* [CapabilityStatement-DataSource-ComputeMeasure](CapabilityStatement-DataSource-ComputeMeasure.html) Defines the requirements for the Data Source implementing the Compute Measure transaction.