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.
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.
Avant de commencer
- Vous avez acces a un workspace Ontologie.
- Au moins un type d'entite (ObjectType) existe avec des proprietes definies.
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, 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.
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).
- Identifiant externe : reference vers un systeme tiers (optionnel).
- Proprietes : champs definis dans le type (texte, nombre, date, etc.).
- Validez pour creer l'instance.
Exemple : pour un type Fournisseur avec les proprietes raison_sociale, pays et actif, le formulaire presentera ces trois champs avec les types et contraintes correspondants.
Consulter et filtrer
Recherche textuelle
La barre de recherche filtre en temps reel par titre, identifiant ou contenu des proprietes.
Filtres
Combinez les filtres pour affiner la liste :
| Filtre | Valeurs |
|---|---|
| Statut | Tous, Actif, Archive |
| Source | Toutes, Manuel, API, Import, Webhook, Connecteur |
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.
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
- Cliquez sur une ligne dans la liste pour ouvrir le panneau de detail.
- Modifiez les champs souhaites (titre, proprietes).
- Cliquez sur Sauvegarder.
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.
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.
Note : les instances issues d'un connecteur externe sont en lecture seule et ne peuvent pas etre modifiees, archivees ni supprimees depuis l'interface.
Exporter en CSV
Cliquez sur le bouton Exporter pour telecharger les instances au format CSV. L'export utilise le streaming cote serveur et adapte les colonnes aux proprietes du type.
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. |
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.