This topic covers how an administrator can create new Data Classes
in the Bioregistry and edit the fields in the existing data classes, including all built in Registry
entity types and Media
The term Data Class
applies to all of the following entities in the Biologics application. These are two of the categories of data class available in LabKey Server
. Within the Biologics application you cannot see or change the category of a Data Class, though if you access these structures outside the application you will be able to see them.
- Registry Types: (Category=registry)
- Media Types: (Category=media)
- Raw Materials
Edit Existing Data Classes
The default set of data classes in Biologics are designed to meet a common set of needs for properties and fields for the Bioregistry and Media sections.
If you want to customize these designs, you can edit them within the Biologics application as follows.
Open the desired data class from the main menu. All entries under Registry
are editable. From the
menu, select Edit [Data Class] Design
. In this example, we'll edit the Molecules
You cannot edit the Name
of a data class, but can update the Description
and Naming Pattern
Click the Fields
section to open it. You'll be able to adjust the fields and their properties here.
Any field properties that cannot be edited are shown read only, but you may be able to adjust other properties of those fields. For example, you cannot change either the name or lookup definition for the "moleculeSetId" field shown below, but you could expand the field and change the label so that it had a different column heading in your grids.
When finished click Finish Editing [Data Class]
in the lower right.
Create New Registry Type
From the main menu, click the Registry
heading. Select Create > Registry Type
Define the Data Class Properties
- Name: (Required) Must be unique and cannot be changed after data class creation.
- Naming Pattern: Naming patterns are used to generate unique IDs for every member of this type.
- Learn more in this topic: Naming Patterns.
- It is best practice to use a naming pattern that will help identify the registry type. Our built in types use the initials of the type (like CL for Cell Lines, etc).
- For example, to use "DC-" followed by the date portion of the time the entity is added, plus an incrementing number you could use:
Click the Fields
section to open it, then import, infer or manually define the fields you need using the field editor
When finished, click Finish Creating Data Class
. Your new class will now appear on the registry dashboard with a default 'ring' icon.
Note that the main menu will not list your new class directly, you'll click See all ##
at the bottom of the list to find it on the main dashboard.
Delete Custom Registry Type
You cannot delete the built in Registry (or Media) types, but if you add a new custom one, you will have the ability to delete it.
on the main menu, then click the tile for the custom registry type to delete.
> Delete [Registry Type]**.
Deleting a data class cannot be undone and will delete all members of the class as well. You will be asked to confirm the action before it completes.