The file transfer format described in this document is meant to specify the minimum amount of information that must be provided by a lab to automatically post results against an anti-doping test recorded in ADAMS.
File Format
A standard CSV file format is defined to allow all laboratories to report BPLR results in a consistent manner.
Timing of Submission
ADAMS has been designed to accept BPLR records (either manually entered or electronically submitted via CSV file transfer) either before or after the relevant doping control form has been entered. The result matching and verification process will only complete after the DCF is entered.
Method of Transmission to ADAMS
ADAMS users at laboratories will be provided with user credentials to allow them to upload files containing multiple Biological results. Of course, individual result records can be entered and posted manually on the BPLR-page.
Posting and Acknowledgement of Results
After a file containing a batch of BPLR results is uploaded, screened, and accepted by ADAMS, ADAMS will display a screen containing a summary of the records uploaded. The user is then expected to review the summary and accept (Post) the results into ADAMS, so that they are made available to all relevant parties.
The user may elect to print this summary screen from the browser as an acknowledgement of the transmission.
Error Handling
ADAMS will carefully screen each record uploaded in a file. If an error occurred during the processing of one line of the CSV file, the summary screen will display the error so that it may be corrected and the file re-transmitted. All other records will be imported.
CSV-file: The first record of the CSV-file (line 0) is reserved for column titles that should exactly match the prescribed spelling (see tables below). Otherwise errors will be displayed. Error messages pertaining to the content will tell on which line (>0) the value for which column is wrong or missing. Duplication of the sample code (for the same sample type) is checked. Only a sample record that causes an error will be rejected. The remainder of the file will still be accepted.
Biological Result Data Elements
This section will describe each data element that will be transmitted to ADAMS. Unless otherwise specified, the data element is considered to be mandatory.
CSV file: This file specifies the CSV file import format for BP lab results. It has been designed to be as simple as possible, with only one line per sample and a minimum set of mandatory data per sample. The sequence of the columns is not relevant. One sample detail record, containing the required information, must be provided for each sample analyzed.
The seven mandatory fields per sample match the fields required in the ADAMS application. The status of each result record is determined by the user action (e.g. POST) taken immediately following import.
FIELDS (Mandatory columns are in bold):
|
Field |
Column header |
Description |
Example(s) |
|
Sample Code |
sample_code |
This is the identifying number on the sample collection kit. |
"1479265" |
|
Sample Type |
sample_type |
Only one sample type is supported "blood_passport" |
|
|
Sample Collection Date |
date_collection |
Date of the sample collection (yyyy-MM-dd); |
"2009-02-02" |
|
Date and Time Received by Lab |
date_received |
This specifies the date that the sample was received by the laboratory (yyyy-MM-dd hh:mm) |
"2008-01-13 06:00" |
|
Testing Authority |
ta |
This field contains the short-name identifier of the Testing Authority, which is generally the laboratory's customer. Valid short-name identifiers can be retrieved from the Contact-link in the ADAMS-header. Codes are available here |
"UCI" |
|
Sample Collection Authority |
sca |
This field contains the short-name identifier of the Sample Collection Authority. Valid short-name identifiers can be retrieved from the Contact-link in the ADAMS-header. Codes are available here |
"UCI" |
| Results Management Authority | rma |
A code indicating the short name of the Results Management Authority. Codes are available here |
"UCI" "IAAF" |
|
Analysis Date |
analysis_date |
Date and time of the analysis (yyyy-MM-dd hh:mm) |
"2009-02-02 14:12" |
|
Test Type |
test_type |
This field is used to indicate whether the sample was collected in- or out-of-competition |
"IC" |
|
Sport |
sport_code |
This field is used to report the sport of the athlete who contributed the sample. The WADA sport identifier code must be used in this field, not the sport's name. Codes are available here
|
"AT" |
|
Discipline |
discipline_code |
The sport discipline's specific code. Codes are available here |
"AT" |
|
Lab |
lab |
Analyzing lab short name in ADAMS. |
"TESTLab" |
|
Lab Internal Reference number |
lin |
The Lab internal reference number (e.g. the client's Id #). Alpha-numeric characters are allowed. |
"123-a" |
|
Blood Analyzer |
analyser |
The field value must start with either of the codes listed. Ex: "XT-1234" |
"XT, "XN", "XE" |
|
Gender |
gender |
Possible values: M, F, X (default) |
"M", "F", "X" |
|
Mission order# |
mo_number |
The mission order number. Alpha-numeric characters are allowed. |
"M-12345" |
|
Country |
country |
The code of the country where the sample was collected. |
"AL" |
|
Region |
region |
The code of the region – linked to the country - where the sample was collected. |
"AL-BR" |
|
City |
city |
The name of the city (free text) where the sample was collected. |
"Cairo" |
|
Comments |
comments |
This field is used to provide any relevant information concerning the analyses performed by the laboratory or specific observations made. |
"text" |
|
Analysis type |
analysis_attribute |
The field is used to list the specific analyses completed. It can include multiple values separated '|' |
"HBOCS" |
|
Analysis Details/Explanation/Opinion |
analysis_details |
Free text field for additional details about the analysis |
|
|
Blood Parameters |
<blood parameter specific code> |
Blood parameters specific code. |
"HCT", "RBC", "HGB", "MCHC", "MCH", "MCV", "RET#", "RET%", "Off-Score", "RDW-SD", "IRF", "WBC", "PLT" |
Date format: Please note that if you are using an older version of Excel, the date format may not be shown as yyyy-MM-dd but as dd/MM/yyyy. You can find out the actual values however by opening your CSV-file in Wordpad. So don't be misled by how it is displayed in Excel.