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

• lmckenzie@gevityinc.com

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

• rick.geimer@lantanagroup.com

Who are we?

• Name: Ardon Toonstra

• Company: Firely

• Background:

• FHIR consultant

• FHIR profiling

• MedMij project in the Netherlands

• Firely tools support

• ardon@fire.ly

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

Accessing Trifolia

• https://trifolia.lantanagroup.com

23

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 simplifier@fire.ly

Questions?

http://wiki.hl7.org/index.php?title=IG_Publisher_Documentation

https://trifolia.lantanagroup.com

https://simplifier.net

lmckenzie@gevityinc.com

rick.geimer@lantanagroup.com

ardon@fire.ly

32