Historique du géotraitement

Les outils de géotraitement que vous exécutez sont consignés et enregistrés avec le projet. Vous pouvez afficher des informations détaillées sur chaque outil ayant été exécuté et les rouvrir avec les mêmes paramètres que ceux que vous avez utilisés précédemment. L’historique de géotraitement renforce votre productivité et vous permet de mieux comprendre les processus à l’origine de la création des données et des couches du projet.

Lorsque vous exécutez un outil de géotraitement, une entrée est ajoutée sous l’onglet Geoprocessing (Géotraitement) de la fenêtre History (Historique). Pour accéder à l’historique des outils de géotraitement, sur le ruban Analysis (Analyse), dans le groupe Geoprocessing (Géotraitement), cliquez sur le bouton History (Historique) .

Entrées de l’historique

Chaque entrée de l’historique conserve des informations détaillées concernant l’outil et notamment :

• L’entrée et la sortie de l’outil ainsi que d’autres paramètres.
• Tout paramètre d’environnement de géotraitement personnalisé.
• La date/l’heure d’exécution de l’outil, la date/l’heure de fin et la durée de l’exécution de l’outil.
• Le succès ou l’échec de l’outil.
• Des informations, avertissements ou messages d’erreur.
• Des liens vers des rapports en sortie ou fichiers, tels que des documents PDF ou HTML. Lorsque vous cliquez sur les liens, les fichiers s’ouvrent dans l’application système par défaut définie pour le type de fichier en question.

Gérer l’historique

Si vous ouvrez le projet ultérieurement pour poursuivre votre travail, vous pourrez consulter, dans l’historique de géotraitement, l’intégralité des outils de géotraitement que vous avez déjà exécutés dans le projet. Vous pouvez rouvrir et exécuter n’importe lequel des outils présents dans l’historique en double-cliquant sur l’entrée ou en cliquant dessus avec le bouton droit de la souris et en choisissant Open (Ouvrir).

Vous pouvez supprimer les entrées de l’historique que vous ne souhaitez pas conserver dans le projet. Sélectionnez les entrées que vous souhaitez supprimer, cliquez avec le bouton droit de la souris et sélectionnez Remove (Supprimer). Vous pouvez également effacer une ou plusieurs entrées de l’historique sélectionnées à l’aide du bouton Remove (Supprimer) figurant en haut de la liste des entrées de l’historique.

Favoris de l’historique

Il est possible de marquer des outils de l’historique de géotraitement du projet comme favoris. L’outil est alors épinglé en haut de la section Favorites (Favoris) de l’historique du géotraitement. Cliquez avec le bouton droit sur un outil et sélectionnez Add To History Favorites (Ajouter aux favoris de l’historique) pour l’ajouter à la section Favorites (Favoris). Les outils marqués comme favoris sont répertoriés dans la section Favorites (Favoris) et continuent d’apparaître dans la vue principale de l’historique du géotraitement selon la méthode de tri choisie.

Pour retirer un outil marqué comme favori, cliquez avec le bouton droit sur cet outil dans la section Favorites (Favoris) et sélectionnez Remove From History Favorites (Retirer des favoris de l’historique) .

Historique des filtres

Utilisez la barre de recherche pour trouver les outils que vous avez déjà exécutés en fonction de leur nom.

Triez l’historique de géotraitement en utilisant les options suivantes du menu Sort (Trier)  :

• Sort By (Trier par) : Status (Statut), Name (Nom) ou Start Time (Heure de début)
• Order (Ordre) : Ascending (Croissant) ou Descending (Décroissant)

Appliquez les filtres suivants à l’historique de géotraitement à l’aide du menu déroulant Filter (Filtrer)  :

• Type : Local ou Portal (Portail)
• Status (Statut) : In Progress (En cours), Completed (Terminé) ou Failed (Échec)
• Input Layer (Couche en entrée) : liste des couches utilisées en entrée par tous les outils de l’historique

Pour filtrer l’historique, procédez comme suit :

1. Ouvrez la fenêtre History (Historique) et sélectionnez l’onglet Geoprocessing (Géotraitement) .
2. Cliquez sur le menu déroulant Filter (Filtrer) .
3. Développez le type de filtre souhaité.
4. Cochez ou désélectionnez des cases pour afficher ou masquer des outils dans l’historique du géotraitement à l’aide du filtre.

   Cochez la case Select All (Sélectionner tout) en haut du menu Filter (Filtrer) pour cocher ou décocher tous les filtres. Après avoir désélectionné tous les filtres, cochez un type, un statut ou une couche en entrée pour afficher les entrées de l’historique de géotraitement qui correspondent à ce filtre.

