NkrIG

Broncode voor de FHIR implementatiegids voor (aanlevering aan de) de Nederlandse Kankerregistratie. Bekijk de implementatiegids op: https://iknl.github.io/NkrIG/

Step 1 - Install required software

sushi This project uses FSH and sushi. Therefore, it requires Node.js. The IG Publisher additionally requires Java to be present on the system.

Installing sushi is detailed here. The following command might be sufficient if you're already working with nvm:

npm install fsh-sushi

IG Publisher The IG Publisher requires Java and Jekyll to be installed.

# Generally a good idea
sudo apt update

# Java
sudo apt install openjdk-17-jre

# Jekyll
sudo apt-get install graphviz jekyll

Tip

If you're running WSL2, the open command in the Makefile will fail. This can be fixed as follows:

Install WSLU
Add export BROWSER=wslview to ~/.bashrc: echo 'BROWSER=wslview' >> ~/.bashrc

Tip

If you're using zsh, be sure to change to ~/.bashrc to ~/.zshrc in the above shell commands!

Step 2 - Clone the repo, and initialize publishers.

# Clone the repo
git clone https://github.com/IKNL/NkrIG.git
cd NkrIG

# Adding executable permissions may or may not be required
chmod +x _updatePublisher.sh

# Install/update the Implementation Guide publisher.
./_updatePublisher.sh

Step 3 - Compile the IG

# Adding executable permissions may or may not be required
chmod +x _genonce.sh

# Run sushi and subsequently the IG Publisher.
./_genonce.sh

Troubleshooting

If sushi complains about snapshots ("Structure Definition http://nictiz.nl/fhir/StructureDefinition/nl-core-Patient is missing a snapshot. Snapshot is required for import."), please follow these steps:

Download the following packages with snapshots from Simplifier:

Overwrite the contents of

~/.fhir/packages/nictiz.fhir.nl.r4.nl-core#0.10.0/package with the contents of the corresponding tgz.
~/.fhir/packages/nictiz.fhir.nl.r4.zib2020#0.10.0/package with the contents of the corresponding tgz.

Re-run sushi.

Warning

The above uses version 0.10.0 of the nl-core package. Please note that version numbers may have changed the meantime.