...
This is a technical work instruction, feel free to contact us if you need any support or if you do not understand the work instruction. Our e-mail address is: support@wmda.info
Definitions
| PGP | Pretty Good Privacy (PGP) is an encryption programme that provides cryptographic privacy and authentication for data communication |
| XML | Extensible Markup Language, a structued 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 |
...
Purpose
This work instruction describes the manual upload method of an PgP/GpG encrypted XML file through the submission platform.
...
PLEASE NOTE: This platform is still under development. Therefore, you may notice outages, changes to your data, or even find some functions broken and giving errors. These potentially issues are either due to new functional deployments taking place or their being a bug in the software. If you do come across any bugs or defects please do report these as part of any feedback you may have by sending an email to support@bmdwsupport@wmda.orginfo.
The premise of giving our listing organisations access to the test site is to allow them to familiarise themselves in advance of this being deployed to production and also start to implement and test their XML files and provide us feedback on any functions that they might wish to enhance or see added to the system.
...
If you are not a current user and would like to have access to upload your test XML file, please send us an email to support@bmdwsupport@wmda.org info
To access the system for the first time
...
| Imagefloat | ||
|---|---|---|
| ||
|
Change password or forgot password
...
Forgot registered email address: If you might have forgotten your e-mail address that was registered for your data upload account, please contact the WMDA office by email via support@bmdwsupport@wmda.org info
Change password: You can also change your password after you logged into the system.
...
Tip: If you haven’t changed your password for a long time, we recommend that you do so to ensure that your profile is secure. We recommend that you change your password every 6 months.
| Imagefloat | ||
|---|---|---|
| ||
|
| Imagefloat | ||
|---|---|---|
| ||
|
...
If you attempt to login more than 3 times with incorrect credentials the system for security reasons will ask you to enter a code that appears in an image as shown in Figure 3b.
| Imagefloat | ||
|---|---|---|
| ||
|
...
Logging off from the service
...
PLEASE NOTE: On the left hand side you can see the Workspace for your registry that you have access to. Most organisations will have access to just one space even if you are submitting data on behalf of other registries.
Setting button: when you click on the settings button, you can seen a drop-down menu (Figure 4) with
...
| Imagefloat | ||
|---|---|---|
| ||
|
You are only allowed to upload files that are encrypted. If you try and upload files that are non PgP/GpG encrypted the system will give you an upload error as shown in figure 8b.
...
Users should be reported for the following scenarios on file level validations
| Scenario | Event stage | Description | Type of message | ||
| File with wrong filename | The system will reject the file if the file name doesn't conform to the agreed format which is : ION-1234-D.PgP, ION-1234-D.xml.Pgp, ION-1234-D.zip.PgP, ION-1234-C.PgP, ION-1234-C.xml.Pgp, ION-1234-C.zip.PgP. | Rejected - ADD MESSAGE AS PART OF THE REPORT | |||
| If a user uploads two files consecutively with same file name. Eg ION-1234-D.PgP and ION-1234-D.PgP | In such a scenario the most recently uploaded file is taken through the pipeline, the previous file is deleted and not processed. | ||||
| If a user uploads two files consecutively with different file names. E.g ION-1234-D.PgP and ION-1234-C.PgP | In such a scenario the system will process the two files as separate files. | ||||
| If a user uploads a PgP encrypted file with a invalid key. | Decrypted | In such a scenario the system will not be able to decrypt the file and the pipeline will not be able to process the file. | Rejected - ADD MESSAGE AS PART OF THE REPORT | ||
| If a user has uploaded a zipped file which isn't an XML | Decompressed | In such a scenario once the system has decrypted the file and finds the file isn't an XML the pipeline will not be able to process the file. | Rejected - ADD MESSAGE AS PART OF THE REPORT | ||
| If a user has uploaded a file with the file creation time set in the future | XSD file validation | In such a scenario once the system has decrypted the file and finds that the file creation date/time is in the future then the pipeline will not be able to process the file. | Rejected - ADD MESSAGE AS PART OF THE REPORT | ||
| If a user has uploaded a file with the file creation date and/or time in an incorrect format | XSD file validation | In such a scenario once the system has decrypted the file and finds that the file creation date/time is in an incorrect format then the pipeline will not be able to process the file. | Rejected - ADD MESSAGE AS PART OF THE REPORT | ||
| If a user has uploaded a file where the listing organisation doesn't match the ION number in the file name | XSD file validation | Rejected - ADD MESSAGE AS PART OF THE REPORT | |||
| If a user has uploaded a file where the update mode is other than full | XSD file validation | Rejected - ADD MESSAGE AS PART OF THE REPORT | |||
| If a user has uploaded a file where the file name and content type do not match. | XSD file validation | In such a scenario once the system has decrypted the file and finds that there is a discrepancy in the file name content type and the file content type then the pipeline will not be able to process the file. E.g File name = ION-1234-D.PgP and the Content type = C | Rejected - ADD MESSAGE AS PART OF THE REPORT | ||
| If a user has uploaded a file that has content type of both donor and cord | XSD file validation | Rejected - ADD MESSAGE AS PART OF THE REPORT | |||
| If a user has uploaded a file where the file version isn't correct | XSD file validation | Rejected - ADD MESSAGE AS PART OF THE REPORT |
[1] The specification is available at https://pydio.com/en/docs/references/api/v2#!/File/uploadStream
STANDARD OPERATING PROCEDURE | |||
| |||
TITLE: | Data submission protocol | ||
VERSION No: | 0.3 | ||
DATE OF ORIGINAL ISSUE: | March 2017 | ||
REVIEW INTERVAL: | 12 months (This includes the testing process) | ||
ORIGINAL PREPARED BY: | Manish Kakkar | ||
QM REVIEWED BY: | Quality Team | ||
AUTHORISED BY: | Chief Executive | ||
COPY and LOCATION | Master Copy – WMDA Share – DOCxxx | ||
Document Version History | |||
Version | Author | Changes | |
0.1 | Manish Kakkar | SOP generated | |
0.2 | Beer Holties | Update (Sprint 3/4) | |
0.3 | Jorine Koenderman | Release staging version (28-07-2017) | |
| 0.4 | Manish Kakkar | Updated post release to staging version (07-08-2017) | |