SlideShare a Scribd company logo
FHIR® is the registered trademark of HL7 and is used with the permission of HL7. The Flame Design mark is the registered trademark of HL7 and is used with the permission of HL7.
Amsterdam, 15-17 November | @fhir_furore | #fhirdevdays17 | www.fhirdevdays.com
FHIR Documents
Rick Geimer, Chief Innovation Officer, Lantana Consulting Group
Instructor
• Rick Geimer
• Co-Chair Structured Documents Working Group
• HL7 CDA R2 Certified Specialist
• Co-Editor, CDA Consolidation and many other implementation guides
• Lead: C-CDA on FHIR project
• Day job: Chief Innovation Officer, Lantana Consulting Group
• rick.geimer@lantanagroup.com
Lantana Consulting Group
• Our Mission
• Improve healthcare through health information technology (IT)
• Lead the industry through consulting and volunteer practice
• Our Services
• Software and standard development and implementation
• Terminology, data governance, and education
• Strategic advice for health IT planning, design, and purchasing
Outline
• Overview of Clinical Documents
• FHIR Documents
• The Composition Resource
• Document Bundles
• Document Operations and APIs
Clinical Documents
• This is a document
• and this
• and this
• and this
• and this
• and this
Clinical Documents
• Persistence – A clinical document continues to exist in an unaltered state, for a
time period defined by local and regulatory requirements. Note: documents
outlive the servers (and often the syntax) on which they are created.
• Stewardship – A clinical document is maintained by an organization entrusted
with its care.
• Potential for authentication – A clinical document is an assemblage of
information that is intended to be legally authenticated.
• Context – A clinical document establishes the default context for its contents.
• Wholeness – Authentication of a clinical document applies to the whole and does
not apply to portions of the document without the full context of the document.
• Human readability – A clinical document is human-readable.
Why are documents important?
• The clinical record has a dual nature
• Data
• Narrative
• Documents support that duality
• Essential for disparate teams—different disciplines, contexts, or clinical
systems
• Developers need coded data to drive applications
• Clinicians often say that the most important part of the clinical record is the
narrative written by their colleagues
FHIR Documents
FHIR Documents
• Position: FHIR is the document future
• Call to action:
• Define, document, and promote a future
where clinical documents and
Application Programming Interfaces
(APIs) share a common syntax and set of
resources
• Establish, in technical and regulatory
policy, a smooth roadmap to the future
of clinical document exchange
FHIR Documents
• Address CDA use case for clinical documents
• Collection of resources bound together
• Root is a Composition resource
• Much like the CDA header + narrative
• Sent as a Bundle resource
• Can be signed, authenticated, etc.
• Has the same basic obligations as a CDA document
• Full rules: http://build.fhir.org/documents.html
Why FHIR Developers Might be Interested in Documents
• Load FHIR servers with massive amounts of existing data
• Most electronic health record (EHR) systems export CDA
• Their CDA export capabilities are more stable than many of their FHIR APIs (if any)
• Converting CDA to FHIR is one of the quickest standardized path to Big Data in healthcare
today
• Comply with existing requirements
• FHIR is simpler than CDA
• Teach developers to create FHIR documents, then convert to CDA for compliance with
existing regulations
• FHIR as an API for creating CDA documents
• Prepare for when FHIR documents are the norm
<Bundle>
<entry>
<Composition />
</entry>
<entry>
<Observation />
</entry>
<entry>
<Device />
</entry>
<entry>
<Prescription />
</entry>
<entry>
<Patient />
</entry>
</Bundle>
Observation Resource
Composition Resource
Section
Section
Device Resource
Patient Resource
Prescription Resource
AttesterMetadata
FHIR Documents are Bundles of Resources
Composition Resource
• Contains
• Patient
• Author
• Custodian
• Type of document (e.g., Discharge Summary)
• Attested narrative of the document
• Sufficient for
• Medical records management
• Document management
• Enabling clinical document exchange across and within institutions
• Human readable documents
Chart
Clinical
Documents
Composition in Detail
• Key fields
• Identifier
• Date
• Type
• Subject
• Author
• Attester
• Custodian
• Sections and narrative
• References to other resources
Sections and Narrative
• Composition resources contain sections (which may be nested)
• Section narrative markup is XHTML
• Narrative contains the attested text of the document
• OK for sections to consist of only human readable text (i.e., no
machine processable resources)
First: Human Readable
<section>
<title value="Allergies and Intolerances"/>
<code>
<coding>
<system value="http://loinc.org"/>
<code value="48765-2"/>
<display value="Allergies and adverse reactions"/>
</coding>
</code>
<text>
<status value="generated"/>
<div xmlns="http://www.w3.org/1999/xhtml">
<ul>
<li>Penicillin - Hives</li>
...
</ul>
</div>
</text>
...
</section>
Allergies and Intolerances
• Penicillin - Hives
<AllergyIntolerance xmlns="http://hl7.org/fhir">
<clinicalStatus value="active"/>
<verificationStatus value="confirmed"/>
<category value="medication"/>
<criticality value="high"/>
<code>
<coding>
<system value="http://snomed.info/sct"/>
<code value="418038007"/>
<display value="allergy to penicillin"/>
</coding>
</code>
<patient>
Next, Coded Data
<assertedDate value="2000"/>
<reaction>
<manifestation>
<coding>
<system value="http://snomed.info/sct"/>
<code value="247472004"/>
<display value="hives"/>
</coding>
</manifestation>
<severity value="mild"/>
</reaction>
</AllergyIntolerance>
A Bit of Bundle
• Type = document
• Bundle.identifier
• Version dependent
• Must be globally unique to satisfy
the persistence requirement
• First resource is Composition
• Documents must be standalone, so…
• The Bundle should (some would say
must) contain all resources
referenced from the Composition
<?xml version="1.0" encoding="UTF-8"?>
<Bundle xmlns="http://hl7.org/fhir">
<id value="ee5590ab-72c0-4c07-9dc0-cc574729cd0a"/>
<type value="document"/>
<entry>
<fullUrl value="urn:uuid:511b05b3-8c3d-4cbe-b9d8-fe5f8666f994"/>
<resource>
<Composition>
<subject>
<reference value="urn:uuid:9f334dba-57b1-47bf-a2ba-a60d9583c8bb"/>
</subject>
...
</Composition>
</resource>
</entry>
<entry>
<fullUrl value="urn:uuid:9f334dba-57b1-47bf-a2ba-a60d9583c8bb"/>
<resource>
<Patient>...</Patient>
</resource>
</entry>
</Bundle>
References in Bundles
This example shows UUID URIs, but can
be a FHIR server URL such as
http://example.org/fhir/Patient/1
Rendering FHIR Documents
• When the document is presented for human consumption,
applications SHOULD present the collated narrative portions
in order:
• Subject resource Narrative
• Composition resource Narrative
• section.text Narratives
• Reference stylesheet (XSLT)
• Document2HTML.xslt in the XML Tools download
• http://hl7.org/fhir/downloads.html
Demonstration
• Review a FHIR Document Bundle
FHIR APIs
• REST = “Representational state transfer”
(an architecture for how to connect systems)
• Based on HTTP, the protocol that powers the Web
• Outcomes
• Simple stable interfaces
• High performance / scalability
• Visible process (e.g., can debug)
• Portability
• Reliability (resistance to failure)
• REST in FHIR
• The FHIR API is composed of RESTful web services
FHIR RESTful URLs
• CRUD(E) operations mapped to HTTP
• Create new resource: POST to the resource type endpoint
• Read existing resource: GET
• Update existing resource: PUT
• Delete existing resource: DELETE
• Execute: Use $operations in the URL
https://server.org/fhir/Patient/1
endpoint
resource type
id
Documents and FHIR APIs
• Generating documents
• Call $document on a Composition resource
• Stores at the /Bundle endpoint if persist=true
• Moving documents or storing externally created documents
• Send to /Bundle or /Binary depending on use case
• Use PUT to preserve IDs when sending to /Bundle
(First, make sure globally unique)
• Decomposing documents
• POST to the transaction endpoint
(May need to be converted to a transaction bundle first)
Managing FHIR Documents
• To satisfy the persistence and stewardship requirements, documents
must be stored somewhere (or reproduced on demand)
• The easiest way is on a FHIR server directly, either at the Bundle or
Binary endpoint
• Other options include document management systems, clinical data
repositories, etc.
• Important: documents (especially attested ones) should not be
generated, transmitted, then disposed of like a transient message
Validating FHIR Documents
• FHIR validation pack
• Includes XML Schema and Schematron files
• http://build.fhir.org/fhir-all-xsd.zip
• The FHIR Validator
• A Java JAR file that runs full FHIR validation
• http://build.fhir.org/validator.zip
• FHIR server validation
• Most servers to basic resource validation
• Use the $validate operation
• Can validate profiles like C-CDA on FHIR
• http://build.fhir.org/operation-resource-validate.html
Resources
• The FHIR specification
• Updated continuously
• Latest balloted version: http://hl7.org/fhir
• Continuous build: http://build.fhir.org/
• “FHIR CDA Position Statement and Roadmap”
Lantana white paper co-authored with Grahame Grieve; Updated April, 2015
• http://www.lantanagroup.com/resources/publications/
• Rick Geimer
• Updated continuously, rebooted occasionally
• rick.geimer@lantanagroup.com

