US Situational Awareness Framework for Reporting (US SAFR) Implementation Guide
1.0.0 - STU 1 ballot United States of America flag

US Situational Awareness Framework for Reporting (US SAFR) Implementation Guide, published by HL7 International / Public Health. This guide is not an authorized publication; it is the continuous build for version 1.0.0 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/HL7/us-safr/ and changes regularly. See the Directory of published versions

Artifacts Summary

This page provides a list of the FHIR artifacts defined as part of this implementation guide.

Behavior: Capability Statements

The following artifacts define the specific capabilities that different types of systems are expected to have in order to comply with this implementation guide. Systems conforming to this implementation guide are expected to declare conformance to one or more of the following capability statements.

US SAFR Data Aggregator CapabilityStatement

This statement defines the expected capabilities of a system that aggregates data from multiple Data Source actors before measure evaluation and then plays the role of a Data Source once aggregation is complete. An example would be a state public health agency aggregating data from all facilities in the state before using those data to produce a MeasureReport containing bed capacity data for the entire state. When FHIR enabled, a Data Aggregator acts as a US Core Server when playing the role of a Data Source after aggregation. During aggregation, the Data Aggregator acts similar to the SANER options for aggregation, but implements its own CapabilityStatement due to the incompatibilities between DEQM and SANER.

US SAFR Data Evaluation Engine CapabilityStatement

This statement defines the expected capabilities of a system that retrieves data from the Data Source and evaluates those data against one or more measures retrieved from the Measure Source. The resulting MeasureReport bundle and related resources are then sent to the MeasureReport recipient. The Measure Evaluation Engine acts as a US Core Client, a DEQM Reporter Client, and implements the $evaluation-measure operation.

Note: FHIR queries are not always required. In the case, an EHR retrieves data from it’s own internal data store using non-FHIR methods or imports data from other systems that are not FHIR-enabled.

US SAFR Data Source CapabilityStatement

This statement defines the expected capabilities of a system containing data (typically patient data, but could be situational awareness data) that will be evaluated against one or more measures. This may be a FHIR server, an EHR with a FHIR endpoint (facade), an internal data store when the Data Source and Measure Evaluation Engine actors are played by the same system such as an EHR that does it’s own measure evaluation, or it may be a system containing other data such as situational awareness data that is reporting via CSV or other format. When FHIR enabled, the Data Source acts as a US Core Server.

Note: US Core Server is only needed for external evaluation engines. Examples of where this is not needed, is an EHR querying it’s own data source using proprietary data access methods.

US SAFR Measure Source CapabilityStatement

This statement defines the expected capabilities of a system at NHSN, federal and jurisdictional Public Health Agencies including State, Tribal, Local and Territorial (STLT) Health Departments that stores FHIR resources such as Measure, Library, ValueSet, etc. that are used for Measure Reporting. The Measure Evaluation Engine queries the Measure Source for the latest Measure content before querying the Patient Data Source and performing measure evaluation. The Measure Source acts as a CQFM Publishable Measure Repository.

US SAFR MeasureReport Recipient CapabilityStatement

This statement defines the expected capabilities of a system at NHSN, federal and jurisdictional Public Health Agencies including State, Tribal, Local and Territorial (STLT) Health Departments that receives MeasureReport bundles from the Measure Evaluation Engine and validates the result against the profiles in this implementation guide, and potentially other measure-specific profiles that are distributed with the measures themselves. The MeasureReport Recipient acts as a DEQM Receiver Server, provides write access to Bundle resources containing MeasureReport and other related resources, and implements the $validate operation.

Knowledge Artifacts: Measure

These define measures as part of content in this implementation guide.

Bed Capacity

Bed Capacity Measure includes counts of specific bed types within the context of a given healthcare context or setting.

Knowledge Artifacts: Libraries

These define logic, asset collections and other libraries as part of content in this implementation guide.

BedCapacityMeasure

Structures: Resource Profiles

These define constraints on FHIR resources for systems conforming to this implementation guide.

US SAFR Measure Bundle

This profile defines a Bundle provided by the MeasureServer containing a Measure resource and enables the inclusion of all related resources (ValueSet, Library, etc.).

