advanced aspects of fhir - hl7 › wp-content › uploads › 2015 › 03 › hl7austria2015... ·...
TRANSCRIPT
![Page 1: Advanced Aspects of FHIR - HL7 › wp-content › uploads › 2015 › 03 › HL7Austria2015... · © 2012 HL7 ® International. Licensed under Creative Commons. HL7 & Health Level](https://reader034.vdocuments.site/reader034/viewer/2022042409/5f2621cb0c37a839b440fe16/html5/thumbnails/1.jpg)
© 2012 HL7 ® International. Licensed under Creative Commons. HL7 & Health Level Seven are registered trademarks of Health Level Seven International. Reg. U.S. TM Office.
Advanced Aspects of FHIR
Hands-on Training Course
Ewout Kramer
March 2015
![Page 2: Advanced Aspects of FHIR - HL7 › wp-content › uploads › 2015 › 03 › HL7Austria2015... · © 2012 HL7 ® International. Licensed under Creative Commons. HL7 & Health Level](https://reader034.vdocuments.site/reader034/viewer/2022042409/5f2621cb0c37a839b440fe16/html5/thumbnails/2.jpg)
© 2012 HL7 ® International. Licensed under Creative Commons. HL7 & Health Level Seven are registered trademarks of Health Level Seven International. Reg. U.S. TM Office.
Who am I?
Name: Ewout Kramer
Company: Furore, Amsterdam
Background:
FHIR core team, RIMBAA
Software developer & healthcare
architect
Contact:
www.thefhirplace.com
![Page 3: Advanced Aspects of FHIR - HL7 › wp-content › uploads › 2015 › 03 › HL7Austria2015... · © 2012 HL7 ® International. Licensed under Creative Commons. HL7 & Health Level](https://reader034.vdocuments.site/reader034/viewer/2022042409/5f2621cb0c37a839b440fe16/html5/thumbnails/3.jpg)
© 2012 HL7 ® International. Licensed under Creative Commons. HL7 & Health Level Seven are registered trademarks of Health Level Seven International. Reg. U.S. TM Office.
Program
Search functionality
Documents and Messages
Exercise #1 – Constructing a FHIR Document
The DSTU2 Class Hierarchy and Operations
Exercise #2 - Using the validate operation
Introducing the DSTU2 Conformance Layer
Using the C#/Java API’s
Interactive session - DSTU2
![Page 4: Advanced Aspects of FHIR - HL7 › wp-content › uploads › 2015 › 03 › HL7Austria2015... · © 2012 HL7 ® International. Licensed under Creative Commons. HL7 & Health Level](https://reader034.vdocuments.site/reader034/viewer/2022042409/5f2621cb0c37a839b440fe16/html5/thumbnails/4.jpg)
© 2012 HL7 ® International. Licensed under Creative Commons. HL7 & Health Level Seven are registered trademarks of Health Level Seven International. Reg. U.S. TM Office.
SEARCH FUNCTIONALITY
![Page 5: Advanced Aspects of FHIR - HL7 › wp-content › uploads › 2015 › 03 › HL7Austria2015... · © 2012 HL7 ® International. Licensed under Creative Commons. HL7 & Health Level](https://reader034.vdocuments.site/reader034/viewer/2022042409/5f2621cb0c37a839b440fe16/html5/thumbnails/5.jpg)
© 2012 HL7 ® International. Licensed under Creative Commons. HL7 & Health Level Seven are registered trademarks of Health Level Seven International. Reg. U.S. TM Office.
Getting “all” patients
http://server.org/fhir/Patient
Always returns a paged feed
Use _count to indicate number of results per page
Special case of the “real” search operation:
http://server.org/fhir/Patient/_search?name=eve
http://server.org/fhir/Patient?name=eve
![Page 6: Advanced Aspects of FHIR - HL7 › wp-content › uploads › 2015 › 03 › HL7Austria2015... · © 2012 HL7 ® International. Licensed under Creative Commons. HL7 & Health Level](https://reader034.vdocuments.site/reader034/viewer/2022042409/5f2621cb0c37a839b440fe16/html5/thumbnails/6.jpg)
© 2012 HL7 ® International. Licensed under Creative Commons. HL7 & Health Level Seven are registered trademarks of Health Level Seven International. Reg. U.S. TM Office.
Search (patient)
Each resource has a set of “standard”
search operations, so not every element
can be searched!:
Our last search
used this one
![Page 7: Advanced Aspects of FHIR - HL7 › wp-content › uploads › 2015 › 03 › HL7Austria2015... · © 2012 HL7 ® International. Licensed under Creative Commons. HL7 & Health Level](https://reader034.vdocuments.site/reader034/viewer/2022042409/5f2621cb0c37a839b440fe16/html5/thumbnails/7.jpg)
© 2012 HL7 ® International. Licensed under Creative Commons. HL7 & Health Level Seven are registered trademarks of Health Level Seven International. Reg. U.S. TM Office.
Combining parameters
Specifying multiple parameters finds
resources matching all params “AND”
Parameters may list multiple values “OR”
http://server.org/fhir
/Patient/_search?
birthdate=1972-11-30
&language=NL,FR
![Page 8: Advanced Aspects of FHIR - HL7 › wp-content › uploads › 2015 › 03 › HL7Austria2015... · © 2012 HL7 ® International. Licensed under Creative Commons. HL7 & Health Level](https://reader034.vdocuments.site/reader034/viewer/2022042409/5f2621cb0c37a839b440fe16/html5/thumbnails/8.jpg)
© 2012 HL7 ® International. Licensed under Creative Commons. HL7 & Health Level Seven are registered trademarks of Health Level Seven International. Reg. U.S. TM Office.
Search (patient)
Each search parameter has a ‘type’
Parameter
Type
![Page 9: Advanced Aspects of FHIR - HL7 › wp-content › uploads › 2015 › 03 › HL7Austria2015... · © 2012 HL7 ® International. Licensed under Creative Commons. HL7 & Health Level](https://reader034.vdocuments.site/reader034/viewer/2022042409/5f2621cb0c37a839b440fe16/html5/thumbnails/9.jpg)
© 2012 HL7 ® International. Licensed under Creative Commons. HL7 & Health Level Seven are registered trademarks of Health Level Seven International. Reg. U.S. TM Office.
Ok I get it…or not?
http://server.org/fhir/Patient/ 406 hits
http://server.org/fhir/Patient?gender=M 234 hits
http://server.org/fhir/Patient?gender=F 167 hits
Total: 234 + 167 = 401
http://server.org/fhir/Patient/ 406 hits
http://server.org/fhir/Patient?gender=M 234 hits
http://server.org/fhir/Patient?gender=F 167 hits
http://server.org/fhir/Patient?gender:missing=true 5 hits
Total: 234 + 167 + 5 = 406
![Page 10: Advanced Aspects of FHIR - HL7 › wp-content › uploads › 2015 › 03 › HL7Austria2015... · © 2012 HL7 ® International. Licensed under Creative Commons. HL7 & Health Level](https://reader034.vdocuments.site/reader034/viewer/2022042409/5f2621cb0c37a839b440fe16/html5/thumbnails/10.jpg)
© 2012 HL7 ® International. Licensed under Creative Commons. HL7 & Health Level Seven are registered trademarks of Health Level Seven International. Reg. U.S. TM Office.
Chained searches
Patient has a search for “name”.
Observation has a search for “subject” (the
id of the Patient, Group or Device)
How do I find Observations for a patient,
searching using his name?
![Page 11: Advanced Aspects of FHIR - HL7 › wp-content › uploads › 2015 › 03 › HL7Austria2015... · © 2012 HL7 ® International. Licensed under Creative Commons. HL7 & Health Level](https://reader034.vdocuments.site/reader034/viewer/2022042409/5f2621cb0c37a839b440fe16/html5/thumbnails/11.jpg)
© 2012 HL7 ® International. Licensed under Creative Commons. HL7 & Health Level Seven are registered trademarks of Health Level Seven International. Reg. U.S. TM Office.
2 queries in 1
You (as a client) don’t need to do separate
operations, just one:
http://server.com/fhir/Observation/_search?
subject.name=jim
But note: this still only works on the predefined
search parameters. You cannot just use any
property of the resource.
![Page 12: Advanced Aspects of FHIR - HL7 › wp-content › uploads › 2015 › 03 › HL7Austria2015... · © 2012 HL7 ® International. Licensed under Creative Commons. HL7 & Health Level](https://reader034.vdocuments.site/reader034/viewer/2022042409/5f2621cb0c37a839b440fe16/html5/thumbnails/12.jpg)
© 2012 HL7 ® International. Licensed under Creative Commons. HL7 & Health Level Seven are registered trademarks of Health Level Seven International. Reg. U.S. TM Office.
More optimalizations
Say we do:
http://fhir.com/fhir/Observation?date=2014-01-20
We get back: a Bundle with 0..* “Observations”
Now, usually, wouldn’t we want the Patient
information too? => Need to do “N” queries
for the Observation’s “subject”
Quicker:
?_include=Observation.subject
Returns both Observations + Patients
![Page 13: Advanced Aspects of FHIR - HL7 › wp-content › uploads › 2015 › 03 › HL7Austria2015... · © 2012 HL7 ® International. Licensed under Creative Commons. HL7 & Health Level](https://reader034.vdocuments.site/reader034/viewer/2022042409/5f2621cb0c37a839b440fe16/html5/thumbnails/13.jpg)
© 2012 HL7 ® International. Licensed under Creative Commons. HL7 & Health Level Seven are registered trademarks of Health Level Seven International. Reg. U.S. TM Office.
BEYOND RESTHow FHIR supports documents and messages
![Page 14: Advanced Aspects of FHIR - HL7 › wp-content › uploads › 2015 › 03 › HL7Austria2015... · © 2012 HL7 ® International. Licensed under Creative Commons. HL7 & Health Level](https://reader034.vdocuments.site/reader034/viewer/2022042409/5f2621cb0c37a839b440fe16/html5/thumbnails/14.jpg)
© 2012 HL7 ® International. Licensed under Creative Commons. HL7 & Health Level Seven are registered trademarks of Health Level Seven International. Reg. U.S. TM Office.
Paradigms
FHIR supports 4 interoperability paradigms
REST Documents
Messages Services
![Page 15: Advanced Aspects of FHIR - HL7 › wp-content › uploads › 2015 › 03 › HL7Austria2015... · © 2012 HL7 ® International. Licensed under Creative Commons. HL7 & Health Level](https://reader034.vdocuments.site/reader034/viewer/2022042409/5f2621cb0c37a839b440fe16/html5/thumbnails/15.jpg)
© 2012 HL7 ® International. Licensed under Creative Commons. HL7 & Health Level Seven are registered trademarks of Health Level Seven International. Reg. U.S. TM Office.
FHIR
Repository
Regardless of paradigm
the content is the same
Lab System
Receive a lab result in a message…
FHIR MessageFHIR Document
…Package it in a discharge summary document
National
Exchange
![Page 16: Advanced Aspects of FHIR - HL7 › wp-content › uploads › 2015 › 03 › HL7Austria2015... · © 2012 HL7 ® International. Licensed under Creative Commons. HL7 & Health Level](https://reader034.vdocuments.site/reader034/viewer/2022042409/5f2621cb0c37a839b440fe16/html5/thumbnails/16.jpg)
© 2012 HL7 ® International. Licensed under Creative Commons. HL7 & Health Level Seven are registered trademarks of Health Level Seven International. Reg. U.S. TM Office.
The Document resource
A single Resource, very often a List
![Page 17: Advanced Aspects of FHIR - HL7 › wp-content › uploads › 2015 › 03 › HL7Austria2015... · © 2012 HL7 ® International. Licensed under Creative Commons. HL7 & Health Level](https://reader034.vdocuments.site/reader034/viewer/2022042409/5f2621cb0c37a839b440fe16/html5/thumbnails/17.jpg)
© 2012 HL7 ® International. Licensed under Creative Commons. HL7 & Health Level Seven are registered trademarks of Health Level Seven International. Reg. U.S. TM Office.
FHIR Document
Dr. BernardPractitioner
Patient MaryPatient
Discharge Medslist
Vital Signslist
PulseObservation
BPObservation
DyclofenacMedicationPrescription
TamsulosinMedicationPrescription
Kidney StonesCondition
Discharge
SummaryComposition
Chief
Complaintsection
Physicalsection
Medicationssection
entry
entry
![Page 18: Advanced Aspects of FHIR - HL7 › wp-content › uploads › 2015 › 03 › HL7Austria2015... · © 2012 HL7 ® International. Licensed under Creative Commons. HL7 & Health Level](https://reader034.vdocuments.site/reader034/viewer/2022042409/5f2621cb0c37a839b440fe16/html5/thumbnails/18.jpg)
© 2012 HL7 ® International. Licensed under Creative Commons. HL7 & Health Level Seven are registered trademarks of Health Level Seven International. Reg. U.S. TM Office.
Documents – are bundles
Observation Resource
Composition Resource
Section
Section
Device Resource
Patient Resource
Prescription Resource
<feed>
<entry>
<Composition />
</entry>
<entry>
<Observation />
</entry>
<entry>
<Device />
</entry>
<entry>
<Prescription />
</entry>
<entry>
<Patient />
</entry>
</feed>
AttesterMetadata
![Page 19: Advanced Aspects of FHIR - HL7 › wp-content › uploads › 2015 › 03 › HL7Austria2015... · © 2012 HL7 ® International. Licensed under Creative Commons. HL7 & Health Level](https://reader034.vdocuments.site/reader034/viewer/2022042409/5f2621cb0c37a839b440fe16/html5/thumbnails/19.jpg)
© 2012 HL7 ® International. Licensed under Creative Commons. HL7 & Health Level Seven are registered trademarks of Health Level Seven International. Reg. U.S. TM Office.
Tag as “Document”
This Bundle
is a
Document
![Page 20: Advanced Aspects of FHIR - HL7 › wp-content › uploads › 2015 › 03 › HL7Austria2015... · © 2012 HL7 ® International. Licensed under Creative Commons. HL7 & Health Level](https://reader034.vdocuments.site/reader034/viewer/2022042409/5f2621cb0c37a839b440fe16/html5/thumbnails/20.jpg)
© 2012 HL7 ® International. Licensed under Creative Commons. HL7 & Health Level Seven are registered trademarks of Health Level Seven International. Reg. U.S. TM Office.
CDA to FHIR
Document bridge
Hospital System A
FHIR
Documents
Note: Documents are compositions,
• No update semantics
• Context?
• Wholeness?
FHIR
Repository
FHIR
REST
FHIR Document
processor
V3 and FHIR
![Page 21: Advanced Aspects of FHIR - HL7 › wp-content › uploads › 2015 › 03 › HL7Austria2015... · © 2012 HL7 ® International. Licensed under Creative Commons. HL7 & Health Level](https://reader034.vdocuments.site/reader034/viewer/2022042409/5f2621cb0c37a839b440fe16/html5/thumbnails/21.jpg)
© 2012 HL7 ® International. Licensed under Creative Commons. HL7 & Health Level Seven are registered trademarks of Health Level Seven International. Reg. U.S. TM Office.
MessageHeaderResource
![Page 22: Advanced Aspects of FHIR - HL7 › wp-content › uploads › 2015 › 03 › HL7Austria2015... · © 2012 HL7 ® International. Licensed under Creative Commons. HL7 & Health Level](https://reader034.vdocuments.site/reader034/viewer/2022042409/5f2621cb0c37a839b440fe16/html5/thumbnails/22.jpg)
© 2012 HL7 ® International. Licensed under Creative Commons. HL7 & Health Level Seven are registered trademarks of Health Level Seven International. Reg. U.S. TM Office.
Messages – are bundles
Observation Resource
Message Resource
source destination
Device Resource
Patient Resource
<feed>
<entry>
<MessageHeader />
</entry>
<entry>
<Observation />
</entry>
<entry>
<Patient />
</entry>
<entry>
<Device />
</entry>
</feed>
event
![Page 23: Advanced Aspects of FHIR - HL7 › wp-content › uploads › 2015 › 03 › HL7Austria2015... · © 2012 HL7 ® International. Licensed under Creative Commons. HL7 & Health Level](https://reader034.vdocuments.site/reader034/viewer/2022042409/5f2621cb0c37a839b440fe16/html5/thumbnails/23.jpg)
© 2012 HL7 ® International. Licensed under Creative Commons. HL7 & Health Level Seven are registered trademarks of Health Level Seven International. Reg. U.S. TM Office.
Tag as “Message”
This Bundle
is a
Message
![Page 24: Advanced Aspects of FHIR - HL7 › wp-content › uploads › 2015 › 03 › HL7Austria2015... · © 2012 HL7 ® International. Licensed under Creative Commons. HL7 & Health Level](https://reader034.vdocuments.site/reader034/viewer/2022042409/5f2621cb0c37a839b440fe16/html5/thumbnails/24.jpg)
© 2012 HL7 ® International. Licensed under Creative Commons. HL7 & Health Level Seven are registered trademarks of Health Level Seven International. Reg. U.S. TM Office.
Sending messages
Again, REST not necessary, but…
There is an explicit REST endpoint:
http://server.org/fhir/Mailbox
No storage implied. Might be a router,
converted to v2, etc. etc.
The server can process them based on the
event code and return the response as
another message (again a bundle).
![Page 25: Advanced Aspects of FHIR - HL7 › wp-content › uploads › 2015 › 03 › HL7Austria2015... · © 2012 HL7 ® International. Licensed under Creative Commons. HL7 & Health Level](https://reader034.vdocuments.site/reader034/viewer/2022042409/5f2621cb0c37a839b440fe16/html5/thumbnails/25.jpg)
© 2012 HL7 ® International. Licensed under Creative Commons. HL7 & Health Level Seven are registered trademarks of Health Level Seven International. Reg. U.S. TM Office.
V2 to FHIR bridge
Hospital System
FHIR
Messages
Note: Messages are events,
REST exposes a “repository”
Model of data…
FHIR
Repository
FHIR
REST
FHIR Message
processor
V2 and FHIR
![Page 26: Advanced Aspects of FHIR - HL7 › wp-content › uploads › 2015 › 03 › HL7Austria2015... · © 2012 HL7 ® International. Licensed under Creative Commons. HL7 & Health Level](https://reader034.vdocuments.site/reader034/viewer/2022042409/5f2621cb0c37a839b440fe16/html5/thumbnails/26.jpg)
© 2012 HL7 ® International. Licensed under Creative Commons. HL7 & Health Level Seven are registered trademarks of Health Level Seven International. Reg. U.S. TM Office.
Exercise #1
Composing a FHIR Document
(45 minutes)
![Page 27: Advanced Aspects of FHIR - HL7 › wp-content › uploads › 2015 › 03 › HL7Austria2015... · © 2012 HL7 ® International. Licensed under Creative Commons. HL7 & Health Level](https://reader034.vdocuments.site/reader034/viewer/2022042409/5f2621cb0c37a839b440fe16/html5/thumbnails/27.jpg)
© 2012 HL7 ® International. Licensed under Creative Commons. HL7 & Health Level Seven are registered trademarks of Health Level Seven International. Reg. U.S. TM Office.
Exercise #1
Open PatsyPregnantDocument.xml
Sketch the structure of the document from the “root”
Composition to the sections and the resources referenced in the
sections.
Which element references an external resource?
Add a Medications section (not necessary to fully fill out a
Medication Resource though)
What if our EHR only has human-readable text available describing
the medications?
![Page 28: Advanced Aspects of FHIR - HL7 › wp-content › uploads › 2015 › 03 › HL7Austria2015... · © 2012 HL7 ® International. Licensed under Creative Commons. HL7 & Health Level](https://reader034.vdocuments.site/reader034/viewer/2022042409/5f2621cb0c37a839b440fe16/html5/thumbnails/28.jpg)
© 2012 HL7 ® International. Licensed under Creative Commons. HL7 & Health Level Seven are registered trademarks of Health Level Seven International. Reg. U.S. TM Office.
The sample document
![Page 29: Advanced Aspects of FHIR - HL7 › wp-content › uploads › 2015 › 03 › HL7Austria2015... · © 2012 HL7 ® International. Licensed under Creative Commons. HL7 & Health Level](https://reader034.vdocuments.site/reader034/viewer/2022042409/5f2621cb0c37a839b440fe16/html5/thumbnails/29.jpg)
© 2012 HL7 ® International. Licensed under Creative Commons. HL7 & Health Level Seven are registered trademarks of Health Level Seven International. Reg. U.S. TM Office.
CLASS HIERARCHYLooking forward to DSTU2
![Page 30: Advanced Aspects of FHIR - HL7 › wp-content › uploads › 2015 › 03 › HL7Austria2015... · © 2012 HL7 ® International. Licensed under Creative Commons. HL7 & Health Level](https://reader034.vdocuments.site/reader034/viewer/2022042409/5f2621cb0c37a839b440fe16/html5/thumbnails/30.jpg)
© 2012 HL7 ® International. Licensed under Creative Commons. HL7 & Health Level Seven are registered trademarks of Health Level Seven International. Reg. U.S. TM Office.
No hierarchy in DSTU1
There were just “resources”
The metadata (also the id) was not part of
the resource data and class definitions
Resources had no “base class” with
common properties (extensions, text)
FAQ: Where are those properties?
![Page 31: Advanced Aspects of FHIR - HL7 › wp-content › uploads › 2015 › 03 › HL7Austria2015... · © 2012 HL7 ® International. Licensed under Creative Commons. HL7 & Health Level](https://reader034.vdocuments.site/reader034/viewer/2022042409/5f2621cb0c37a839b440fe16/html5/thumbnails/31.jpg)
© 2012 HL7 ® International. Licensed under Creative Commons. HL7 & Health Level Seven are registered trademarks of Health Level Seven International. Reg. U.S. TM Office.
More trouble
In DSTU1 we had Resources and we
combined Resources into Bundles
But Bundles were Atom…
Two parsers, two code paths, no
commonality
31
![Page 32: Advanced Aspects of FHIR - HL7 › wp-content › uploads › 2015 › 03 › HL7Austria2015... · © 2012 HL7 ® International. Licensed under Creative Commons. HL7 & Health Level](https://reader034.vdocuments.site/reader034/viewer/2022042409/5f2621cb0c37a839b440fe16/html5/thumbnails/32.jpg)
© 2012 HL7 ® International. Licensed under Creative Commons. HL7 & Health Level Seven are registered trademarks of Health Level Seven International. Reg. U.S. TM Office.
Overview
32
Resource
DomainResource
Patient Observation
Bundle
Entry
![Page 33: Advanced Aspects of FHIR - HL7 › wp-content › uploads › 2015 › 03 › HL7Austria2015... · © 2012 HL7 ® International. Licensed under Creative Commons. HL7 & Health Level](https://reader034.vdocuments.site/reader034/viewer/2022042409/5f2621cb0c37a839b440fe16/html5/thumbnails/33.jpg)
© 2012 HL7 ® International. Licensed under Creative Commons. HL7 & Health Level Seven are registered trademarks of Health Level Seven International. Reg. U.S. TM Office.
Basic elements
33
Resource
Id (http://example.org/fhir/Patient/4A33)
VersionId (http://example.org/fhir/Patient/4A33/_history/1)
LastUpdated
Profile (0..* Uri’s)
Tag (0..* Coding)
Security (0..* Coding)
DomainResource
Text (the Resource’s narrative)
Contained (0..* Resource)
Extension (0..* Extension)
ModifierExtension (0..* Extension)
Patient
Bundle
![Page 34: Advanced Aspects of FHIR - HL7 › wp-content › uploads › 2015 › 03 › HL7Austria2015... · © 2012 HL7 ® International. Licensed under Creative Commons. HL7 & Health Level](https://reader034.vdocuments.site/reader034/viewer/2022042409/5f2621cb0c37a839b440fe16/html5/thumbnails/34.jpg)
© 2012 HL7 ® International. Licensed under Creative Commons. HL7 & Health Level Seven are registered trademarks of Health Level Seven International. Reg. U.S. TM Office.
The Base Resource
34
Base Resource in the specification
![Page 35: Advanced Aspects of FHIR - HL7 › wp-content › uploads › 2015 › 03 › HL7Austria2015... · © 2012 HL7 ® International. Licensed under Creative Commons. HL7 & Health Level](https://reader034.vdocuments.site/reader034/viewer/2022042409/5f2621cb0c37a839b440fe16/html5/thumbnails/35.jpg)
© 2012 HL7 ® International. Licensed under Creative Commons. HL7 & Health Level Seven are registered trademarks of Health Level Seven International. Reg. U.S. TM Office.
Demo: Full example
35
![Page 36: Advanced Aspects of FHIR - HL7 › wp-content › uploads › 2015 › 03 › HL7Austria2015... · © 2012 HL7 ® International. Licensed under Creative Commons. HL7 & Health Level](https://reader034.vdocuments.site/reader034/viewer/2022042409/5f2621cb0c37a839b440fe16/html5/thumbnails/36.jpg)
© 2012 HL7 ® International. Licensed under Creative Commons. HL7 & Health Level Seven are registered trademarks of Health Level Seven International. Reg. U.S. TM Office.
INTRODUCING THE OPERATIONS FRAMEWORK
Looking forward to DSTU2
![Page 37: Advanced Aspects of FHIR - HL7 › wp-content › uploads › 2015 › 03 › HL7Austria2015... · © 2012 HL7 ® International. Licensed under Creative Commons. HL7 & Health Level](https://reader034.vdocuments.site/reader034/viewer/2022042409/5f2621cb0c37a839b440fe16/html5/thumbnails/37.jpg)
© 2012 HL7 ® International. Licensed under Creative Commons. HL7 & Health Level Seven are registered trademarks of Health Level Seven International. Reg. U.S. TM Office.
Operations framework
37
FHIR RepositoryStandard
FHIR REST
Operations
Read
Update
Search
Expand
ValueSetValidate
![Page 38: Advanced Aspects of FHIR - HL7 › wp-content › uploads › 2015 › 03 › HL7Austria2015... · © 2012 HL7 ® International. Licensed under Creative Commons. HL7 & Health Level](https://reader034.vdocuments.site/reader034/viewer/2022042409/5f2621cb0c37a839b440fe16/html5/thumbnails/38.jpg)
© 2012 HL7 ® International. Licensed under Creative Commons. HL7 & Health Level Seven are registered trademarks of Health Level Seven International. Reg. U.S. TM Office.
Operations framework
Seamlessly extends the RESTful API
Uses an RPC-like paradigm
Operations
have a name
have input and output parameters
have a context - system, resource type, or
resource instance
See specification for defined FHIR operations
38
![Page 39: Advanced Aspects of FHIR - HL7 › wp-content › uploads › 2015 › 03 › HL7Austria2015... · © 2012 HL7 ® International. Licensed under Creative Commons. HL7 & Health Level](https://reader034.vdocuments.site/reader034/viewer/2022042409/5f2621cb0c37a839b440fe16/html5/thumbnails/39.jpg)
© 2012 HL7 ® International. Licensed under Creative Commons. HL7 & Health Level Seven are registered trademarks of Health Level Seven International. Reg. U.S. TM Office.
Operation request
HTTP POST
End-point depends on context:
system: [base]/$[name]
resource type [base]/[type]/$[name]
resource instance: [base]/[type]/[id]/$[name]
Example:POST [base]/ValueSet/$expand
39
![Page 40: Advanced Aspects of FHIR - HL7 › wp-content › uploads › 2015 › 03 › HL7Austria2015... · © 2012 HL7 ® International. Licensed under Creative Commons. HL7 & Health Level](https://reader034.vdocuments.site/reader034/viewer/2022042409/5f2621cb0c37a839b440fe16/html5/thumbnails/40.jpg)
© 2012 HL7 ® International. Licensed under Creative Commons. HL7 & Health Level Seven are registered trademarks of Health Level Seven International. Reg. U.S. TM Office.
Parameters Resource
40
![Page 41: Advanced Aspects of FHIR - HL7 › wp-content › uploads › 2015 › 03 › HL7Austria2015... · © 2012 HL7 ® International. Licensed under Creative Commons. HL7 & Health Level](https://reader034.vdocuments.site/reader034/viewer/2022042409/5f2621cb0c37a839b440fe16/html5/thumbnails/41.jpg)
© 2012 HL7 ® International. Licensed under Creative Commons. HL7 & Health Level Seven are registered trademarks of Health Level Seven International. Reg. U.S. TM Office.
Example
41
![Page 42: Advanced Aspects of FHIR - HL7 › wp-content › uploads › 2015 › 03 › HL7Austria2015... · © 2012 HL7 ® International. Licensed under Creative Commons. HL7 & Health Level](https://reader034.vdocuments.site/reader034/viewer/2022042409/5f2621cb0c37a839b440fe16/html5/thumbnails/42.jpg)
© 2012 HL7 ® International. Licensed under Creative Commons. HL7 & Health Level Seven are registered trademarks of Health Level Seven International. Reg. U.S. TM Office.
Exercise #2
Using the validate operation
(45 minutes)
![Page 43: Advanced Aspects of FHIR - HL7 › wp-content › uploads › 2015 › 03 › HL7Austria2015... · © 2012 HL7 ® International. Licensed under Creative Commons. HL7 & Health Level](https://reader034.vdocuments.site/reader034/viewer/2022042409/5f2621cb0c37a839b440fe16/html5/thumbnails/43.jpg)
© 2012 HL7 ® International. Licensed under Creative Commons. HL7 & Health Level Seven are registered trademarks of Health Level Seven International. Reg. U.S. TM Office.
Exercise #2
Validate the Patient “uslab-example1” against the profile http://fhir-dev.healthintersections.com.au/open/Profile/patient-uslab-uslabpatient
Locate the “validate” operation on the base resource in the spec and look at the parameters
Construct a Parameters object containing the “uslab-example1” Patient and the profile http://fhir-dev.healthintersections.com.au/open/Profile/patient-uslab-uslabpatient
Invoke the $validate operation on the correct endpoint. Why are there two possible endpoints?
![Page 44: Advanced Aspects of FHIR - HL7 › wp-content › uploads › 2015 › 03 › HL7Austria2015... · © 2012 HL7 ® International. Licensed under Creative Commons. HL7 & Health Level](https://reader034.vdocuments.site/reader034/viewer/2022042409/5f2621cb0c37a839b440fe16/html5/thumbnails/44.jpg)
© 2012 HL7 ® International. Licensed under Creative Commons. HL7 & Health Level Seven are registered trademarks of Health Level Seven International. Reg. U.S. TM Office.
Operation Outcome
When something goes wrong….return the
OperationOutcome Resource!
![Page 45: Advanced Aspects of FHIR - HL7 › wp-content › uploads › 2015 › 03 › HL7Austria2015... · © 2012 HL7 ® International. Licensed under Creative Commons. HL7 & Health Level](https://reader034.vdocuments.site/reader034/viewer/2022042409/5f2621cb0c37a839b440fe16/html5/thumbnails/45.jpg)
© 2012 HL7 ® International. Licensed under Creative Commons. HL7 & Health Level Seven are registered trademarks of Health Level Seven International. Reg. U.S. TM Office.
INTRODUCING THE CONFORMANCE LAYER
Looking forward to DSTU2
![Page 46: Advanced Aspects of FHIR - HL7 › wp-content › uploads › 2015 › 03 › HL7Austria2015... · © 2012 HL7 ® International. Licensed under Creative Commons. HL7 & Health Level](https://reader034.vdocuments.site/reader034/viewer/2022042409/5f2621cb0c37a839b440fe16/html5/thumbnails/46.jpg)
© 2012 HL7 ® International. Licensed under Creative Commons. HL7 & Health Level Seven are registered trademarks of Health Level Seven International. Reg. U.S. TM Office.
How to adapt the specs to meet our needs
46
“Profile”
Structure
Definition
SearchParam
Definition
ValueSet
ConceptMap
NamingSystem
Operation
Definition
Conformance
![Page 47: Advanced Aspects of FHIR - HL7 › wp-content › uploads › 2015 › 03 › HL7Austria2015... · © 2012 HL7 ® International. Licensed under Creative Commons. HL7 & Health Level](https://reader034.vdocuments.site/reader034/viewer/2022042409/5f2621cb0c37a839b440fe16/html5/thumbnails/47.jpg)
© 2012 HL7 ® International. Licensed under Creative Commons. HL7 & Health Level Seven are registered trademarks of Health Level Seven International. Reg. U.S. TM Office.
The need for Conformance
Many different contexts in healthcare, but a single “core spec” with operations and Resources
Need to be able to describe restrictions based on use and context
Allow for these usage statements to: Authored in a structured manner
Published in a repository
Used as the basis for validation, code, report and UI generation
![Page 48: Advanced Aspects of FHIR - HL7 › wp-content › uploads › 2015 › 03 › HL7Austria2015... · © 2012 HL7 ® International. Licensed under Creative Commons. HL7 & Health Level](https://reader034.vdocuments.site/reader034/viewer/2022042409/5f2621cb0c37a839b440fe16/html5/thumbnails/48.jpg)
© 2012 HL7 ® International. Licensed under Creative Commons. HL7 & Health Level Seven are registered trademarks of Health Level Seven International. Reg. U.S. TM Office.
Extend/restrictthe API
Conformancedescribes how a client or server
uses or should use the FHIR API
• Which wire formats supported?
• Which resources?
• Which operations (read, create,
update, search)
• Which FHIR version?
• What search operations?
• Is this a test server?
• Who can I contact?
• What’s the name of the software?
![Page 49: Advanced Aspects of FHIR - HL7 › wp-content › uploads › 2015 › 03 › HL7Austria2015... · © 2012 HL7 ® International. Licensed under Creative Commons. HL7 & Health Level](https://reader034.vdocuments.site/reader034/viewer/2022042409/5f2621cb0c37a839b440fe16/html5/thumbnails/49.jpg)
© 2012 HL7 ® International. Licensed under Creative Commons. HL7 & Health Level Seven are registered trademarks of Health Level Seven International. Reg. U.S. TM Office.
Extend/restrictthe API
OperationDefinitiondescribes additional operations over
and above the RESTful interactions
defined in the specification
• What is the name?
• Input/output parameters
• What does it do?
• Works on which resources?
![Page 50: Advanced Aspects of FHIR - HL7 › wp-content › uploads › 2015 › 03 › HL7Austria2015... · © 2012 HL7 ® International. Licensed under Creative Commons. HL7 & Health Level](https://reader034.vdocuments.site/reader034/viewer/2022042409/5f2621cb0c37a839b440fe16/html5/thumbnails/50.jpg)
© 2012 HL7 ® International. Licensed under Creative Commons. HL7 & Health Level Seven are registered trademarks of Health Level Seven International. Reg. U.S. TM Office.
50
StructureDefinition• Core definition (see validation.zip)
• Constraints
• Extensions
![Page 51: Advanced Aspects of FHIR - HL7 › wp-content › uploads › 2015 › 03 › HL7Austria2015... · © 2012 HL7 ® International. Licensed under Creative Commons. HL7 & Health Level](https://reader034.vdocuments.site/reader034/viewer/2022042409/5f2621cb0c37a839b440fe16/html5/thumbnails/51.jpg)
© 2012 HL7 ® International. Licensed under Creative Commons. HL7 & Health Level Seven are registered trademarks of Health Level Seven International. Reg. U.S. TM Office.
Extend/restrict Resources
StructureDefinition
describes additional restrictions on or possible
extensions to a resource or datatype
“Must use only the Dutch national patient identifier”
“In our Patient registration system, we use these
maritalStatus codes beyond those provided by HL7…”
“We need to add a field to specify the Tax Office of an
organization”
![Page 52: Advanced Aspects of FHIR - HL7 › wp-content › uploads › 2015 › 03 › HL7Austria2015... · © 2012 HL7 ® International. Licensed under Creative Commons. HL7 & Health Level](https://reader034.vdocuments.site/reader034/viewer/2022042409/5f2621cb0c37a839b440fe16/html5/thumbnails/52.jpg)
© 2012 HL7 ® International. Licensed under Creative Commons. HL7 & Health Level Seven are registered trademarks of Health Level Seven International. Reg. U.S. TM Office.
Constraining cardinality
Limit cardinality to 1..2
(e.g. to at maximum your
organizations’ identifier + the
national one)1..2
1..1
Limit names to just 1 (instead of 0..*)
Forbid any telecom elements
0..0
Note: something that’s mandatory in the core definition
cannot be made optional in a profile
![Page 53: Advanced Aspects of FHIR - HL7 › wp-content › uploads › 2015 › 03 › HL7Austria2015... · © 2012 HL7 ® International. Licensed under Creative Commons. HL7 & Health Level](https://reader034.vdocuments.site/reader034/viewer/2022042409/5f2621cb0c37a839b440fe16/html5/thumbnails/53.jpg)
© 2012 HL7 ® International. Licensed under Creative Commons. HL7 & Health Level Seven are registered trademarks of Health Level Seven International. Reg. U.S. TM Office.
Limit value domains
Fix value: Only allow “active”
Patients
=“true”
If deceased is given, it must be
a dateTime, not a boolean
Use our national codes for
MaritalStatus
Use another profiled Resource
OrganizationNL
![Page 54: Advanced Aspects of FHIR - HL7 › wp-content › uploads › 2015 › 03 › HL7Austria2015... · © 2012 HL7 ® International. Licensed under Creative Commons. HL7 & Health Level](https://reader034.vdocuments.site/reader034/viewer/2022042409/5f2621cb0c37a839b440fe16/html5/thumbnails/54.jpg)
© 2012 HL7 ® International. Licensed under Creative Commons. HL7 & Health Level Seven are registered trademarks of Health Level Seven International. Reg. U.S. TM Office.
Extending a resource
54
Key = location of formal definition
Value = value according to definition
![Page 55: Advanced Aspects of FHIR - HL7 › wp-content › uploads › 2015 › 03 › HL7Austria2015... · © 2012 HL7 ® International. Licensed under Creative Commons. HL7 & Health Level](https://reader034.vdocuments.site/reader034/viewer/2022042409/5f2621cb0c37a839b440fe16/html5/thumbnails/55.jpg)
© 2012 HL7 ® International. Licensed under Creative Commons. HL7 & Health Level Seven are registered trademarks of Health Level Seven International. Reg. U.S. TM Office.
ValueSets
![Page 56: Advanced Aspects of FHIR - HL7 › wp-content › uploads › 2015 › 03 › HL7Austria2015... · © 2012 HL7 ® International. Licensed under Creative Commons. HL7 & Health Level](https://reader034.vdocuments.site/reader034/viewer/2022042409/5f2621cb0c37a839b440fe16/html5/thumbnails/56.jpg)
© 2012 HL7 ® International. Licensed under Creative Commons. HL7 & Health Level Seven are registered trademarks of Health Level Seven International. Reg. U.S. TM Office.
56
• Publication meta-data
• Concepts from 1 or
more existing systems
• Additional concepts
![Page 57: Advanced Aspects of FHIR - HL7 › wp-content › uploads › 2015 › 03 › HL7Austria2015... · © 2012 HL7 ® International. Licensed under Creative Commons. HL7 & Health Level](https://reader034.vdocuments.site/reader034/viewer/2022042409/5f2621cb0c37a839b440fe16/html5/thumbnails/57.jpg)
© 2012 HL7 ® International. Licensed under Creative Commons. HL7 & Health Level Seven are registered trademarks of Health Level Seven International. Reg. U.S. TM Office.
Implementation Guide Publication
Publication tool
Website
Validation
Schema’s
Examples
DictXmlResource profiles
Profiled resources
Structure
DefinitionValueSet
ConceptMap
NamingSystem
OperationDefinition
![Page 58: Advanced Aspects of FHIR - HL7 › wp-content › uploads › 2015 › 03 › HL7Austria2015... · © 2012 HL7 ® International. Licensed under Creative Commons. HL7 & Health Level](https://reader034.vdocuments.site/reader034/viewer/2022042409/5f2621cb0c37a839b440fe16/html5/thumbnails/58.jpg)
© 2012 HL7 ® International. Licensed under Creative Commons. HL7 & Health Level Seven are registered trademarks of Health Level Seven International. Reg. U.S. TM Office.
![Page 59: Advanced Aspects of FHIR - HL7 › wp-content › uploads › 2015 › 03 › HL7Austria2015... · © 2012 HL7 ® International. Licensed under Creative Commons. HL7 & Health Level](https://reader034.vdocuments.site/reader034/viewer/2022042409/5f2621cb0c37a839b440fe16/html5/thumbnails/59.jpg)
© 2012 HL7 ® International. Licensed under Creative Commons. HL7 & Health Level Seven are registered trademarks of Health Level Seven International. Reg. U.S. TM Office.
HL7.FHIR SUPPORT APIUsing the Reference Implementations
![Page 60: Advanced Aspects of FHIR - HL7 › wp-content › uploads › 2015 › 03 › HL7Austria2015... · © 2012 HL7 ® International. Licensed under Creative Commons. HL7 & Health Level](https://reader034.vdocuments.site/reader034/viewer/2022042409/5f2621cb0c37a839b440fe16/html5/thumbnails/60.jpg)
© 2012 HL7 ® International. Licensed under Creative Commons. HL7 & Health Level Seven are registered trademarks of Health Level Seven International. Reg. U.S. TM Office.
Reference implementations
- Contents
- Model – classes generated from the spec
- Parsers – Parsers generated from the spec
- Serializers – Serializers generated from the spec
- FhirClient
- Validation
- Java – Maven
- .NET – NuGet “FHIR”, or GitHub “fhir-net-api”
![Page 61: Advanced Aspects of FHIR - HL7 › wp-content › uploads › 2015 › 03 › HL7Austria2015... · © 2012 HL7 ® International. Licensed under Creative Commons. HL7 & Health Level](https://reader034.vdocuments.site/reader034/viewer/2022042409/5f2621cb0c37a839b440fe16/html5/thumbnails/61.jpg)
© 2012 HL7 ® International. Licensed under Creative Commons. HL7 & Health Level Seven are registered trademarks of Health Level Seven International. Reg. U.S. TM Office.
![Page 62: Advanced Aspects of FHIR - HL7 › wp-content › uploads › 2015 › 03 › HL7Austria2015... · © 2012 HL7 ® International. Licensed under Creative Commons. HL7 & Health Level](https://reader034.vdocuments.site/reader034/viewer/2022042409/5f2621cb0c37a839b440fe16/html5/thumbnails/62.jpg)
© 2012 HL7 ® International. Licensed under Creative Commons. HL7 & Health Level Seven are registered trademarks of Health Level Seven International. Reg. U.S. TM Office.
Example
Let’s look at the validation exercise and
see what the reference implementation
can do for you
62
![Page 63: Advanced Aspects of FHIR - HL7 › wp-content › uploads › 2015 › 03 › HL7Austria2015... · © 2012 HL7 ® International. Licensed under Creative Commons. HL7 & Health Level](https://reader034.vdocuments.site/reader034/viewer/2022042409/5f2621cb0c37a839b440fe16/html5/thumbnails/63.jpg)
© 2012 HL7 ® International. Licensed under Creative Commons. HL7 & Health Level Seven are registered trademarks of Health Level Seven International. Reg. U.S. TM Office.
Example: validation with the API
![Page 64: Advanced Aspects of FHIR - HL7 › wp-content › uploads › 2015 › 03 › HL7Austria2015... · © 2012 HL7 ® International. Licensed under Creative Commons. HL7 & Health Level](https://reader034.vdocuments.site/reader034/viewer/2022042409/5f2621cb0c37a839b440fe16/html5/thumbnails/64.jpg)
© 2012 HL7 ® International. Licensed under Creative Commons. HL7 & Health Level Seven are registered trademarks of Health Level Seven International. Reg. U.S. TM Office.
INTERACTIVE SESSION
![Page 65: Advanced Aspects of FHIR - HL7 › wp-content › uploads › 2015 › 03 › HL7Austria2015... · © 2012 HL7 ® International. Licensed under Creative Commons. HL7 & Health Level](https://reader034.vdocuments.site/reader034/viewer/2022042409/5f2621cb0c37a839b440fe16/html5/thumbnails/65.jpg)
© 2012 HL7 ® International. Licensed under Creative Commons. HL7 & Health Level Seven are registered trademarks of Health Level Seven International. Reg. U.S. TM Office.
FHIR Timeline (planned)
2012 20162014 2018 2020
First
Draft
2011 20152013 2017 2019
1st
DSTU~ 2nd
DSTU
~ 1st
Norm.
~ 2nd
Norm.. . .
![Page 66: Advanced Aspects of FHIR - HL7 › wp-content › uploads › 2015 › 03 › HL7Austria2015... · © 2012 HL7 ® International. Licensed under Creative Commons. HL7 & Health Level](https://reader034.vdocuments.site/reader034/viewer/2022042409/5f2621cb0c37a839b440fe16/html5/thumbnails/66.jpg)
© 2012 HL7 ® International. Licensed under Creative Commons. HL7 & Health Level Seven are registered trademarks of Health Level Seven International. Reg. U.S. TM Office.
What would you like to know
about DSTU2?
![Page 67: Advanced Aspects of FHIR - HL7 › wp-content › uploads › 2015 › 03 › HL7Austria2015... · © 2012 HL7 ® International. Licensed under Creative Commons. HL7 & Health Level](https://reader034.vdocuments.site/reader034/viewer/2022042409/5f2621cb0c37a839b440fe16/html5/thumbnails/67.jpg)
© 2012 HL7 ® International. Licensed under Creative Commons. HL7 & Health Level Seven are registered trademarks of Health Level Seven International. Reg. U.S. TM Office.
WHAT’S NEXT?
![Page 68: Advanced Aspects of FHIR - HL7 › wp-content › uploads › 2015 › 03 › HL7Austria2015... · © 2012 HL7 ® International. Licensed under Creative Commons. HL7 & Health Level](https://reader034.vdocuments.site/reader034/viewer/2022042409/5f2621cb0c37a839b440fe16/html5/thumbnails/68.jpg)
© 2012 HL7 ® International. Licensed under Creative Commons. HL7 & Health Level Seven are registered trademarks of Health Level Seven International. Reg. U.S. TM Office.
Next Steps for you
Read the spec: http://hl7.org/fhir
Try implementing it
Come to a Connectathon!
#FHIR
Implementor’s Skype Channel
StackOverflow: hl7 fhir tag
![Page 69: Advanced Aspects of FHIR - HL7 › wp-content › uploads › 2015 › 03 › HL7Austria2015... · © 2012 HL7 ® International. Licensed under Creative Commons. HL7 & Health Level](https://reader034.vdocuments.site/reader034/viewer/2022042409/5f2621cb0c37a839b440fe16/html5/thumbnails/69.jpg)
© 2012 HL7 ® International. Licensed under Creative Commons. HL7 & Health Level Seven are registered trademarks of Health Level Seven International. Reg. U.S. TM Office.
International Working Group Meeting
Mark Your Calendar and Join Us!
Paris, France
May 10 – 15
69
![Page 70: Advanced Aspects of FHIR - HL7 › wp-content › uploads › 2015 › 03 › HL7Austria2015... · © 2012 HL7 ® International. Licensed under Creative Commons. HL7 & Health Level](https://reader034.vdocuments.site/reader034/viewer/2022042409/5f2621cb0c37a839b440fe16/html5/thumbnails/70.jpg)
© 2012 HL7 ® International. Licensed under Creative Commons. HL7 & Health Level Seven are registered trademarks of Health Level Seven International. Reg. U.S. TM Office.
International HL7 FHIR Developer DaysNovember 18-20, 2015 in Amsterdam
Education
Tutorials
Connectathon
Meet fellow developers
Put FHIR to the test
Networking
FHIR experts and authors on hand
http://fhir.furore.com/devdays
![Page 71: Advanced Aspects of FHIR - HL7 › wp-content › uploads › 2015 › 03 › HL7Austria2015... · © 2012 HL7 ® International. Licensed under Creative Commons. HL7 & Health Level](https://reader034.vdocuments.site/reader034/viewer/2022042409/5f2621cb0c37a839b440fe16/html5/thumbnails/71.jpg)
© 2012 HL7 ® International. Licensed under Creative Commons. HL7 & Health Level Seven are registered trademarks of Health Level Seven International. Reg. U.S. TM Office.
The End –
Questions?