CDD Vault Update (December 2020): Manage Molecule Fields and Registration Settings; Improvements to Run and Protocol Modified Dates

CDD Vault Update Logo
December 11, 2020

Manage Molecule Fields

The long-awaited ability to manage your molecule fields is finally here. Just like Batch fields, Molecule fields now have a menu in the Settings > Vault tab. So, navigate to the Settings > Vault > Molecule Fields where Vault Administrators can:

  • create new Molecule fields,
  • set business rules for Molecule fields, and
  • edit and delete Molecule fields.

molecule fields settings

Molecule fields are optional, required or conditionally required (just like Batch fields) and can be:

  • Text
  • Number
  • Date
  • Pick List
  • File

Noteworthy Tips

  1. Using the Keyword search, you can now query Molecule fields in the same manner as you query Batch Fields.
  2. Don’t forget that “managing your Molecule fields” also means you can designate which Molecule field can be overwritten during a bulk import process. Just like overwriting Batch Fields, the ability to overwrite values stored in Molecule fields via the Import Data wizard is now available as a Vault Administrator setting. Vault Admins can use the Settings > Vault > Molecule Fields page to set an “Overwritable” flag on any Molecule field that is not being automatically generated nor calculated.
  3. Clean up your Molecule fields in CDD Vault and ensure mandatory data is captured. You can delete and merge unnecessary fields, control content using pick lists and even overwrite existing values. CDD is happy to help – please contact Support for guidance.
  4. Vault Admins can enforce a uniqueness check on values populated in a Molecule field. This ensures that no two Molecules registered will ever have the same value in that Molecule field. However, unlike unique Batch fields, these unique Molecule fields cannot be used as a key field in the Vault. So, for example, users:
    1. cannot create Batches based on these unique Molecule fields.
    2. cannot import data using these unique Molecule fields (Molecule Synonym values can be used for mapping data during import).
  5. In the future, all Molecule file attachments will need to be attached to a Molecule field. CDD plans to migrate existing Molecule file attachments into a special Molecule field which will not accept new files. The current “Attach a file” option in the Molecule > Files tab will not be available.

Change Molecule Name/ID Prefix and Sequence

Speaking of providing more utility to our Vault Admins, the Molecule name (IDs) prefix generated by CDD Vault when new Molecules are registered may now be updated. Changing this setting will update the prefix for all registered Molecules and sets the new prefix for any Molecules registered in the future. Additionally, the Vault Admin can change the sequence used for the next Molecule Name (ID) registered.

edit molecule name ID

Once in edit mode, type in the new prefix and/or the new Registration System Current Value. (Remember to click the green Save Changes button!)

registration system prefix and current value

Noteworthy Tips

  1. As an example, the Vault Admin can set the sequence to 99,999 before a bulk import of a library so that the Molecules registered from that library will have Molecule Names (IDs) beginning at Prefix-0100000.
  2. The typical time for changing the Molecule Name (ID) prefix is approximately 15 minutes for every set of 10,000 Molecules. During this processing time, registration of new Molecules or Batches will not be allowed.

Import XLSX Excel Files from ELN

When hovering over a XLSX Excel file within the ELN entry, select the “Import File” button to send the data file through the Import Data process.

import XLSX icon

Files that can be directly imported from an ELN entry now include XLSX, csv, sdf and zip files.

Protocol and Run Modified Dates

Many CDD customers use the API to retrieve data from CDD Vault, and in order to know when to fetch new data you need to know when something has changed. Changes to Protocol and Run data are now reflected in the Protocol and Run “Modified Date”.

  • Run Modified Date is updated when users: add or delete readout rows, edit existing readout rows, flag data points as outliers.
  • Protocol Modified Date is updated when users create or delete Runs.
  • GET Protocols API call now includes a query parameter for
    • runs_modified_before
    • runs_modified_after

Noteworthy Tips

  1. These updates to Modified Dates are useful for API integrations that routinely poll CDD Vault for changes made to any data.