More Related Content

What's hot

What is FHIR
What is FHIRWhat is FHIR
What is FHIR
Igor Bossenko
 
HL7 Fhir for Developers
HL7 Fhir for DevelopersHL7 Fhir for Developers
HL7 Fhir for Developers
Ewout Kramer
 
Building an Integrated Healthcare Platform with FHIR®
Building an Integrated Healthcare Platform with FHIR®Building an Integrated Healthcare Platform with FHIR®
Building an Integrated Healthcare Platform with FHIR®
WSO2
 
Security in FHIR with OAuth by Grahame Grieve
Security in FHIR with OAuth by Grahame GrieveSecurity in FHIR with OAuth by Grahame Grieve
Security in FHIR with OAuth by Grahame Grieve
FHIR Developer Days
 
Hl7 & FHIR
Hl7 & FHIRHl7 & FHIR
Integrating with the epic platform fhir dev days 17
Integrating with the epic platform fhir dev days 17Integrating with the epic platform fhir dev days 17
Integrating with the epic platform fhir dev days 17
DevDays
 
Introduction to HL7 FHIR
Introduction to HL7 FHIRIntroduction to HL7 FHIR
Introduction to HL7 FHIR
Health Informatics New Zealand
 
FHIR API for Java programmers by James Agnew
FHIR API for Java programmers by James AgnewFHIR API for Java programmers by James Agnew
FHIR API for Java programmers by James Agnew
FHIR Developer Days
 
Integrating Healthcare Applications with EMR Systems and Databases and Transf...
Integrating Healthcare Applications with EMR Systems and Databases and Transf...Integrating Healthcare Applications with EMR Systems and Databases and Transf...
Integrating Healthcare Applications with EMR Systems and Databases and Transf...
WSO2
 
FHIR Tutorial - Morning
FHIR Tutorial - MorningFHIR Tutorial - Morning
FHIR Tutorial - Morning
Ewout Kramer
 
FHIR tutorial - Afternoon
FHIR tutorial - AfternoonFHIR tutorial - Afternoon
FHIR tutorial - Afternoon
Ewout Kramer
 
An Introduction to HL7 FHIR
An Introduction to HL7 FHIRAn Introduction to HL7 FHIR
An Introduction to HL7 FHIR
Health Informatics New Zealand
 
2010 06 07 - LOINC Introduction
2010 06 07 - LOINC Introduction2010 06 07 - LOINC Introduction
2010 06 07 - LOINC Introductiondvreeman
 
FHIR - more than the basics
FHIR - more than the basicsFHIR - more than the basics
FHIR - more than the basics
Ewout Kramer
 
IHE on FHIR and DICOMweb 2017
IHE on FHIR and DICOMweb 2017IHE on FHIR and DICOMweb 2017
IHE on FHIR and DICOMweb 2017
Brad Genereaux
 
Fhir basics session4_conformance_and_terminology
Fhir basics session4_conformance_and_terminologyFhir basics session4_conformance_and_terminology
Fhir basics session4_conformance_and_terminology
Kumar Satyam
 
Introduction to FHIR™
Introduction to FHIR™Introduction to FHIR™
Introduction to FHIR™
Grahame Grieve
 
PECB Webinar: Overview of the PECB ISO 55001 Training and Certification course
PECB Webinar: Overview of the PECB ISO 55001 Training and Certification coursePECB Webinar: Overview of the PECB ISO 55001 Training and Certification course
PECB Webinar: Overview of the PECB ISO 55001 Training and Certification course
PECB
 
