Instances
En bref
Les instances sont les enregistrements concrets d'un type d'entite. Si un type d'entite Produit definit la structure (nom, prix, categorie), chaque produit individuel est une instance de ce type.
Pensez-y comme un tableur : le type d'entite definit les colonnes (proprietes), et chaque instance est une ligne dans ce tableur.
L'onglet Instances, accessible depuis le panneau d'une entite dans le Modeler ou le Navigateur, vous permet de creer, consulter, modifier et supprimer ces enregistrements.
Les instances transforment votre ontologie d'un modele theorique en une base de donnees vivante. Vous pouvez :
- Centraliser vos donnees metier (clients, produits, fournisseurs, equipements...)
- Connecter des sources externes pour alimenter automatiquement vos entites
- Exploiter ces donnees dans les workflows, les agents IA et les dashboards
Avant de commencer
- Vous avez acces a un workspace.
- Au moins un type d'entite (ObjectType) existe avec des proprietes definies.
Concepts cles
Types d'instances
| Type | Icone | Description |
|---|---|---|
| Native | Base de donnees | Creee manuellement, via API, import ou webhook. Modifiable dans l'interface. |
| Connecteur (externe) | Lien externe | Synchronisee depuis un connecteur applicatif. Lecture seule — modifiable uniquement dans le systeme source. |
Lien entre entites et instances
Type d'entite « Fournisseur » Instances
┌──────────────────────────┐ ┌─────────────────────────┐
│ Proprietes : │ │ Acme Corp │
│ • raison_sociale (text) │────>│ raison_sociale: Acme │
│ • pays (text) │ │ pays: France │
│ • actif (boolean) │ │ actif: true │
└──────────────────────────┘ ├─────────────────────────┤
│ Beta Industries │
│ raison_sociale: Beta │
│ pays: Allemagne │
│ actif: false │
└─────────────────────────┘
Les proprietes definies dans le type d'entite servent de schema : chaque instance respecte cette structure.
Acceder aux instances
- Ouvrez le Modeler ou le Navigateur.
- Selectionnez un type d'entite dans le canvas ou la liste.
- Dans le panneau de detail (a droite), cliquez sur l'onglet Instances.
En haut de l'onglet, deux compteurs indiquent :
- Natives : instances creees manuellement ou via API.
- Connecteurs (externes) : instances synchronisees depuis une source externe (connecteur applicatif).
Creer une instance
- Cliquez sur le bouton Nouveau en haut a droite de l'onglet Instances.
- Remplissez le formulaire dynamique qui reprend les proprietes du type d'entite :
- Titre d'affichage : nom lisible de l'instance (optionnel mais recommande).
- Identifiant externe : reference vers un systeme tiers (optionnel).
- Proprietes : champs definis dans le type (texte, nombre, date, etc.).
- Validez pour creer l'instance.
Pour un type Fournisseur avec les proprietes raison_sociale, pays et actif, le formulaire presentera ces trois champs avec les types et contraintes correspondants.
Sources de creation
Les instances peuvent arriver dans le systeme de plusieurs facons :
| Source | Badge | Description |
|---|---|---|
| Manuel | Bleu | Creee depuis l'interface (bouton Nouveau) |
| API | Vert | Creee par un appel API externe |
| Import | Violet | Importee en masse (CSV, bundle) |
| Webhook | Orange | Recue via un webhook entrant |
| Connecteur | Indigo | Synchronisee automatiquement via un connecteur applicatif |
Consulter et filtrer
Recherche textuelle
La barre de recherche filtre en temps reel par titre, identifiant ou contenu des proprietes.
Filtres principaux
Combinez les filtres pour affiner la liste :
| Filtre | Valeurs |
|---|---|
| Statut | Tous, Actif, Archive |
| Source | Toutes, Manuel, API, Import, Webhook, Connecteur |
Filtres par propriete
Pour un filtrage avance, cliquez sur l'icone de filtre (curseurs) a droite de la barre de recherche. Un panneau s'ouvre avec les proprietes disponibles — saisissez une valeur pour filtrer les instances dont la propriete contient ce texte.
Pagination et colonnes
- La liste affiche 25 instances par page avec navigation.
- Les colonnes de donnees s'adaptent automatiquement aux proprietes du type, ou suivent la configuration de la vue enregistree.
- Cliquez sur un en-tete de colonne pour trier (ascendant/descendant).
Vues enregistrees
Enregistrez vos combinaisons de colonnes et filtres dans des vues pour y revenir en un clic. Une vue par defaut peut etre definie pour chaque type d'entite.
Modifier une instance
Via le panneau de detail
- Cliquez sur une ligne dans la liste pour ouvrir le panneau de detail lateral.
- Modifiez les champs souhaites (titre, proprietes).
- Cliquez sur Sauvegarder.
Edition en ligne (double-clic)
Pour les modifications rapides :
- Double-cliquez sur une cellule dans le tableau.
- Modifiez la valeur directement.
- Appuyez sur Entree pour valider ou Echap pour annuler.
L'edition en ligne n'est pas disponible pour les instances provenant d'un connecteur (lecture seule).
Le systeme utilise un controle de version optimiste : si un autre utilisateur a modifie la meme instance entre-temps, un conflit sera signale.
Supprimer et archiver
Suppression individuelle
Dans le panneau de detail, cliquez sur Supprimer en bas a gauche. Vous pouvez aussi utiliser l'icone corbeille dans la colonne Actions du tableau.
Operations en lot
- Cochez les instances a traiter dans la liste (colonne de gauche).
- La barre d'actions en bas de l'ecran apparait avec les options :
- Archiver : passe les instances selectionnees en statut Archive.
- Supprimer : supprime definitivement les instances selectionnees.
Les instances issues d'un connecteur externe sont en lecture seule et ne peuvent pas etre modifiees, archivees ni supprimees depuis l'interface. Pour les modifier, intervenez directement dans le systeme source.
Exporter en CSV
Cliquez sur le bouton CSV dans la barre d'outils pour telecharger les instances au format CSV. L'export adapte automatiquement les colonnes aux proprietes du type d'entite.
Cas d'usage courants
Centraliser des donnees metier
Vous modelisez votre activite avec des types d'entite (Clients, Produits, Commandes) puis creez les instances correspondantes. Les instances deviennent la source de verite exploitable par les agents et workflows.
Alimenter depuis un systeme externe
Connectez un connecteur applicatif (CRM, ERP, Google Sheets...) a un type d'entite. Les instances se synchronisent automatiquement et apparaissent en lecture seule avec le badge Connecteur.
Exploiter dans un workflow
Les blocs entity_lookup et graph_neighbors du Workflow Builder permettent de requeter les instances directement dans vos automatisations.
Analyser via un agent IA
L'agent IA peut interroger vos instances en langage naturel grace aux outils integres (recherche, filtrage, agregation).
Limites et erreurs frequentes
| Situation | Explication |
|---|---|
| Instance en lecture seule | L'instance provient d'un connecteur externe. Modifiez-la dans le systeme source. |
| Erreur de validation | Une propriete ne respecte pas les contraintes definies (type, valeur min/max, format). |
| Conflit de version | Un autre utilisateur a modifie l'instance. Rechargez et reessayez. |
| Aucune instance affichee | Verifiez vos filtres (statut, source) et la barre de recherche. |
Resultat attendu
Vous creez, consultez, filtrez et gerez les instances de vos types d'entite. Les instances natives sont editables ; les instances connecteur sont en lecture seule. Les vues enregistrees vous permettent de retrouver rapidement vos configurations de colonnes et filtres.
Besoin d'aide ?
Ecrivez-nous : Support et contact.