...
| Table of Contents |
|---|
Introduction
The service is called Data Manager, previously known as Data Upload before, and is changed to Data Manager at beginning of 2024. The reason for changing name of this service is because extra feature related to data will be added gradually to this service, and Data Upload can not interpret it well.
There are two ways to upload data for listing in the Search & Match Service:
...
is WMDA's enhanced platform designed for efficient and secure data management within the global donor registry network. Renamed in early 2024, the platform's name change reflects its expanded functionality beyond simple data uploads, accommodating a growing range of data-related features.
Data Manager supports both manual and automatic data uploads, allowing registries to list donor information in the Search & Match Service. Manual uploads involve uploading encrypted XML files, while automatic uploads utilize a REST API for seamless integration between systems. Though XML is currently the primary format, support for JSON files is forthcoming, with notifications to be provided when this becomes available.
Once data is uploaded and processed, it becomes accessible to search coordinators and transplant physicians through the Search & Match Service, and is also integrated into the Match-Connect service. For those using the API, technical support is readily available to ensure smooth operation and understanding.
Data Manager is designed to meet the evolving needs of donor registries, offering robust and real-time data processing capabilities that ensure accurate and up-to-date information is always available. For more information and support, you can contact us directly by emailing support@wmda.info
Definitions
| PGP/GPG | Pretty Good Privacy (PGP) is an encryption programme that provides cryptographic privacy and authentication for data communication |
| XML | Extensible Markup Language, a structured |
Data mentioned here is actually the encrypted files which can be files in XML or JSON format. Currently, only file in XML format is supported, when JSON format is supported, WMDA will send out a notification.
If the data is received, it will be processed, and accepted data will be available for Search & Match. Search coordinators and transplant physicians who use the Search & Match Service will be able to search in these data. The data will also be used for Match-Connect service.
For the API usage, it is a technical work instruction, feel free to contact us if you need any support or if you do not understand the work instruction clearly. Our e-mail address is: support@wmda.info
Definitions
| PGP/GPG | Pretty Good Privacy (PGP) is an encryption programme that provides cryptographic privacy and authentication for data communication |
| XML | Extensible Markup Language, a structured file format |
| API | Application Programming Interface (API): a set of clearly defined methods of communication between various software components |
| ION | Issuing Organisation Number (ION) which is provided by ICCBBA to organisations listing in the Search & Match Service You may lookup IONS in the list of organisations maintained by WMDA |
| XSD | XSD defines what elements and attributes may appear in an XML document; annually a new version of the XSD will be released; the current version is: 2.1 |
| JSON | JavaScript Object Notation, a structured data format |
Purpose
This work instruction describes the manual upload method of an PGP/GPG encrypted file through the web application Data Manager.
General concepts:
...
| XSD | XSD defines what elements and attributes may appear in an XML document; annually a new version of the XSD will be released; the current version is: 2.1 |
| JSON | JavaScript Object Notation, a structured data format |
Purpose
This work instruction describes the manual upload method of an PGP/GPG encrypted file through the web application Data Manager.
General concepts:
- Only organisations that have an ION (listing organisations) will be able to upload, ION can be requested before you can list in WMDA Data Manager.
- User must login to the web application using MFA with a user specific email, no group email is allowed, and please follow WMDA MFA user guide here to set it up.
- The platform is organised in so called 'Workspaces'. This Workspace is a private space for each organisation where files can be uploaded and processing reports are available.
- If your organisation submits data on behalf of other registries/CBBs then as an uploading organisation you will be able to see Workspace where you can upload files for affiliated members.
- Uploaded XML files should follow the XML guidelines as described in the Data submission information. JSON format will be supported from data schema version 2.4 onwards, guidelines to follow.
File requirements:
Please check the detailed user guide of XML generation and requirements in Search & Match Service Data submission information.
Some key requirements are as below:
- Files must following the file naming rules as described in the Search & Match Service Data submission information
- Only files with the .pgp and .gpg extension will be accepted for upload.
- XML files should be encrypted with a public key (How to encrypt a file can be found here)
- XML files larger than 800MB is rejected. If your file reach this limitation, contact support team at support@wmda.info.
Getting started
Data Manager Service URLs
We have 2 data submission environments :
- Sandbox: https://sandbox-datamanager.wmda.info : here organisations can upload their data for testing purposes and check their data quality before moving to production.
- Production: https://datamanager.wmda.info : here data is uploaded to production for use in Search & Match Service and Match-Connect. Upload to production is only permitted after a quality assurance inspection by WMDA.
Setup MFA to get access to Data Manager
Setup MFA for the first time
Please follow steps below if you have not setup MFA with any other WMDA services like Search & Match or SPEAR:
- After you get permission to list data in WMDA Data Manager, please contact support team at support@wmda.info to add you in our CRM system, mention clearly you want to get access for Data Manager web application.
- After you are added in our system, normally after 30 mins, you will get a Welcome email, follow steps inside to setup the MFA.
- Contact us by sending an email to support@wmda.info if you do not receive a "Welcome" email with login instructions or if something goes wrong during setup.
...
File requirements:
Please check the detail user guide of XML generation and requirements in Search & Match Service Data submission information.
Some key requirements are as below:
- Files must following the file naming rules as described in the Search & Match Service Data submission information
- Only files with the .pgp and .gpg extension will be accepted for upload.
- XML files should be encrypted with a public key (How to encrypt a file can be found here)
- XML files larger than 800MB is rejected. If your file reach this limitation, contact support team at support@wmda.info.
Getting started
Data Manager Service URLs
We have 2 data submission platform :
- sandbox: https://sandbox-datamanager.wmda.info : here organisations can upload their data for testing purposes and check their dataquality, before moving to production.
- production: https://datamanager.wmda.info : here production data is uploaded, which is permitted only after QA inspection by WMDA.
Setup MFA to get access for Data Manager
Setup MFA for the first time
Please follow steps below if you have not setup MFA with any other WMDA services like Search & Match or SPEAR:
- After you get permission to list data in WMDA Data Manager service, please contact support team at support@wmda.info to add you in our CRM system, mention it clearly you want to get access for Data Manager web application.
- After you are added in our system, normally after 30 mins, you will get a Welcome email, follow steps inside to setup the MFA. For your convenience, we also added the steps below:
- Click on the following link: WMDA Service password reset
- Confirm your e-mail address and set your password
- When you are done with setting up your password go to: https://portal.wmda.info/
- Click on “Partner Sign in” in top right corner
- Enter your email address as username
- Enter the password you set up earlier
- Click “sign in”
- Follow the steps to add this account to your authentication app on your mobile device Once complete, confirm that your MFA credentials allows you access to https://datamanager.wmda.info/
Troubleshooting MFA
When you setup your MFA, or after your MFA is setup successfully, you may encounter issues use MFA properly. If that is the case, go to the WMDA MFA troubleshooting guide to check whether your issue can be fixed.
Manage and transfer MFA to new mobile device
After your MFA is correctly setup and you have already login to the system once, and you want to change to a new device, then you can do it easily by following steps below:
...
- You successfully setup your MFA.
- To access the sandbox system to test your files, please go to https://sanbox-datamanager.wmda.info/. To access the production system, please got to https://datamanager.wmda.info/. You will see the Login screen. (Figure 2)
- If you are a normal (B2C) user, click on the Login button in Figure 2. If you are a B2B user, please follow the user guide here to login.
- Follow the steps for MFA to log in to Data Manager web application.
- If for some reason, you still do not have access to Data Manager, even the MFA is setup, you may get a warning. (Figure 3)
- After login, the system defaults to your personalized Workspace, where you will find your organisation Workspace and all the folders you need.
...