Benchling has released a new version of the registration table. This article describes the new features and functionality. Read about the historical registration table.
Select a mode on insertion
Use the insert menu on the notebook entry toolbar to insert a new registration table.
You will be prompted to select a mode, which makes the table behavior more intuitive:
- Create new entities: use this mode to create new, registered entities
- Register existing entities: use this mode to register existing, unregistered entities
- Register batches: use this mode to create batches in the historical table
After selecting a registry schema, you will see a preview of the table before you insert it. Use this to confirm you've made the right selection.
Registering entities in the table
Enter information into the rows of the table: each row corresponds to one entity. The columns of the table are defined by the registry configuration.
The registration table has a Submit button which is used to commit entities in the table to the registry. You will notice a blue bar in the row on the leftmost side of the table. This bar indicates that the row has additions and/or modifications to this row that have not been submitted.
Adding more rows to the table
You can add rows to the registration table by dragging the icon in the bottom left corner of the table to create a blank row.
The registration table supports a more structured way of adding existing entities from table or worklist sources. Select the blue plus icon and choose an option. You will indicate:
- destination column: the column where you want to add entities
- source table/worklist: the name of the source table (a registration table or request input table on the same entry) or the name of the entity worklist
- source column: the name of the source column, when adding from a table
- number of samples: indicate the number you'd like to add, per entity (this can be bulk set using the pencil icon)
Entities are added to the table in the first empty cell in the destination column. Entities added to different columns will fill the same rows, if those cells don't yet have values.
You can find a spreadsheet importer in the same menu to make bulk additions to the table.
Tip: It's easy to make child entities by adding from the "parent" registration table to the "child" registration table.
Modifying data after registration
After registering entities in the table, you can modify values of fields in the columns and re-submit to update the values in the registry. This allows you to correct mistakes or update the entities with newer information.
Tip: You can both register new entities (in new rows) and update entities (in existing rows) at the same time.
Updates to entities outside of the table
When an entity is updated in the registry, field values in the table will not change. This ensures that information you recorded in the entry doesn't change without you knowing. The table will display a purple indicator in any cell that has a newer value which is not yet reflected in the table.
You can press the refresh button to display the current values in the table. You can reset the entry version if you wish to return to the prior state after a refresh.
Find the entry where an entity was registered
The registration table will create a link to the entry in the relevant items section of the entity. This includes entities that were registered in the table as well as entities that were linked as fields in the table.
What do these buttons do? What are the menu options?
- Expanded view: expand the table to full view
- Add from sources: add entities from another table or from a worklist
- Outdated value: the value in this cell has been updated in the registry
- Refresh: refresh the table to show the most recent values
- Submit: submit rows in the table for registration and/or modification
- Collapse: hide the rows of the table
- Drag to add row: drag down to add empty rows to the table
- Unsubmitted change: this row has un-submitted additions or modifications
- Illegal/required value: this cell has an illegal value (i.e. letters in a number field) or a missing required value
- Create Request: create a request with the entities in the leftmost column
- Download as CSV: download the table as a CSV
- Print Barcodes: print barcodes for these entities, if enabled
Can I edit any entity in this table?
You can only edit entities that were registered in the table. You cannot add an existing, registered entity to a registration table to perform edits.
Will my existing registration tables work? Do I need to update all my entry templates?
Historical registration tables will continue to function as normal.
Why does batch mode look different?
Batch mode inserts the historic registration table which lacks the features described in this article. We suggest considering child entities with your customer experience representative.
Can rows automatically be added to a table from another table?
Not now, but we anticipating releasing this functionality in the future.
Can I use the registration table to "look up" information about existing, registered entities?
You cannot add existing, registered entities to the registration table.
Can I see relevant items for things I've registered in the past?
The historic registration table did not create a link in relevant items. We anticipate performing a backfill for these values in the future.
Does this work in Benchling Workflows?
Workflow stage entities continue to use the historic registration table due to the nature of stage runs.