Training Design Model Fields in the Schema Designer

Training: Design Model Fields in the Schema Designer

What you'll learn: how to build a data model visually — fields, types, validation — and deploy it. You need: Administrator or Developer access type, an Application Development application. Time: 10 minutes.

Before you start

The Schema Designer creates the model, its fields, and its first version in one visual session. (Models created from the Data Models table start without a version and can't be opened in the designer until one exists — starting in the designer is the smoother path.)

Steps

1. Go to Left menu → Schema & GraphQL → Data Models, or open the Schema Designer directly. (Can't see it? Type "Schema Designer" in the header Search.)
2. In the designer, click File → New Model. Fill Model Name* (alphabetic only, e.g. TrainingPart), Module* (e.g. Engineering), and Type* — Master (core entities), Setup (statuses/settings installed with the app), or Transactional (operational events).
3. Click ✓. The model appears on the canvas as a card with an id field.
4. Click the card's New field name row, type the field name (e.g. name), and click +. The right panel switches to the Field editor.
5. In the Field editor, pick the Type (ID, Int, Float, Boolean, String, DateTime, Date, Time, JSON, JSONObject) and set Validation — Unique, Required — plus Default Value and API options.
6. Repeat steps 4–5 for each field (e.g. serialNumber String, quantity Int, active Boolean).
7. Click File → Save. The New Model dialog asks for the Initial Version (1) and a Version Description → click 💾. Toast: "Successfully created TrainingPart v1."
8. Click the deploy arrow (⬆) on the model card. The Deploy dialog appears — note the Data migration required? checkbox for breaking changes (not needed for a new model) → click ⬆.

Check your work

The model card turns green when deployed. The Data Models table shows Deployments 1 and a Current Deployment, and the model's generated types appear in the GraphQL API Explorer.

Try it yourself

Add a Date field named installDate to your model, save (the designer prompts for a new version), and deploy again — then check the model's VERSIONS tab to see both versions.

Related training

Training: Create a Data Model · Training: Generate a Screen from a Data Model · Training: Explore the GraphQL API