If this fails, use the following FHIRPath expression to discover missing resources: Bundle.entry.resource.descendants().reference.where($this.startsWith(‘#’).not()).where((%resource.entry.fullUrl.join(‘|’)&’|’).contains(($this&’|’)).not())

US SAFR Measure Report Bundle

This profile defines a valid submission bundle to NHSN, federal and jurisdictional Public Health Agencies including State, Tribal, Local and Territorial (STLT) Health Departments with all resources contained within. The Bundle is comprised of entry slices representing the data submitting organization, submitting device, and individual MeasureReports.

If this fails, use the following FHIRPath expression to discover missing resources: Bundle.entry.resource.descendants().reference.where($this.startsWith(‘#’).not()).where((%resource.entry.fullUrl.join(‘|’)&’|’).contains(($this&’|’)).not())

US SAFR Submitting Organization

This profile includes the name and identifier of the organization submitting the report Bundle, and may include other information about the organization.

Terminology: Code Systems

These define new code systems used by systems conforming to this implementation guide.

Healthcare Bed Capacity Reporting Code System

This CodeSystem defines coded concepts for Healthcare Capacity reporting to US SAFR. This is an example CodeSystem and is experimental, and is expected to be replaced by LOINC codes once they have been assigned.

Healthcare Bed Capacity Reporting Group Code System

This CodeSystem defines coded concepts for Healthcare Capacity Group reporting to US SAFR. This is an example CodeSystem and is experimental, and is expected to be replaced by LOINC codes once they have been assigned.

Hospital Respiratory Data Reporting Code System

This CodeSystem defines coded concepts for Hospital Respiratory Data reporting for US SAFR IG. This is an example CodeSystem and is experimental, and is expected to be replaced by LOINC codes once they have been assigned.

Hospital Respiratory Data Supply Days Code System

This CodeSystem defines coded concepts for supply days in Hospital Respiratory Data reporting for US SAFR IG. This is an example CodeSystem and is experimental, and is expected to be replaced when a permanent location is identified.

Example: Example Instances

These are example instances that show what data produced and consumed by systems conforming with this implementation guide might look like.

Bundle - Bed Capacity Report Bundle Example

Bundle containing a measure report and all referenced resources for NHSN bed capacity reporting.

Bundle - HRD Measure Bundle Example

This Bundle resource is an example of a Hospital Respiratory Data (HRD) Measure Bundle.

Bundle - HRD Measure Report Bundle Example

Bundle containing a measure report and all referenced resources for NHSN Hospital Respiratory Disease (HRD) reporting

Children's Bed 4

A bed located in the Children’s Department of the hospital.

Device - CQF Tooling System Example

Example of a Software System Device instance for describing tooling that was used to process artifacts.

Emergency Dept. Bed 1

A bed located in the Emergency Department.

Encounter - Example ACH Pass2 - Emergency

Encounter - Example ACH Pass2 - Emergency department visit

Hospital Respiratory Data Measure for US Situational Awareness Framework for Reporting

US Situational Awareness Framework for Reporting - Hospital Respiratory Data Measure

Inpatient Psychiatric Bed 3

A bed located in the Inpatient Psychiatric Department of the hospital.

Inpatient Rehabilitation Bed 2

A bed located in Inpatient Rehabilitation department of the hospital.

Intensive Care Unit Bed 6

A bed located in the ICU Unit of the hospital.

Library - HRD Measure Example

This library contains CQL logic for evaluating structural measures related to hospital respiratory disease reporting capabilities

Location - Hospital Facility Example

Example of a Hospital Facility for NHSN reporting.

Measure - HRD Measure Example

Example of a Hospital Respiratory Disease (HRD) Measure for NHSN reporting.

MeasureReport - Bed Capacity MeasureReport Example

Example MeasureReport for NHSN bed capacity monitoring showing ICU, ED, and Pediatric bed capacity

MeasureReport - HRD MeasureReport Example

This Bundle resource is an example of a Hospital Respiratory Data (HRD) MeasureReport.

Organization - Submitting Hospital Organization Example

Organization - Example of a Submitting Hospital Organization

Other Facility Bed 3

A bed located in an subunit of the facility.

Patient - Example ED Patient 1
Pediatric Bed 7

A bed located in the Pediatrics Unit of the hospital.