Configurer un graphe de connaissances
Lorsque vous créez un graphe de connaissances, vous pouvez modifier la configuration par défaut. Pour commencer le processus et définir les propriétés générales, reportez-vous à la rubrique Créer une enquête dans un projet.
Vous pouvez configurer un graphe de connaissances de manière à autoriser les utilisateurs à mettre à jour les données sous-jacentes, à configurer la manière dont les données du graphe de connaissances sont gérées, et à définir la prise en charge des entités Document et des relations HasDocument. Certains paramètres de niveau de service peuvent également être configurés. Les propriétés configurables dépendent de la version de votre logiciel et de ce qu’utilise le graphe de connaissances : un Graph Store hébergé ou un Data Store NoSQL.
Configurer le graphe de connaissances
Procédez comme suit pour configurer les opérations et propriétés pour le graphe de connaissances. Ces paramètres sont stockés en tant que partie de la définition du service ArcGIS Knowledge Server qui est créé.
Sur la page Define Knowledge Graph (Définir un graphe de connaissances) de l’assistant Create Investigation (Créer une enquête), fournissez les informations dans l’onglet General (Général) comme décrit pour créer un graphe de connaissances à l’aide de la configuration par défaut.
Notez le choix effectué sous Data Stores, car cela impacte la façon dont vous pouvez configurer le graphe de connaissances.
Cliquez sur l’onglet Configuration.
L’onglet Configuration comporte plusieurs onglets qui vous permettent de modifier les paramètres d’un graphe de connaissances de fichiers ou d’un service de graphe de connaissances.
Cliquez sur l’onglet approprié et configurez les paramètres du graphe de connaissances.
Cliquez sur Finish (Terminer).
Un service de graphe de connaissances est créé.
Configurer les privilèges de mise à jour
Le propriétaire du service de graphe de connaissances et les administrateurs du portail ArcGIS Enterprise peuvent toujours modifier les données. Par défaut, les autres utilisateurs ne peuvent pas modifier les données de ce graphe de connaissances, sauf si la mise à jour est activée. Procédez comme suit pour configurer les opérations d’édition pour les utilisateurs disposant de privilèges suffisants :
Remarque :
Il est impossible d’ajouter un suivi de l’éditeur aux graphes de connaissances qui utilisent un data store NoSQL contenant des données gérées par l’utilisateur. Cette option n’est pas disponible pour les graphes de connaissance fichier.
Cliquez sur l’onglet Configurer les privilèges de mise à jour
.Activez le bouton Activer les privilèges de mise à jour pour permettre aux autres utilisateurs de modifier les données dans le service de graphe de connaissances.
Sélectionnez le type d’opérations de mise à jour autorisées pour les autres utilisateurs disposant de privilèges suffisants.
Les opérations de mise à jour sont décrites dans la table suivante :
Add (Ajouter)
Les éditeurs peuvent ajouter des entités et des relations au graphe de connaissances. Ils peuvent définir de nouveaux types d’entités et de relations, et ajouter des propriétés. Ils peuvent définir la géométrie d’une nouvelle entité en créant l’entité sur une carte. Cette option est activée par défaut. Une fois les entités et les relations créées, l’option Update (Mettre à jour) doit être activée pour que les éditeurs puissent modifier les entités et les relations, leurs propriétés et leurs géométries.
Effacer
Les éditeurs peuvent supprimer des entités. Cette option est activée par défaut.
Mettre à jour
Lorsque cette option est activée, l’option Properties and geometry (Propriétés et géométrie) est activée par défaut, ce qui permet aux éditeurs de mettre à jour les propriétés des entités et des relations, ainsi que la géométrie d’une entité. Choisissez Properties only (Propriétés uniquement) pour autoriser les éditeurs à mettre à jour les propriétés des entités et relations existantes uniquement. Ils ne peuvent pas modifier la géométrie d’une entité existante.
Configurer le suivi de l’éditeur
Cette option de suivi de l’éditeur ajoute quatre propriétés à tous les types de relation et d’entité du graphe de connaissances afin d’effectuer le suivi des personnes qui créent et modifient les données et de la date et l’heure de ces modifications. Procédez comme suit afin de configurer le mode de définition du suivi de l’éditeur dans le graphe de connaissances. Ces paramètres sont stockés en tant que partie de la définition du service ArcGIS Knowledge Server qui est créé.
Remarque :
Il est impossible d’ajouter un suivi de l’éditeur aux graphes de connaissances qui utilisent un data store NoSQL contenant des données gérées par l’utilisateur. Cette option n’est pas disponible pour les graphes de connaissance fichier.
Cliquez sur l’onglet Configurer l’éditeur de suivi
.Activez le bouton Activer le suivi de l’éditeur pour enregistrer qui a modifié les données dans le service de graphe de connaissances.
Vous pouvez également configurer le mode de définition des propriétés du suivi de l’éditeur dans le graphe de connaissances.
Un ensemble de propriétés, répertoriées ci-dessous, est créé pour toutes les données du graphe de connaissances lorsque le suivi de l’éditeur est activé. Si vous attribuez des noms personnalisés à ces propriétés, ces noms sont visibles lorsque vous explorez les données de l’enquête.
created_user
Utilisateur qui a créé les données dans le graphe de connaissances. Le nom de la propriété par défaut est created_user.
created_date
Date et heure de création des données dans le graphe de connaissances. Les valeurs sont au format MM/JJ/AAAA et UTC. Le nom de la propriété par défaut est created_date.
last_edited_user
Utilisateur qui a mis à jour en dernier les données dans le graphe de connaissances. Le nom de la propriété par défaut est last_edited_user.
last_edited_date
Date et heure de la modification la plus récente apportée aux données dans le graphe de connaissances. Les valeurs sont au format MM/JJ/AAAA et UTC. Le nom de propriété par défaut est last_edited_date.
Lorsque le graphe de connaissances est créé, le texte que vous fournissez est utilisé pour identifier les propriétés du suivi de l’éditeur.
Configurer les documents
Vous pouvez référencer des documents à partir d’un graphe de connaissances pour fournir un contexte à une entité ou une relation à laquelle elle contribue. Un document du graphe de connaissances constitue une référence à un fichier à un emplacement où il est stocké ou à un site Web ou un document disponible sur Internet. Vous pouvez configurer la représentation des documents dans le graphe de connaissances. Ces paramètres sont stockés en tant que partie de la définition du service ArcGIS Knowledge Server qui est créé.
Remarque :
Il est impossible d’ajouter des documents aux graphes de connaissances qui utilisent un Data Store NoSQL contenant des données gérées par l’utilisateur. Les documents sont toujours disponibles pour les graphes de connaissances fichier et les services de graphes de connaissances qui utilisent un stockage de données hébergé, ou un stockage de données NoSQL contenant des données gérées par ArcGIS, et ne peuvent pas être désactivés.
En savoir plus sur les documents
Pour configurer la représentation des documents dans le graphe de connaissances, procédez comme suit :
Cliquez sur l’onglet Configure documents (Configurer les documents)
.Dans la zone de texte Document Entity Type Name (Nom du type d’entité Document), saisissez un nom pour le type d’entité dans le modèle de données qui représente les documents référencés dans le graphe de connaissances.
La valeur par défaut est Document. Avec la valeur par défaut, lorsque vous ajoutez un document à un graphe de connaissances, une nouvelle entité est créée pour le type d’entité Document. Si tous les documents seront des photos, par exemple, vous pouvez changer le nom de ce type d’entité en Photo.
Dans la zone de texte HasDocument Relationship Type Name (Nom du type de relation HasDocument), saisissez un nom pour le type de relation dans le modèle de données qui représente une relation entre une entité du graphe de connaissances et un document associé à cette entité.
La valeur par défaut est HasDocument. Avec la valeur par défaut, lorsque vous ajoutez un document à une entité spécifique dans le graphe de connaissances, telle qu’une entité Person, une nouvelle relation du type de relation HasDocument est créée entre l’entité Person et l’entité Document. Si vous avez attribué un nom personnalisé au type d’entité servant à stocker des documents, vous pouvez également modifier le nom de ce type de relation. Vous pouvez par exemple changer le nom du type de relation en HasPhoto.
Vous avez par ailleurs la possibilité de configurer la façon dont le type d’entité de document est défini.
Certaines informations sont obligatoires ou fortement recommandées pour tous les documents dans les graphes de connaissances. Un ensemble de propriétés, répertoriées ci-dessous, est créé par défaut pour chaque entité de document pour que vous puissiez fournir ces informations. Si vous attribuez des noms personnalisés à ces propriétés, ces noms sont visibles lorsque vous définissez et explorez des documents dans l’enquête.
texte
Le texte des documents est extrait et stocké dans cette propriété. Le nom de propriété par défaut est text.
url
L’emplacement du document est stocké dans cette propriété. La valeur peut être une URL vers un site Web ou un document disponible sur Internet, ou le chemin d’accès au fichier qui permet d’accéder à un document sur le réseau. Le nom de propriété par défaut est url.
mots-clés
Cette propriété vous permet de spécifier des mots-clés qui peuvent vous aider à rechercher le document. Le nom de propriété par défaut est keywords.
name
Nom de fichier du document. Par exemple, si vous ajoutez un fichier nommé
notes.txtau graphe de connaissances, ce nom de fichier est stocké. Le nom de propriété par défaut est name.contentType
Le type de données contenu par le document référencé est stocké dans cette propriété comme type MIME (Multipurpose Internet Mail Extensions). Par exemple, si vous ajoutez un simple fichier texte au graphe de connaissances, la valeur text/plain est enregistrée. Le nom de propriété par défaut est contentType.
titre
Cette propriété vous permet de spécifier un titre pour le document. Le nom de propriété par défaut est title.
métadonnées
Cette propriété vous permet de spécifier des métadonnées pour décrire le document. Le nom de propriété par défaut est metadata.
fileExtension
Lorsque le document référencé est un fichier, l’extension de fichier est enregistrée. Pour les sites Web, l’extension de fichier
.htmest stockée. Le nom de propriété par défaut est fileExtension.Lorsque le graphe de connaissances est créé, le texte que vous fournissez est utilisé pour identifier les propriétés du type d’entité de document.
Configurer la provenance
Vous pouvez ajouter une provenance afin de décrire d’où proviennent les informations du graphe de connaissances. Vous pouvez configurer comment la provenance est stockée dans le graphe de connaissances. Ces paramètres sont stockés en tant que partie de la définition du service ArcGIS Knowledge Server qui est créé.
Remarque :
Il est impossible d’ajouter une provenance aux graphes de connaissances qui utilisent un data store NoSQL contenant des données gérées par l’utilisateur.
En savoir plus sur la provenance
Procédez comme suit pour configurer le stockage de la provenance :
Cliquez sur l’onglet Configure provenance (Configurer la provenance)
.Activez le bouton Enable provenance (Activer la provenance) pour décrire d’où provient l’information stockée dans les propriétés d’une entité ou d’une relation.
Dans la zone de texte Provenance Name (Nom de la provenance), saisissez un nom permettant d’identifier les enregistrements qui définissent les sources d’informations stockées dans le graphe de connaissances.
La valeur par défaut est Provenance. Par exemple, la valeur fournie dans ce paramètre apparaît lorsque vous parcourez les valeurs Meta Types (Types méta) d’une enquête dans la fenêtre Catalog (Catalogue) et la vue du catalogue et dans la colonne Type d’une enquête lorsque vous listez les enregistrements de provenance.
Vous avez par ailleurs la possibilité de configurer la façon dont les propriétés d’un enregistrement de provenance sont définies.
Certaines informations sont obligatoires ou fortement recommandées pour tous les enregistrements de provenance dans les graphes de connaissances. Un ensemble de propriétés, répertoriées ci-dessous, est créé par défaut pour que vous puissiez fournir ces informations pour chaque enregistrement de provenance. Si vous attribuez des noms personnalisés à ces propriétés, ces noms sont visibles lorsque vous définissez et explorez des enregistrements de provenance dans l’enquête.
instanceID
Cette propriété stocke la valeur d’ID global de l’entité ou de la relation associée à l’enregistrement de provenance. Le nom de propriété par défaut est instanceID.
sourceType
Le type de matériel source associé à cet enregistrement de provenance est stocké dans cette propriété. Les types de source pris en charge sont Document, URL et Chaîne. Le nom de propriété par défaut est sourceType.
sourceName
Cette propriété fournit un nom pour le matériel source. Lorsque la propriété sourceType est Document, cette valeur est définie sur la propriété de nom de l’entité Document. Lorsque la propriété sourceType est de type URL ou Chaîne, vous pouvez fournir un texte comme le nom du site Web ou le nom d’une personne qui a été interrogée. Le nom de propriété par défaut est sourceName.
source
Cette propriété identifie la source des informations. Le nom de propriété par défaut est source.
Lorsque la propriété sourceType est de type Document, l’enregistrement de provenance fait référence à un document qui a déjà été ajouté dans le graphe de connaissances.
Lorsque la propriété sourceType est de type URL, la valeur peut être l’emplacement d’un site Web ou d’un document sur Internet, ou un chemin d’accès à un document sur le réseau.
Lorsque la propriété sourceType est de type Chaîne, la valeur est du texte dans lequel vous pouvez fournir les informations ou instructions d’accès au matériel source.
commentaire
Cette propriété vous permet de rédiger une note concernant le matériel source ou sa pertinence par rapport à l’entité ou à la relation associée à cet enregistrement de provenance. Le nom de propriété par défaut est comment.
typeName
Cette propriété stocke le type de l’entité ou de la relation associée à l’enregistrement de provenance. Par exemple, si l’enregistrement de provenance établit le nom d’une personne, le nom du type d’entité Person est stocké. Le nom de propriété par défaut est typeName.
propertyName
Cette propriété identifie la propriété de l’entité ou de la relation associée à l’enregistrement de provenance. Par exemple, si l’enregistrement de provenance établit la date de naissance d’une personne, le nom de propriété birthDate est stocké. Le nom de propriété par défaut est propertyName.
Lorsque le graphe de connaissances est créé, le texte que vous fournissez est utilisé pour identifier les propriétés de l’enregistrement de provenance.
Vous avez par ailleurs la possibilité de configurer la façon dont les types de sources d’un enregistrement de provenance sont définis.
Trois types de source, répertoriés ci-dessous, sont pris en charge lors de la définition d’un enregistrement de provenance. Si vous attribuez des noms personnalisés à ces types, ces noms sont visibles lorsque vous définissez et explorez des enregistrements de provenance dans l’enquête. Ces valeurs du type de source sont stockées dans la propriété sourceType de l’enregistrement de provenance.
Document
Lorsque ce type est sélectionné, l’enregistrement de provenance fait référence à un document dans le graphe de connaissances. Le nom par défaut de cette valeur sourceType est Document.
URL
Lorsque ce type est sélectionné, l’enregistrement de provenance stocke l’emplacement dans lequel le document source se trouve sur Internet ou sur le réseau. Le nom par défaut de cette valeur sourceType est URL.
Chaîne
Lorsque ce type est sélectionné, vous pouvez saisir les informations, une description de la source même ou des instructions d’accès au matériel source. Le nom par défaut de cette valeur sourceType est Chaîne.
Lorsque le graphe de connaissances est créé, le texte que vous fournissez est utilisé pour identifier le type de matériel source décrit par un enregistrement de provenance.
Configurer les paramètres
Procédez comme suit afin de configurer les paramètres pour le graphe de connaissances. Ces paramètres sont stockés en tant que partie de la définition du service ArcGIS Knowledge Server qui est créé.
Remarque :
Cette option n’est pas disponible pour un graphe de connaissances fichier. Elle reste toujours disponible pour un service de graphe de connaissances.
Cliquez sur l’onglet Configure parameters (Configurer les paramètres)
.Sous Properties (Propriétés), spécifiez une valeur pour le Maximum records returned by server (Nombre maximal d’enregistrements renvoyés par le serveur).
Cette propriété spécifie le nombre d’éléments du graphe qui peuvent être renvoyés par une requête openCypher ou lors de l’affichage des données dans une enquête, une carte ou un diagramme de liens. Un chiffre élevé peut réduire les performances. La valeur par défaut est 10 000.
Spécifiez une valeur pour Maximum records returned by server during search operation (Nombre maximal d’enregistrements renvoyés par le serveur au cours d’une recherche).
Cette propriété spécifie le nombre d’éléments de graphe qui peuvent être renvoyés lors d’une recherche sur les propriétés indexées des entités et des relations. Un chiffre élevé peut réduire les performances. La valeur par défaut est 2 000.