Mode d’indexation des projets

L’index de recherche ArcGIS Pro génère des résultats lorsque vous recherchez des jeux de données, des cartes et d’autres éléments de projet dans un projet. Les éléments apparaissent dans les résultats de recherche uniquement s’ils ont été indexés. L’indexation est activée par défaut.

Les paramètres d’indexation figurent dans l’onglet Indexing (Indexation) de la boîte de dialogue Options dans les paramètres ArcGIS Pro. Cette rubrique décrit la manière dont fonctionne l’index de recherche. Pour plus d’informations sur la définition des options, consultez la rubrique Gérer l’index.

Emplacements d’indexation

Il existe trois emplacements d’indexation :

  • Disques locaux
  • Emplacements réseau
  • Géodatabases d’entreprise

Lorsque l’indexation est activée pour l’application, il est toujours posible de l’activer ou la désactiver séparément pour chacun de ces emplacements. Lorsque l’indexation est désactivée pour l’application, elle est désactivée pour les trois emplacements.

Par défaut, l’indexation est activée pour les disques locaux qui incluent le disque dur de votre ordinateur et les disques durs externes connectés physiquement.

Par défaut, l’indexation est désactivée pour les emplacements réseau. Toutefois, si vous sauvegardez un projet sur un partage réseau, les éléments enregistrés dans le fichier de projet (.aprx), comme les cartes et les mises en page, sont indexés, même si les emplacements réseau ne le sont pas.

Par défaut, l’indexation est désactivée pour les géodatabases d’entreprise (.sde).

Contenu indexé

Par défaut, les éléments sont indexés seulement s’ils sont disponibles dans un projet. Le contenu suivant est indexé :

  • Les éléments stockés dans le fichier de projet, tels que les cartes, les couches cartographiques, les tables autonomes, les mises en page, les rapports, les présentations et les tâches.
  • Les connexions à un élément, telles que les connexions à des dossiers, des bases de données, des boîtes à outils, des notebooks, des serveurs et des stores Cloud.
  • Les éléments stockés dans des connexions à un dossier, une base de données et une boîte à outils, tels que les shapefiles, les classes d’entités de géodatabase, les jeux de données raster et les modèles de géotraitement.

Vous pouvez également indexer les éléments qui ne figurent pas dans un projet. Seuls les éléments pouvant être utilisés dans ArcGIS Pro sont indexés.

Le contenu des connexions à un élément ne sont pas indexés sauf dans le cadre des connexions à un dossier, une base de données et à une boîte d’outils. Par exemple, vous pouvez trouver une connexion ArcGIS GIS Server dans une recherche étant donné que le fichier de connexion est indexé, mais ne pouvez pas trouver les services associés. Toutefois, lorsqu’une connexion est renvoyée en tant que résultat d’une recherche, vous pouvez parcourir son contenu.

Fenêtre de catalogue affichant les résultats d’une recherche comportant une connexion à un serveur
Une recherche sur le terme « traffic » renvoie une connexion à un serveur, car le nom de fichier de la connexion inclut le terme de recherché. Vous pouvez alors parcourir le contenu du serveur.

Attention :

Les services de stockage Cloud, comme Microsoft OneDrive et Google Drive, ne sont pas pris en charge, sauf indication contraire dans la documentation relative aux outils et fonctions spécifiques.

En savoir plus sur ArcGIS Pro et les services de stockage cloud

Informations indexées

Le nom de fichier d’un élément, le type de fichier (comme une couche, une classe d’entités ou un raster) et les métadonnées sont indexés. En ce qui concerne les métadonnées, des éléments sont renvoyés si le terme de recherche apparaît dans l’un des champs de description de l’élément suivants :

  • Titre
  • Balises
  • Récapitulatif (objet)
  • Description

En savoir plus sur la recherche dans un projet

Fenêtre de catalogue affichant les résultats de recherche comportant différents éléments
Une recherche sur le terme « layer » renvoie des éléments avec des noms de fichier qui incluent le terme recherché et des éléments correspondant au type de fichier.

