Release of the MII data-sharing process plugin used by a HRP to coordinate data sharing of an approved data usage project including transfer of data-sets or analysis results from a DIC to a DMS and aggregation of transferred data at the DMS. This release includes bug fixes and improves error messages.
The documentation of the process including the description, the deployment and configuration guides as well as instructions on how to start a process instance can be found in the wiki. For a pre-built jar file, see assets: mii-process-data-sharing-1.1.0.0.jar.
General remarks:
- This release is compatible with the Data Sharing Framework version
>= 1.0.0. This release does not work with DSF versions< 1.0.0.
Features include:
- Error messages are now propagated using the camunda:errorMessageVariable extension in BPMN instead of setting additional process variables.
- Implemented the enhanced FHIR RESTful API for serving Binary resources, enabling direct streaming of Binary content to support larger data transfers in data use projects. It can be activated by setting the environment variable
DE_MEDIZININFORMATIK_INITIATIVE_DATA_SHARING_DIC_FHIR_SERVER_BINARY_STREAM_READ_ENABLEDtotruefor reading Binary resources by stream as DIC andDE_MEDIZININFORMATIK_INITIATIVE_DATA_SHARING_DMS_FHIR_SERVER_BINARY_STREAM_WRITE_ENABLEDfor writing Binary resources as stream for DMS. By default reading and writing Binary resources as stream is deactivated. For HAPI FHIR servers, the additional environment variableDE_MEDIZININFORMATIK_INITIATIVE_DATA_SHARING_DIC_FHIR_SERVER_BINARY_STREAM_READ_USE_HAPI_BLOB_STORAGE_OPERATIONhas to be set totrueif theblob-storageoperation is enabled. - The environment variable
DE_MEDIZININFORMATIK_INITIATIVE_REPORT_DIC_FHIR_SERVER_OAUTH2_ISSUER_URLchanged toDE_MEDIZININFORMATIK_INITIATIVE_REPORT_DIC_FHIR_SERVER_OAUTH2_URL(withoutISSUER). It now matches its intended meaning and no longer requires setting the token URL. The same applies for the corresponding DMS configuration. See the Configuration Change section below. - DocumentReference resources can now include multiple attachments, allowing the transfer of multiple datasets in a single data transfer between DIC and DMS.
- Dependencies were updated where applicable.
- Updates CodeSystems and StructureDefinition resources of older process versions so that different versions of the process can be executed in parallel.
Configuration Change:
The environment variable DE_MEDIZININFORMATIK_INITIATIVE_REPORT_DIC_FHIR_SERVER_OAUTH2_ISSUER_URL changed to DE_MEDIZININFORMATIK_INITIATIVE_REPORT_DIC_FHIR_SERVER_OAUTH2_URL (without ISSUER). It now specifies the OIDC realm base endpoint instead of the OIDC token endpoint previously. The token endpoint is now automatically discovered using the OIDC discovery protocol. The discovery endpoint can be configured using the environment variable DE_MEDIZININFORMATIK_INITIATIVE_REPORT_DIC_FHIR_SERVER_OAUTH2_DISCOVERY_PATH, using a default value of /.well-known/openid-configuration. The same applies for the corresponding DMS configuration. Please update your configuration accordingly.
Issues closed:
- Use BPMN errorMessageVariable instead of specific self set variable #36
- Read Binary Content as Stream instead of a Binary Ressource #44
- Configuration parameters for OAuth2 token URLs incorrectly named issuer URLs #45
- Allow multiple attachments for DocumentReference resource #47
- Update Dependencies #52
- Deployment of process with different versions in parallel #54
Contributors:
This release contains contributions from @wetret, @schwzr, and @hhund.