CH EPL (R5)

FHIR® Implementation Guide for the 'Elektronische Plattform Leistungen (EPL)' of the Swiss Federal Office of Public Health (FOPH).

• Current Stable Version: not yet available
• CI Build

---

Setup your computer to work with an implementation guide

Editor: Visual Studio Code (VSC)

• Install the editor Visual Studio Code as described here

VSC Extensions

• Install the extension FHIR tools (yannick-lagger.vscode-fhir-tools)

  • Go to extensions in the activity bar on the right side of VSC (shown as 4 squares)
  • Search for this extension using the search field at the top left: yannick-lagger.vscode-fhir-tools
  • Then install it

• Install the extension vscode-language-fsh (kmahalingam.vscode-language-fsh)

  • Installation as described above

Java

• Install Java as described here
  • Java 17 (Java 8 not longer supported, see here)

Jekyll

• Installation: https://jekyllrb.com/ (see Jekyll on Windows for windows users)

SUSHI (and Node.js)

• Install SUSHI (and Node.js) as described here

Git

• Install Git as described here

GitHub

• Create a GitHub account as described here
• You should definitely set up two-factor authentication as it is described there in the lowest section

---

Get the implementation guide running

Get the existing git repository

• If you haven't already done so, create a local GitHub folder on your computer (e.g. C:\Users\username\Documents\GitHub).
• Open a terminal in VSC (Terminal > New Terminal)
• Navigate to the local GitHub folder in the terminal (cd .\Documents\, cd .\GitHub\)
• Then clone the repository via the terminal: git clone https://github.com/bag-epl/bag-epl-fhir.git
• Open the folder of the repository in VSC (File > Open Folder...)
• Navigate to this repository in the therminal (cd .\bag-epl-fhir\ )

Install the FHIR IG publisher

• In VSC press F1 or Ctrl+Shift+P
• Type following command in the field: FHIR update Java Validator and IGPublisher

Building the IG

• Option A:
  • See also instructions for installing the IG publisher
  • In VSC press F1 or Ctrl+Shift+P
  • Type following command in the field: FHIR run IGPublisher
  • Copy the link from the result in your terminal in a web browser (file:///C:/Users/username/Documents/GitHub/bag-epl-fhir/qa.html)
  • Change qa.html to index.html and see your IG!
• Option B:
  • Get the latest IG publisher from https://github.com/HL7/fhir-ig-publisher/releases/latest/download/publisher.jar.
    • Make sure you are always working with the lastest publisher
  • Put the publisher.jar in the main directory.
  • A local build of the IG can be generated by running java -jar publisher.jar -ig ig.ini at the command line.
• See the output:
  • Validation results (QA): .\bag-epl-fhir\output\qa.html (link is displayed in the command line)
  • Implementation guide: .\bag-epl-fhir\output\index.html (replace qa with index)

FHIR Implementation Guide Auto-Builder

For further information see here.

Publish the IG

For further information see here.

---

Further links

• Further supporting information on FSH:
  • Documentation of the FHIR Shorthand language standard
  • FSH School: The place to learn and try FHIR Shorthand!
  • FSH Cheat Sheet
• IG Publisher Documentation
• Using the FHIR Validator
• FHIR Chat Zulip
  • Create a free account
  • Use different streams for help/information: #implementers, #IG creation, #committers/notification, #shorthand, #terminology, #switzerland, and more...