Remarque :

Tous les éléments ne stockent pas des métadonnées ArcGIS. Par ailleurs, certains éléments, tels que les localisateurs, stockent des métadonnées qui ne sont pas indexées.

Index de projet et index de ressources

L’index de recherche est composé de deux index, chacun d’eux étant utilisé pour générer des résultats de recherche :

  • Index de projet : il indexe les éléments stockés dans le fichier de projet, comme des cartes et des mises en page. Chaque projet dispose de son propre index de projet.
  • Index de ressources : il indexe les éléments stockés hors du fichier de projet (les dossiers, les bases de données, les boîtes à outils et leur contenu, par exemple). Il s’agit d’un index commun à tous les projets.

Les éléments ne sont indexés qu’une seule fois dans l’index de ressources. Par exemple, vous pouvez ajouter à de nombreux projets le dossier C:\MyData sous forme de connexion aux dossiers, mais le dossier et les éléments qu’il contient ne sont indexés qu’une fois. Le chemin d’accès aux emplacements indexés et à la liste des projets y faisant référence est conservé dans un fichier placé dans C:\<user profile>\AppData\Local\ESRI\Index\Config\IndexingConfig.cfg.

Extrait de code d’un fichier de configuration d’indexation
Dans cet extrait de code d’un fichier de configuration d’indexation, le dossier C:\MyData est indexé par l’index de ressource. La propriété <Owners> montre les deux projets faisant référence à ce dossier.

Lorsque vous effectuez une recherche dans un projet, vous obtenez des résultats sur les éléments contenus dans le projet en question. Si, par exemple, C:\MyData est une connexion aux dossiers dans le projet MyProject, son contenu (sous-dossiers et contenu inclus) peut être renvoyé pour une recherche dans MyProject. En revanche, même si ces éléments sont indexés, ils ne sont pas renvoyés pour une recherche dans MyProject2 puisque celle-ci n’a pas de connexion à ce dossier.

Seule exception : lorsqu’un dossier est ajouté à la liste des éléments indexés qui ne figurent pas dans des projets. En pareille situation, le contenu du dossier peut être renvoyé dans une recherche, quel que soit le projet.

Remarque :

Si un dossier est ajouté à la liste des éléments indexés qui ne figurent pas dans des projets, le dossier et son contenu peuvent faire l’objet d’une recherche sur n’importe quel projet.

Chemins d’accès et dossiers de l’index

L’index de ressources est stocké dans le profil d’utilisateur : <user profile>\AppData\Local\ESRI\Index. Le dossier Index contient les sous-dossiers suivants :

  • Config : inclut les fichiers suivants :
    • IndexingConfig.cfg : le fichier de configuration d’indexation dresse la liste des chemins d’accès indexés et des projets qui y font référence.
    • Excludes.cfg : le fichier d’exclusion recense les emplacements qui ont entraîné une erreur d’indexation et sont par conséquent ignorés temporairement lors de l’exécution des opérations d’indexation planifiées. Il se peut que ce chemin soit absent.
    • Status.cfg : le fichier de statut indique la dernière fois que les opérations d’indexation planifiées ont été réalisées pour chaque emplacement indexé.
  • Connections : contient des copies des fichiers de connexion à la géodatabase d’entreprise qui sont utilisés lors de l’indexation.
  • Log : contient le fichier journal d’indexation et les fichiers connexes.
  • ResourceIndex : contient les fichiers d’index de ressources.
  • Thumbnail : contient les images miniatures des éléments indexés par l’index de ressources, si elles existent. Il est possible de générer automatiquement des miniatures ou de les créer manuellement.

L’index de chaque projet est stocké dans un dossier nommé Index\<project name>_index. Pour les projets stockés en local ou sur un partage réseau, ce dossier se trouve dans le dossier d’accueil du projet. Pour les projets de portail, il figure dans le dossier de téléchargement du projet. Le dossier <project name>_index peut contenir les sous-dossiers suivants :

  • Connections : ce dossier est vide.
  • <Nom du projet> : ce dossier contient les fichiers d’index de projet.
  • Thumbnail : ce dossier contient les images miniatures des cartes indexées par l’index de projet.

