Create and inspect relations

Where: define links in an entity's create/edit form; inspect them in sidebar → Relations. Both entity types must exist before linking them.

Relations visualizes the configured Customer and Order link.

Add a link to an entity#

1. Open Entities and select the entity that owns the outgoing link, such as Order.
2. Choose Edit, then open the Links section or step.
3. Click Add Link.
4. Set the link API name and display names.
5. Select the target entity and cardinality.
6. Configure the source foreign-key property and the target matching property. For many-to-many links, review the join table and its source/target column fields.
7. Save the entity.

Link configuration names the target entity, cardinality, and matching fields.

Choose cardinality#

For an Order → Customer link, many-to-one is often appropriate. Match the order's customer business key to a unique customer business key. If your model uses generated UUID record IDs, do not link an external integer key to that UUID just because both fields are called id.

Inspect the graph#

Open Relations, locate the two entity types, and inspect their connection. Select an entity or relation to review the model details offered by the screen. The graph describes configured business relationships; it does not clean unmatched keys or install an external database constraint.

Verify with records#

Test one known matching record and one with no target. Compare values and types on both sides. If a relation returns multiple unexpected matches, inspect uniqueness of the target property. If it returns none, inspect nulls, string/integer differences, whitespace, and whether the target rows were imported.

Cross-project targets use an ontology reference and additional access checks. Use Sharing and references rather than assuming local links cross a project boundary automatically.