Implementation Guide Tooling - FHIR DevDays · Name: Lloyd McKenzie Company: Gevity Background: Kv...
Transcript of Implementation Guide Tooling - FHIR DevDays · Name: Lloyd McKenzie Company: Gevity Background: Kv...
HL7®, FHIR® and the flame Design mark are the registered trademarks of Health Level Seven International and are used with per mission.
Boston, 19-21 June | @HL7 @FirelyTeam | #fhirdevdays18 | www.fhirdevdays.com
Implementation Guide Tooling
Lloyd McKenzie, Gevity; Rick Geimer, Lantana; Ardon Toonstra, Firely
Who are we?
• Name: Lloyd McKenzie
• Company: Gevity
• Background:
• One of FHIR’s 3 initial editors
• Co-chair FMG & FHIR Infrastructure
• Co-chair HL7 Modeling & Methodology
• Heavily involved in HL7 and healthcare exchange for last 19 years
• v2, v3, CDA, etc.
• Have created 10+ IGs for various projects using HL7 tools
Who are we?
• Name: Rick Geimer
• Company: Lantana
• Background:
• Member:
• HL7 CDA Management Group
• FHIR Infrastructure Work Group
• Structured Documents Work Group
• Attachments Work Group
• HL7 CDA R2 Certified Specialist, Certified FHIR Proficient
• Co-Editor, CDA Consolidation and many other implementation guides
• Lead: C-CDA on FHIR project
• Day job: Lantana Chief Innovation Officer
Who are we?
• Name: Ardon Toonstra
• Company: Firely
• Background:
• FHIR consultant
• FHIR profiling
• MedMij project in the Netherlands
• Firely tools support
Outline
• Tooling inputs & outputs
• HL7 IGPublisher (Lloyd)
• Trifolia (Rick)
• Simplifier (Ardon)
• Objective: Show you some of what exists
• Won’t have time to do a detailed exploration
5
IG Inputs and Outputs
6
ImplementationGuide
Conformance
resources
Config
XHTML /
Markdown
pages
X + “Package”
IG Content Authoring Tools
• ImplementationGuide
• Forge, Trifolia
• CapabilityStatement
• FHIR Toolkit (beta)
• StructureDefinition
(profiles/logical models/extensions)
• Forge, Trifolia, ClinFHIR, Excel (retiring?)
• ValueSet
• FHIR Toolkit (beta), ClinFHIR, Snapper
• CodeSystem
• FHIR Toolkit (beta), ClinFHIR, Snapper
• ConceptMap
• ClinFHIR, Snapper
• StructureMap
• OMS
• Example instances
• ClinFHIR, NotePad++
• ExampleScenario
• FHIR Toolkit (in development)
• Questionnaire
• FHIR Toolkit (alpha)
7
No authoring tools as yet for
• OperationDefinition
• MessageDefinition
• GraphDefinition
• NamingSystem
• Use Notepad++ or your favorite XML or JSON (or RDF??) editor.
• Similarly for markdown or HTML, use your favorite editor
8
HL7 IG Publisher
9
HL7 IG Publisher
• Written in Java
• Shares code with the spec publisher and validator
• Open source – feedback submitted over HL7’s gForge tracker
• Driven by ImplementationGuide resource + JSON config file
• Generates “fragments” for resources in the IG
• Uses templates and Jekyll to produce a static website for the IG
• Supports “continuous” generation
• Performs full validation of artifacts and links
• Packages up zips for download and for dependent IGs
Finding the HL7 IG Publisher
11
Using the IGPublisher – quick tour
• http://wiki.hl7.org/index.php?title=FHIR_IG_Framework
12
Trifolia
13
Trifolia
• Developed & Maintained by Lantana Consulting Group
• Web-based development & publishing of profiles & IGs
• Can host a local version if needed for projects
• Also acts as a registry – discover other projects that are hosted in the Trifolia environment that have been marked as “public”
• Code is publicly available if you want to tweak it
14
Key Trifolia Features
• Web based tool, no install needed
• Open source
• Supports multiple FHIR versions in a single user interface
• Integrated value set authoring and VSAC integration
• Exports a complete FHIR IG Publisher package (zip)
• Includes FHIR API endpoints for each supported FHIR version
• Integrated ImplementationGuide editor
15
lantanagroup.com
FHIR Versions
• Currently support the following FHIR versions
• DSTU2
• STU3
• Latest Build
• Each version:
• Maintained separately
• Represented by a separate Implementation Guide Type
• Has its own API end-point
16 lantanagroup.com
Workflow/process
• Described in help documentation
• Steps
• Create an implementation guide based on a FHIR implementation guide type
• Add profiles to the implementation guide
• Export as FHIR IG Publisher Package
17 lantanagroup.com
Profile Editor
18
Value Sets
• Supports creating enumerated value sets manually in Trifolia
• Supports importing value sets from VSAC and PHIN VADS
• Exports value sets as
• FHIR Value Set Resources
• IHE SVS
• Excel
• Trifolia XML
• Can re-use value sets created in other specifications, such as C-CDA, US-Core, etc.
19 lantanagroup.com
Exports
• FHIR implementation guides have several export options:
• FHIR IG Publisher Package
• FHIR Bundle
• MS Word
• HTML
20 lantanagroup.com
API
• API end-points:
• https://trifolia.latanagroup.com/api/FHIR2
• https://trifolia.latanagroup.com/api/FHIR3
• https://trifolia.latanagroup.com/api/FHIRCurrentBuild
• API support for the following resources:
• GET/PUT/POST StructureDefinition
• GET/PUT/POST ValueSet
• GET/PUT/POST ImplementationGuide
• GET /metadata
• GET /CapabilityStatement
21 lantanagroup.com
Limitations
• Does not support lesser-used features of FHIR profiles, such as mappings, re-slicing, etc.
• Not currently integrated with HL7 FHIR Registry (Simplifier).
• Current build of FHIR is changing constantly, requires regular updates to Trifolia to incorporate those changes.
• FHIR IG Publisher changes often, requiring occasional changes to the FHIR IG Publisher Package export.
22 lantanagroup.com
Simiplifier - IG editor
The IG editor - features
• Web based editor
• Use all publicly available FHIR resources on Simplifier
• Using simple placeholders
• Intellisense
• Different format / designs
• Project members
Example: {{render:demoproject/us-core-patient-2}}
The IG editor - features
• Page history / logging
• CSS
• GitHub support
• Export: • static HTML pages
• ImplementationGuide resource
Demo
1. Demonstrate two IG’s: • https://simplifier.net/guide/DraftpcCDRFHIRImplementationGuide
• Profiling Academy
2. Create an IG based on a small example use case
• Retrieve Lab Results
Exercise – IG tooling
• https://www.fhirdevdays.com/boston/exercises/
Create your own IG with one of the hightlighted tools based on example content.
Simplifier.net Trial Voucher
Get a 3 month trial for additional features of Simplifier.net, including the IG editor.
1. Create an account
2. Send your account details to [email protected]
Questions?
http://wiki.hl7.org/index.php?title=IG_Publisher_Documentation
https://trifolia.lantanagroup.com
https://simplifier.net
32