Remarque :

Les fichiers d’index de projet et de ressources sont des fichiers Lucene qui peuvent uniquement être lus avec un outil conçu à cet effet. Le fichier de configuration d’indexation peut être lu dans un éditeur de texte.

Héritage :

En raison d’une modification de la convention de dénomination des dossiers de l’index de projet de ArcGIS Pro 3.3, les projets créés dans les versions précédentes peuvent contenir un dossier d’index supplémentaire par rapport à la version précédente. Ce dossier n’est pas nécessaire et est automatiquement supprimé lors de la régénération de l’index du projet. Vous pouvez également le supprimer manuellement.

Indexation dynamique, planifiée et à la demande

Lorsque l’indexation est activée, l’index est mis à jour au fur et à mesure. Vous pouvez également planifier des opérations d’indexation pour qu’elles aient lieu à des heures particulières ou lancer l’indexation via une commande.

Lorsque vous ouvrez un projet et effectuez une action qui fait appel à l’indexation (l’insertion d’une nouvelle carte, l’ajout d’une couche à une carte ou l’ajout d’une connexion aux dossiers au projet), le traitement en arrière-plan ArcGISIndexingServer est actif dans le Gestionnaire des tâches de Windows. Le traitement reste présent pendant toute la session ArcGIS Pro mais peut être inactif la plupart du temps. Lorsque vous quittez l’application, le traitement se ferme. Le traitement du serveur d’indexation est également actif pendant l’exécution d’une opération d’indexation planifiée.

Indexation dynamique

L’indexation dynamique est réalisée automatiquement lorsque vous travaillez sur un projet. Elle met à jour les index de projet et de ressources lorsque les événements suivants se produisent :

  • Les éléments stockés dans le fichier de projet sont créés, supprimés, copiés ou renommés.
  • Les connexions aux éléments sont ajoutées, retirées, renommées, copiées ou supprimées dans la fenêtre Catalog (Catalogue) ou une vue de catalogue.
  • Les éléments accessibles à partir de connexions (les shapefiles dans une connexion aux dossiers ou les classes d’entités dans une connexion à une base de données, par exemple) sont créés, supprimés, copiés, importés, déplacés ou renommés.
  • Les métadonnées d’élément sont mises à jour.

Par exemple, si vous utilisez un projet nommé MyProject et ajoutez une connexion aux dossiers dans C:\MyData, l’emplacement est ajouté à l’index de ressource et l’indexation de son contenu commence immédiatement. Pendant un bref laps de temps, les recherches dans le projet peuvent renvoyer des résultats de recherche partiels et un message s’affiche pour signaler que l’indexation est en cours.

Si le dossier C:\MyData est déjà indexé (une connexion aux dossiers existe dans un autre projet), MyProject est ajouté à la liste des projets figurant dans le fichier de configuration d’indexation faisant référence à ce chemin. Dans ce cas, les éléments indexés sont immédiatement disponibles lors des recherches dans MyProject.

L’indexation dynamique met seulement à jour le contenu modifié ou actualisé dans ArcGIS Pro. Si vous copiez un jeu de données à l’aide de la commande d’un système d’exploitation, le jeu de données demeure introuvable lors d’une recherche dans le projet tant que vous n’actualisez pas l’emplacement dans la fenêtre Catalog (Catalogue) ou une vue de catalogue. Cependant, si vous copiez le jeu de données à l’aide d’ArcGIS Pro, il est immédiatement indexé de manière dynamique et peut faire l’objet d’une recherche qui permet de le trouver.

Indexation planifiée

La tâche ArcGIS Pro Indexing (Indexation d’ArcGIS Pro) dans le Planificateur de tâches de Windows effectue trois opérations d’indexation : l’indexation incrémentielle, la régénération d’index et la génération de miniatures. La fréquence et les dates/heures auxquelles ces opérations sont exécutées peuvent être modifiées séparément pour chaque emplacement d’indexation.

