ERE Primary System Desktop Client Application of the Gematik TI
GPL-3.0 License
ERE Primary System Desktop Client Application for the Gematik TI
The repository for the front-end UI can be found here
A playlist with 22 short videos: ere.health Integration Program
Find details to installation on Windows and Linux systems in the INSTALL.md file
Open a terminal window and do the following:
Clone the ere-ps-app back-end repository by running:
The repository of the front-end is setup as a submodule in the ere-ps-app repository. After cloning the ere-ps-app repository or to reference the latest version of the frontend repository, run the following command:
git submodule update --init
Cool tip! You can use one command which combines both of the previous commands to clone the ere-ps-app repository, and to update the front-end UI submodule as shown below:
git clone --recurse-submodules https://github.com/ere-health/ere-ps-app.git
The source files of the front-end UI will be located in the following directory location:
src/main/resources/META-INF/resources/frontend
At this point, you should now have access to the source files for both the backend and front-end of the application.
Periodically, you may wish to update the front-end UI submodule to reference different branches in the front-end UI repository. You can do this by entering the following commands as shown below from the ere-ps-app directory:
git submodule deinit --all
rm -rf .git/modules
git rm -rf src/main/resources/META-INF/resources/frontend
rm -rf src/main/resources/META-INF/resources/frontend
git submodule add -b < branch name > https://github.com/ere-health/front-end-ere.health.git src/main/resources/META-INF/resources/frontend
The ere-health application read configuration is the following order from most important to least important:
Find details to environment variables in the CONFIGURATION.md file
Download and install the latest version of the OpenJDK 17 SDK. You can use your preferred package manager software on your computer to handle this, or simply download an archive or installer from a publishing site such as AdoptOpenJDK (https://adoptopenjdk.net/). Make sure to choose OpenJDK 17 (LTS) and the HotSpot version of the JVM.
Download and install the latest version of Apache Maven (https://maven.apache.org/).
The latest Chrome, Firefox or Edge Browser (https://www.google.com/intl/en/chrome, https://www.mozilla.org/en-US/firefox/new, https://www.microsoft.com/en-us/edge).
Open a terminal window and change to the parent ere-ps-app directory of the back-end and then run the following commands:
In order to make sure you are working with the latest front-end UI, run the following first:
git submodule update --init
Make sure you created a .env
file with your connector-specific configuration, see CONFIGURATION.md.
Then run:
mvn quarkus:dev
At this point, the application should be running as highlighted below.
Listening for transport dt_socket at address: 43411
__ ____ __ _____ ___ __ ____ ______
--/ __ \/ / / / _ | / _ \/ //_/ / / / __/
-/ /_/ / /_/ / __ |/ , _/ ,< / /_/ /\ \
--\___\_\____/_/ |_/_/|_/_/|_|\____/___/
2024-05-14 17:26:26,620 INFO [ca.uhn.fhi.uti.VersionUtil] (Quarkus Main Thread) HAPI FHIR version 7.0.2 - Rev 95beaec894
2024-05-14 17:26:26,623 INFO [ca.uhn.fhi.con.FhirContext] (Quarkus Main Thread) Creating new FHIR context for FHIR version [R4]
2024-05-14 17:26:26,647 INFO [io.und.websockets] (Quarkus Main Thread) UT026003: Adding annotated server endpoint class health.ere.ps.websocket.Websocket for path /websocket
2024-05-14 17:26:26,954 INFO [io.qua.sch.run.SimpleScheduler] (Quarkus Main Thread) No scheduled business methods found - Simple scheduler will not be started
2024-05-14 17:26:27,053 INFO [hea.ere.ps.ser.idp.cli.IdpClient] (Quarkus Main Thread) Initializing using url: https://idp-ref.zentral.idp.splitdns.ti-dienste.de//.well-known/openid-configuration
2024-05-14 17:26:28,270 INFO [ca.uhn.fhi.con.FhirContext] (Quarkus Main Thread) Creating new FHIR context for FHIR version [R4]
2024-05-14 17:26:29,012 INFO [io.quarkus] (Quarkus Main Thread) ere-ps-app 1.0.0-SNAPSHOT on JVM (powered by Quarkus 3.9.4) started in 5.855s. Listening on: http://0.0.0.0:8080 and https://0.0.0.0:8443
2024-05-14 17:26:29,013 INFO [io.quarkus] (Quarkus Main Thread) Profile RU activated. Live Coding activated.
2024-05-14 17:26:29,014 INFO [io.quarkus] (Quarkus Main Thread) Installed features: [cdi, resteasy, resteasy-client, resteasy-jsonb, scheduler, servlet, smallrye-context-propagation, smallrye-openapi, swagger-ui, vertx, websockets, websockets-client]
You can access the front-end UI of the application by making reference to the following URL
To use the swagger ui go to:
To check that the ere-ps-app back-end is correctly referencing the front-end UI and its latest version, run the following command at a terminal window from the ere-ps-app parent directory:
git submodule status
You should see something similar to the following with the only difference being the preceding git revision number:
7887a70e4dbe35cede4d286dc57bc3bba608a48d src/main/resources/META-INF/resources/frontend (heads/main)
Use the swagger UI: http://localhost:8080/q/swagger-ui/
The comfort signature can be enabled by sending an ActivateComfortSignature message through the websocket. The response will contain a userId that has to be used afterwards in the userId field to enable the usage of the comfort signature.
Another way of enabling the comfort signature is posting to the workflow/comfortsignature/activate endpoint with passing the ehba card handle in the header "X-eHBAHandle". The endpoint will return the userId.
Right now details in the README.md file in the websocket message folder
If you want to use the comfort signature you have to pass the user id that you got from the ActivateComfortSignature message in the connector.user-id field e.g.:
{
...
"runtimeConfig": {
...
"connector.user-id": "50aa5d2a-6f14-43bc-85ea-d03f9bd49441"
...
}
...
}
For general information and understanding the eRezept / prescribing workflow the gematik E-Rezept API-Dokumentation is a valuable source.