Understanding Resources in FHIR - Session 3 of FHIR basics training series
Understanding Resources in FHIR - Session 3 of FHIR basics training seriesUnderstanding Resources in FHIR - Session 3 of FHIR basics training series
Understanding Resources in FHIR - Session 3 of FHIR basics training series
Kumar Satyam
 

What's hot (20)

What is FHIR
What is FHIRWhat is FHIR
What is FHIR
 
HL7 Fhir for Developers
HL7 Fhir for DevelopersHL7 Fhir for Developers
HL7 Fhir for Developers
 
Building an Integrated Healthcare Platform with FHIR®
Building an Integrated Healthcare Platform with FHIR®Building an Integrated Healthcare Platform with FHIR®
Building an Integrated Healthcare Platform with FHIR®
 
Security in FHIR with OAuth by Grahame Grieve
Security in FHIR with OAuth by Grahame GrieveSecurity in FHIR with OAuth by Grahame Grieve
Security in FHIR with OAuth by Grahame Grieve
 
Hl7 & FHIR
Hl7 & FHIRHl7 & FHIR
Hl7 & FHIR
 
Integrating with the epic platform fhir dev days 17
Integrating with the epic platform fhir dev days 17Integrating with the epic platform fhir dev days 17
Integrating with the epic platform fhir dev days 17
 
Introduction to HL7 FHIR
Introduction to HL7 FHIRIntroduction to HL7 FHIR
Introduction to HL7 FHIR
 
FHIR API for Java programmers by James Agnew
FHIR API for Java programmers by James AgnewFHIR API for Java programmers by James Agnew
FHIR API for Java programmers by James Agnew
 
Integrating Healthcare Applications with EMR Systems and Databases and Transf...
Integrating Healthcare Applications with EMR Systems and Databases and Transf...Integrating Healthcare Applications with EMR Systems and Databases and Transf...
Integrating Healthcare Applications with EMR Systems and Databases and Transf...
 
FHIR Tutorial - Morning
FHIR Tutorial - MorningFHIR Tutorial - Morning
FHIR Tutorial - Morning
 
FHIR tutorial - Afternoon
FHIR tutorial - AfternoonFHIR tutorial - Afternoon
FHIR tutorial - Afternoon
 
An Introduction to HL7 FHIR
An Introduction to HL7 FHIRAn Introduction to HL7 FHIR
An Introduction to HL7 FHIR
 
Exploring HL7 CDA & Its Structures
Exploring HL7 CDA & Its StructuresExploring HL7 CDA & Its Structures
Exploring HL7 CDA & Its Structures
 
2010 06 07 - LOINC Introduction
2010 06 07 - LOINC Introduction2010 06 07 - LOINC Introduction
2010 06 07 - LOINC Introduction
 
FHIR - more than the basics
FHIR - more than the basicsFHIR - more than the basics
FHIR - more than the basics
 
IHE on FHIR and DICOMweb 2017
IHE on FHIR and DICOMweb 2017IHE on FHIR and DICOMweb 2017
IHE on FHIR and DICOMweb 2017
 
Fhir basics session4_conformance_and_terminology
Fhir basics session4_conformance_and_terminologyFhir basics session4_conformance_and_terminology
Fhir basics session4_conformance_and_terminology
 
Introduction to FHIR™
Introduction to FHIR™Introduction to FHIR™
Introduction to FHIR™
 
PECB Webinar: Overview of the PECB ISO 55001 Training and Certification course
PECB Webinar: Overview of the PECB ISO 55001 Training and Certification coursePECB Webinar: Overview of the PECB ISO 55001 Training and Certification course
PECB Webinar: Overview of the PECB ISO 55001 Training and Certification course
 
Understanding Resources in FHIR - Session 3 of FHIR basics training series
Understanding Resources in FHIR - Session 3 of FHIR basics training seriesUnderstanding Resources in FHIR - Session 3 of FHIR basics training series
Understanding Resources in FHIR - Session 3 of FHIR basics training series
 

Similar to fhir-documents

APIsecure 2023 - FHIR API Security, Grahame Grieve (Health Intersections)
APIsecure 2023 - FHIR API Security, Grahame Grieve (Health Intersections)APIsecure 2023 - FHIR API Security, Grahame Grieve (Health Intersections)
APIsecure 2023 - FHIR API Security, Grahame Grieve (Health Intersections)
apidays
 
2017 11-ccda-on-fhir
2017 11-ccda-on-fhir2017 11-ccda-on-fhir
2017 11-ccda-on-fhir
DevDays
 
Intro_To_FHIR.pptx
Intro_To_FHIR.pptxIntro_To_FHIR.pptx
Intro_To_FHIR.pptx
Pierluigi10
 
Health Information Exchange Standards - Compliance via Integration Testing
Health Information Exchange Standards  -  Compliance via Integration TestingHealth Information Exchange Standards  -  Compliance via Integration Testing
Health Information Exchange Standards - Compliance via Integration Testing
Health Informatics New Zealand
 
Furore devdays2017 general-introtofhir
Furore devdays2017 general-introtofhirFurore devdays2017 general-introtofhir
Furore devdays2017 general-introtofhir
DevDays
 
Fire and Ice - FHIR in New Zealand - David Hay
Fire and Ice - FHIR in New Zealand - David HayFire and Ice - FHIR in New Zealand - David Hay
Fire and Ice - FHIR in New Zealand - David Hay
HL7 New Zealand
 
FHIR.pptx
FHIR.pptxFHIR.pptx
FHIR.pptx
VITNetflix
 
FHIR for implementers in New Zealand
FHIR for implementers in New ZealandFHIR for implementers in New Zealand
FHIR for implementers in New Zealand
David Hay
 
Whats new (grahame)
Whats new (grahame)Whats new (grahame)
Whats new (grahame)
DevDays
 
Interoperability, the rise of HL7 and FHIR
Interoperability, the rise of HL7 and FHIRInteroperability, the rise of HL7 and FHIR
Interoperability, the rise of HL7 and FHIR
Suranga Nath Kasthurirathne
 
Devdays 2017 implementation guide authoring - ardon toonstra
Devdays 2017  implementation guide authoring - ardon toonstraDevdays 2017  implementation guide authoring - ardon toonstra
Devdays 2017 implementation guide authoring - ardon toonstra
DevDays
 
