FHIR for FAIR - FHIR Implementation Guide, published by Health Level Seven International - SOA Work Group. 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/fhir-for-fair/ and changes regularly. See the Directory of published versions
This page integrates the HL7 FHIR and FAIR principles page providing an overview of the relationship between the FAIR Data Maturity Model described in the RDA Indicators page and the HL7 FHIR standard, independently on the implementation approach adopted (Native Vs non-Native FHIR architectures, see HL7 FHIR and FAIR principles for more details).
INDICTOR_ID | INDICATORS | PRIORITY | Interpretation for HL7 FHIR Data | Notes |
---|---|---|---|---|
RDA-F1-01M | Metadata is identified by a persistent identifier | Essential | HL7 FHIR provides different means to assign persistent identifiers to FHIR resources. See FHIR identifiers and FAIR principles on IDs for more details. The page Metadata and data describes some of the challenges in implementing distinct data and metadata by using HL7 FHIR. Depending on the usage context and on the kind of metadata to deal with, implementers may choose different means , including a partial fulfillment of the requirement or the adoption of hybrid solutions (FHIR and non-FHIR). |
Given that FHIR provides means to uniquely identify resources, the key point of this requirement is a clear identification of what a metadata is (see also the page Metadata and data ). If there are no doubts that metadata are the “data about data”, more complex is to turn this definition in the reality, with a clear distinction between data and metadata. In fact, what is “data” and what is “metadata” is a matter of perspective: based on the context, the same information can be in fact considered as part of the data or of the metadata. In consideration of this, the expectation of having a single persistent and unique ID that identifies the metadata FAIR data object, distinct from that describing the data one, cannot be always satisfied in the FHIR space, except for specific contexts. A pragmatic approach is therefore suggested in the evaluation of this requirement, determining case by case, and in dependence of the type of data (study level or subject level data), what are the actual information to label as metadata, that should and can be distinguished by the associated data. Other information, that could be considered as well as metadata might be recorded in the same object containing the data and used to search them. |
RDA-F1-01D | Data is identified by a persistent identifier | Essential | See RDA-F1-01M for the general considerations on the identification of the FHIR resources. If the organization assures the persistency of the FHIR identifiers, this indicator is automatically fulfilled when data is represented by a single FHIR resource. This doesn't exclude more complex situations that need to be analyzed case by case. |
See RDA-F1-01M. This requirement is fulfilled when data is represented by FHIR resources. |
RDA-F1-02M | Metadata is identified by a globally unique identifier | Essential | See RDA-F1-01M | See RDA-F1-01M. |
RDA-F1-02D | Data is identified by a globally unique identifier | Essential | See RDA-F1-01D | See RDA-F1-01D. |
RDA-F2-01M | Rich metadata is provided to allow discovery | Essential | HL7 FHIR provides means to record metadata information and to enable the search of data based on them. Moreover through FHIR profiling can enforce their adoption by implementers. Communities should define what is meant with "rich" metadata for the use cases they need to cover and possibly formalize them by using FHIR profiles and implementation guides. |
The rationale behind this principle is that someone should be able to find data based on the information provided by their metadata, even without the data’s identifier (adapted from GO-FAIR F2 principle). Whether metadata is 'rich' enough would therefore really depend on what users would need to search on in terms of metadata fields to find the resources. This 'richness' criterium is then use case dependent. Please refer to Metadata and data about a more general discussion about issues in implementing metadata in FHIR. Communities should define what is meant with "rich" metadata for the use cases they need to cover; indicating what are the information that have to be recorded, possibly formalized as FHIR profiles; and the kind of searches that servers should support, possibly formalized as FHIR Capability Statement. |
RDA-F3-01M | Metadata includes the identifier for the data | Essential | This is in general true, the way this is satisfied depends on how metadata and data are represented in HL7 FHIR. (See also RDA-F1-01M) FHIR provides several mechanisms to refer other FHIR resources documenting data; implementers should declare how this is realized; possibly through community FHIR profiles and Implementation Guides. | In dependence on how the FAIR metadata are realized in FHIR (see e.g., RDA-F1-01M); different solutions can be adopted to refer the data objects. This can be done referencing the target FHIR resource, per business identifier or per url. Implementers should use appropriate FHIR conformance resources to declare how this is done. |
RDA-F4-01M | Metadata is offered in such a way that it can be harvested and indexed | Essential | The way this is satisfied depends on how FAIR metadata and data objects are represented in HL7 FHIR. In order to adhere to this requirement, the FHIR search framework can be used. The extent of data and metadata that have to be registered or indexed would however depend on what users would need to search to find the resources. Each community should define what are the relevant metadata and data that have to be registered or indexed by a FHIR server for each supported resource to fulfil this principle; formalizing them with FHIR conformance resources and implementation guides. |
Identifiers and rich metadata descriptions alone will not ensure ‘findability’ on the internet. Perfectly good data resources may go unused simply because no one knows they exist. If the availability of a digital resource such as a dataset, service or repository is not known, then nobody (and no machine) can discover it (adapted from GO-FAIR F4 principle). FHIR provides FHIR metadata datatypes and resource interfaces. FHIR resources allow the documentation of the data context. The architectures adopted should ensure that the FHIR server hosting the data set has strong searching capabilities. Implementers should look for specific FHIR Conformance resources and/or Implementation Guides that describe the metadata and data elements that shall or should be provided to a FHIR server for the use case in question and registered or indexed by that server. HL7 FHIR CapabilityStatement, SearchParameter, StructureDefiniton , possibly documented within a Implementation Guide should be used to document this. See also RDA-F2-01M and RDA-F3-01M |
INDICATOR_ID | INDICATORS | PRIORITY | Interpretation for HL7 FHIR Data | Notes |
---|---|---|---|---|
RDA-A1-01M | Metadata contains information to enable the user to get access to the data | Important | If RDA-F3-01M is true, this is true. This is in general true, since depending on how metadata and data FAIR objects are represented in FHIR, different means are provided by this standard to enable the access to the referred data. Communities should agree what are the relevant metadata information enabling the access of data in their context and formalize and enforce their usage by specifying appropriate FHIR profiles and Implementation Guides. |
Please refer to RDA-F1-01M and RDA-F1-01D for the discussion on distinct and identifiable metadata and data FAIR objects. http://example.org/fhir/Patient/123 (where 123 is the Logical Id of a Patient resource). When the location is an HTTP address, this address can generally be used to retrieve or manipulate the resource."_ Depending on the FAIR data design, different FHIR mechanisms can be used to refer the FAIR data, e.g. by using direct or reverse references to other FHIR resources, or referring data business identifiers. FHIR also provides mechanisms to enable the access to non-FHIR data. The solution architecture should ensure that the metadata FHIR resource includes a reference to the actual data or information on how to access it directly or indirectly. |
RDA-A1-02M | Metadata can be accessed manually (i.e. with human intervention) | Essential | This is not related to the FHIR standard, but on the capabilities offered by the system/platform implementing the services. The metadata FHIR resources should provide information on how to access the data, if a manual access is foreseen. |
Concerning the ability to identify FAIR metadata as distinct and identifiable FHIR resource(s), please refer to item RDA-F1-01M |
RDA-A1-02D | Data can be accessed manually (i.e. with human intervention) | Essential | See RDA-A1-02M | See RDA-A1-02M |
RDA-A1-03M | Metadata identifier resolves to a metadata record | Essential | If RDA-F1-01M is true, this is true This is in general true, since depending on how metadata and data FAIR objects are represented in FHIR different means are provided by this standard to enable the access to the referred metadata. Communities can enforce this requirement by using community FHIR profiles and Implementation Guides. |
Please refer to RDA-F1-01M and RDA-F1-01D for the discussion on distinct and identifiable metadata and data FAIR objects. |
RDA-A1-03D | Data identifier resolves to a digital object | Essential | If RDA-F1-01D is true, this is true. This is in general true, since depending on how metadata and data FAIR objects are represented in FHIR different means are provided by this standard to enable the access to the referred data. Communities can enforce this requirement by using community FHIR profiles and Implementation Guides. |
Please refer to RDA-F1-01M and RDA-F1-01D for the discussion on distinct and identifiable metadata and data FAIR objects. |
RDA-A1-04M | Metadata is accessed through standardised protocol | Essential | FHIR specifies standardized mechanisms to access FHIR resources | Please refer to RDA-F1-01M and RDA-F1-01D for the discussion on distinct and identifiable metadata and data FAIR objects This requirement is typically fulfilled if the metadata object is expressed in HL7 FHIR and available in a FHIR server. |
RDA-A1-04D | Data is accessible through standardised protocol | Essential | FHIR specifies standardized mechanisms to access FHIR resources | Please refer to RDA-F1-01M and RDA-F1-01D for the discussion on distinct and identifiable metadata and data FAIR objects This requirement is typically fulfilled if the data object is expressed in HL7 FHIR and available in a FHIR server. |
RDA-A1-05D | Data can be accessed automatically (i.e. by a computer program) | Important | FHIR specifies standardized mechanisms to automatically access FHIR resources (e.g. FHIR API) | Please refer to RDA-F1-01M and RDA-F1-01D for the discussion on distinct and identifiable metadata and data FAIR objects This is fulfilled by the existence of the data in a FHIR server. |
RDA-A1.1-01M | Metadata is accessible through a free access protocol | Essential | FHIR specifies free access mechanisms to access FHIR resources | HL7 FHIR specifications are published under Creative Commons "No Rights Reserved" (CC0 ).Please refer to RDA-F1-01M and RDA-F1-01D for the discussion on distinct and identifiable metadata and data FAIR objects |
RDA-A1.1-01D | Data is accessible through a free access protocol | Important | FHIR specifies free access mechanisms to access FHIR resources | HL7 FHIR specifications are published under Creative Commons "No Rights Reserved" (CC0). Please refer to RDA-F1-01M and RDA-F1-01D for the discussion on distinct and identifiable metadata and data FAIR objects |
RDA-A1.2-01D | Data is accessible through an access protocol that supports authentication and authorisation | Useful | HL7 FHIR is not 'per se' a security protocol, nor does it define any security related functionality; however it defines exchange protocols and content models (https://www.hl7.org/fhir/exchange-module.html) that can be used with various open security protocols such as HMAC authentication, HTTPS, OAuth2 or SMART (see e.g. https://hl7.org/fhir/security.html#http for Communications Security in HL7 FHIR) | Please refer to RDA-F1-01M and RDA-F1-01D for the discussion on distinct and identifiable metadata and data FAIR objects. |
RDA-A2-01M | Metadata is guaranteed to remain available after data is no longer available | Essential | FHIR provides mean to fulfils this requirements, excepting for the metadata information that are recorded in the same FHIR resource documenting the data. The fulfillment of this requirement is not however determined by the technical capabilities of FHIR, but it depends also on architectural and organizational choices. |
Please refer to RDA-F1-01M and RDA-F1-01D for the discussion on distinct and identifiable metadata and data FAIR objects This principle is important because there can be many reasons why data are no longer available whereas the associated metadata should be a permanent record to describe the data. Future reuse of available data requires separately identified metadata and it also crucial to enable future reproducibility of new data for more science. The practical application of this A2 FAIR principle to data and metadata from the clinical sciences and specifically, supported by the HL7 FHIR standards should consider the following recommendations.
|
INDICATOR_ID | INDICATORS | PRIORITY | Interpretation for HL7 FHIR Data | Notes |
---|---|---|---|---|
RDA-I1-01M | Metadata uses knowledge representation expressed in standardised format | Important | FHIR provides support for standardized knowledge representation The RDA-I1 (01M, O1D, O2M, O2D) indicators are in general covered by virtue of using HL7 FHIR, however, to strive to semantic computable interoperability, communities should agreed on common vocabularies, profiles and other conformance resources that applies for their context of use. |
Please refer to RDA-F1-01M and RDA-F1-01D for the discussion on distinct and identifiable metadata and data FAIR objects There are different ways to interpret 'knowledge representation expressed in standardised format', for example the capability to:
HL7 FHIR supports XML, JSON and RDF machine readable physical representations. It provides in general a formal (FHIR Infrastructure, the core framework on which FHIR depend, is a Normative part of FHIR); accessible and shared (the HL7 FHIR standard is public, accessible and usable by everyone) and broadly applicable language: HL7 FHIR is widely used in the Healthcare for covering a wide range of domains and use cases (from genetic to administrative data for representing healthcare related models and data). The FHIR Clinical Reasoning module provides "resources and operations to enable the representation, distribution, and evaluation of clinical knowledge artifacts such as clinical decision support rules, quality measures, public health indicators, order sets, clinical protocols, and evidence summaries.". It enables finally the representation of logic using languages such as FHIRPath and Clinical Quality Language (CQL). FHIR resources can be used together with other knowledge representation approaches, including SNOMED CT Compositional Grammar Thus, if we are looking to the first four aspects this principle is covered by virtue of using HL7 FHIR resources to represent metadata and data. Concerning instead the last point, the compliance with FHIR, even if it is a strong enabler, may not be sufficient for the semantic computable interoperability. For example a vocabulary used by the sender or an extension defined in a specific context might not be understood by the receiver. To strive for semantic computable interoperability communities are invited to agree on context specific FHIR Implementation Guides, relying as possible on existing ones. |
RDA-I1-01D | Data uses knowledge representation expressed in standardised format | Important | See RDA-I1-01M | See RDA-I1-01M |
RDA-I1-02M | Metadata uses machine-understandable knowledge representation | Important | See RDA-I1-01M | See RDA-I1-01M |
RDA-I1-02D | Data uses machine-understandable knowledge representation | Important | See RDA-I1-01M | See RDA-I1-01M |
RDA-I2-01M | Metadata uses FAIR-compliant vocabularies | Important | HL7 FHIR provides a formal way to bind codeable elements with vocabularies (intended as terminologies), but with very few exceptions, it doesn't impose the usage of any of them. Communities should select FAIR-compliant vocabularies, preferably managed through FHIR terminology services. This choice should be formalized through community specified FHIR Implementation Guide, including appropriate conformance and terminology resources. |
Please refer to RDA-F1-01M and RDA-F1-01D for the discussion on distinct and identifiable metadata and data FAIR objects HL7 HL7 FHIR provides a formal way to bind codeable elements with vocabularies (intended as terminologies), but with very few exceptions, it doesn't impose the usage of any of them. HL7 FHIR includes terminology resources and API that may facilitate the fulfillment of some 'technical' FAIR principles as the unique, global persistent identification of vocabulary metadata and data (e.g. by using the canonical URL). To satisfy this principle FHIR implementers should make an assessment of the FAIRness of the terminologies to be used and enforce the adoption of the FAIR-compliant vocabularies. |
RDA-I2-01D | Data uses FAIR-compliant vocabularies | Useful | See RDA-I2-01M | See RDA-I2-01M |
RDA-I3-01M | Metadata includes references to other metadata | Important | FHIR supports different kinds of (qualified) references among FHIR resources and also to non-FHIR objects. Communities should determine what are the (qualified) references to other resources that are needed to provide a sufficient contextual knowledge for the scope of their community. This should be formalized through a community FHIR Implementation Guide. |
A qualified reference is intended as a cross-reference that explains its intent. HL7 FHIR technically supports different kinds of (qualified) references among FHIR resources and also to non-FHIR objects. This capability of HL7 FHIR doesn't guarantee however "per se" that as many meaningful links between metadata and data resources are used to enrich the contextual knowledge about the data (that is the goal). Thus, if on one hand this principle is technically satisfied by HL7 FHIR, FHIR implementers should determine what are the links among resources that are needed to provide a sufficient contextual knowledge for the scope of their community. The realization of this requirement may depend on the data and metadata design approach (e.g. hybrid approaches with some metadata represented using non-FHIR technologies) . |
RDA-I3-01D | Data includes references to other data | Useful | See RDA-I3-01M | See RDA-I3-01M |
RDA-I3-02M | Metadata includes references to other data | Useful | See RDA-I3-01M | See RDA-I3-01M |
RDA-I3-02D | Data includes qualified references to other data | Useful | See RDA-I3-01M | See RDA-I3-01M |
RDA-I3-03M | Metadata includes qualified references to other metadata | Important | See RDA-I3-01M | See RDA-I3-01M |
RDA-I3-04M | Metadata include qualified references to other data | Useful | See RDA-I3-01M | See RDA-I3-01M |
INDICATOR_ID | INDICATORS | PRIORITY | Interpretation for HL7 FHIR Data | Notes |
---|---|---|---|---|
RDA-R1-01M | Plurality of accurate and relevant attributes are provided to allow reuse | Essential | Each HL7 FHIR resource includes a rich set of attributes describing most relevant data and metadata. A formal extension mechanism is also specified by that standard to cover additional requirements. Communities should define which rich metadata are sufficient to describe data to make them useful in their context. This should be formalized with appropriate FHIR conformance resources in FHIR implementation guides. |
This requirement is related to the F2, but while F2 focuses on metadata that allows its discovery, R1 focuses on the context under which the data were generated as well as they should been used. General considerations made for F2 about FHIR apply also for R1, FHIR is therefore an enabling factor, but the conformance with FHIR is not necessarily a sufficient condition for fulfilling this requirement. The fact data and metadata are 'richly described' depends on the context of use; therefore, depending on the use case, implementers should identify what are the minimal, recommended and suggested intrinsic and contextual information that should be returned to describe the data and make them actually USEFUL in a particular context. FHIR implementers should look for specific FHIR Implementation Guides (IG) that cover the Resource types and the use case of interest; and/or define FHIR IGs that apply in their usage context. The realization of this requirement may depend however on the data and metadata design approach (e.g. hybrid approaches with some metadata represented using non-FHIR technologies). |
RDA-R1.1-01M | Metadata includes information about the license under which the data can be reused | Essential | FHIR provides different means to specify the license and the conditions under which data can be reused. Published FHIR resources have to include clear references to the usage license. |
Please refer to RDA-F1-01M and RDA-F1-01D for the discussion on distinct and identifiable metadata and data FAIR objects HL7 HL7 FHIR provides different means to specify the license and the conditions under which data can be used. For example, a resource may convey specific security metadata by using the security labels, enabling policy fragments to accompany the resource data; the Citation resource offers a copyright element to covey human readable copyright information at different level of granularity (Citation , abstract, cited artefacts); the Consent resource can be used to record choices which permits or denies identified recipient(s) or recipient role(s) to perform one or more actions within a given policy context, for specific purposes and periods of time. The solution to be adopted may change depending on the type of data and the context of use. The adoption of FHIR is not however a sufficient condition for fulfilling this requirement, implementers should therefore define how this requirement is supposed to be met. The fulfillment of this requirement depends moreover on the capability of the organization to capture and record this kind of information. |
RDA-R1.1-02M | Metadata refers to a standard reuse license | Important | See RDA-R1.1-01M | See RDA-R1.1-01M. |
RDA-R1.1-03M | Metadata refers to a machine-understandable reuse license | Important | See RDA-R1.1-01M | See RDA-R1.1-01M. |
RDA-R1.2-01M | Metadata includes provenance information according to community-specific standards | Important | HL7 FHIR offers a Provence resource enabling the recording of information sources and of the actions applied to them. Other resources, as the Citation, could be used for capturing instead publication related infos. The adoption of FHIR is not however a sufficient condition for fulfilling this requirement. Communities are encouraged to use the Provenance resource to improve description the data context. They should moreover specify in FHIR implementation guide how this requirement is realized in their context. |
Please refer to RDA-F1-01M and RDA-F1-01D for the discussion on distinct and identifiable metadata and data FAIR objects HL7. This principle focuses on specific type of contextual data as where the data came from, how they have been processed; if it has been published before; who need to be cited and/or acknowledged.... Most of this information may be captured in HL7 FHIR by using the Provence resource enabling the recording of data sources and of the actions applied on them at different level of granularity. Other kinds of resources, e.g. the Citation, could be used for capturing instead publication related infos. As for some other principles, HL7 FHIR can technically support the data FAIRness, but it is not a sufficient condition for fulfilling this requirement; that depends also on the capability of the organization to capture and record this information. |
RDA-R1.2-02M | Metadata includes provenance information according to a cross-community language | Useful | See RDA-R1.2-01M | See RDA-R1.2-01M |
RDA-R1.3-01M | Metadata complies with a community standard | Essential | FHIR is a standard that can be used to represent human and machine-readable metadata and data information. Even though HL7 FHIR can be considered it self a 'domain-relevant community standard' , implementers are strongly suggested to identify, and if needed specify, appropriate FHIR Implementation Guides covering the community expectations in terms of models, vocabularies and other objects for their context of use. |
Please refer to RDA-F1-01M and RDA-F1-01D for the discussion on distinct and identifiable metadata and data FAIR objects HL7. HL7 FHIR is a globally recognized standard in the health domain, that can be used to represent human and machine-readable metadata and data information. There are several published FHIR Implementation Guides describing how FHIR should be used for specific scopes. Beyond this, there might be implementation independent standards (e.g. clinical guidelines) a community wish to refer to. Implementers are therefore suggested to look for existing FHIR implementation guides or define new ones to cover appropriately the community expectations. |
RDA-R1.3-01D | Data complies with a community standard | Essential | See RDA-R1.3-01M | See RDA-R1.3-01M |
RDA-R1.3-02M | Metadata is expressed in compliance with a machine-understandable community standard | Essential | See RDA-R1.3-01M | See RDA-R1.3-01M |
RDA-R1.3-02D | Data is expressed in compliance with a machine-understandable community standard | Important | See RDA-R1.3-01M | See RDA-R1.3-01M |