Skip to content

Latest commit

 

History

History
90 lines (73 loc) · 9.4 KB

exercise-4.md

File metadata and controls

90 lines (73 loc) · 9.4 KB

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

Exercise 4 - Messaging

Communication between organizations in BPMN processes is modeled using message flow. The fourth exercise shows how a process at one organization can trigger a process at another organization.

To demonstrate communication between two organizations we will configure message flow between the processes exampleorg_dicProcess and exampleorg_cosProcess. After that, the processes are to be executed at the organizations dic.dsf.test and cos.dsf.test respectively in the docker dev setup, with the former triggering execution of the latter by automatically sending a Task resource from organization dic.dsf.test to organization cos.dsf.test.

In order to solve this exercise, you should have solved exercise 2 and read the topics on Messaging, Message Activities, Version Pattern, URLs and Target and Targets.

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

Exercise Tasks

  1. Replace the End Event of the exampleorg_dicProcess in the dic-process.bpmn file with a Message End Event. Give the Message End Event a name and an ID and set its implementation to the HelloCosMessage class.
    Configure field injections instantiatesCanonical, profile and messageName in the BPMN model for the Message End Event. Use http://example.org/fhir/StructureDefinition/task-hello-cos|#{version} as the profile and helloCos as the message name. Figure out what the appropriate instantiatesCanonical value is, based on the name (process definition key) of the process to be triggered.

    Can't remember how instantiatesCanonical is built?

    Read the concept here again.

  2. Modify the exampleorg_cosProcess in the cos-process.bpmn file and configure the message name of the Message Start Event with the same value as the message name of the Message End Event in the exampleorg_dicProcess.

  3. Create a new StructureDefinition with a Task profile for the helloCos message.

    Don't know how to get started?

    You can base this Task profile off the StructureDefinition/task-start-dic-process.xml resource. Then look for elements that need to be added, changed or can be omitted.

  4. Create a new ActivityDefinition resource for the exampleorg_cosProcess and configure the authorization extension to allow the dic.dsf.test organization as the requester and the cos.dsf.test organization as the recipient. The file has to be called cos-process.xml.

    Don't know how to get started?

    You can base this ActivityDefinition off the ActivityDefinition/dic-process.xml resource. Then look for elements that need to be added, changed or can be omitted. Or you can take a look at the guide on creating ActivityDefinitions.

  5. Add the exampleorg_cosProcess and its resources to the TutorialProcessPluginDefinition class. This will require a new mapping entry with the full process name of the cosProcess as the key and a List of associated FHIR resources as the value.

  6. Modify DicTask service class to set the target process variable for the cos.dsf.test organization.

  7. Configure the HelloCosMessage class as a Spring Bean in the TutorialConfig class. Don't forget the right scope.

  8. Again, we introduced changes that break compatibility. Older plugin versions at the COS instance won't be able to handle the Task resource type we added earlier. Increment your resource version to 1.3.

Solution Verification

Maven Build and Automated Tests

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

mvn clean install -Pexercise-4

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

Process Execution and Manual Tests

To verify the exampleorg_dicProcess and exampleorg_cosProcesses 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 COS instance to your browser the same way you added it for the DIC instance in exercise 1 or use the Keycloak user Tyler Tester with username test and password test. Otherwise, you won't be able to access https://cos/fhir. You can find the client certificate in .../dsf-process-tutorial/browser-certs/cos/cos-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 another 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 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 another 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. 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://cos/fhir/ActivityDefinition to check if the expected resource was created by the BPE while deploying the process. The returned FHIR Bundle should contain two ActivityDefinition resources. Also, go to https://cos/fhir/StructureDefinition?url=http://example.org/fhir/StructureDefinition/task-hello-cos to check if the expected Task profile was created.

  5. 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 then executed by the DSF BPE server of the cos.dsf.test organization.

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