2010 CLARA Nijmegen - Data Seal of Approval tutorial
2010 CLARA Nijmegen - Data Seal of Approval tutorial2010 CLARA Nijmegen - Data Seal of Approval tutorial
2010 CLARA Nijmegen - Data Seal of Approval tutorial
Dirk Roorda
 
3.0 FHIR Deep Dive AMIA SA 2022.pdf
3.0 FHIR Deep Dive AMIA SA 2022.pdf3.0 FHIR Deep Dive AMIA SA 2022.pdf
3.0 FHIR Deep Dive AMIA SA 2022.pdf
VaishnaviYadav151699
 
Christchurch presentation
Christchurch presentationChristchurch presentation
Christchurch presentation
David Hay
 
Electronic Document and Record Management (EDRMS)
Electronic Document and Record Management (EDRMS) Electronic Document and Record Management (EDRMS)
Electronic Document and Record Management (EDRMS)
6PM Solutions
 
FHIR - as a new currency of exchange in New Zealand
FHIR - as a new currency of exchange in New ZealandFHIR - as a new currency of exchange in New Zealand
FHIR - as a new currency of exchange in New Zealand
David Hay
 
2016 SEP SMART ON FHIR
2016 SEP   SMART ON FHIR2016 SEP   SMART ON FHIR
2016 SEP SMART ON FHIR
Brett Esler
 
Clireo eTMF Solution by arivis
Clireo eTMF Solution by arivisClireo eTMF Solution by arivis
Clireo eTMF Solution by arivis
Tricia Campbell - McQuarrie
 
Introduction-and-RDF-Representation-of-FHIR-for-Clinical-Data
Introduction-and-RDF-Representation-of-FHIR-for-Clinical-DataIntroduction-and-RDF-Representation-of-FHIR-for-Clinical-Data
Introduction-and-RDF-Representation-of-FHIR-for-Clinical-Data
DATAVERSITY
 
Ihic preso v2
Ihic preso v2Ihic preso v2
Ihic preso v2
David Hay
 

Similar to fhir-documents (20)

APIsecure 2023 - FHIR API Security, Grahame Grieve (Health Intersections)
APIsecure 2023 - FHIR API Security, Grahame Grieve (Health Intersections)APIsecure 2023 - FHIR API Security, Grahame Grieve (Health Intersections)
APIsecure 2023 - FHIR API Security, Grahame Grieve (Health Intersections)
 
2017 11-ccda-on-fhir
2017 11-ccda-on-fhir2017 11-ccda-on-fhir
2017 11-ccda-on-fhir
 
Intro_To_FHIR.pptx
Intro_To_FHIR.pptxIntro_To_FHIR.pptx
Intro_To_FHIR.pptx
 
Health Information Exchange Standards - Compliance via Integration Testing
Health Information Exchange Standards  -  Compliance via Integration TestingHealth Information Exchange Standards  -  Compliance via Integration Testing
Health Information Exchange Standards - Compliance via Integration Testing
 
Furore devdays2017 general-introtofhir
Furore devdays2017 general-introtofhirFurore devdays2017 general-introtofhir
Furore devdays2017 general-introtofhir
 
Fire and Ice - FHIR in New Zealand - David Hay
Fire and Ice - FHIR in New Zealand - David HayFire and Ice - FHIR in New Zealand - David Hay
Fire and Ice - FHIR in New Zealand - David Hay
 
FHIR.pptx
FHIR.pptxFHIR.pptx
FHIR.pptx
 
FHIR for implementers in New Zealand
FHIR for implementers in New ZealandFHIR for implementers in New Zealand
FHIR for implementers in New Zealand
 
Whats new (grahame)
Whats new (grahame)Whats new (grahame)
Whats new (grahame)
 
Interoperability, the rise of HL7 and FHIR
Interoperability, the rise of HL7 and FHIRInteroperability, the rise of HL7 and FHIR
Interoperability, the rise of HL7 and FHIR
 
Devdays 2017 implementation guide authoring - ardon toonstra
Devdays 2017  implementation guide authoring - ardon toonstraDevdays 2017  implementation guide authoring - ardon toonstra
Devdays 2017 implementation guide authoring - ardon toonstra
 
2010 CLARA Nijmegen - Data Seal of Approval tutorial
2010 CLARA Nijmegen - Data Seal of Approval tutorial2010 CLARA Nijmegen - Data Seal of Approval tutorial
2010 CLARA Nijmegen - Data Seal of Approval tutorial
 
3.0 FHIR Deep Dive AMIA SA 2022.pdf
3.0 FHIR Deep Dive AMIA SA 2022.pdf3.0 FHIR Deep Dive AMIA SA 2022.pdf
3.0 FHIR Deep Dive AMIA SA 2022.pdf
 
Christchurch presentation
Christchurch presentationChristchurch presentation
Christchurch presentation
 
Electronic Document and Record Management (EDRMS)
Electronic Document and Record Management (EDRMS) Electronic Document and Record Management (EDRMS)
Electronic Document and Record Management (EDRMS)
 
FHIR - as a new currency of exchange in New Zealand
FHIR - as a new currency of exchange in New ZealandFHIR - as a new currency of exchange in New Zealand
FHIR - as a new currency of exchange in New Zealand
 
2016 SEP SMART ON FHIR
2016 SEP   SMART ON FHIR2016 SEP   SMART ON FHIR
2016 SEP SMART ON FHIR
 
Clireo eTMF Solution by arivis
Clireo eTMF Solution by arivisClireo eTMF Solution by arivis
Clireo eTMF Solution by arivis
 
Introduction-and-RDF-Representation-of-FHIR-for-Clinical-Data
Introduction-and-RDF-Representation-of-FHIR-for-Clinical-DataIntroduction-and-RDF-Representation-of-FHIR-for-Clinical-Data
Introduction-and-RDF-Representation-of-FHIR-for-Clinical-Data
 
Ihic preso v2
Ihic preso v2Ihic preso v2
Ihic preso v2
 

More from DevDays

Consent dev days
Consent dev daysConsent dev days
Consent dev days
DevDays
 
Mohannad hussain dicom and imaging tools
Mohannad hussain   dicom and imaging toolsMohannad hussain   dicom and imaging tools
Mohannad hussain dicom and imaging tools
DevDays
 
