Graphe de connaissances
Carte visuelle des entités et des relations de votre ontologie — zoomez, explorez, examinez les connexions et tracez des chemins entre les enregistrements.
La page Graphe de connaissances (/graph dans Analytics) est un canevas en direct et zoomable qui affiche les entités réelles (instances) de votre ontologie et les relations entre elles. Vous pouvez y naviguer comme dans un coffre — un zoom arrière révèle la structure au niveau des types ; un zoom avant révèle les enregistrements individuels et la façon dont ils sont connectés.
Ce que montre le graphe
Chaque point lumineux est une entité de votre ontologie. La taille d'un nœud reflète le nombre de connexions de cette entité : les pôles fortement connectés apparaissent plus grands ; les enregistrements isolés apparaissent plus petits. Les arêtes représentent les relations déclarées entre les entités à partir de vos types de liens.
Lorsque vous effectuez un zoom arrière important, le canevas passe à une vue d'ensemble des clusters — les types d'objets et les communautés d'entités liées apparaissent sous forme de super-nœuds étiquetés, ce qui vous donne d'un coup d'œil la forme de vos données. Effectuez un zoom avant et les entités individuelles réapparaissent.
Les très grandes ontologies affichent une vue bornée — les entités les plus connectées sont chargées dans la limite d'un budget de rendu. Le canevas vous indique toujours lorsque les résultats sont échantillonnés, avec un indicateur « +N de plus » ; rien n'est abandonné silencieusement.
Couleurs et tailles
| Propriété visuelle | Signification |
|---|---|
| Taille du nœud | Nombre de connexions (degré) — plus grand = plus connecté |
| Couleur du nœud | Contrôlée par le mode Colorer par actif : par type d'objet, par cluster ou par nombre de connexions |
| Enveloppes de cluster | « Flaques » ombrées qui regroupent les entités fortement connectées entre elles (communautés de Louvain) |
| Flèche | Le sens d'une relation, de la source vers la cible. Une double flèche signifie que les deux entités sont liées dans les deux sens |
| Libellé d'arête | Le type de lien. Lorsque plusieurs liens relient les deux mêmes entités, ils partagent une seule arête, dont le libellé nomme chaque type une fois avec un compte, par exemple owns ×2 · operates |
| Arête en pointillés | Une relation sans aucune paire inférée — vérifiez vos Liaisons |
Les libellés d'arêtes suivent le réglage Libellés des nœuds. Sur un graphe comportant de nombreux liens, ils apparaissent lorsque vous zoomez, afin que la vue ajustée reste lisible.
Naviguer dans le canevas
- Déplacer — cliquez et faites glisser sur une zone vide du canevas.
- Zoomer — molette de défilement ou commandes de zoom (en bas à droite). Un zoom éloigné affiche la vue d'ensemble des types/clusters ; un zoom rapproché affiche les entités individuelles.
- Faire glisser un nœud — saisissez n'importe quelle entité et faites-la glisser. La simulation physique réagit en direct et le graphe se stabilise naturellement lorsque vous relâchez.
Rechercher une entité
La pastille de recherche en haut du canevas effectue une recherche dans toutes les valeurs textuelles liées de votre ontologie. Au fil de la saisie, les entités correspondantes sont suggérées avec le libellé de leur type. Sélectionner un résultat :
- Déplace la caméra vers cette entité.
- Charge son voisinage immédiat — toutes les entités auxquelles elle est liée via n'importe quelle relation déclarée.
Examiner les connexions
Expansion égocentrée et épinglage
Cliquez sur n'importe quel nœud pour le sélectionner et ouvrir l'Inspecteur (panneau de droite), qui affiche ses propriétés et ses connexions. Depuis l'inspecteur — ou en double-cliquant directement sur le nœud — vous pouvez le déployer pour charger ses voisins sur le canevas.
Épingler un nœud le fixe en place afin qu'il ne dérive pas pendant que vous continuez à explorer. Double-cliquez sur un nœud épinglé pour le déployer davantage (les voisins de ses connexions). Désépinglez-le en cliquant sur l'icône d'épingle dans l'inspecteur.
Mode Chemin — tracer de A à B
Passez en mode Chemin dans la barre d'investigation pour découvrir comment deux entités sont connectées :
- Cliquez sur une entité de départ (A).
- Cliquez sur une entité de destination (B).
Le canevas met en évidence le plus court chemin entre elles et atténue tout le reste. Les voisins communs — les entités connectées à la fois à A et à B — sont mis en évidence dans une couleur distincte pour que vous puissiez voir qui se trouve entre les deux.
Pôles — trouver les entités les plus connectées
Passez en mode Pôles pour dimensionner et colorer les nœuds selon leur nombre de connexions (degré) ou leur centralité d'intermédiarité. Une liste classée des principales entités apparaît dans le panneau latéral pour que vous puissiez accéder directement aux enregistrements les plus centraux de votre ontologie.
Clusters
Passez en mode Clusters pour mettre en évidence les communautés de Louvain dans vos données. Chaque cluster reçoit une couleur distincte et un contour d'enveloppe ; la coloration des clusters est également reflétée dans la légende. Utilisez ce mode pour identifier des groupes d'entités étroitement liées.
Mode Carte
La bascule Graphe / Carte (en bas au centre) passe à une vue géographique de chaque type d'objet lié qui porte des coordonnées. Au lieu de charger chaque ligne, la carte affiche des bulles de comptage — chaque bulle est un décompte exact, conforme aux habilitations, des enregistrements situés dans cette zone au niveau de zoom actuel. Zoomer (ou cliquer sur une bulle) subdivise les zones jusqu'à ce que les enregistrements individuels apparaissent sous forme de véritables marqueurs ; les relations s'affichent sous forme d'arcs entre les zones, pondérés par le nombre exact de paires liées.
La bande de badges en bas indique le total exact visible par type. Lorsqu'une liste a dû être tronquée, le total est affiché comme une borne inférieure (par exemple 12,400+) — rien n'est échantillonné silencieusement.
Traces d'observations
Les types dont les données sont un flux d'observations horodatées (relevés de position, mesures de capteurs, signalements) sont regroupés en un seul nœud par entité réelle sur le canevas, avec un nombre exact d'observations dans l'inspecteur. Pour voir l'historique des déplacements derrière une telle entité :
- Cliquez sur le nœud de l'entité pour ouvrir l'Inspecteur.
- Cliquez sur Afficher la trace sur la carte.
La vue passe en mode Carte et dessine les observations de l'entité sous forme de trace ordonnée dans le temps, ajustée à la fenêtre d'affichage, ordonnée selon la propriété d'horodatage mappée de la liaison. La pastille de trace en haut indique exactement combien d'observations sont dessinées sur le total de l'entité ; Charger plus prolonge la trace page par page. Les observations sans coordonnées lisibles sont comptées et déclarées sur la pastille au lieu d'être inventées sur la carte.
Les traces exigent que la liaison déclare identitySpec.entityColumns (regroupement par entité) et mappe une propriété d'horodatage (comme observedAt ou seenAt). Si l'un ou l'autre manque, le graphe vous indique pourquoi la trace n'est pas disponible au lieu d'afficher une carte vide.
Commandes et paramètres
Panneau Paramètres
Le panneau repliable Paramètres (en haut à gauche) comporte quatre sections :
| Section | Ce que vous pouvez modifier |
|---|---|
| Investiguer | Le mode d'interaction, y compris les deux extrémités d'une recherche de chemin |
| Affichage | Les libellés des nœuds (qui affichent ou masquent aussi les libellés d'arêtes) et les enveloppes de cluster |
| Forces | Curseurs physiques en direct : force centrale, force de répulsion, force des liens, distance des liens |
| Proximité | Le rayon des liens de proximité ; 0 utilise la distance déclarée de chaque type de lien |
Le mode de couleur se trouve dans la légende.
L'ajustement d'un curseur Forces prend effet immédiatement — la simulation physique réagit en temps réel.
Légende
La légende (en bas à gauche) liste les regroupements de couleurs actifs avec des décomptes en direct. Cliquez sur un nom de type ou de cluster pour basculer sa visibilité ; masquer un groupe masque tous ses nœuds ainsi que les arêtes qui ne se connectent qu'à des nœuds masqués.
Autres commandes
| Commande | Emplacement | Action |
|---|---|---|
| Zoom avant / arrière / ajuster | En bas à droite | Ajuster la caméra ou afficher tous les nœuds chargés |
| Bascule des libellés | En bas à droite | Afficher ou masquer les libellés des entités |
| Animer | En bas à droite | Reconstruire la disposition physique avec une animation de construction visuelle |
Diagnostics
La pastille de diagnostic dans l'en-tête de la page distingue les problèmes des remarques liées à la conception :
- Une pastille rouge N problèmes signifie que quelque chose doit être corrigé — des types de liens de référence avec un nombre d'arêtes nul ou inconnu, ou des liaisons qui ne sont pas prêtes.
- Une pastille discrète N remarques apparaît lorsqu'il n'y a rien à corriger mais qu'il existe des entrées informatives (types de liens inférés géographiquement, liaisons ignorées).
Cliquez sur la pastille pour ouvrir le panneau de diagnostic groupé. Les groupes actionnables viennent en premier :
- Liaisons non prêtes — une colonne ou une table requise est manquante ; corrigez-la dans Liaisons.
- Types de liens sans arêtes — 0 signifie que la jointure s'est exécutée mais qu'aucune valeur de colonne ne correspondait (vérifiez le mappage de colonnes) ; ? signifie que le décompte n'a pas pu être calculé (généralement un type d'extrémité sans liaison).
Les groupes informatifs suivent :
- Types de liens inférés géographiquement — les liens de proximité calculent leurs arêtes à partir des coordonnées des instances lors du rendu du graphe ; un nombre d'arêtes au niveau du schéma n'est donc pas applicable. Ce sont des remarques, pas des échecs.
- Liaisons ignorées — les types de liaisons que le moteur de graphe ne projette pas (par exemple les liaisons memex ou manuelles).
Chaque ligne actionnable comporte un lien de correction qui vous mène directement au bon endroit dans l'onglet Liaisons :
- Un type de lien ? (une extrémité sans liaison) affiche Lier
<Type>, qui ouvre la boîte de dialogue Nouvelle liaison préciblée sur ce type d'objet. - Un type de lien 0 affiche Modifier le mappage de colonnes, qui fait défiler jusqu'à la liaison source et déploie son mappage de colonnes pour que vous puissiez rediriger la colonne de jointure.
- Une liaison non prête affiche Corriger la liaison, et le pied de panneau propose Ouvrir l'éditeur de liaisons comme solution générale.
Sélectionner une ontologie et une branche
Les listes déroulantes de l'en-tête vous permettent de basculer entre les ontologies (à l'échelle de l'organisation et au niveau de l'espace de travail) et entre les branches. Le graphe reflète toujours le schéma et les données de la branche sélectionnée, y compris les branches de proposition non publiées — utile pour prévisualiser une modification de schéma avant de la publier.
Utiliser le SDK de graphe
Les applications peuvent lire la même projection gouvernée via @scrydon/ontology-sdk/client :
const graph = await client.graph.instanceGraph({
ontology: "operations",
mode: "overview",
budget: 1500,
});
const viewport = await client.graph.viewport({
ontology: "operations",
zoom: 8,
bbox: { west: 4.2, south: 50.7, east: 4.6, north: 51.0 },
});L'espace de noms client.graph fournit également des tranches de schéma, la recherche, l'expansion, les voisins, les traces et
les lectures de dispositions persistées. Chaque réponse identifie la révision et la branche exactes qu'elle représente.
Les enregistrements détenus et les enregistrements liés en externe conservent des formes d'origine différentes : une application n'a donc jamais
à deviner si un ID est un ID d'objet du registre ou une clé canonique de la source.
Les résultats de disposition sont isolés par espace de travail et par habilitation. Une disposition calculée à une habilitation plus élevée n'est ni exposée à une requête d'habilitation inférieure, ni écrasée par elle. Si l'ontologie change pendant le calcul d'une disposition, le service abandonne la passe obsolète et publie une génération pour la révision la plus récente.
Voir aussi
- Types d'objets — définissez les types d'entités (nœuds) affichés sur le graphe.
- Types de liens — définissez les relations (arêtes) entre eux.
- Liaisons — connectez les types d'objets à des données réelles et activez l'inférence d'arêtes.
- Branches et propositions — la branche affichée dans le sélecteur du graphe.