Prerequisites • Exercise 1 • Exercise 1.1 • Exercise 2 • Exercise 4 • Exercise 5 • Exercise 6
In order to be able to solve the exercises described in this tutorial a software development environment with GIT, Java 17, Maven 3.8, Docker, docker-compose, a Java IDE like Eclipse or IntelliJ, a BPMN Editor like the Camunda Modeler and a minimum 16GB of RAM is needed. Make sure you read through the introductory documentation pages located here. You also want to have some amount of experience in HL7 FHIR R4.
git is a free and open source distributed version control system designed to handle everything from small to very large projects with speed and efficiency.
- An installation guide for Linux, Mac and Windows can be found here: installation guide
- The most basic git CLI commands are described here: commands
Process plugins for the DSF are written using the Java programming language in version 17. Various open source releases of the Java Developer Kit (JDK) 17 exist, you are free in your choice.
When implementing DSF processes, we use Maven 3.8 to manage the software project's build, reporting and documentation workflow.
- An installation guide for Maven 3.8 can be found here: installation guide
- The most important maven commands are described here: commands
You can also find all DSF Maven artifacts here.
To be able to test the implemented processes, we use a dev-setup based on Docker and docker-compose. This allows us to simulate multiple organizations with different roles and run the processes across "organizational boundaries".
- An installation guide for Docker and docker-compose can be found here: installation guide
- The most important Docker commands are described here: Docker commands
- An overview of docker-compose commands are described here: docker-compose commands
The following entries are required in the hosts
file of your computer so that the FHIR servers of the simulated organizations can be accessed in your web browser. On Linux and Mac this file is located at /etc/hosts
. On Windows you can find it at C:\Windows\System32\drivers\etc\hosts
.
127.0.0.1 dic
127.0.0.1 cos
127.0.0.1 hrp
127.0.0.1 keycloak
For the development of the processes we recommend the use of an IDE, e.g. Eclipse or IntelliJ:
- An installation guide for Eclipse can be found here: Eclipse installation guide
- An installation guide for IntelliJ can be found here: IntelliJ installation guide
To simplify modeling of BPMN processes, we recommend a graphical editor, e.g. the Camunda Modeler:
- An installation guide for the Camunda Modeler can be found here: installation guide
- CAVE: When creating models with Camunda Modeler, make sure you create a Camunda 7 model, not a Camunda 8 model. The DSF relies on Camunda 7 which is incompatible with Camunda 8.
The minimum hardware requirements to run all simulated organizations as part of the Docker dev-setup is 16 GB of RAM.
Prerequisites • Exercise 1 • Exercise 1.1 • Exercise 2 • Exercise 4 • Exercise 5 • Exercise 6