Use Protocol fields to establish business rules for capturing biological data. For biological data, the protocol is a data template for the assay that is defined to capture raw data, normalization of data, additional calculations, conditions and lastly plate control layouts.
In this article, we go over how a Vault Administrator can add Protocol fields using the Settings > Vault > Protocol Fields tab.
Protocol Fields When creating Protocol definitions within CDD Vault, users have traditionally been able to define the Protocol name, a Category, and a Description. These top-level Protocol annotations can now be modified and/or expanded to include additional custom Protocol fields. The Vault Administrator must create any new fields (for example SOP, Mode of Action, Assay Kit, Assay Target, etc) that users can then populate when creating new Protocol definitions.
To edit or add Protocol fields, a Vault Administrator can navigate to the Settings > Vault > Protocol Fields tab and click the “Add/Edit Protocol Fields” link (the pencil icon) located in the top right of this panel.
Next, the Vault Administrator can:
- “Add a protocol field” at the bottom of the list of current Protocol fields
- Type in a Name for the new Protocol field
- Choose the data type (Text, Long text, Pick List or File)
- Select if the field is optional, required or conditionally required
- Repeat steps 1 through 4 as needed
- When finished, click the green “Update protocol fields” button in the lower right corner
Users can then populate these new fields when creating Protocols. As a reminder, to create a new Protocol, click the “+ Create a new…” button in the sidebar and select Protocol.
A form containing all of the available Protocol fields, as created by the Vault Administrator, is shown.
Once the values are filled in, and the Protocol definition is saved, the Protocol Details tab will show the full definition of the Protocol.
- Values stored in these Protocol fields are keyword searchable within the Explore Data > Protocols tab
- For “Text” versus “Long text” field types, the number of characters allowed in each are the same, this distinction only affects the size of the data input box and whether the special characters drop-down is displayed when creating a new Protocol definition. The “Long text” type will display a bigger text entry box that is resizable and the special characters drop-down is displayed so that users may insert special symbols (like a Greek character or the degree symbol).