Mohannad hussain community track - siim dataset & dico mweb proxy
Mohannad hussain   community track - siim dataset & dico mweb proxyMohannad hussain   community track - siim dataset & dico mweb proxy
Mohannad hussain community track - siim dataset & dico mweb proxy
DevDays
 
final Keynote (grahame)
final Keynote (grahame)final Keynote (grahame)
final Keynote (grahame)
DevDays
 
Validation in net and java (ewout james)
Validation in net and java (ewout james)Validation in net and java (ewout james)
Validation in net and java (ewout james)
DevDays
 
Transforming other content (grahame)
Transforming other content (grahame)Transforming other content (grahame)
Transforming other content (grahame)
DevDays
 
Structure definition 101 (ewout)
Structure definition 101 (ewout)Structure definition 101 (ewout)
Structure definition 101 (ewout)
DevDays
 
Quality improvement dev days-2017
Quality improvement dev days-2017Quality improvement dev days-2017
Quality improvement dev days-2017
DevDays
 
Furore devdays 2017-sdc (lloyd)
Furore devdays 2017-sdc (lloyd)Furore devdays 2017-sdc (lloyd)
Furore devdays 2017-sdc (lloyd)
DevDays
 
Furore devdays 2017- rdf2(solbrig)
Furore devdays 2017- rdf2(solbrig)Furore devdays 2017- rdf2(solbrig)
Furore devdays 2017- rdf2(solbrig)
DevDays
 
Furore devdays 2017- rdf1(solbrig)
Furore devdays 2017- rdf1(solbrig)Furore devdays 2017- rdf1(solbrig)
Furore devdays 2017- rdf1(solbrig)
DevDays
 
Furore devdays 2017- oai
Furore devdays 2017- oaiFurore devdays 2017- oai
Furore devdays 2017- oai
DevDays
 
Furore devdays 2017 - implementation guides (lloyd)
Furore devdays 2017 - implementation guides (lloyd)Furore devdays 2017 - implementation guides (lloyd)
Furore devdays 2017 - implementation guides (lloyd)
DevDays
 
Dev days 2017 questionnaires (brian postlethwaite)
Dev days 2017 questionnaires (brian postlethwaite)Dev days 2017 questionnaires (brian postlethwaite)
Dev days 2017 questionnaires (brian postlethwaite)
DevDays
 
Dev days 2017 advanced directories (brian postlethwaite)
Dev days 2017 advanced directories (brian postlethwaite)Dev days 2017 advanced directories (brian postlethwaite)
Dev days 2017 advanced directories (brian postlethwaite)
DevDays
 
Connectathon opening 2017
Connectathon opening 2017Connectathon opening 2017
Connectathon opening 2017
DevDays
 
Building bridges devdays 2017- powerpoint template
Building bridges devdays 2017- powerpoint templateBuilding bridges devdays 2017- powerpoint template
Building bridges devdays 2017- powerpoint template
DevDays
 
20171127 rene spronk_messaging_the_unloved_paradigm
20171127 rene spronk_messaging_the_unloved_paradigm20171127 rene spronk_messaging_the_unloved_paradigm
20171127 rene spronk_messaging_the_unloved_paradigm
DevDays
 
Vonk fhir facade (christiaan)
Vonk fhir facade (christiaan)Vonk fhir facade (christiaan)
Vonk fhir facade (christiaan)
DevDays
 
Security overview (grahame)
Security overview (grahame)Security overview (grahame)
Security overview (grahame)
DevDays
 

More from DevDays (20)

Consent dev days
Consent dev daysConsent dev days
Consent dev days
 
Mohannad hussain dicom and imaging tools
Mohannad hussain   dicom and imaging toolsMohannad hussain   dicom and imaging tools
Mohannad hussain dicom and imaging tools
 
Mohannad hussain community track - siim dataset & dico mweb proxy
Mohannad hussain   community track - siim dataset & dico mweb proxyMohannad hussain   community track - siim dataset & dico mweb proxy
Mohannad hussain community track - siim dataset & dico mweb proxy
 
final Keynote (grahame)
final Keynote (grahame)final Keynote (grahame)
final Keynote (grahame)
 
Validation in net and java (ewout james)
Validation in net and java (ewout james)Validation in net and java (ewout james)
Validation in net and java (ewout james)
 
Transforming other content (grahame)
Transforming other content (grahame)Transforming other content (grahame)
Transforming other content (grahame)
 
Structure definition 101 (ewout)
Structure definition 101 (ewout)Structure definition 101 (ewout)
Structure definition 101 (ewout)
 
Quality improvement dev days-2017
Quality improvement dev days-2017Quality improvement dev days-2017
Quality improvement dev days-2017
 
Furore devdays 2017-sdc (lloyd)
Furore devdays 2017-sdc (lloyd)Furore devdays 2017-sdc (lloyd)
Furore devdays 2017-sdc (lloyd)
 
Furore devdays 2017- rdf2(solbrig)
Furore devdays 2017- rdf2(solbrig)Furore devdays 2017- rdf2(solbrig)
Furore devdays 2017- rdf2(solbrig)
 
Furore devdays 2017- rdf1(solbrig)
Furore devdays 2017- rdf1(solbrig)Furore devdays 2017- rdf1(solbrig)
Furore devdays 2017- rdf1(solbrig)
 
Furore devdays 2017- oai
Furore devdays 2017- oaiFurore devdays 2017- oai
Furore devdays 2017- oai
 
Furore devdays 2017 - implementation guides (lloyd)
Furore devdays 2017 - implementation guides (lloyd)Furore devdays 2017 - implementation guides (lloyd)
Furore devdays 2017 - implementation guides (lloyd)
 
Dev days 2017 questionnaires (brian postlethwaite)
Dev days 2017 questionnaires (brian postlethwaite)Dev days 2017 questionnaires (brian postlethwaite)
Dev days 2017 questionnaires (brian postlethwaite)
 
Dev days 2017 advanced directories (brian postlethwaite)
Dev days 2017 advanced directories (brian postlethwaite)Dev days 2017 advanced directories (brian postlethwaite)
Dev days 2017 advanced directories (brian postlethwaite)
 
Connectathon opening 2017
Connectathon opening 2017Connectathon opening 2017
Connectathon opening 2017
 
Building bridges devdays 2017- powerpoint template
Building bridges devdays 2017- powerpoint templateBuilding bridges devdays 2017- powerpoint template
Building bridges devdays 2017- powerpoint template
 
