Premium Feature — Available with LabKey Biologics LIMS. Learn more or contact LabKey.

This topic describes how to use the Biologics application to create new Registry Sources, i.e. members of any Registry Source Type, including cell lines, molecules, nucleotide sequences, expression systems, etc. Users creating these entities may specify a name, or have one generated for them using a naming pattern. Names can also be edited later. If desired, administrators may also hide the ability to specify or edit names.

Create Registry Sources in the User Interface

In this example, we show creation of a new cell line. Other kinds of sources will have different fields that compose them, and may also have additional tabs in the creation wizard. See specific documentation listed at the end of this topic.

Add Manually

  • Provide the details in the registration wizard:
  • Name: Provide a short unique name, or leave this field blank to have one generated using the naming pattern for this Registry Source Type.
    • Hover over the to see an example generated name.
  • Description: Optional, but will be shown in the grids and can be a helpful way to illustrate the entity.
  • Common Name: Every entity includes a field for the common name.
  • Remaining fields: Required fields are marked with an asterisk.
  • When the fields are completed, click Finish to create the new entity.

You can now return to the grid for this Registry Source Type (i.e. Cell Lines in this example) to find your new entity later.

Add Manually from Grid

Using the grid interface to create Registry Sources as described in the Sample Manager documentation.

Note that this option not supported for all Registry Source Types. You will not see this option for Nucleotide Sequences, Protein Sequences, Molecules, Molecular Species, etc.

Create/Import Entities from File

For bulk registration of many entities in Biologics, including registry sources, samples, assay result data, ingredients, and raw materials, you can make use of importing new data from file. Templates are available to assist you in reliably uploading your data in the expected format.

Obtain Template

Obtain a template by opening the type of entity you want to create, then clicking Template.

You can also find the download template button on the overview grids for each Registry Source Type. If you wait until you are importing data from a file, you can also find the Template button in the import interface.

Use the downloaded template as a basis for your import file. It will include all possible columns and will exclude unnecessary ones. You may not need to populate every column of the template when you import data.

  • For example, if you have defined Parent aliases, all the possible columns will be included in the template, but only the ones you are using need to be included.
  • Columns that cannot be set/edited directly are omitted from the template.

Import Registry Sources From File

For Registry Sources, Samples, Assays, and Ingredients and Raw Materials, you can select Add > Import from File to use the file import method of creation. Select the Registry Source Type and select or drag and drop the spreadsheet containing your data into the target area. Starting from the template makes file import easier.

Learn more about updating registry entities during import in this topic:

Update or Merge Registry Sources from File

To update data for existing Registry Sources from file, or to import a spreadsheet merging updates with creation of new Registry Sources, use Edit > Update from File. Learn more in this topic:

Entity Naming Patterns

If you do not provide a name, the naming pattern for the Registry Source Type will be used to generate one. Hover over the to see the naming pattern in a tooltip, as well as an 'example name' using that pattern.

The default naming patterns in LabKey Biologics are:

Registry Source TypeDefault Naming Pattern
Cell LinesCL-${genId}
Expression SystemsES-${genId}
Molecular SpeciesMSp-${genId}
Molecule SetsMS-${genId}
Nucleotide SequencesNS-${genId}
Protein SequencesPS-${genId}

To change a naming pattern, edit the Registry Source Type definition.

Hide Name Entry/Edit Options

An administrator can hide the Name field for insert, update, or both. When insert of names is hidden, they will be generated using the naming pattern for the registry source type. When update of names is hidden, names remain static after entity creation.

This can be done:

For example, to hide the Name field for cell lines for both insert and update use the following:

<tables xmlns="">
<table tableName="CellLine" tableDbType="NOT_IN_DB">
<column columnName="Name">

Review Registry Source Details

Once created, you'll see a grid of all entities of the given type when you select it from the main menu.

To see details for a specific Registry Source, click the name.

Tabs provide more detail:

  • Overview: Panels for details, samples, related entities (for built in Registry Source Types), notebooks, and parent sources.
  • Lineage: See the lineage in graph or grid format.
  • Samples: Contains a grid of all samples 'descended' from this source.
  • Assays: See all assay data available for samples 'descended' from this source.
  • Jobs: All jobs involving samples 'descended' from this source.
  • Additional tabs may be included such as:

Related Topics

Was this content helpful?

Log in or register an account to provide feedback

expand allcollapse all