Process Data Sharing Deployment v0.3.0

Deploying the data-sharing process plugin to the DSF involves copying the process jar-file and additional (non process) plugin jar-file and configuring environment variable for the business process engine (BPE). Information of fixed issues and new features see Release Notes v0.3.0.

Prerequisites

• A DSF installation of version 0.9.0 or higher. A link to an installation guide of the DSF can be found in the release notes.

• The hapi-fhir-client-5.1.0.jar has to be installed as a regular DSF BPE plugin by adding the .jar file to the folder /opt/bpe/plugin:

   wget https://repo1.maven.org/maven2/ca/uhn/hapi/fhir/hapi-fhir-client/5.1.0/hapi-fhir-client-5.1.0.jar
  

  Make sure the file is readable by the bpe user or group, for example by setting the permissions using the commands:

  sudo chmod 440 hapi-fhir-client-5.1.0.jar
  sudo chown root:bpe hapi-fhir-client-5.1.0.jar
  

Deployment

• Add the mii-dsf-process-projectathon-data-sharing-0.3.0.jar to the DSF BPE folder /opt/bpe/process:

   wget https://github.com/medizininformatik-initiative/mii-dsf-processes/releases/download/v0.3.0/mii-dsf-process-projectathon-data-sharing-0.3.0.jar
  

  Make sure the process is readable by the bpe user or group, for example by executing:

  sudo chmod 440 mii-dsf-process-projectathon-data-sharing-0.3.0.jar
  sudo chown root:bpe mii-dsf-process-projectathon-data-sharing-0.3.0.jar
  

• Modify the process exclude config in /opt/bpe/docker-compose.yml:

  • DIC:

  @@ -50,3 +50,3 @@
         ORG_HIGHMED_DSF_BPE_PROCESS_EXCLUDED: |
  +        medizininformatik-initiativede_coordinateDataSharing/0.3.0,
  +        medizininformatik-initiativede_mergeDataSharing/0.3.0

  • COS:

  @@ -50,3 +50,3 @@
         ORG_HIGHMED_DSF_BPE_PROCESS_EXCLUDED: |
  +        medizininformatik-initiativede_coordinateDataSharing/0.3.0,
  +        medizininformatik-initiativede_executeDataSharing/0.3.0

  • HRP:

  @@ -50,3 +50,3 @@
         ORG_HIGHMED_DSF_BPE_PROCESS_EXCLUDED: |
  +        medizininformatik-initiativede_mergeDataSharing/0.3.0,
  +        medizininformatik-initiativede_executeDataSharing/0.3.0

  Additional processes may be listed in your process exclude config.

Configuration

• The configuration of the data-sharing process is described here.

Preparations & Starting the Data-Sharing Coordinate Process

• How to prepare the DIC KDS FHIR store before answering a manual user task and how to start the data-sharing coordinate process at a HRP is described here.