When you want to import a worksheet in Waters' MassLynx™ directly from OneLab, you need to configure 2 things:
Your OneLab protocol - with all the sample reference and consumable defined as "Target labware" (See this article: Enabling 🏷️ Sample tracking in your experiments)
The MassLynx template file - with all the settings such as LC/MS method settings required by MassLynx. OneLab will propose you to download an example template that you update to fit your needs. (See this article for further information: Create or update your MassLynx template file)
After the experiment, export samples info for MassLynx
How do to it
a. Release the experiment report by clicking on the button on the top right corner
OneLab will ask you to provide a reason why you wish to release this report and optionally e-sign this report.
b. Click on Export sample information then Download samples info for MassLynx (.csv)
c. OneLab asks you to import your MassLynx template file (following the instructions in this article), click on "Import MassLynx template file..." and browse to the location that contains the template that corresponds to your experiment.
d. You will automatically receive a CSV file ready to import in MassLynx
Then, open MassLynx, click "File", "Import Worksheet..." and select CSV file downloaded form OneLab
Note: It is important that the headers in the MassLynx sample list match those in the template file for successful import.
Once the MassLynx sample list has been created, it should be saved and the sample list can then be submitted.
📈 Now, you can start the measurements with your instrument!
Annex: What OneLab does with the MassLynx template file.
This exported file contains all the settings contained in the MassLynx template file plus all the gaps filled by OneLab:
The Index is generated at every export
A unique File Name is generated with date and time as a prefix and an increment on 3 digits as a suffix
The Sample ID columns is filled with the sample information available in OneLab following these rules:
If available, we use the SampleIdentifier of the source (
SampleParentIdentifier) or sample bar code scanned in using a USB hand held scanner.
Otherwise, we use the LabwareIdentifier of the source and we concatenate with the SamplePositionNumbering by following this format:
If the LabwareIdentifier of the source was not provided by the operator, OneLab will use the OneLab UUID of the parent labware (
The Sample location
o The Bed position (before the colon), being the location the extracted samples in the 96 well plate are placed into the sample manager/organizer of the LC/MS system, is retrieved from the MassLynx template file
We add the sample position on 2 digits after the colon (well numbering of the plate in sequential discontinuous format (column-wise numbering from 1-96), like
SamplePositionNumberingin the other samples info export file)
Learn more about the sample info export data, see Annex: Complete and retrieve 🏷️ sample info at the end of the experiment
Important: The number of lines contained in the MassLynx template file will be cropped to fit the current number of samples that was process in this samples prep run. OneLab will not add any lines.
Note: If we have multiple samples in one well, we only process the first one (alphanumerical order).