Making Electronic Data More available for Research and Public Health (MedMorph), published by HL7 International - Public Health Work Group. This is not an authorized publication; it is the continuous build for version 1.0.0). This version is based on the current content of https://github.com/HL7/fhir-medmorph/ and changes regularly. See the Directory of published versions
The MedMorph Reference Architecture (RA) IG aims to minimize the burden on both the senders and receivers of data by providing a common method for obtaining data for research and public health. The CDC established a Technical Expert Panel (TEP) comprised of a wide variety of representatives with relevant expertise to inform the development of the technical approach, use cases, and the MedMorph RA IG. Read the Use Cases section for background on the initial representative MedMorph use cases that have been used to create the data exchange abstract model and workflows from which the MedMorph RA is derived.
The following are the guiding principles for the MedMorph RA IG.
The following requirements are in-scope for the MedMorph RA IG based on the use cases.
The following aspects are out-of-scope for the MedMorph RA IG based on the use cases.
This guide is based on the HL7 FHIR R4 standard, as well as US Core IG, Bulk Data Access IG, SMART App Launch IG for Backend Services Authorization specifications. This IG is intended to maximize the number of clinical systems that can conform to this guide as well as to allow for extensibility of system capabilities in the future.
Implementers of the MedMorph RA IG must understand some basic information about the underlying specifications listed above.
The table below identifies the specific FHIR Resources and their use in the MedMorph RA IG. Implementers should familiarize themselves with these FHIR resources and their purposes.
FHIR Resource | MedMorph Purpose |
---|---|
PlanDefinition | Used to define the Knowledge Artifacts which contains the definitions of all the activities, events, conditions that can be executed as part of workflows. |
Library | Used to specify logic expressions, queries, trigger codes to be used as part of PlanDefinition. |
ValueSet | Used to group codes for various activities such as trigger codes, activity codes. |
Bundle | Used to group resources for creating submission reports. |
MessageHeader | Used to specify metadata for message routing. |
Organization | Representing Sending, Receiving and Intermediary organizations. |
Location | Used to represent locations in workflows. |
Endpoint | Used to represent sender and receiver addresses during data exchange. |
The MedMorph project’s vision is to provide a common framework (i.e., the RA) that can be used for multiple public health and research use cases. Each use case will contain content specific data, workflow requirements, and operational requirements necessary for implementation. The use case specific content will be detailed in additional IGs referred to as content IGs. Generally, each content IG would apply to one use case, however it is possible that existing content IGs broader in scope may cover all or some of the requirements needed by a use case, as described in the next section with the Hep C example. Implementers of other use cases and content IGs not documented within the MedMorph RA IG may also choose to implement the MedMorph RA IG as it may support their use cases based on the data necessary for exchange, workflow, and operational requirements. The relationships among different FHIR IG types are depicted in Figure 2.1, with the more general types at the top and more specific types at the bottom. Typically, the more general an IG is, the more reusable its components; and the more specific an IG is, the more use case specific it is.
NOTE to Readers:
Although the US Public Health (PH) Profiles Library is in the process of being balloted at the time of MedMorph RA IG v1.0.0 publication, it is included to show the direction MedMorph will take under the guidance of the HL7 Public Health Work Group (WG). The US PH Profiles Library will harmonize similar profiles from multiple IGs being produced under the sponsorship of the HL7 Public Health WG. This will ensure consistency across IGs, reduce profile proliferation, and provide a starting point for future content IGs.
The United States Public Health (US PH) Profiles Library establishes a baseline of common artifacts that will be used by multiple public health IGs as shown in Figure 2.1. It provides a way to harmonize profiles needed for multiple public health use cases that are not already in US Realm foundational IGs such as US Core. The initial content for the US PH Profiles Library is derived from the MedMorph RA and eCR FHIR IGs, and in the future will likely include reusable profiles from other IGs as well (see Section on “Other Existing Public Health IGs contributing to a common US PH Profiles Library” for more details). The MedMorph RA IG and v2.0.0 of the eCR FHIR IG were balloted in January 2021, and both IGs created aligned artifacts that can be reflected in the US PH Profiles Library, which is being balloted in September 2022. All artifacts that are candidates for promotion to the US PH Profiles Library will use the words “us” or “US” and “ph” or “PH” as part of the profile definition, name, and title elements. This RA IG will harmonize with the US PH Profiles Library going forward to reduce implementer burden for supporting public health use cases. At the architectural level, this RA IG aligned with and then expanded from the architectural components of the eCR FHIR IG. In this way, the MedMorph and eCR architectures are harmonized while the MedMorph RA also allows for public health use cases beyond reportable conditions (which is the focus of eCR), research use cases, and potentially other types of use cases in the future.
At the content IG level, the eCR FHIR IG contains content profiles (identified as eICR Content Profiles in eCR FHIR IG in Figure 2.1) related to electronic case reporting of reportable conditions. There are three different permutations for how a new use case might leverage these profiles or profiles in other existing FHIR IGs, as shown in Figure 2.1 with the initial MedMorph use cases as examples.
For example, the MedMorph Hep C use case data requirements overlap with the content specified for electronic case reporting. Creation of a new Hep C content IG would replicate most, if not all, of the content specified as eICR Content Profiles in the eCR FHIR IG, which is undesirable. To minimize proliferation of profiles and IGs, which increases implementation burden, the MedMorph Hep C use case will reuse the eICR Content Profiles from eCR FHIR IG from a content perspective rather than create a separate content IG. An example of partial reuse is the Cancer Registry Reporting Content IG, which in part overlaps with the eICR Content Profiles in eCR FHIR IG but also requires additional profiles to fully meet its data requirements. These overlapping profiles have been refactored into the US PH Profiles Library, which can then be reused by the Central Cancer Registry Reporting Content IG. Any specific data elements needed for the Cancer Registry Reporting use case not included in the US PH Profiles Library will be added to the Central Cancer Registry Reporting Content IG. The Health Care Surveys Content IG overlaps minimally with the eICR FHIR IG from a content perspective, however the Health Care Surveys Content IG can use the MedMorph RA components for the reporting function. The Health Care Surveys Content IG references the MedMorph RA IG and adds profiles and/or extensions, etc. needed for the Health Care Surveys use case not included in the MedMorph RA IG (e.g., Health Care Surveys content specifications).
As shown in Figure 2.1, the MedMorph RA IG is built on other FHIR specifications, including the US Core IG. The MedMorph RA IG will use US Core IG profiles as required for each use case. In addition to the profiles, the patient level FHIR APIs specified in US Core will be leveraged for all public health reporting use cases that leverage the MedMorph RA. The version of the US Core IG referenced is the one widely implemented across the US to support United States Core Data for Interoperability (USCDI) as required in the Office of the National Coordinator (ONC) 21st Century Cures Act certification criteria.
For research use cases and potentially some public health use cases, specifically when data about multiple patients is needed but does not require real-time reporting, MedMorph will leverage the Bulk Data Access IG. The Bulk Data Access IG is used to retrieve population level information from EHRs, subject to applying appropriate authorities and policies. The version of the Bulk Data Access IG referenced is the one being widely implemented across the US to support USCDI required in the ONC 21st Century Cures Act certification criteria.
The MedMorph RA IG uses SMART App Launch IG for Backend Services Authorization to secure all system-to-system interactions among the various actors in the MedMorph RA. The version of the SMART App Launch IG referenced is the being widely implemented across the US to support USCDI as required in the ONC 21st Century Cures Act certification criteria.
The MedMorph RA IG intends to use the Subscriptions Backport IG/index.html) to enable content IGs to define specific trigger events using Subscription Topics. These subscription topics will be subscribed to by the HDEA per the Knowledge Artifact. Upon receiving notifications, the HDEA will process the notification and automate the MedMorph workflows without additional provider burden.However currently there is no Subscriptions Backport IG that is compatible with FHIR Release 4.0.1 hence the MedMorph RA IG currently does not include a dependency on the Subscriptions Backport IG, however an STU2 update will be made on MedMorph RA IG when the Subscriptions Backport IG becomes available.
The Vital Records Common Profile Library was published in August 2021. While it is focused around vital records there are overlapping profiles with eCR FHIR IG and Occupational Data for Health (ODH) IG. This project was created through the recognition of overlapping birth defects and birth and fetal death FHIR profiles. However, to help harmonize overlapping profiles with other public health use cases such as MedMorph, the VR common library may be a seed for the establishment of the US PH library mentioned above in the MedMorph Reference Architecture IG.
The MedMorph RA IG does not prescribe content specific to any use case. Rather, it specifies the workflow processing, trigger mechanisms using PlanDefinition, ActivityDefinition, ValueSets, and APIs for message routing using Bundle, MessageHeader, etc. The content IGs would specify the profiles, search parameters, and operations for use case specific requirements but would reuse the MedMorph RA IG to trigger events, submit data, process knowledge artifacts, manage workflows, etc. (e.g., Health Care Surveys Content IG, Cancer Registry Reporting Content IG).
The MedMorph RA IG specifies the use of FHIR APIs to collect data from EHRs and potentially other systems and exchange with systems that can receive data in FHIR format. The RA IG can support multiple use cases, including but not limited to case-based surveillance, registry reporting, national health care surveys, and research.
Protocols in the Clinical Registry Extraction and Data Submission (CREDS) IG focus on providing healthcare provider organizations information on how to collect the data needed to submit to registries. This may include but is not limited to data sources such as EHRs, Health Information Exchanges (HIEs), and others, which may use FHIR as well as HL7 CDA documents, and HL7 V3 messages that are not available via FHIR APIs.
Use cases that can obtain all the needed data via MedMorph compliant FHIR APIs should consider the use of the MedMorph RA as the basis for their efforts. Use cases that need to obtain data not available MedMorph should consider the use of CREDS.
The MedMorph RA IG uses FHIR Messaging to route messages with appropriate headers and contents packaged within a reporting bundle, which is a type of Bundle resource. The MedMorph RA IG allows for Trusted Third Parties (TTPs) who act as intermediaries to provide multiple services such as routing, content validation, content conversions, and transport protocol bridging. The Hybrid/Intermediary Exchange IG, developed by the FHIR at Scale Taskforce (FAST), identifies best practices for using intermediaries for FHIR Representational State Transfer (RESTful) interactions. The MedMorph RA IG and the Hybrid/Intermediary Exchange IGs are compatible with each other. For example, a MedMorph use case implementation can use an intermediary that conforms to the Hybrid/Intermediary Exchange IG and also implement the TTP capabilities outlined in the MedMorph RA IG.
The MedMorph RA IG describes a framework for data extraction from EHRs and the process in which Data Marts can load the data for research purposes. While there are many different data models used for research, the MedMorph RA IG examined the CDMH IG, which supports mappings between FHIR and Patient-Centered Outcomes Research Network (PCORnet) Common Data Model(CDM), Informatics for Integrating Biology & the Bedside (i2b2), Sentinel, and Observational Medical Outcomes Partnership (OMOP) data models. These mappings will be useful for the MedMorph Research Data Exchange Content IG and potentially other research use cases.