Skip to content

exercise-6.md

Latest commit

 

History

History
101 lines (80 loc) · 11 KB

exercise-6.md

File metadata and controls

101 lines (80 loc) · 11 KB

Prerequisites • Exercise 0 • Exercise 1 • Exercise 1.1 • Exercise 2 • Exercise 3 • Exercise 4 • Exercise 5 • Exercise 6 • Exercise 7

Exercise 6 - Event Based Gateways and Intermediate Events

In this exercise we will look at message flow between three organizations as well as how to continue a waiting process if no return message arrives. With this exercise we will add a third process and complete a message loop from dic.dsf.test to cos.dsf.test to hrp.dsf.test and back to dic.dsf.test.

In order to solve this exercise, you should have solved exercise 5 and read the topics on Managing Multiple Incoming Messages and Missing Messages and Message Correlation.

Solutions to this exercise are found on the branch solutions/exercise-6.

Exercise Tasks

  1. Modify the exampleorg_dicProcess:

  2. Modify the exampleorg_cosProcess to use a Message End Event to trigger the process in file hrp-process.bpmn. Figure out the values for the instantiatesCanonical, profile and messageName input parameters of the Message End Event based on the ActivityDefinition in file hrp-process.xml. Change the Cos Task element into a Service Task and include the CosTask as the implementation.

  3. Modify the process in file hrp-process.bpmn and set the process definition key and version. Figure out the appropriate values based on the AcitvityDefinition in file hrp-process.xml.

  4. Add a new process authorization extension element to the ActivityDefinition for exampleorg_dicProcess using the parent organization role coding where only remote organizations which are part of medizininformatik-initiative.de and have the HRP role are allowed to request goodByeDic messages and only organizations which are part of medizininformatik-initiative.de and have the DIC role are allowed to receive goodByeDic messages

    Don't know which values to choose for roles?

    Take a look at the dsf-organization-role CodeSystem.

  5. Forward the value from the Task.input parameter of the dicProcess Task to the exampleorg_cosProcess using the HelloCosMessage. To do this, you need to override HelloCosMessage#getAdditionalInputParameters. Don't forget to also add the definition of your tutorial-input Input Parameter from task-start-dic-process.xml to task-hello-cos.xml. HelloHrpMessage already implements the forwarding of the Input Parameter to the HRP instance and might have to be adjusted e.g. if other the Input Parameter was named differently.

  6. Add the process in file hrp-process.bpmn to the TutorialProcessPluginDefinition and configure the FHIR resources needed for the three processes.

  7. Add the CosTask, HelloHrpMessage , HrpTask and GoodbyeDicMessage classes as Spring Beans. Don't forget the scope.

  8. Again, we introduced changes that break compatibility. Older plugin versions won't execute the HRP process because the process ID in the BPMN model is still invalid and it is missing a version. Increment your resource version to 1.4.

Solution Verification

Maven Build and Automated Tests

Execute a maven build of the dsf-process-tutorial parent module via:

mvn clean install -Pexercise-6

Verify that the build was successful and no test failures occurred.

Process Execution and Manual Tests

To verify the exampleorg_dicProcess, exampleorg_cosProcess and exampleorg_hrpProcesses can be executed successfully, we need to deploy them into DSF instances and execute the exampleorg_dicProcess. The maven install build is configured to create a process jar file with all necessary resources and copy the jar to the appropriate locations of the docker dev setup. Don't forget that you will have to add the client certificate for the HRP instance to your browser the same way you added it for the DIC and COS instances in exercise 1 and exercise 4 or use the Keycloak user Tyler Tester with username test and password test. Otherwise, you won't be able to access https://hrp/fhir. You can find the client certificate in .../dsf-process-tutorial/browser-certs/hrp/hrp-client.p12 (password: password).

  1. Start the DSF FHIR server for the dic.dsf.test organization in a console at location .../dsf-process-tutorial/dev-setup:

    docker compose up dic-fhir

    Verify the DSF FHIR server started successfully at https://dic/fhir.

  2. Start the DSF BPE server for the dic.dsf.test organization in a second console at location .../dsf-process-tutorial/dev-setup:

    docker compose up dic-bpe

    Verify the DSF BPE server started successfully and deployed the exampleorg_dicProcess.

  3. Start the DSF FHIR server for the cos.dsf.test organization in a third console at location .../dsf-process-tutorial/dev-setup:

    docker compose up cos-fhir

    Verify the DSF FHIR server started successfully at https://cos/fhir.

  4. Start the DSF BPE server for the cos.dsf.test organization in a fourth console at location .../dsf-process-tutorial/dev-setup:

    docker compose up cos-bpe

    Verify the DSF BPE server started successfully and deployed the exampleorg_cosProcess.

  5. Start the DSF FHIR server for the hrp.dsf.test organization in a fifth console at location .../dsf-process-tutorial/dev-setup:

    docker compose up hrp-fhir

    Verify the DSF FHIR server started successfully at https://hrp/fhir.

  6. Start the DSF BPE server for the hrp.dsf.test organization in a sixth console at location .../dsf-process-tutorial/dev-setup:

    docker compose up hrp-bpe

    Verify the DSF BPE server started successfully and deployed the exampleorg_hrpProcess. The DSF BPE server should print a message that the process was deployed. The DSF FHIR server should now have a new ActivityDefinition resource. Go to https://hrp/fhir/ActivityDefinition to check if the expected resource was created by the BPE while deploying the process. The returned FHIR Bundle should contain three ActivityDefinition resources. Also, go to https://hrp/fhir/StructureDefinition?url=http://example.org/fhir/StructureDefinition/task-hello-hrp to check if the expected Task profile was created.

  7. Start the exampleorg_dicProcess by posting a specific FHIR Task resource to the DSF FHIR server of the dic.dsf.test organization using either cURL or the DSF FHIR server's web interface. Check out Starting A Process Via Task Resources again if you are unsure.

    Verify that the FHIR Task resource was created at the DSF FHIR server and the exampleorg_dicProcess was executed by the DSF BPE server of the dic.dsf.test organization. The DSF BPE server of the dic.dsf.test organization should print a message showing that a Task resource to start the exampleorg_cosProcess was sent to the cos.dsf.test organization.
    Verify that a FHIR Task resource was created at the DSF FHIR server of the cos.dsf.test organization and the exampleorg_cosProcess was executed by the DSF BPE server of the cos.dsf.test organization. The DSF BPE server of the cos.dsf.test organization should print a message showing that a Task resource to start the exampleorg_hrpProcess was sent to the hrp.dsf.test organization.

    Based on the value of the Task.input parameter you send, the exampleorg_hrpProcess will either send a goodbyeDic message to the dic.dsf.test organization or finish without sending a message.

    To trigger the goodbyeDic message, use send-response as the tutorial-input input parameter.

    Verify that the exampleorg_dicProcess either finishes with the arrival of the goodbyeDic message or after waiting for two minutes.

Prerequisites • Exercise 0 • Exercise 1 • Exercise 1.1 • Exercise 2 • Exercise 3 • Exercise 4 • Exercise 5 • Exercise 6 • Exercise 7