See attached file for the latest XML template.
Work is currently still in progress. The following will be effective as of the start date of the TD2016EAAS & TD2016IRMS Reporting in 2016.
For more details, also see the descriptions under CSV file |
BATCH HEADER INFORMATION
Each file must contain one batch header containing the following information:
Data Element | Description |
File Creation Date | An ISO representation of the date that the data file was created by the laboratory (e.g. 2005-02-15). This date will be stored in ADAMS as the result posting date. |
Transmission Source Name | The name of the organization, department, or possibly individual that is the source of the data transmission. This field is optional, but if provided, it will be stored in the "Observations and Details" area of the result record. |
Batch ID or Number | An internal lab number to identify the batch of results contained within the transmission. This identifier will be stored with each result record in ADAMS. |
Lab | An identification code indicating the Lab name that is to send the result records. |
Testing Type | A code indicating whether the samples were collected in-competition ("IC") or out-of-competition ("OOC"). This tag is mandatory for the Import operation, whereas it is optional for the Update operation. If mentioned in the header, the suggested value will apply to all results in the body. |
Comments | If desired, comments can be provided. This field is not mandatory. |
SAMPLE DETAIL RECORDS
One sample detail record, containing the following information, must be provided for each sample analyzed:
* Identifies mandatory fields
Data Element | Description |
Sample Code* | The unique sample code (e.g. test kit identifier). This will be used to match the result record to the test record. |
Lab ID Number (LIN) | An internal number or code assigned to each sample by the lab. This field is not mandatory, but will be stored in ADAMS if provided. |
Sample Type* | A code used to identify the type of sample provided (e.g. Blood, Urine)... |
Sample A/B* | Code to indicate whether the result record relates to the analysis of the "A", the "B", "B1" or "B2" Sample. It is possible to specify the values "B1" and "B2" for samples reported after January 1st 2015. (ADAMS Release 4.0) |
Date Sample Collected* | The sample collection date as recorded on the doping control form. (e.g. 2005-02-12) This field is mandatory for samples with a date received after the start date of the TD2016EAAS & TD2016IRMS Reporting in Jan 2016 |
Date Sample Received by Lab* | The date that the lab received the sample (e.g. 2005-02-12) |
Gender of Athlete* | A code (M, F, or X) indicating the gender of the athlete as provided on the doping control form. This field is not mandatory. |
Sport & Discipline* | The sport and discipline in which the athlete competes (e.g. AQ ). ADAMS will record the lab entry even though it may not exactly match the sport and discipline recorded on the sample collection order. |
Event | The name of the event (e.g. Men's 100m finals) in which the athlete was competing, as provided on the doping control form. |
Sample Collection Authority* | A code indicating the short name of the Sample Collection Authority. |
Country of Sample Collection | A code indicating the country in which the sample was collected. |
Region of Sample Collection | A code indicating the region in which the sample was collected. |
City of Sample Collection | The city where the sample was collected. This is not a mandatory field but may be used to verify a match if provided. |
Testing Authority* | A code indicating the short name of the Testing Authority.This is a mandatory field for samples reported after January 1st 2015. (ADAMS Release 4.0) |
Results Management Authority | A code indicating the short name of the Results Management Authority. This is an optional field for samples reported after January 1st 2015. (ADAMS Release 4.0) Example: <rma> <shortName>CCES</shortName> </rma> |
Mission order number | Optional |
Competition name | If applicable, the name of a competition |
Validity* | urine sample validity - tag: valid with the values "true" or "false". This is a mandatory field for urine samples since January 1st 2014. |
Screen T/E Ratio | A number indicating the T/E ratio of the sample. For example, 2.6 would indicate a T/E ratio of 2.6:1. This field must only be used for samples received prior to January 1st 2014, it is not a mandatory field. |
pH | A value indicating the pH of the sample. This is not a mandatory field; if it is not provided, the implication will be that the pH of the sample is within acceptable limits. |
Specific Gravity* | A value indicating the S.G. of the sample. This is a mandatory field for samples received after January 1st 2014. |
Test Result* | A code indicating the test result following the sample analysis ("Negative", AAF, ATF, "NotAnalyzed"). |
Test Result Reason | This is not a mandatory field. |
Date results reported | Date of reporting the results. This is not a mandatory field. |
Analysis Type(s) Performed | A list of analysis types that were performed on the sample. E.g. "EPO", "GC/C/IRMS", "Transfusion", "HBOCS", "hGH", and "Other". Not mandatory.
ESAs (incl. recombinant EPOs and analogues) [internal code EPO]; GC/C/IRMS [code IRMS] ; Insulins [code Insulin] ; GHRF (GHRH/GHS/GHRP) [code GH]; GnRH [code GnRH ] ; IGF-1 analogues (code IGF1]; Other (code Other]
GH Isoforms [code hGH] ; GH Biomarkers [code hGH Markers] ; Blood Transfusions [code Transfusion] ; HBOCS [code HBOCS] ; ESAs (incl. recombinant EPOs and analogues) [code EPOb]; IGF-1 analogues [IGF1b] ; Insulins [code Insulinsb] ; Other [code Other] |
Details | A free-text description (Analysis details/Explanation/ Opinion) of any relevant observations or analyses performed on the sample (e.g. sample tampering or received in poor condition, sample decomposition detected, unusual odor or color detected, etc.). This field is not mandatory. Please note that any departure from the International Standard for Laboratories must be reported to the Testing Authority outside of ADAMS, especially if the sample result is an adverse analytical finding. |
Send notification of results to | A code indicating the short name of the organization the results have to be sent to. Multiple organizations are possible. |
Steroid profile variable* | A code and value indicating the name of the variable and the corresponding value. This field is mandatory for samples received as of January 1st 2014. |
Prohibited substance | The code, value and unit of the prohibited substance. |
Metabolite only | A flag indicating whether merely metabolite(s) are involved |
Mean concentration/ standard uncertainty | If a Threshold substance is concerned, the Mean/ Uncertainty values and units can be indicated |
Indicator Monitoring | To indicate whether the sample was analysed for the Monitoring programme. Tag: monitoring with possible values 'true' or 'false' |
Comments monitored | Comments on the monitored sample. Tag: commentsMonitored |
Monitored substance details | ![]() |
Test method details | The comments are free text, whereas the 'code' is an ISO code as has been pre-defined by the Lab administrator. |
Microbial contamination parameters | ratio_5aand_a and ratio_5band_etio refer to 5aAND/A or 5βAND/Etio and are both mandatory for the screening procedure. ratio_freet_totalt refers to "Free T/total T" All are decimal values These fields are effective after the start date of the TD2016EAAS & TD2016IRMS Reporting in Jan 2016
|
Confirmed specific gravity | When the user is confirming the result, the Specific Gravity must be confirmed. This is mandatory. This will be effective after the start date of the TD2016EAAS & TD2016IRMS Reporting in Jan 2016 |
Suspicious SP confirmation request status | The confirmation request status is mandatory for a Suspicious Steroidal Passport under certain conditions. The selection options are boolean values (true/false) This will be effective after the start date of the TD2016EAAS & TD2016IRMS Reporting in Jan 2016 |
Presence of confounding factors | CF_code[index]: specific code of the Confounding Factor variable. Possible values: ‘ethylglucuronide’ for ‘Ethyl Glucuronide’; ‘5areductase’ for ‘5a-reductase inhibitors’; ‘ketoconazole’ for ‘ketoconazole or similar’; ‘hCG’ for ‘Heterodimeric hCG’; ‘steroids’ for ‘Anabolic Steroids’; masking’ for ‘Masking Agents and diuretics’. The index number ranges from 1 to 6. If Lab results are entered after the start date of the TD2016EAAS & TD2016IRMS Reporting in Jan 2016 AND the sample_type = Urine in the file, then ALL CF_codes for index 1 to 6 should be present in the Import file. CF_presence[index]: Boolean with values True (yes-confounding factor is present) or False (no - confounding factor is not present). Mandatory for all indices from 1 to 6. CF_ethyl_conc: decimal value for the estimated concentration of the confounding factor Ethyl Glucuronide’. Optional, yet the Lab should enter a value if concentration is above 5 ug/mL. This will be effective after the start date of the TD2016EAAS & TD2016IRMS Reporting in Jan 2016 |
Confirmation of the presence of confounding factors | CF_code_confirmed[index]: specific code of the Confirmed Confounding Factor variable. It is mandatory for all CFs where CF-presence (initial value) = ‘True’ – the file should then contain a CF_code_confirmed = CF_code CF_presence_confirmed[index]: Boolean with values True (yes- Confirmed confounding factor is present) or False (no- Confirmed confounding factor is not present). It is mandatory for all CFs where CF-presence (initial value) = ‘True’ – the file should then contain a CF_code_confirmed = CF_code AND a CF_presence_confirmed CF_ethyl_conc_confirmed: decimal value for the Confirmed estimated concentration of the confounding factor Ethyl Glucuronide’. It is mandatory if for any index (CF_code_confirmed[index] = ‘ethylglucuronide’ AND CF_presence_confirmed[index] = ‘True’) This will be effective after the start date of the TD2016EAAS & TD2016IRMS Reporting in Jan 2016 |
IRMS Target Compounds | TC_variable_code[index]: specific code of the IRMS Target_Compound variable. If Lab results are entered after the start date of the TD2016EAAS & TD2016IRMS Reporting in Jan 2016 AND the analysis_attribute = IRMS in the file, then at least one TC should be present in the Import file. Index should not have a limit. Current possible values: testosterone (T), epitestosterone (E), androsterone (A), etiocholanolone (Etio), "5α-androstane-3α,17β-diol" (5aAdiol), "5β-androstane-3α,17β-diol" (5βAdiol), 19-NA, formestane, boldenone, boldenone metabolites, other TC (other_TC). TC_variable_d_value[index]: δ (0/00) decimal value or integer as per ADM2 settings for each variable. Mandatory if a TC_code is included for the same index. TC_variable_u_value[index]: uc (0/00) decimal value or integer as per ADM2 settings for each variable. Mandatory if a TC_code is included for the same index. This will be effective after the start date of the TD2016EAAS & TD2016IRMS Reporting in Jan 2016 |
Endogenous Reference Compounds | ERC_variable_code: specific code of the Endogenous Reference Compound variable for IRMS. Can only be present if the analysis_attribute = IRMS; If nothing is entered, then the default is PD. Possible values: Pregnanediol (PD), 5α-androst-16-en-3α-ol (16-en), 11β-hydroxyandrosterone (11-OHA), 11-ketoetiocholanolone (11-O-Etio) ERC_variable_d_value: δ(0/00) decimal value or integer as per ADM2 settings for the variable. Mandatory if the analysis_attribute = IRMS is included. If there is no ERC-code then it is assumed that it is for PD. ERC_variable_u_value: uc (0/00) decimal value or integer as per ADM2 settings for the variable. Mandatory if the analysis_attribute = IRMS is included. If there is no ERC-code then it is assumed that it is for PD. This will be effective after the start date of the TD2016EAAS & TD2016IRMS Reporting in Jan 2016 |
Comments for the IRMS reporting | free text comments to the IRMS analysis for the sample (optional) This will be effective after the start date of the TD2016EAAS & TD2016IRMS Reporting in Jan 2016 |