Skip to content

Tables

The Tables panel lets you create, configure, rename and delete data tables. Open it from Config → Tables.

TODO_SCREENSHOT: Tables panel showing a list of tables on the left and table settings on the right

Creating a table

Click Add table at the bottom of the table list. Fill in:

FieldDescription
NameInternal slug (lowercase letters, digits and underscores; e.g. sites)
LabelDisplay name shown in the UI (e.g. Sites)
Is pluginEnable if this table is a sub-table attached to a parent (e.g. finds attached to contexts)

After saving, the new table appears in the list and a corresponding DB column is created automatically.

Table settings

Select a table to edit its settings:

FieldDescription
LabelDisplay name
Order fieldDefault sort column (e.g. id or date)
Preview fieldsComma-separated column names shown in the record list; also used by fast search
Plugin tablesSub-tables attached inline inside RecordView
Backlink tablesTables that reference this table; shown as a read-only panel in RecordView
Cross-table linksTables whose records can be manually linked to records of this table
RS fieldEnable the Harris Matrix for this table; set to the field that stores the stratigraphic unit identifier

TODO_SCREENSHOT: Table settings panel with preview fields and plugin tables configured

Reordering tables

The order of tables in the list controls the order in the navigation sidebar and in all dropdowns. Drag rows in the table list to reorder them.

Renaming a table

Use the Rename button in the table settings panel. The DB table and all references in the config are updated atomically.

WARNING

Renaming a table that is referenced by other tables (as a plugin, backlink or cross-link) requires manually updating those references too. The Validation panel will report orphaned references.

Deleting a table

Click Delete in the table settings panel. This drops the DB table and removes all config references. This action is irreversible.