Indexation incrémentielle

L’indexation incrémentielle met à jour tous les chemins d’accès indexés (dans l’index de ressources et l’index de projet) ainsi que la liste actuelle des éléments qui se trouvent dans ces emplacements. Elle prend en compte les modifications qui ne sont pas capturées par l’indexation dynamique :

  • Les éléments ajoutés, supprimés ou renommés à l’aide de commandes du système d’exploitation ou d’autres applications que ArcGIS Pro.
  • Les éléments dans un emplacement partagé, tel qu’un dossier réseau, qui sont modifiés par un autre utilisateur ArcGIS Pro.
  • Les éléments qui sont modifiés dans une instance d’ArcGIS Pro alors que d’autres instances sont ouvertes.

L’indexation incrémentielle ne capture pas les modifications apportées aux métadonnées. Si, par exemple, vous ajoutez ou supprimez des balises ou encore si vous modifiez le résumé de la description d’un élément, ces modifications ne sont pas répercutées au cours des recherches dans le projet après l’exécution de l’indexation incrémentielle.

Régénération de l’index

La régénération de l’index, également appelée réindexation ou indexation complète, entraîne la suppression des entrées de l’index dans tous les emplacements indexés (dans l’index de ressources et l’index de projet) et la nouvelle indexation de chaque emplacement. Elle ne supprime pas complètement l’index, mais garge la liste existant des chemins d’accès indexés et des projets qui leur font référence. La régénération de l’index permet :

  • De créer une liste d’éléments stockés au niveau de chaque emplacement indexé.
  • D’indexer les métadonnées de chaque élément.
  • De créer une liste d’éléments pour lesquels des images miniatures peuvent être générées.

Génération de miniatures

La génération de miniatures crée des images .jpg représentant des cartes, des scènes et des jeux de données spatiales. Les dimensions des images sont égales à 300 x 200 pixels. Les miniatures des cartes et des scènes sont stockées dans les index de projet tandis que les miniatures des jeux de données spatiales sont conservées dans l’index de ressources. Les miniatures s’affichent aux emplacements suivants :

Par défaut, les miniatures ne sont pas écrasées après avoir été générées. Une fois que les miniatures ont été générées pour la première fois, l’opération s’exécute plus rapidement, car les miniatures sont générées uniquement pour les nouveaux éléments. Vous pouvez également remplacer les miniatures existantes en sachant que les miniatures créées par l’utilisateur ne sont pas écrasées.

La liste des miniatures à générer est créée par l’opération de régénération de l’index. En conséquence, la génération de miniatures ne peut pas avoir lieu plus fréquemment que la régénération de l’index.

Indexation à la demande

Bien que l’indexation incrémentielle s’exécute à des intervalles planifiés, vous pouvez également lancer manuellement une indexation incrémentielle grâce à une commande. La commande lance l’opération sur le champ.

Inclure ou exclure des éléments

Vous pouvez désigner un ou plusieurs dossiers à indexer même s’il s’agit de connexions aux dossiers (ou de sous-dossiers de connexions aux dossiers) dans un projet. Les éléments de dossiers désignés pour l’indexation se trouvent dans le projet que vous recherchez, y compris les projets sans titre.

Par défaut, les dossiers désignés pour l’indexation sont indexés par l’index de ressources existant. Toutefois, vous pouvez créer un index spécifique au dossier désigné dans l’emplacement de votre choix. Cela peut s’avérer utile dans les situations suivantes :

  • Vous souhaitez partager l’index d’autres personnes.
  • Vous souhaitez désactiver l’indexation pour les disques locaux ou d’autres emplacements, mais continuer à mettre à jour l’index pour le dossier désigné.

Vous pouvez également désigner des dossiers à ne pas indexer. Si un dossier est exclu de l’indexation, son contenu n’est pas renvoyé dans les recherches, même si le dossier a déjà été indexé.

Index gérés par d’autres personnes

