forked from hl7-fhir/fhir-dstu1
-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy pathoverview.html
192 lines (171 loc) · 11.7 KB
/
overview.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
<!DOCTYPE HTML>
[%settitle FHIR Overview%]
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
<head>
[%file newheader%]
</head>
<body>
[%file newnavbar%]
<div class="col-9">
<a name="root"> </a>
<h2>FHIR Overview</h2>
<p>
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.
</p>
<h3>Background</h3>
<p>
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 <a href="change.html">Coming digital challenges in healthcare</a>)
</p>
<p>
<a href="http://hl7.org">HL7</a> 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 <a href="comparison.html">Comparing FHIR to other HL7 standards</a>)
</p>
<p>
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 <a href="comparison.html">Comparing FHIR
to other HL7 standards</a>)
</p>
<h3>Components</h3>
<p>
The basic building block in FHIR is a <a href="resources.html">Resource</a>. All exchangeable content is defined as a resource. Resources all share the following set of characteristics:
</p>
<ul>
<li>A common way to <a href="resources.html">define</a> and <a href="formats.html">represent</a> them, building them from <a href="datatypes.html">data types</a> that define common reusable patterns of elements</li>
<li>A common set of <a href="resources.html#metadata">metadata</a></li>
<li>A <a href="narrative.html">human readable</a> part</li>
</ul>
<h3>Approach</h3>
<h4>Approach to information modeling</h4>
<p>
The philosophy behind FHIR is to build a base set of resources that,
either by themselves or when combined, satisfy the majority of common
user 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 <a href="extensibility.html">built-in extension mechanism</a> to
cover the remaining content as needed.
</p>
<p>
FHIR modeling uses a composition approach. In comparison, HL7 v3 modeling is
based on "model by constraint" (see <a href="comparison.html">Comparing FHIR
to other HL7 standards</a>). With FHIR, specific use cases are usually implemented
by combining resources together through the use of <a href="references.html">resource references</a>.
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:
</p>
<ul>
<li><a href="conformance.html">Conformance Statement</a> – describes the interfaces that an implementation exposes for exchange of data</li>
<li><a href="profile.html">Profile</a> - provide additional rules that serve to constrain the optionality, cardinality, terminology bindings, data types and extensions defined in the resources used by the implementation</li>
</ul>
<h3>The Specification</h3>
<p>
Broadly, the FHIR specification is broken up into 3 parts:
</p>
<ul>
<li>General <a href="documentation.html">documentation</a> that describes how <a href="resources.html">resources are defined</a>,
and gives background material including definitions of <a href="datatypes.html">data types</a>, <a href="terminologies.html">codes</a>, and the <a href="xml.html">XML</a> and <a href="json.html">JSON formats</a></li>
<li><a href="implementation.html">Implementation</a> - how to use resources using <a href="http.html">REST</a>, <a href="messaging.html">Messaging</a>, as <a href="documents.html">clinical documents</a>, or in a <a href="services.html">service based architecture</a></li>
<li>The <a href="resourcelist.html">resource list</a> - a list of all the resources defined by FHIR. You can also get lists
for <a href="clinical.html">clinical</a>, <a href="administration.html">administrative</a> and <a href="infrastructure.html">infrastructural</a> resources</li>
</ul>
<p>
Resources have a wide range of uses, from pure clinical content such as <a href="careplan.html">care plans</a> and <a href="diagnosticreport.html">diagnostic reports</a> through to pure infrastructure
such as <a href="messageheader.html">Message Header</a> and <a href="conformance.html">conformance</a> 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.
</p>
<h3>Where to Start</h3>
<p>
The best place to start is to quickly read the <a href="resourcelist.html">Resources</a> list to get a sense of what resources exist and then look at
the <a href="patient.html">Patient resource</a> definition to see what resource definitions look like, and then read these background pages:
</p>
<ul>
<li><a href="resources.html">Resource Definitions</a> - basic background to how resources are defined</li>
<li>About Resources: the <a href="narrative.html">Narrative</a> they all contain, and how <a href="references.html">Resources refer to each other</a></li>
<li><a href="formats.html">Formats</a>: <a href="xml.html">XML</a> and <a href="json.html">JSON</a></li>
<li>About <a href="extensibility.html">Extensibility</a>: a key way that the specification is kept simple</li>
<li>If you are coming to FHIR with a background in another HL7 standard (v2, v3 or CDA), <a href="comparison.html">The Relationship between FHIR and other HL7 Standards</a> may also be useful</li>
</ul>
<h4>Header Tabs</h4>
<p>
These header tabs found through-out the specification are important, and many readers miss them:
</p>
<p>
<img src="header-tabs.png"/>
<br/>
</p>
<p>
Resources and the <a href="datatypes.html">data types</a> that they use are presented in an concise easy to read XML-like format,
but they also have formal definitions 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.
</p>
<h3>Style conventions</h3>
<p>
This document uses some simple style conventions:
<code>this content represents information that may go over the wire</code>
<i>this is the name of a data element</i>
</p>
<h3>Finding Additional Information and Providing Feedback</h3>
<p>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.
</p>
<p>
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.
</p>
<h4>Comments</h4>
<p>
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 currated to ensure ongoing relevance, particularly if the specification is subsequently updated to eliminate confusion that may have
spawned an initial comment.
</p>
<h4>The FHIR Wiki</h4>
<p>
The FHIR project team also maintains a <a href="http://wiki.hl7.org/index.php?title=FHIR">wiki</a> 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.
</p>
<p>
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 <a href="http://wiki.hl7.org/index.php?title=FHIR_Development_Process">FHIR methodology</a>,
use of the <a href="http://wiki.hl7.org/index.php?title=FHIR_Guide_to_Authoring_Resources">FHIR design tools</a>, etc. To
explore the FHIR wiki, you can start at the <a href="http://wiki.hl7.org/index.php?title=FHIR">root page</a>
</p>
<h4>Formal Change requests</h4>
<p>
Formal requests for change can be submitted <a href="http://gforge.hl7.org/gf/project/fhir/tracker/?action=TrackerItemAdd&tracker_id=677">here</a>.
(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.
</p>
<h4>Additional Information sources/Engagement Mechanisms</h4>
<p>
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
<a href="http://wiki.hl7.org/index.php?title=FHIR#More_help_and_Asking_Questions">here</a>.
</p>
</div>
[%file newfooter%]
</body>
</html>