Skip to main content

Add your first object

An object is one row of data — one car, one contract, one publication. It lives inside a register and conforms to one of the schemas you attached. This tutorial creates a single object end-to-end.

Goal

By the end you will have one object stored in your register, visible in the Search / views list for that register and schema.

Prerequisites

Steps

  1. Open Search / views from the app navigation — this is where you browse and create objects. Pick a Register and a Schema in the sidebar; the object list for that register + schema loads (or No objects found on an empty one).

    Shortcut: from a register's detail page (Registers → your register) open a schema's ⋯ → View objects. That lands you here with the register and schema already selected.

    Search / views with a register and schema selected

  2. Click Add Object. The create dialog renders a form generated straight from the schema. Each property becomes one field, typed correctly — strings get a text input, dates get a date picker, enums get a dropdown, booleans get a checkbox. Required fields are marked.

    Schema-driven object create form

  3. Fill the form in. For the schema from the previous step that's title (required), description, status (pick draft), date (today). Click Save.

    Form filled in

  4. The dialog closes and the object detail page opens. The sidebar carries Overview, Properties, Files, Comments, Audit Trails, Related and Source tabs — each one is empty for now except Properties (your data) and Audit Trails (a create entry).

    Object detail page

  5. Go back to Search / views (with the same register + schema selected). Your new object appears as one row, with the schema title rendered as a chip, the status enum value, and a timestamp.

    Search / views with the new object row

Verification

The object appears in the Search / views list for that register + schema, the Properties tab shows the values you typed, the Audit Trails tab has a create entry timestamped now, and the register's object counter in the statistics sidebar goes up by one.

Common issues

SymptomFix
Add Object is disabledNo register and schema is selected in the Search / views sidebar — pick both. (If the register has no schema attached at all, see Create and attach a schema.)
Form opens but every field shows "unknown type"The attached schema's Source tab has invalid JSON Schema — fix it before adding objects.
Save fails with "validation failed: property X"The value you typed doesn't match the schema rule for that property (required-but-empty, wrong enum value, regex mismatch). The error message names the offending property.
Object disappears after a refreshYou did not have write rights on the register — the dialog let you fill the form but the save was rejected. Check the RBAC setup.

Reference