Home

Projectathon-6 Data Transfer

This repository contains the Data Transfer Process used in the Projectathon-6 to send data from a Data Integration Center (DIC) to a Coordinating Site (COS, also called Data Management Site). The infrastructure and communincation messages on which the process is based can be seen in the following figure. The organizations use the Data Sharing Framework (DSF) for deployment and execution of the process.

<PLACEHOLDER-PROCESS-IMAGE>

The Data Transfer Process in v0.1.0 is composed of 2 different subprocesses:

Send Process

The send process is used at a DIC to prepare and initiate data sending of a specific projectathon projects results to a COS. This subprocess performs the following steps:

• Read the project results from a dedicated KDS FHIR store
• Validate the project results and create a data transfer Bundle
• Download the public-key from the COS and encrypt the transfer Bundle
• Provide the encrypted transfer Bundle and the local DSF FHIR server for the COS
• Automatically delete the encrypted transfer Bundle on the local DSF FHIR server after 2 minutes

Prerequisites:

In order to start the send process, the following needs to be known and prepared:

• DIC identifier of the local organization (dic-identifier)
• COS identifier which should receive the results (coordinating-site-identifier)
• Project identifier for which results should be transmitted (project-identifier)
• A DocumentReference and Binary resource on the KDS FHIR store representing the result to be transmitted
  • An example transaction Bundle to load the results onto a KDS FHIR store for the projects WE-STORM and NT-proBNP can be found here
  • Replace the placeholder <REPLACE-WITH-YOUR-ORGANIZATION-IDENTIFIER> with the dic-identifier
  • Replace the placeholder <REPLACE-WITH-DATE-AND-TIME> with the date and time when the result was created in the form yyyy-MM-dd'T'HH:mm:ssX
  • Replace the placeholder <REPLACE-WITH-BASE64-ENCODED-CSV-FILE> with the base64 encoded CSV result file
  • Check the project-identifier which is already set in the example transaction Bundles

Start Send Process:

The send process can be started for the projects WE-STORM and NT-proBNP by sending the Task resources that can be found here to the local DSF FHIR server:

• Replace the placeholder <REPLACE-WITH-YOUR-ORGANIZATION-IDENTIFIER> with the dic-identifier
• Replace the placeholder <REPLACE-WITH-DATE-AND-TIME> with the date and time when the result was created in the form yyyy-MM-dd'T'HH:mm:ssX
• Check the coordinating-site-identifier and the project-identifier which are already set in the example Task resources

Receive Process

TODO