This page is part of the FHIR Specification (v0.5.0: DSTU 2 Ballot 2). The current version which supercedes this version is 5.0.0. For a full list of available versions, see the Directory of published versions . Page versions: R5 R4B R4 R3 R2

1.7.0 FHIR Overview

Welcome to the FHIR (Fast Healthcare Interoperability Resources) Specification, which is a standard for exchanging healthcare information electronically. This page provides an overview of the standard, and serves as a road map for first-time readers of the specification to help find your way around FHIR quickly.

1.7.0.1 Background

Healthcare records are increasingly becoming digitized. As patients move around the healthcare eco-system, their electronic health records must be available, discoverable, and understandable. Further, to support automated clinical decision support and other machine based processing, the data must also be structured and standardized. (See Coming digital challenges in healthcare)

HL7 has been addressing these challenges by producing healthcare data exchange and information modeling standards for over 20 years. FHIR is a new specification based on emerging industry approaches, but informed by years of lessons around requirements, successes and challenges gained through defining and implementing HL7 v2, v3 and the RIM, and CDA. FHIR can be used as a stand-alone data exchange standard, but can and will also be used in partnership with existing widely used standards. (See Comparing FHIR to other HL7 standards)

FHIR aims to simplify implementation without sacrificing information integrity. It leverages existing logical and theoretical models to provide a consistent, easy to implement, and rigorous mechanism for exchanging data between healthcare applications. FHIR has built-in mechanisms for traceability to the HL7 RIM and other important content models. This ensures alignment to HL7's previously defined patterns and best practices without requiring the implementer to have intimate knowledge of the RIM or any HL7 v3 derivations. (See Comparing FHIR to other HL7 standards)

1.7.0.2 Components

The basic building block in FHIR is a Resource. All exchangeable content is defined as a resource. Resources all share the following set of characteristics:

• A common way to define and represent them, building them from data types that define common reusable patterns of elements
• A common set of metadata
• A human readable part

1.7.0.3 Approach

1.7.0.3.1 Approach to information modeling

The philosophy behind FHIR is to build a base set of resources that, either by themselves or when combined, satisfy the majority of common use cases. FHIR resources aim to define the information contents and structure for the core information set that is shared by most implementations. There is a built-in extension mechanism to cover the remaining content as needed.

FHIR modeling uses a composition approach. In comparison, HL7 v3 modeling is based on "model by constraint" (see Comparing FHIR to other HL7 standards). With FHIR, specific use cases are usually implemented by combining resources together through the use of resource references. Although a single resource might be useful by itself for a given use case, it is more common that resources will be combined and tailored to meet use case specific requirements. Two special kinds of resources are used to describe how resources are combined and used:

• Conformance Statement – describes the interfaces that an implementation exposes for exchange of data
• Profile - provide additional rules that serve to constrain the optionality, cardinality, terminology bindings, data types and extensions defined in the resources used by the implementation

1.7.0.4 The Specification

Broadly, the FHIR specification is broken up into 3 parts:

• General documentation that describes how resources are defined, and gives background material including definitions of data types, codes, and the XML and JSON formats
• Implementation - how to use resources using REST, Messaging, as clinical documents, or in a service based architecture
• The resource list - a list of all the resources defined by FHIR. You can also get lists for clinical, administrative and infrastructural resources

Resources have a wide range of uses, from pure clinical content such as care plans and diagnostic reports through to pure infrastructure such as Message Header and conformance statements. They all share common technical characteristics (see below for a more formal definition), but they are used in totally different fashions. Note that you do not have to use REST to make use of resources.

1.7.0.5 Where to Start

The best place to start is to quickly read the Resources list to get a sense of what resources exist and then look at the Patient resource definition to see what resource definitions look like, and then read these background pages:

• Resource Definitions - basic background to how resources are defined
• About Resources: the Narrative they all contain, and how Resources refer to each other
• Formats: XML and JSON
• About Extensibility: a key way that the specification is kept simple
• If you are coming to FHIR with a background in another HL7 standard (v2, v3 or CDA), The Relationship between FHIR and other HL7 Standards may also be useful

1.7.0.5.1 Header Tabs

These header tabs found through-out the specification are important, and many readers miss them:

Resources and the data types that they use are presented in an concise easy to read XML-like format, but they also have detailed descriptions that describe their contents in considerable detail. In addition, most resources are mapped to several different formats, including HL7 v2, the HL7 v3 RIM, CDA, DICOM, and others. Also, all resources come with at least one example (sometimes many more) and, where appropriate, with profiles that describe their use in specific circumstances. Finally, some resources include notes that helps implementers understand the design rationale underlying them.

1.7.0.6 Finding Additional Information and Providing Feedback

While intended to be consumable by a variety of audiences, the FHIR specification is targeted to the implementation community - those who will actually write the software that uses the specification. To help meet the needs of the implementation community, the editors have strived to keep the specification concise to reduce the amount of reading that must be done before writing useful code. (The specification isn't nearly as brief as we'd like - sometimes the complexity of healthcare and the real world get in the way.) For this reason, information that is not essential to the implementation process, such as rationale, considered alternatives, points of contention, future plans, etc. have been excluded from this specification. As well, it is likely that from time-to-time, implementers will encounter situations where the specification is unclear or incomplete. Finally, there will be circumstances where the specification may be broken or where a change could allow it to better meet implementer needs.

HL7 has therefore provided a number of mechanisms through which additional information about FHIR can be sought and maintained and through which support and requests for change can be made.

1.7.0.6.1 Comments

Each page includes a "comments" section at the bottom of the page where questions and discussion about that particular portion of the FHIR specification can occur. The comments will be actively monitored by FHIR editors and HL7 work groups, so questions should be answered in a fairly timely fashion. This content will occasionally be curated to ensure ongoing relevance, particularly if the specification is subsequently updated to eliminate confusion that may have spawned an initial comment.

1.7.0.6.2 The FHIR Wiki

The FHIR project team also maintains a wiki where development processes, methodology and design decisions are documented. Implementers and others can also contribute to the wiki to provide additional guidance and supplemental information not found in the specification. Note that wiki content is not authoritative and is not relevant for determining conformance to the FHIR specification. As well, some wiki content may not be up to date with the most recent version of the FHIR specification.

A wiki page exists for each page in the FHIR specification. These pages will generally be used to capture background rationale, decision points and other information not relevent to implementers. Additional pages defined include FHIR methodology, use of the FHIR design tools, etc. To explore the FHIR wiki, you can start at the root page

1.7.0.6.3 Formal Change requests

Formal requests for change can be submitted here. (There's a link at the bottom of each page as well.) These will be reviewed by the appropriate work group and a decision made on their incorporation into the specification, including which release (if any) they will be part of.

1.7.0.6.4 Additional Information sources/Engagement Mechanisms

In addition to the above mechanisms, HL7 provides a Stack Overflow tag, list servers and mass Skype chats to provide various levels of implementer support and engagement. Instructions for accessing these other mechanisms (and instructions for how best to make use of them) can be found here.