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 designs.


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)
    • CellLine
    • Construct
    • ExpressionSystem
    • MolecularSpecies
    • Molecule
    • MoleculeSet
    • NucSequence
    • ProtSequence
    • Vector
  • Media Types: (Category=media)
    • Batches
    • Ingredients
    • Mixtures
    • 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 and Media are editable. From the menu, select Edit [Data Class] Design. In this example, we'll edit the Molecules design:

You cannot edit the Name of a data class, but can update the Description and Naming Pattern if desired.

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.
  • Description
  • 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.

Click Registry on the main menu, then click the tile for the custom registry type to delete. Select > 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.

Related Topics


Was this content helpful?

Log in or register an account to provide feedback

expand all collapse all