20171127 rene spronk_messaging_the_unloved_paradigm
20171127 rene spronk_messaging_the_unloved_paradigm20171127 rene spronk_messaging_the_unloved_paradigm
20171127 rene spronk_messaging_the_unloved_paradigm
 
Vonk fhir facade (christiaan)
Vonk fhir facade (christiaan)Vonk fhir facade (christiaan)
Vonk fhir facade (christiaan)
 
Security overview (grahame)
Security overview (grahame)Security overview (grahame)
Security overview (grahame)
 

Recently uploaded

The Challenger.pdf DNHS Official Publication
The Challenger.pdf DNHS Official PublicationThe Challenger.pdf DNHS Official Publication
The Challenger.pdf DNHS Official Publication
Delapenabediema
 
The Accursed House by Émile Gaboriau.pptx
The Accursed House by Émile Gaboriau.pptxThe Accursed House by Émile Gaboriau.pptx
The Accursed House by Émile Gaboriau.pptx
DhatriParmar
 
A Strategic Approach: GenAI in Education
A Strategic Approach: GenAI in EducationA Strategic Approach: GenAI in Education
A Strategic Approach: GenAI in Education
Peter Windle
 
CACJapan - GROUP Presentation 1- Wk 4.pdf
CACJapan - GROUP Presentation 1- Wk 4.pdfCACJapan - GROUP Presentation 1- Wk 4.pdf
CACJapan - GROUP Presentation 1- Wk 4.pdf
camakaiclarkmusic
 
Introduction to AI for Nonprofits with Tapp Network
Introduction to AI for Nonprofits with Tapp NetworkIntroduction to AI for Nonprofits with Tapp Network
Introduction to AI for Nonprofits with Tapp Network
TechSoup
 
The geography of Taylor Swift - some ideas
The geography of Taylor Swift - some ideasThe geography of Taylor Swift - some ideas
The geography of Taylor Swift - some ideas
GeoBlogs
 
Unit 2- Research Aptitude (UGC NET Paper I).pdf
Unit 2- Research Aptitude (UGC NET Paper I).pdfUnit 2- Research Aptitude (UGC NET Paper I).pdf
Unit 2- Research Aptitude (UGC NET Paper I).pdf
Thiyagu K
 
Supporting (UKRI) OA monographs at Salford.pptx
Supporting (UKRI) OA monographs at Salford.pptxSupporting (UKRI) OA monographs at Salford.pptx
Supporting (UKRI) OA monographs at Salford.pptx
Jisc
 
Acetabularia Information For Class 9 .docx
Acetabularia Information For Class 9  .docxAcetabularia Information For Class 9  .docx
Acetabularia Information For Class 9 .docx
vaibhavrinwa19
 
2024.06.01 Introducing a competency framework for languag learning materials ...
2024.06.01 Introducing a competency framework for languag learning materials ...2024.06.01 Introducing a competency framework for languag learning materials ...
2024.06.01 Introducing a competency framework for languag learning materials ...
Sandy Millin
 
Thesis Statement for students diagnonsed withADHD.ppt
Thesis Statement for students diagnonsed withADHD.pptThesis Statement for students diagnonsed withADHD.ppt
Thesis Statement for students diagnonsed withADHD.ppt
EverAndrsGuerraGuerr
 
Model Attribute Check Company Auto Property
Model Attribute  Check Company Auto PropertyModel Attribute  Check Company Auto Property
Model Attribute Check Company Auto Property
Celine George
 
Mule 4.6 & Java 17 Upgrade | MuleSoft Mysore Meetup #46
Mule 4.6 & Java 17 Upgrade | MuleSoft Mysore Meetup #46Mule 4.6 & Java 17 Upgrade | MuleSoft Mysore Meetup #46
Mule 4.6 & Java 17 Upgrade | MuleSoft Mysore Meetup #46
MysoreMuleSoftMeetup
 
Operation Blue Star - Saka Neela Tara
Operation Blue Star   -  Saka Neela TaraOperation Blue Star   -  Saka Neela Tara
Operation Blue Star - Saka Neela Tara
Balvir Singh
 
Adversarial Attention Modeling for Multi-dimensional Emotion Regression.pdf
Adversarial Attention Modeling for Multi-dimensional Emotion Regression.pdfAdversarial Attention Modeling for Multi-dimensional Emotion Regression.pdf
Adversarial Attention Modeling for Multi-dimensional Emotion Regression.pdf
Po-Chuan Chen
 
Sha'Carri Richardson Presentation 202345
Sha'Carri Richardson Presentation 202345Sha'Carri Richardson Presentation 202345
Sha'Carri Richardson Presentation 202345
beazzy04
 
The basics of sentences session 5pptx.pptx
The basics of sentences session 5pptx.pptxThe basics of sentences session 5pptx.pptx
The basics of sentences session 5pptx.pptx
heathfieldcps1
 
Palestine last event orientationfvgnh .pptx
Palestine last event orientationfvgnh .pptxPalestine last event orientationfvgnh .pptx
Palestine last event orientationfvgnh .pptx
RaedMohamed3
 
Instructions for Submissions thorugh G- Classroom.pptx
Instructions for Submissions thorugh G- Classroom.pptxInstructions for Submissions thorugh G- Classroom.pptx
Instructions for Submissions thorugh G- Classroom.pptx
Jheel Barad
 
The approach at University of Liverpool.pptx
The approach at University of Liverpool.pptxThe approach at University of Liverpool.pptx
The approach at University of Liverpool.pptx
Jisc
 

Recently uploaded (20)

The Challenger.pdf DNHS Official Publication
The Challenger.pdf DNHS Official PublicationThe Challenger.pdf DNHS Official Publication
The Challenger.pdf DNHS Official Publication
 
The Accursed House by Émile Gaboriau.pptx
The Accursed House by Émile Gaboriau.pptxThe Accursed House by Émile Gaboriau.pptx
The Accursed House by Émile Gaboriau.pptx
 
A Strategic Approach: GenAI in Education
A Strategic Approach: GenAI in EducationA Strategic Approach: GenAI in Education
A Strategic Approach: GenAI in Education
 
CACJapan - GROUP Presentation 1- Wk 4.pdf
CACJapan - GROUP Presentation 1- Wk 4.pdfCACJapan - GROUP Presentation 1- Wk 4.pdf
CACJapan - GROUP Presentation 1- Wk 4.pdf
 
