Training Relate Two Data Models

Training: Relate Two Data Models

What you'll learn: how to create a relationship between two data models in the Schema Designer by connecting them on the canvas. You need: Administrator or Developer access type, an Application Development application, and two models on the canvas. Time: 10 minutes.

Before you start

A relation links two models so records can reference each other (for example, a part belongs to a category). Fuuz creates the relation by drawing a connection between two model cards — you don't pick a model from the field Type list (that list holds only scalar and special types).

Have both models open on the Schema Designer canvas. To add a second model, drag New Model from the Toolbox (or open an existing one), give it a Module and Type, and add at least one field.

Steps

1. Find the dark-grey connection node at the top of the source model card (e.g. TrainingPart).
2. Drag from that node and drop it on top of the other model card (e.g. TrainingCategory) — drop anywhere on the target card, not on a specific field. A connection line follows your cursor as you drag.
3. On release, the Create Relation dialog opens:
   • Relation Type — e.g. One To Many (one source record relates to many of the other), plus other cardinalities.
   • Prefix — optional prefix for the generated field names.
   • Required — whether the relation must be set.
   • Deletion Reference Behavior — what happens to references when a related record is deleted.
4. Choose the Relation Type and click the orange ✓.

Fuuz generates the relation fields automatically — on the target it adds a foreign-key field (e.g. trainingPartId, type ID) and a relation field that resolves the related record (e.g. trainingPart → TrainingPart); on the source it adds the matching relation field (e.g. trainingCategories → TrainingCategory). A line now connects the two cards.

5. Click File → Save All (each model gets a new version), then File → Deploy All → ✓.

Check your work

Both model cards are green (deployed) and joined by a connection line. The generated foreign-key and relation fields appear in each model's field list, and the related type is queryable through the GraphQL API.

Try it yourself

Open Schema & GraphQL → GraphQL API Explorer and query the source model — you can now select the related model's fields in the same query. In Components → Component References, the relation shows as a dependency between the two models.

Related training

Training: Create a Data Model · Training: Design Model Fields in the Schema Designer · Training: Explore the GraphQL API