Situational Awareness for Novel Epidemic Response
1.0.1 - CI Build International flag

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 SourceMeasure ConsumerMeasure ComputerData SourceCompute 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 ComputerData SourceMeasure SourceMeasure Consumer1. Compute Measure2. Search FHIR Resources3. Search Response4. Report Measure5. 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.