Number of Days
|One 8-hour day (face-to-face training course), or two 4-hour sessions on 2 different days (online training courses)|
Who should attend
|This workshop is intended for those who are responsible for the authoring of FHIR implementation guides.|
Summary of the workshop content
This 1-day workshop covers a range of topics that are related to the creation and maintenance of FHIR Implementation Guides. The content of this workshop is largely determined by its attendees:
- The morning part of the workshop will focus on a discussion of a number of issues and best practices around the creation and maintenance of FHIR Implementation Guides. These workshop modules are based on a fictitious use case which is also used during the exercises.
- The afternoon part of the workshop will focus on the creation of a FHIR Implementation Guide based on a use case as relevant to the individual attendees. Attendees will be sent a checklist, to ensure they’ll have the “raw information” which is needed to create an implementation guide. Any attendee that doesn’t have the details of their own project (at the time of the workshop) will be provided with an elaborate use case.
The hands-on nature of this workshop allows the attendee to get an in depth understanding of the material covered. The main tool used during this workshop will be Simplifier.net, but the intent is to be largely tool agnostic, alternatives such as FHIR IG Publisher and Trifolia will be covered as well.
The dates for the in-company training courses are flexible and can be agreed depending on the availability of your team. The open training courses (whether online or face-to-face) have fixed dates.
Goals of the training course
Upon completion of this training course, attendees will be able to:
- Understand what information is required for creating a FHIR Implementation Guide.
- Get hands-on experience with various FHIR Implementation Guide tools.
- Advance their own project by having a deeper understanding of the documentation process.
- Partially create a (new) Implementation Guide for your own use case or project.
- The attendees are assumed to be familiar with the core FHIR profiling resources (e.g. by having attended the FHIR Profiling Training Course), as well as a FHIR profiling tool (e.g. Forge).
The agenda of the first part of the workshop serves to familiarize the attendees with a number of issues and best practices around the creation and maintenance of FHIR Implementation Guides. The second part of the workshop focuses on the creation of a FHIR Implementation Guide based on a use case as relevant to the individual attendees.Over 50% of the duration will be spent on hands-on development aimed to support scenarios as relevant to the attendees.
Note: the agenda is subject to change; there are additional exercises beyond those shown below.
- Profiling (summary)
- Key conformance resources
- The ImplementationGuide resource
- CapabilityStatement to express requirements
- Other supporting resources
- Overview of Implementation Guide tools
- Content design
- Scope, architecture
- Logical models used
- For each use case: actors, functional requirements, profiles, examples.
- Appendix: Data type profiles
- Appendix: Value sets, Identification Systems
- Appendix: Privacy and security requirements
- Creation of HTML, applying templates
- Creation of CapabilityStatement(s) to express requirements
- Implementation Guide Registry
- Proof reader, link checker
- Test environment
- Governance and versioning
- Example Implementation Guides in <your country>
- Checklist for the creation of an implementation guide
- IG development Best practices
- Hands-on: applying the checklist to your own project (3-4 hours)
We will provide each participant with handouts containing all materials covered in the training as well as other support materials.