Outre l’index créé sur votre ordinateur, vous pouvez utiliser des index gérés par quelqu’un d’autre et partagés avec vous. Par exemple, un administrateur utilisant un autre ordinateur peut indexer un contenu sur un partage réseau et stocker l’index dans un emplacement auquel vous pouvez accéder. Pour utiliser les éléments renvoyés dans les résultats de recherche (pour ajouter des données à une carte, par exemple), vous devez être en mesure d’accéder à l’emplacement dans lequel les éléments indexés sont stockés.

Projets non indexés

Dans les cas suivants, les éléments d’un projet existant ne sont pas indexés :

  • Vous n’avez pas encore ouvert le projet (vous avez téléchargé un paquetage de projet à partir d’un portail, par exemple).
  • Vous avez créé le projet alors que l’indexation était désactivée.

Pour indexer un projet qui ne l’est pas, ouvrez le projet et effectuez une recherche ou effectuez une action qui lance l’indexation dynamique.

Projets de portail

Les projets de portail sont indexés de la même façon que les projets locaux à ceci près que l’index de projet d’un projet de portail est conservé dans le dossier de téléchargement plutôt que dans le dossier d’accueil.

La plupart des configurations des projets de portail exigent que les données et les autres ressources de projet se trouvent sur un partage réseau. De plus, en ce qui concerne les projets de portail multi-utilisateur, la géodatabase par défaut doit être une géodatabase d’entreprise. Dans ce cas, les résultats de recherche ne sont disponibles qu’aux utilisateurs activant l’indexation pour les emplacements réseau et les géodatabases d’entreprise.

Dans un projet de portail qui possède une géodatabase d’entreprise contenant des classes d’entités et une connexion à un dossier réseau, les résultats de recherche dépendent des paramètres d’indexation de l’utilisateur. Voici quelques exemples :

  • L’utilisateur 1 (sachant que l’indexation est activée pour les disques locaux) peut seulement trouver des éléments tels que des cartes et des couches stockées dans le fichier de projet.
  • L’utilisateur 2 (sachant que l’indexation est activée pour les disques locaux et les emplacements réseau) peut trouver les éléments stockés dans le fichier de projet et dans le dossier réseau, mais pas dans la géodatabase d’entreprise.
  • L’utilisateur 3 (sachant que l’indexation est activée pour les disques locaux, les emplacements réseau et les géodatabases d’entreprise) peut trouver toutes les données de projet.
  • L’utilisateur 4 (sachant que l’indexation est désactivée) n’obtient aucun résultats de recherche (autres que les éléments de projet précédemment indexés).

L’indexation des emplacements réseau et des géodatabases d’entreprise peut prendre beaucoup de temps. Pour cette raison, vous pouvez décider d’exclure de l’indexation certains lecteurs réseau ou d’utiliser un index géré lorsque vous utilisez des projets de portail.

Mettre à niveau à partir d’une version antérieure d’ArcGIS Pro

Lorsque vous procédez à une mise à niveau d’ArcGIS Pro vers une version plus récente, toutes les modifications que vous avez apportées aux paramètres d’indexation par défaut dans la version précédente sont conservées. Les paramètres par défaut suivants s’appliquent si les paramètres n’ont pas été modifiés :

  • Les disques locaux sont indexés ; les emplacements de réseau et les géodatabases d’entreprise ne le sont pas.
  • Les opérations d’indexation planifiées s’exécutent lorsque vous avez ouvert une session sur votre ordinateur et qu’ArcGIS Pro ne fonctionne pas.
  • L’indexation incrémentielle a lieu toutes les heures, la régénération d’index tous les jours et la génération de miniatures toutes les semaines.

Remarque :

Après la mise à niveau, il est recommandé de régénérer l’index. Avant de planifier cette opération, utilisez File Explorer pour accéder au dossier <user profile>\AppData\Local\ESRI\Index et supprimer manuellement tous les fichiers des dossiers ResourceIndex et Thumbnail. Cela permet d’optimiser l’index recréé pour la version actuelle d’ArcGIS Pro.

Rubriques connexes