Skip to content

Tutorial

UI quickstart

UI quickstart

3 min

Level: beginner · Estimated duration: 15 minutes · Access: edit models and create instances. Use demonstration data in a workspace intended for this purpose.

Prerequisites

Sign in and choose the target workspace. Confirm that Ontologie is available and that you may edit the model. A canvas space organizes types; its name does not establish an isolated environment. See Workspaces and spaces.

1. Create the Client type

Open Ontologie and the Modeler. Use the type creation command, choose Object and name it Client. This is a reusable definition, not an actual customer yet.

Add its properties:

Technical nameTypeExample value
identifiantTextCLI-001
nomTextACME France
statutTextActif

Make identifiant and nom required. Here statut is a single text value: List means a collection, not a dropdown of choices. Technical names start with a letter and use unaccented letters, digits and underscores.

Save and reopen Client. Check that properties and constraints were retained.

2. Create Commande and the relationship

Move the Client card on the canvas before creating Commande: new cards appear at the center and may overlap.

Create an Object type Commande with reference (Text), montant (Number) and devise (Text). The amount is expressed in the stated currency; do not add amounts in different currencies.

Create a relationship from Client to Commande named passe. Choose a cardinality compatible with a customer having several orders. Check both endpoints and direction in the canvas.

Diagram : UI quickstart
View the diagram description
flowchart LR
  Client[Client : identifiant, nom, statut] -->|places| Commande[Commande : reference, montant, devise]

The diagram connects types. It does not automatically create orders for customers.

3. Add a Client instance

Select Client and open Instances. Click New and enter CLI-001, ACME France and Actif. Use a readable display title if offered. Save and reopen the instance.

Check the values and the platform's returned identifier. This technical identifier differs from business reference CLI-001. This is a native instance; connector records are corrected in their source.

4. Verify the result

CheckExpected result
ModelClient and Commande exist in the intended workspace and space
PropertiesThe six technical names survive reopening
RelationshipClient is the source, Commande the target, with the chosen cardinality
RecordCLI-001 appears as a native Client instance
PermissionsA user without write permission cannot create a record

If a save fails or reports a conflict, read the current state before retrying. Do not repeat creation to compensate for a list that has not refreshed yet.

Cleanup and next step

Delete only demonstration data you no longer need. Ordinary instance deletion is logical deletion, not immediate physical erasure. Deleting a type that is still used may be refused: see Instances and Modeler.

Next, read instances through the API or map two sources.

Did this page help you achieve your goal?