Automatiser le géotraitement à l’aide de l’historique

Vous pouvez utiliser les outils de géotraitement exécutés dans la fenêtre Geoprocessing (Géotraitement) comme point de départ pour automatiser vos tâches avec ModelBuilder ou Python.

Il est possible de faire glisser les entrées de l’historique de géotraitement vers une vue ModelBuilder. Les outils et toutes les définitions de paramètre sont ajoutés et connectés dans le modèle. Vous pouvez aussi cliquer avec le bouton droit sur les entrées de l’historique et sélectionner Add To Model (Ajouter au modèle) ; les outils et toutes les données nécessaires à l’exécution des outils sont alors ajoutés à un modèle ouvert. Si aucun modèle n’est ouvert, un modèle est créé dans la boîte d’outils du projet. Vous pouvez sélectionner plusieurs entrées de l’historique et les ajouter à un modèle pour créer une chaîne de traitements connectée dans le modèle, dans lequel la sortie d’un outil peut alimenter un autre outil en entrée.

Les éléments de l’historique du géotraitement peuvent également être convertis en langage Python. Cliquez avec le bouton droit sur un ou plusieurs éléments de l’historique et sélectionnez l’une des options suivantes :

• Copy Python Command (Copier la commande Python) : copiez les outils sélectionnés sous forme de code Python.
• Send To Python window (Envoyer dans la fenêtre Python) : envoyez le code Python pour les outils sélectionnés dans la fenêtre Python.
• Send To Notebook (Envoyer à un notebook) : envoyez le code Python pour les outils sélectionnés à un ArcGIS Notebooks. Si un notebook est ouvert, le code Python est copié dans le notebook ouvert. Si aucun notebook n’est ouvert, le code Python est copié dans un nouveau notebook.
• Save As Python Script (Enregistrer comme script Python) : enregistrez un script Python (.py).

Vous pouvez également sélectionner plusieurs éléments d’historique et les ajouter à la fenêtre Python ou un notebook.

Si l’un des environnements de géotraitement était utilisé lors de l’exécution de l’outil, l’environnement est inclus dans le code Python via la classe arcpy.EnvManager.

En savoir plus sur l’exécution des outils de géotraitement dans Python

Partager l’analyse

L’historique du géotraitement joue un rôle essentiel lors du partage d’une analyse en tant que paquetage de géotraitement ou qu’outil Web. Les analyses que vous souhaitez partager doivent d’abord s’être exécutées correctement et être consignées dans l’historique de géotraitement.

Pour en savoir plus sur le partage des analyses

Options de consignation au journal de géotraitement

Les options de géotraitement décrites ci-dessous permettent de contrôler la façon dont les outils de géotraitement que vous exécutez sont consignés dans l’historique du géotraitement, les journaux XML externes et les métadonnées du jeu de données.

Consigner les opérations de géotraitement dans l’historique de géotraitement

Cette option indique si les outils que vous exécutez sont ajoutés dans l’historique du géotraitement du projet en cours.

• Option activée : chaque outil exécuté est consigné dans l’historique du géotraitement du projet. Il s’agit de l’option par défaut.
• Option désactivée : les outils ne sont pas consignés dans l’historique du géotraitement.

Consigner les opérations de géotraitement dans un fichier journal XML

Cette option indique si les informations concernant tous les outils de géotraitement que vous exécutez sont écrites dans un fichier journal externe.

• Option activée : des fichiers journaux XML sont créés dans le répertoire %AppData%\Esri\ArcGISPro\ArcToolbox\History.
• Option désactivée : aucun fichier journal XML n’est créé. Il s’agit de l’option par défaut.

Consigner les opérations de géotraitement dans les métadonnées du jeu de données

Cette option indique si les métadonnées des jeux de données en entrée et en sortie de l’outil de géotraitement sont actualisées pour inclure le nom de l’outil, ses paramètres, la date et l’heure de son exécution, ainsi que d’autres informations.

• Option activée : les métadonnées du jeu de données contiennent une section Geoprocessing History (Historique du géotraitement) chargée de consigner les outils utilisés avec ce jeu de données. Il s’agit de l’option par défaut.
• Option désactivée : les métadonnées du jeu de données ne sont pas mises à jour.