Introduction to AI for Nonprofits with Tapp Network
Introduction to AI for Nonprofits with Tapp NetworkIntroduction to AI for Nonprofits with Tapp Network
Introduction to AI for Nonprofits with Tapp Network
 
The geography of Taylor Swift - some ideas
The geography of Taylor Swift - some ideasThe geography of Taylor Swift - some ideas
The geography of Taylor Swift - some ideas
 
Unit 2- Research Aptitude (UGC NET Paper I).pdf
Unit 2- Research Aptitude (UGC NET Paper I).pdfUnit 2- Research Aptitude (UGC NET Paper I).pdf
Unit 2- Research Aptitude (UGC NET Paper I).pdf
 
Supporting (UKRI) OA monographs at Salford.pptx
Supporting (UKRI) OA monographs at Salford.pptxSupporting (UKRI) OA monographs at Salford.pptx
Supporting (UKRI) OA monographs at Salford.pptx
 
Acetabularia Information For Class 9 .docx
Acetabularia Information For Class 9  .docxAcetabularia Information For Class 9  .docx
Acetabularia Information For Class 9 .docx
 
2024.06.01 Introducing a competency framework for languag learning materials ...
2024.06.01 Introducing a competency framework for languag learning materials ...2024.06.01 Introducing a competency framework for languag learning materials ...
2024.06.01 Introducing a competency framework for languag learning materials ...
 
Thesis Statement for students diagnonsed withADHD.ppt
Thesis Statement for students diagnonsed withADHD.pptThesis Statement for students diagnonsed withADHD.ppt
Thesis Statement for students diagnonsed withADHD.ppt
 
Model Attribute Check Company Auto Property
Model Attribute  Check Company Auto PropertyModel Attribute  Check Company Auto Property
Model Attribute Check Company Auto Property
 
Mule 4.6 & Java 17 Upgrade | MuleSoft Mysore Meetup #46
Mule 4.6 & Java 17 Upgrade | MuleSoft Mysore Meetup #46Mule 4.6 & Java 17 Upgrade | MuleSoft Mysore Meetup #46
Mule 4.6 & Java 17 Upgrade | MuleSoft Mysore Meetup #46
 
Operation Blue Star - Saka Neela Tara
Operation Blue Star   -  Saka Neela TaraOperation Blue Star   -  Saka Neela Tara
Operation Blue Star - Saka Neela Tara
 
Adversarial Attention Modeling for Multi-dimensional Emotion Regression.pdf
Adversarial Attention Modeling for Multi-dimensional Emotion Regression.pdfAdversarial Attention Modeling for Multi-dimensional Emotion Regression.pdf
Adversarial Attention Modeling for Multi-dimensional Emotion Regression.pdf
 
Sha'Carri Richardson Presentation 202345
Sha'Carri Richardson Presentation 202345Sha'Carri Richardson Presentation 202345
Sha'Carri Richardson Presentation 202345
 
The basics of sentences session 5pptx.pptx
The basics of sentences session 5pptx.pptxThe basics of sentences session 5pptx.pptx
The basics of sentences session 5pptx.pptx
 
Palestine last event orientationfvgnh .pptx
Palestine last event orientationfvgnh .pptxPalestine last event orientationfvgnh .pptx
Palestine last event orientationfvgnh .pptx
 
Instructions for Submissions thorugh G- Classroom.pptx
Instructions for Submissions thorugh G- Classroom.pptxInstructions for Submissions thorugh G- Classroom.pptx
Instructions for Submissions thorugh G- Classroom.pptx
 
The approach at University of Liverpool.pptx
The approach at University of Liverpool.pptxThe approach at University of Liverpool.pptx
The approach at University of Liverpool.pptx
 

