Skip to content

Process Description v1.1.0.0

Simon Schweizer edited this page Mar 25, 2024 · 1 revision

Overview

The following BPMN collaboration diagram illustrates the interactions between the four different processes that make up the NUM-RDP data transfer:

BPMN collaboration diagram of the NUM-CODEX processes Trigger, Send, Translate and Receive

The Data Transfer Process in v1.0.0.0 is composed of 4 different sub-processes: Trigger, Send, Translate and Receive.

DIC: Trigger

The Trigger process can be used to identify MII core data set FHIR resources that have been created or modified after a specified timestamp or after the last execution of the process. Once activated the process is configured to check for changed or created resources every 24 hours. When new or changed resources are found, the Send process is triggered for every patient associated to theses resources. During the 24 hour waiting period the tirgger process can be stopped.

DIC: Send

During the Send process executed at the Data Integration Center (DIC) organization, MII core data set FHIR resources are read from a local data FHIR server for a single patient, validated against the MII core data set implementation guides and packaged as a FHIR Bundle for transport. The Bundle is temporarily stored in the local DSF FHIR server after all appearances of the patient pseudonym (DIC PSN) have been replaced with a placeholder and the Bundle is asymmetrically encrypted with the RSA public key from the Central Research Repository (CRR) organization. After the encrypted bundle has been placed in the local DSF FHIR server a Task resource with the patient pseudonym is send to the NUM Transfer Hub (NTH) organization to start the download of the encrypted transfer Bundle and further processing.

After the Translate process at the NTH organization finishes or fails a Task resource is send back to the DIC organization to finish the Send process.

NTH: Translate

The Translate process at the NTH organization downloads the encrypted transfer Bundle from the Data Integration Centers (DIC). Exchanges the DIC organization specific patient pseudonym (DIC PSN) by requesting a linked central pseudonym for the Central Research Repository (CRR) organization from the Federated Trusted Third Party (fTTP) organization. Before sending a Task resource with the central pseudonym (CRR PSN) to the CRR in order to start the Send process, the still encrypted transfer Bundle is temporarily stored in the DSF FHIR server of the NTH organization.

After the Send process at the CRR organization finishes or fails a Task resource is send back to the NTH organization to finish the Translate process which in turn sends a Task resource to the DIC organization to finish the Send process.

CRR: Receive

At the Central Research Repository (CRR) organization the encrypted transfer Bundle is downloaded from the NTH organization at the beginning of the Receive process. After decryption all pseudonym placeholders are replace with the received central pseudonym (CRR PSN). Subsequently the transfer Bundle is executed against the data repository of the CRR organization.

General errors, data validation errors or a success message is send via a Task message back to the NTH organization in order to complete the Translate process.

BPMN 2.0 Process Diagrams and FHIR Metadata Resources

The executable BPMN 2.0 process diagrams used for application can be found in the repository at codex-processes-ap1/codex-process-data-transfer/src/main/resources/bpe/. FHIR metadata resources that are needed to perform the data transfers between Data Sharing Framework (DSF) instances are located at codex-processes-ap1/codex-process-data-transfer/src/main/resources/fhir/. Together with the executable code of this DSF process plugin both the BPMN diagrams and the FHIR metadata resources are released as a JAR file.

Clone this wiki locally