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 un 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éé.

  1. 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 modifie la manière dont vous pouvez configurer le graphe de connaissances.

  2. Cliquez sur l’onglet Configuration. Si nécessaire, cliquez sur l’onglet Configure service (Configurer le service) Configurer le service en dessous.
  3. Sous Operations (Opérations), cochez la case Enable editing (Activer la mise à jour) pour activer la mise à jour des données du graphe de connaissances.

    Le propriétaire du graphe de connaissances et les administrateurs du portail 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.

  4. 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 :

    Addition

    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.

    Suppr

    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.

    Cette option n’est pas disponible si un Data Store NoSQL a été sélectionné dans l’onglet General (Général) et que l’option User managed (Gérées par l’utilisateur) est sélectionnée.

    Remarque :

    Lorsque le graphe de connaissances est créé, vous pouvez modifier ses options de mise à jour dans le portail Enterprise.

  5. Sous Data Store, sélectionnez le mode de gestion des données dans le Data Store NoSQL du graphe de connaissances.
    Gérées par ArcGIS

    ArcGIS Knowledge crée, gère et supprime les entités et les relations, et définit le modèle de données des éléments du graphe stockés dans la base de données Neo4j. La base de données ne doit pas être mise à jour directement dans Neo4j. Cette option est activée par défaut. Les graphes de connaissances sont correctement créés avec ce paramètre uniquement si votre base de données Neo4j est vide.

    Gérées par l’utilisateur

    Vous devez créer, gérer et supprimer les entités et les relations, et définir le modèle de données des éléments du graphe à l’aide de Neo4j. Le graphe de connaissances est en lecture seule lorsque vous accédez à la base de données Neo4j via ArcGIS Knowledge. La base de données Neo4j ne doit pas nécessairement être vide, mais son nom et les noms des types de modèles de données et des propriétés doivent satisfaire à toutes les restrictions en matière de noms.

    Cette option n’est pas disponible si l’option Hosted graph store (Graph Store hébergé) a été sélectionnée dans l’onglet General (Général).

    Remarque :

    Le paramètre par défaut pour cette option est ArcGIS managed (Gérées par ArcGIS) et les graphes de connaissances créés avec ce paramètre prennent en charge la mise à jour des données dans le graphe de connaissances par d’autres personnes, comme indiqué par les paramètres spécifiés dans les étapes précédentes. Toutefois, si vous choisissez de créer un graphe de connaissances avec l’option User managed (Gérées par l’utilisateur), ses données sont en lecture seule. Si vous avez activé l’option Enable editing (Activer la modification), l’option est automatiquement décochée et toutes les options liées à la mise à jour sont indisponibles dans cet onglet.

  6. Si l’option User managed (Gérées par l’utilisateur) est sélectionnée, configurez le graphe de connaissances de manière à accéder aux données dans la base de données Neo4j.

    Les options sont présentées dans la table suivante :

    Identifiant unique

    Toutes les entités et relations du graphe de connaissances doivent avoir une valeur de chaîne unique qui peut être utilisée pour identifier l’élément de graphe. Spécifiez la propriété dans le Data Store NoSQL dans laquelle cette valeur est stockée. Par exemple, si la base de données utilise une propriété nommée id, saisissez le nom de cette propriété, id, dans la zone de texte Unique identifier (Identifiant unique). Dans ce cas, tous les types d’entité ou types de relations définis du graphe de connaissances doivent posséder une propriété nommée id.

    Activer la recherche

    Toutes les données du graphe de connaissances sont accessibles via une requête openCypher. Toutefois, pour rechercher les éléments de graphe à l’aide d’une recherche de texte intégral des valeurs de propriété, cette option doit être sélectionnée. Cette option est activée par défaut.

    Si vous désactivez cette option et recherchez un élément, une requête openCypher est utilisée pour rechercher les éléments de graphe dont les propriétés contiennent la valeur spécifiée. Cependant, vous ne serez pas en mesure d’utiliser la syntaxe Lucene dans la chaîne de recherche incluant les opérateurs OR et LIKE. Vous ne pouvez pas non plus ajouter un astérisque avec un mot-clé partiel (plan*, par exemple) pour tirer parti des fonctions de racinisation ou d’autres fonctions de recherche de texte intégral pour trouver tous les termes correspondants.

    Activer les documents

    Cette option indique s’il est possible d’ajouter des documents au graphe de connaissances. Elle ne peut pas être modifiée. 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.

    Si l’option ArcGIS managed (Gérées par ArcGIS) est sélectionnée, ces options ne sont pas modifiables mais indiquent comment le Data Store NoSQL est configuré. Une propriété portant le nom globalid est créée pour stocker les identifiants uniques. La recherche est activée et les documents sont pris en charge.

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éé.

  1. En haut de l’assistant Create Investigation (Créer une enquête), sous l’onglet Configuration, cliquez sur Configure parameters (Configurer les paramètres) Configurer les paramètres.
  2. 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.

  3. 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.

Configurer les documents

Procédez comme suit afin de configurer la manière dont les documents sont représentés 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.

En savoir plus sur les documents

  1. En haut de l’assistant Create Investigation (Créer une enquête), sous l’onglet Configuration, cliquez sur Configure documents (Configurer les documents) Document.
  2. 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. Par exemple, lorsque vous ajoutez un document à un graphe de connaissances, une nouvelle entité est créée pour le type d’entité Document.

  3. 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. Par exemple, lorsque vous ajoutez un document à une entité spécifique dans le graphe de connaissances, telle qu’une entité Person, une nouvelle relation du type d’entité HasDocument est créée entre l’entité Person et l’entité Document.

  4. Enregistrez les informations essentielles pour chaque document référencé par le graphe de connaissances. Configurez les propriétés du type d’entité de document utilisé pour stocker ces informations.
    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 du fichier qui peut être utilisé pour 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.

    nom

    Nom de fichier du document. Par exemple, si vous ajoutez un fichier nommé notes.txt au graphe de connaissances, le 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 .htm est stockée. Le nom de propriété par défaut est fileExtension.

Rubriques connexes