fhir-documents

  • 1. FHIR® is the registered trademark of HL7 and is used with the permission of HL7. The Flame Design mark is the registered trademark of HL7 and is used with the permission of HL7. Amsterdam, 15-17 November | @fhir_furore | #fhirdevdays17 | www.fhirdevdays.com FHIR Documents Rick Geimer, Chief Innovation Officer, Lantana Consulting Group
  • 2. Instructor • Rick Geimer • Co-Chair Structured Documents Working Group • HL7 CDA R2 Certified Specialist • Co-Editor, CDA Consolidation and many other implementation guides • Lead: C-CDA on FHIR project • Day job: Chief Innovation Officer, Lantana Consulting Group • rick.geimer@lantanagroup.com
  • 3. Lantana Consulting Group • Our Mission • Improve healthcare through health information technology (IT) • Lead the industry through consulting and volunteer practice • Our Services • Software and standard development and implementation • Terminology, data governance, and education • Strategic advice for health IT planning, design, and purchasing
  • 4. Outline • Overview of Clinical Documents • FHIR Documents • The Composition Resource • Document Bundles • Document Operations and APIs
  • 5. Clinical Documents • This is a document • and this • and this • and this • and this • and this
  • 6. Clinical Documents • Persistence – A clinical document continues to exist in an unaltered state, for a time period defined by local and regulatory requirements. Note: documents outlive the servers (and often the syntax) on which they are created. • Stewardship – A clinical document is maintained by an organization entrusted with its care. • Potential for authentication – A clinical document is an assemblage of information that is intended to be legally authenticated. • Context – A clinical document establishes the default context for its contents. • Wholeness – Authentication of a clinical document applies to the whole and does not apply to portions of the document without the full context of the document. • Human readability – A clinical document is human-readable.
  • 7. Why are documents important? • The clinical record has a dual nature • Data • Narrative • Documents support that duality • Essential for disparate teams—different disciplines, contexts, or clinical systems • Developers need coded data to drive applications • Clinicians often say that the most important part of the clinical record is the narrative written by their colleagues
  • 9. FHIR Documents • Position: FHIR is the document future • Call to action: • Define, document, and promote a future where clinical documents and Application Programming Interfaces (APIs) share a common syntax and set of resources • Establish, in technical and regulatory policy, a smooth roadmap to the future of clinical document exchange
  • 10. FHIR Documents • Address CDA use case for clinical documents • Collection of resources bound together • Root is a Composition resource • Much like the CDA header + narrative • Sent as a Bundle resource • Can be signed, authenticated, etc. • Has the same basic obligations as a CDA document • Full rules: http://build.fhir.org/documents.html
  • 11. Why FHIR Developers Might be Interested in Documents • Load FHIR servers with massive amounts of existing data • Most electronic health record (EHR) systems export CDA • Their CDA export capabilities are more stable than many of their FHIR APIs (if any) • Converting CDA to FHIR is one of the quickest standardized path to Big Data in healthcare today • Comply with existing requirements • FHIR is simpler than CDA • Teach developers to create FHIR documents, then convert to CDA for compliance with existing regulations • FHIR as an API for creating CDA documents • Prepare for when FHIR documents are the norm
  • 12. <Bundle> <entry> <Composition /> </entry> <entry> <Observation /> </entry> <entry> <Device /> </entry> <entry> <Prescription /> </entry> <entry> <Patient /> </entry> </Bundle> Observation Resource Composition Resource Section Section Device Resource Patient Resource Prescription Resource AttesterMetadata FHIR Documents are Bundles of Resources
  • 13. Composition Resource • Contains • Patient • Author • Custodian • Type of document (e.g., Discharge Summary) • Attested narrative of the document • Sufficient for • Medical records management • Document management • Enabling clinical document exchange across and within institutions • Human readable documents Chart Clinical Documents
  • 14. Composition in Detail • Key fields • Identifier • Date • Type • Subject • Author • Attester • Custodian • Sections and narrative • References to other resources
  • 15. Sections and Narrative • Composition resources contain sections (which may be nested) • Section narrative markup is XHTML • Narrative contains the attested text of the document • OK for sections to consist of only human readable text (i.e., no machine processable resources)
  • 16. First: Human Readable <section> <title value="Allergies and Intolerances"/> <code> <coding> <system value="http://loinc.org"/> <code value="48765-2"/> <display value="Allergies and adverse reactions"/> </coding> </code> <text> <status value="generated"/> <div xmlns="http://www.w3.org/1999/xhtml"> <ul> <li>Penicillin - Hives</li> ... </ul> </div> </text> ... </section> Allergies and Intolerances • Penicillin - Hives
  • 17. <AllergyIntolerance xmlns="http://hl7.org/fhir"> <clinicalStatus value="active"/> <verificationStatus value="confirmed"/> <category value="medication"/> <criticality value="high"/> <code> <coding> <system value="http://snomed.info/sct"/> <code value="418038007"/> <display value="allergy to penicillin"/> </coding> </code> <patient> Next, Coded Data <assertedDate value="2000"/> <reaction> <manifestation> <coding> <system value="http://snomed.info/sct"/> <code value="247472004"/> <display value="hives"/> </coding> </manifestation> <severity value="mild"/> </reaction> </AllergyIntolerance>
  • 18. A Bit of Bundle • Type = document • Bundle.identifier • Version dependent • Must be globally unique to satisfy the persistence requirement • First resource is Composition • Documents must be standalone, so… • The Bundle should (some would say must) contain all resources referenced from the Composition
  • 19. <?xml version="1.0" encoding="UTF-8"?> <Bundle xmlns="http://hl7.org/fhir"> <id value="ee5590ab-72c0-4c07-9dc0-cc574729cd0a"/> <type value="document"/> <entry> <fullUrl value="urn:uuid:511b05b3-8c3d-4cbe-b9d8-fe5f8666f994"/> <resource> <Composition> <subject> <reference value="urn:uuid:9f334dba-57b1-47bf-a2ba-a60d9583c8bb"/> </subject> ... </Composition> </resource> </entry> <entry> <fullUrl value="urn:uuid:9f334dba-57b1-47bf-a2ba-a60d9583c8bb"/> <resource> <Patient>...</Patient> </resource> </entry> </Bundle> References in Bundles This example shows UUID URIs, but can be a FHIR server URL such as http://example.org/fhir/Patient/1
  • 20. Rendering FHIR Documents • When the document is presented for human consumption, applications SHOULD present the collated narrative portions in order: • Subject resource Narrative • Composition resource Narrative • section.text Narratives • Reference stylesheet (XSLT) • Document2HTML.xslt in the XML Tools download • http://hl7.org/fhir/downloads.html
  • 21. Demonstration • Review a FHIR Document Bundle
  • 22. FHIR APIs • REST = “Representational state transfer” (an architecture for how to connect systems) • Based on HTTP, the protocol that powers the Web • Outcomes • Simple stable interfaces • High performance / scalability • Visible process (e.g., can debug) • Portability • Reliability (resistance to failure) • REST in FHIR • The FHIR API is composed of RESTful web services
  • 23. FHIR RESTful URLs • CRUD(E) operations mapped to HTTP • Create new resource: POST to the resource type endpoint • Read existing resource: GET • Update existing resource: PUT • Delete existing resource: DELETE • Execute: Use $operations in the URL https://server.org/fhir/Patient/1 endpoint resource type id
  • 24. Documents and FHIR APIs • Generating documents • Call $document on a Composition resource • Stores at the /Bundle endpoint if persist=true • Moving documents or storing externally created documents • Send to /Bundle or /Binary depending on use case • Use PUT to preserve IDs when sending to /Bundle (First, make sure globally unique) • Decomposing documents • POST to the transaction endpoint (May need to be converted to a transaction bundle first)
  • 25. Managing FHIR Documents • To satisfy the persistence and stewardship requirements, documents must be stored somewhere (or reproduced on demand) • The easiest way is on a FHIR server directly, either at the Bundle or Binary endpoint • Other options include document management systems, clinical data repositories, etc. • Important: documents (especially attested ones) should not be generated, transmitted, then disposed of like a transient message
  • 26. Validating FHIR Documents • FHIR validation pack • Includes XML Schema and Schematron files • http://build.fhir.org/fhir-all-xsd.zip • The FHIR Validator • A Java JAR file that runs full FHIR validation • http://build.fhir.org/validator.zip • FHIR server validation • Most servers to basic resource validation • Use the $validate operation • Can validate profiles like C-CDA on FHIR • http://build.fhir.org/operation-resource-validate.html
  • 27. Resources • The FHIR specification • Updated continuously • Latest balloted version: http://hl7.org/fhir • Continuous build: http://build.fhir.org/ • “FHIR CDA Position Statement and Roadmap” Lantana white paper co-authored with Grahame Grieve; Updated April, 2015 • http://www.lantanagroup.com/resources/publications/ • Rick Geimer • Updated continuously, rebooted occasionally • rick.geimer@lantanagroup.com