- Join us in our next virtual connectathon from September 9-11, 2020. Details can be found here.
- To view our upcoming connectathon schedule, click here.
- Click here to view the SDOH-CC Master and Temporary Code List.
The Gravity Project creates and maintains a consensus-building community to expand available Core Social Determinant of Health (SDOH) Data for Interoperability and accelerate standards-based information exchange by using HL7 FHIR. Gravity Project is part of the HL7 FHIR Accelerator Program.
Many of the recent innovations at scale in this area begin with the strategic collection of SDOH data. As examples, the Centers for Medicare & Medicaid Services Innovation Center (CMS Innovation Center) Comprehensive Primary Care Plus Model requires providers to assess patients’ social risks; and the CMS Innovation Center’s Accountable Health Communities Model developed a social risk assessment tool to help identify and address social risks across clinical and community-based settings. However, presently there is no consensus on the coding and standards-based modeling to facilitate the data uses envisioned for SDOH information. The Gravity Project is addressing the question of how to record and document SDOH information in the clinical care setting, across the four primary activities of care (screening, assessment/diagnosis, care planning, and treatment). Initially, the project focuses on three of the many different domains that form social determinants of health: Food Insecurity, Housing Instability and Quality, and Transportation Access.
The FHIR IG work for Gravity will include several iterative builds of the SDOH-CC IG, multiple rounds of Connectathon testing, and periodic updates to summarize this work for the Community. General education about FHIR IG development and HL7 ballot participation will be provided to build awareness and develop skills relevant for participation in standards development at the Community level.
Upcoming FHIR IG Meetings
If you missed any FHIR IG meetings, click here for past meeting minutes.
|Implementation Guides||Sponsoring Work Groups||Governance Documents||Connectathon Information||Potential Connectathon Participants||Ballot Information||Reference Implementations||Testing and Validation Tools|
Status: Approved 2019.11.18
FHIR IG Proposal: Proposal
Status: Approved 2019.10.30
Sept 2020 HL7 Connectathon 25 - Virtual 2020.09.9-11
Ballot for STU: 2020.09
Git Hub TBD
If you have any questions, please contact Gravity Technical Director, Robert Dieterle at email@example.com
Project Scope Statement
For details on the approved scope for the Gravity Project SDOH Data Element FHIR IG, read the HL7 PSS.
Project Insight Number: 1567
The Gravity Project will incrementally develop one (1) FHIR IG covering the following three primary use cases listed in the table below. The three SDOH domains these use cases focus on are as follows:
- Food Insecurity (In-progress)
- Housing Instability and Quality
- Transportation Access
1) Document SDOH Data Elements in the Clinical Care Setting
Document SDOH data in conjunction with the patient encounter.
2) Track SDOH Intervention Referrals to Completion
Document and track SDOH related intervention referrals to completion.
3) Aggregate SDOH Data Elements for Secondary Use (QRPH)
Gather and aggregate SDOH data for uses beyond the point of care (e.g.,quality, research, and population/public health)
Note: Out of Scope for the 2020 SDOH-CC FHIR IG.
Roadmap Timelines (updated 2020.05.04)
Milestones (updated 2020.05.26)
|Task||WorkStream||Overview of FHIR IG Development Workstream Activities||Start Date||Target Date||Status||Completion Date|
|5||1||Work Stream 1 (Community Engagement) comprises three main aspects of work:|
- Participation in PMO activities
- Support for Gravity Community and Content Domain activities
- HL7 WG Community Support and Project Governance
|5||2||Work Stream 2 (Connectathon Testing) comprises three main aspects of work:|
- Planning for Connectathons
- Support for Testing Participants
- Participation in Connectathon Events
|5||3||Work Stream 3 (FHIR IG) comprises three main aspects of work: FHIR IG Dev||2020.01.01||2020.08.01||In Progress|
|5||3||Work Stream 3 (FHIR IG) comprises three main aspects of work: Ballot Reconciliation and Execution of Ballot Changes||2020.08.01||2020.12.31|
|5||3||Development of Reference Implementation||2020.10.01||2020.12.31|
|Task||WorkStream 1||Details||Start Date||Target Date||Status||Completion Date|
|5||1||Project Scope Statement||2019.10.04||2019.11.18||Completed||2019.11.18|
|5||1||FHIR IG Proposal||2019.10.17||2019.10.30||Completed||2019.10.30|
|5||1||Develop Base IG and Profiles for UC1v1 (IGV0.0.1) |
Initial pass at key SDOH-specific profiles for UC1.
|5||1||Gravity Community Feedback||2019.12.12||Completed||2019.12.12|
|5||1||Overview of FHIR IG Development in Gravity Community Meeting||2019.12.12||Completed||2019.12.12|
|5||1||Review initial Community Feedback||2020.01.08||Completed||2020.01.08|
|5||1||Project briefing for Patient Care||2020.02.04||Completed||2020.02.04|
|5||1||Project briefing for Vocabulary WG||2020.02.05||Completed||2020.02.05|
|5||1||Project briefing for Public Health WG||2020.02.06||Completed||2020.04.06|
|5||1||HIMSS SDOH Presentations||2020.03||Completed||2020.03|
|5||1||Overview of FHIR IG Development in Gravity Community Meeting||2020.03.26||Completed||2020.03.26|
|5||1||Sydney Connectathon Report out||2020.03||Completed||2020.03|
|5||1||Project briefing for Patient Care||2020.03||Completed||2020.03|
|5||1||Project briefing for Vocabulary WG||2020.03||Completed||2020.03|
|5||1||Project briefing for Public Health WG||2020.03.03||Completed||2020.03.03|
|5||1||May 2020 HL7 Connectathon Track Plan||2020.04.03||Completed||2020.04.03|
|5||1||May 2020 HL7 Connectathon Report to Gravity Community||2020.06||In progress|
|5||1||Project briefing for Patient Care WG||2020.06||In progress|
|5||1||Project briefing for Vocabulary WG||2020.06||In progress|
|5||1||Project briefing for Public Health WG||2020.06||In progress|
|5||1||Governance WS: NIB for Sept Ballot must be completed||2020.06.15|
|5||1||Approval to ballot from Patient Care Workgroup||2020.07|
Marketing/Education WS: Overview of FHIR IG Development in Gravity Community Meeting
|5||1||Sept 2020 HL7 Connectathon Track Plan|
|5||1||Project briefing for Patient Care||2020.09.01|
|5||1||Sept 2020 HL7 Connectathon Report to Gravity Community||2020.09|
|5||1||Sept 2020 Analysis of Ballot Comments|
|5||1||Project briefing for Vocabulary WG|
|5||1||Project briefing for Public Health WG|
|5||1||Work on Ballot Comments||2020.09.01||2020.11.30|
|5||1||Approval of Ballot Reconciliation Amalgamated Sheet||2020.09.01||2020.11.30|
|5||1||Approval of Request to Publish STU R1 from Patient Care Workgroup||2020.12|
|Task||WorkStream 2||Details||Start Date||Target Date||Status||Completion Date|
|5||2||Generate SDOH Track Proposal and prepare track participants (Sydney)||2020.01.05||Completed||2020.02.04|
|5||2||HL7 Connectathon 23 - Sydney, Australia||2020.02.02||2020.02.03||Completed||2020.02.04|
|5||2||Connectathon Participants Preparation Call||2020.02.26||Completed|
|5||2||Connectathon Participants Preparation Call||2020.03.04||Completed|
|5||2||Connectathon Participants Preparation Call||2020.03.25||Completed|
|5||2||Connectathon Participants Preparation Call||2020.04.01||Completed|
Generate SDOH Track Proposal and prepare track participants for San Antonio, TX Connectathon
|5||2||Connectathon Participants Preparation Call||2020.04.15||Completed|
|5||2||Connectathon Participants Preparation Call||2020.04.29||Completed|
|5||2||HL7 Connectathon 24 - Virtual||2020.05.13||2020.05.15||Completed|
|5||2||MiHIN Interopathon - Virtual||2020.05.28||2020.05.29||In progress|
|7||2||Create Recommendations to inform the development and piloting of the AHRQ/NIDDKE eCare Plan app and associated FHIR IG||2020.03||2020.06.05||In progress|
|5||2||Generate SDOH Track Proposal and prepare track participants for Baltimore, MD Connectathon||2020.07|
|5||2||Connectathon Participants Preparation Call||2020.07|
|5||2||Connectathon Participants Preparation Call||2020.08|
|5||2||Connectathon Participants Preparation Call||2020.08|
|5||2||HL7 Connectathon 25 - Baltimore, MD||2020.09|
|Task||WorkStream 3||Details||Start Date||Target Date||Status||Completion Date|
|5||3||IG Development: Continued IG Development UC1v2 (IGV0.0.2))|
Refinement of V0.0.1 with emerging content ready enough for early testing at Sydney Connectathon
|5||3||IG Development: Continued IG Development UC1v3 (IGV0.0.3)|
Improvements on V0.0.2 based on learning from Sydney Connectathon and additional profiles and guidance that continues to be developed.
|5||3||IG Development: Continued IG Development UC1v4, UC2v1 (IGV0.0.4)|
First version that includes profiles and guidance regarding use of BSeR for UC2
FHIR IG Scope change to focus solely on Resource content profiles. Specifying data exchange mechanisms between actors removed from scope.
|5||3||Continued IG Development UC1v5, and UC2v2 (IGV0.0.5)|
Improvements on V0.0.4 based on learning from Connectathon 24 and additional profiles and guidance that continues to be developed.
|5||3||Ballot Package Prep (IGV5), WG Review and Voting||2020.06.01||2020.07.30|
|5||3||Sponsor WG approves FHIR IG content submitted to ballot||2020.08.01|
|5||3||FHIR IG content determined is included in September HL7 Ballot V0.1.0||2020.08.13|
|5||3||September HL7 Ballot|
Community reviews and submits formal comments on V0.1.0
|5||3||Improvements on V0.1.1 based on learning from Baltimore Connectathon and additional profiles and guidance that continues to be developed.||2020.09|
|5||3||FHIR IG with Ballot dispositions applied. (v1.0.2 - v1.0.n)||2020.12|
|5||3||Publish SDOH-CC STU1 V1.0.0 for Food Insecurity||2020.12|
|5||3||Develop FHIR Reference Implementation|
|Out of Scope||Out of Scope||Subsequent iterations for Housing Instability and Quality (STU R2)||TBD|
|Out of Scope||Out of Scope||Subsequent Iterations for Transportation Barriers (STU R3)||TBD|
FHIR R4 Implementation Guide and Artifacts
|Implementation Guide Narrative Explanations||X||X|
|Patient Stories and Persona Information||X||X|
|Use Case Documentation||X||X|
|Use Case 1||Use Case 2|
|Resources, Profiles, Operations, Examples, Validation Scripts||Screening||Encounter||Request||Response|
|US Core Patient||X||X||X||X|
|US Core Practitioner||X||X||X||X|
|US Core PractitionerRole||X||X||X||X|
US Core Organization
|US Core Location||X||X||X||X|
|US Core Encounter for a patient visit/encounter||X|
$process-message operation for screening Task
MessageBundle for screening task
|MessageHeader for screening task||removed||removed|
|Task for screening task||removed||removed|
|MessageHeader for update screening task||removed||removed|
SDOH-CC List of Patients for screening task
|SDOH-CC Consent for sharing questionnaire response information||X||X|
US Core Observation for Screening Result
|Document Bundle for encounter summary and care plan documents or referral note and referral feedback documents||removed||removed|
|C-CDA on FHIR Composition for encounter summary and care plan documents or referral note and referral feedback documents||removed||removed|
|DocumentReference for keeping track of received documents||removed||removed|
|Binary for holding a copy of a received document||removed||removed|
|SDOH-CC Observation for food insecurity clinical observation||X|
|SDOH-CC Condition for food insecurity diagnosis||X|
|SDOH-CC Goal for food insecurity goal||X|
|SDOH-CC Procedure for food insecurity services (performed and requested)||X|
|SDOH-CC ServiceRequest to do a referral (ServiceRequest) for services to address SDOH needs||X|
|SDOH-CC CarePlan to show how SDOH information relates to each other||Description only|
|CDex MessageBundle for Communications||removed|
|CDex MessageHeader for solicited communication request||removed|
|CDex MessageHeader for solicited communication response||removed|
|BSer $process-message operation for SDOH Referral Task||removed||removed|
BSer MessageBundle for SDOH Referral Task
|BSer MessageHeader for SDOH Initiate Referral Task||removed||removed|
BSer MessageHeader for SDOH Update Referral Task
|BSeR ServiceRequest Activity Status||TBD||TBD|
|Clinical Statements - multiple Profiles that describe how to represent individual data elements used in referral note and referral feedback documents||removed||removed|
|CapabilityStatement - Patient App||removed||removed|
|CapabilityStatement - Screening App||removed||removed|
|CapabilityStatement - Screening Requester||removed||removed|
|CapabilityStatement - Clinical Data Source||removed||removed|
|CapabilityStatement - Clinical Data Requester||removed||removed|
|CapabilityStatement - Referral Requester||removed||removed|
|CapabilityStatement - Referral Responder||removed||removed|
|CapabilityStatement - Services Directory||removed||removed|
|Resource Instance Examples||X||X||X||X|
|Messaging Examples||Informative examples on Confluence only||Informative examples on Confluence only||Informative examples on Confluence only||Informative examples on Confluence only|
|Validation Scripts||removed||removed * Due to CDex changing||removed||removed|
Approved SDOHCC FHIR IG Errors and Warnings
|v0.0.1||N/A||Early efforts are not complete enough to expect error-free builds with IG Publisher.|
|v0.0.2||N/A||Early efforts are not complete enough to expect error-free builds with IG Publisher.|
|v0.0.3||Current unresolved Build Errors for v0.0.3||First version where expectation is an error-free build with IG Publisher. 199 total errors. 181 errors are approved at this time. 18 errors need to be resolved|
|error-The link 'toc.md' for "Table of Contents" cannot be resolved||17 errors|
|error- The link '' for "" cannot be resolved||148 errors|
|error- The link 'Patient/patientExample1' for "Patient/patientExample1" cannot be resolved||5 errors|
error- The link 'Encounter/encounterExample1' for "Encounter/encounterExample1" cannot be resolved.
error- The link 'Encounter/encounterExample2' for "Encounter/encounterExample2" cannot be resolved
The link 'Encounter/encounterExample3' for "Encounter/encounterExample3" cannot be resolved
error- The link 'Practitioner/practitionerExample1' for "Practitioner/practitionerExample1" cannot be resolved
The link 'Practitioner/practitionerExample2' for "Practitioner/practitionerExample2" cannot be resolved
|The link 'StructureDefinition-SDOHCC-Procedure-FoodInsecurity-1.sch' for "Schematron" cannot be resolved||4 errors|
|v0.0.4||StructureDefinition.baseDefinition warning US FHIR Usage rules require that all profiles on CarePlan derive from the core US profile|
|The link 'StructureDefinition-SDOHCC-Procedure-FoodInsecurity-1.sch' for "Schematron" cannot be resolved|
|The link 'StructureDefinition-SDOHCC-Observation-FoodInsecurity-1.sch' for "Schematron" cannot be resolved|
|The link 'StructureDefinition-SDOHCC-Goal-FoodInsecurity-1.sch' for "Schematron" cannot be resolved|
|The link 'StructureDefinition-SDOHCC-Condition-FoodInsecurity-1.sch' for "Schematron" cannot be resolved|
|The resource should declare it's jurisdiction to match the package id (hl7.fhir.us.sdohcc, jurisdiction = urn:iso:std:iso:3166:-2#US)|
Other IGs to be Utilized
|Implementation Guide||Description and intended use (Note that many extensions are defined within these IGs)|
FHIR US Core
Version (3.1.0) - FHIR R4
The US Core Implementation Guide is based on FHIR Version R4 and defines the minimum conformance requirements for accessing patient data. The Argonaut pilot implementations, ONC 2015 Edition Common Clinical Data Set (CCDS), and the latest proposed ONC U.S. Core Data for Interoperability (USCDI) provided the requirements for this guide. The prior Argonaut search and vocabulary requirements, based on FHIR DSTU2, are updated in this guide to support FHIR Version R4. These profiles are the foundation for future US Realm FHIR implementation guides. In addition to Argonaut, they are used by DAF-Research, QI-Core, and CIMI. Under the guidance of HL7 and the HL7 US Realm Steering Committee, the content will expand in future versions to meet the needs specific to the US Realm.
These requirements were originally developed, balloted, and published in FHIR DSTU2 as part of the Office of the National Coordinator for Health Information Technology (ONC) sponsored Data Access Framework (DAF) project. For more information on how DAF became US Core see the US Core change notes.
Version 2.1 - widely adopted standard for exchange of patient encounter information.
Consolidated CDA (C-CDA) specifies several relevant document types used currently by EHR systems to exchange clinical encounter information. These documents express a collection of information that tells the patient's story at a point in time when an encounter occurred or provides the patient's medical history over a span of time. The documents are expressed using the HL7 Clinical Document Architecture standard which is compatible and can be used in conjunction with FHIR. For systems that do not yet support FHIR document creation, exchange of patient data using C-CDA standard documents may be a viable option. C-CDA document can be shared as attachments within FHIR exchange mechanisms. FHIR also supports robust document registry and repository capabilities appropriate for exchanging information in all types of document formats.
Structured Data Capture (SDC)
Version for FHIR R4
Questionnaires and forms permeate healthcare. They are used to capture administrative data, claims data, clinical information, research information, for public health reporting - every type of data that is manipulated by healthcare systems. They provide a user-friendly mechanism for capturing data in a consistent way. In FHIR, forms are represented using the Questionnaire resource and completed forms are represented using the QuestionnaireResponse resource. The base FHIR specification defines these resources but doesn't provide much guidance around how they should be used, nor does it set minimal expectations for interoperation. This implementation guide provides a set of guidance around the use of Questionnaire and QuestionnaireResponse. Specifically, it provides answers to - and conformance expectations around - questions such as:
The implementation guide is structured to allow implementers to pick and choose the capabilities they need and combine them as necessary.
FHIR SDC SMART App
For FHIR R4
FHIR SDC SMART App
This open-source app uses the LHC-Forms form rendering widget to manage FHIR Questionnaire and QuestionnaireResponse resources. It provides partial (and growing) support for the Structured Data Capture (SDC) profile. The app is designed to be launched from an EHR system using SMART on FHIR to connect to the EHR's FHIR server. When you select "Try App" below, you will first go to a patient selector, and then to the app, the idea being that in an EHR environment, the patient would already be chosen before the app is used to fill out a form for the patient.
The app supports both STU3 and R4 versions of FHIR; the "Try App" button will connect you to an R4 FHIR server.
Da Vinci Clinical Data Exchange
Version (1.0.0) for FHIR R4
The CDex implementation guide defines combinations of exchange methods (push, pull, etc. ), specific payloads (Documents, Bundles, and Individual Resources), search criteria, conformance, provenance, and other relevant requirements to support the exchange of clinical information between provider and other providers and/or payers. The goal is to identify, document and constrain specific exchange patterns so that providers and payers can reliably exchange information for patient care (including coordination of care), risk adjustment, quality reporting, identifying that requested services are necessary and appropriate (e.g. should be covered by the payer) and other uses that may be documented as part of this effort. Clinical data payloads will include C-CDA, C-CDA on FHIR, compositions, bundles, and discrete resources conforming to the US Core specification.
Ultimately this IG is expected to support multiple versions of FHIR (DSTU2/Argonaught, STU3, and R4), but the current version of this IG only supports for FHIR R4.
Bidirectional Services eReferrals
Version (0.2.0) for FHIR R3
The Bidirectional Services eReferrals (BSeR) FHIR IG provides guidance on STU3 FHIR Resources and US Core IG profiles for use in exchanging a referral request and specific program data from a clinical provider to a typically extra-clinical program service provider, such as a diabetes prevention program, a smoking quitline, or a hypertension management training program. And provides for the return of feedback information from the service program to the referring provider.
This IG includes definition of the BSer Consent Profile which may be used to share information sharing consent information gathered from the patient.
FHIR Bulk Data Access
Version (1.0.0) for FHIR 4.0
Providers and organizations accountable for managing the health of populations often need to efficiently access large volumes of information on a group of individuals. For example, a health system may want to periodically retrieve updated clinical data from an EHR to a research database, a provider may want to send clinical data on a roster of patients to their ACO to calculate quality measures, or an EHR may want to access claims data to close gaps in care. In most cases, access to these bulk-data exports is pre-authorized between the data holder and the data requester. The data exchange involves extracting a specific subset of fields from the source system, mapping the fields into a structured file format like CSV, and persisting the files in a server from which the requester can then download them into the target system. This multi-step process increases the cost of integration projects and can act as a counter-incentive to data liquidity.
Existing FHIR APIs work well for accessing small amounts of data, but large exports can require hundreds of thousands of requests. This implementation guide defines a standardized, FHIR based approach for exporting bulk data from a FHIR server to a pre-authorized client.
|FOR FUTURE CONSIDERATION:|
C-CDA on FHIR
Version (1.1.0) for FHIR R4
Consolidated CDA (C-CDA) is one of the most widely implemented implementation guides for CDA and covers a significant scope of clinical care. Its target of the ‘common/essential’ elements of healthcare is closely aligned with FHIR’s focus on the ‘80%’. There is significant interest in industry and government in the ability to interoperate between CDA and FHIR and C-CDA is a logical starting point. Implementers and regulators have both expressed an interest in the ability to map between FHIR and C-CDA.
This Implementation Guide (IG) defines a series of FHIR profiles on the Composition resource to represent the various document types in C-CDA. This release does not directly map every C-CDA template to FHIR profiles, rather tries to accomplish the C-CDA use case using Composition resource profiles created under this project (the equivalent of Level 2 CDA documents), and begins by linking to the profiles created under the US Core project for any coded entries that would normally be included in C-CDA sections. To have a simpler, more streamlined standard that reuses existing work and focuses on the 80% that implementers actually need in production systems, the resources of US Core represents a portion of the 80% needed for coded entries for coded entries of CCD, Care Plan & Discharge Summary).
The Composition profiles in this IG do not require coded data in any section. This is a departure from C-CDA, which requires coded data for Problems, Results, Medications, etc. This departure is intentional, as the C-CDA requirement for one or more coded entries in these sections resulted in some very complicated workarounds using nullFlavors to handle the fact that sometimes a patient is not on any medications, or has no current problems. In general, FHIR takes the approach that if something is nullable, it should simply be optional to ease the burden on implementers, thus C-CDA on FHIR does not require any coded entries, but rather uses the “required if known” approach, meaning that if an implementer’s system has data for a section that requires data under Meaningful Use, they need to send it, but if they have no data there is no need for a null entry.