HLA typing and format is very important in the WMDA and registry data exchange.
WMDA is using the published guidance in WMDA guidance for HLA typing for the rules and validation.
A service called HLA Validator is used for all the HLA validation in WMDA services including Data Manager for donors and CBUs, Search & Match for patients, and Match-Connect for both donors and patients.
There are several validations process involved to better serve this service, and these validations are listed below:
- The specification for the endpoint of HLA Validator can be found in the link below:
https://apispecs.wmda.info/?urls.primaryName=HLA%20Validator
2. HLA format validation based on json schema before the value reaching the HLA validator.
The json schema used is as below, if you are with technique background, then you can doc the schema doc below:
https://brave-forest-04a379103.azurestaticapps.net/json_schemas/hlaValidator/validateBatchRequestBody.json
As the doc above it too technique, below is the explanation of the format validation that which are NOT supported in the json schema:
| Loci | Rule of Regular expression | Length | Valid value examples | Invalid value examples |
|---|---|---|---|---|
| SER value for all loci that have SER | ^\\d{1,4}$|^UUUU$ | 4 | 1 | "XXXX" is not allowed for ser value |
| "NNNN" is not allowed for ser value | ||||
| "NEW" is not allowed | ||||
| "01" value start with "0" will be rejected | ||||
DNA for loci A, B, C, E, DRB1, DPA,DPB,DQA,DQB | ^\\d{2,}:[A-Z0-9:]{1,}$|^NEW$|^UUUU$ | 20 | 01: XX | "/" is not allowed: for example01:02/01:03 |
| "*" is not allowed: A*01:02, A*11:FKFNG | ||||
| value is not start with letters: A01:02 | ||||
| Space is not allowed: 07:BZEJD | ||||
| value using small letter "new" is not allowed | ||||
| Use mixed value is not allowed, for example: NEW:XX | ||||
| ";" comma is not allowed, which mean 01;02 is invalid format. | ||||
| G group is not allowed at end of other HLA field instead of 3rd HLA field. 01:01G and 01:01:01:02G is invalid. | ||||
| P group is not allowed at end of other HLA field instead of 2nd HLA field. 01:01:01P is invalid. | ||||
| value using small letter "uuuu" is not allowed | ||||
| DNA for loci DRB3, DRB4, DRB5 | ^\\d{2,}:[A-Z0-9:]{1,}$|^NNNN$|^UUUU$|^XXXX$|^NEW | 20 | All valid value above for DNA | All the invalid value above for DNA |
| value below using small letters are not allowed: nnnn, xxxx |