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 son entrée ou en cliquant avec le bouton droit dessus et en choisissant Open (Ouvrir).

Vous pouvez effacer des entrées de l’historique que vous ne voulez pas conserver dans le projet. Sélectionnez les entrées à effacer, cliquez avec le bouton droit 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 également d’apparaître dans la vue principale de l’historique du géotraitement selon la méthode de tri sélectionnée.

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

Vous pouvez appliquer les filtres suivants à l’historique du géotraitement grâce au menu déroulant Filter (Filtrer)  :

• Type : Local, Portal (Portail)
• Status (Statut) : In Progress (En cours), Completed (Terminé), 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.

   Vous pouvez utiliser le bouton d’activation Select All (Sélectionner tout) en haut du menu Filter (Filtrer) pour cocher ou désélectionner 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, où 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 votre analyse

L’historique du géotraitement joue un rôle clé lors du partage de votre analyse en tant que paquetage de géotraitement ou outil web. Les analyses que vous souhaitez partager doivent d’abord s’être exécutées correctement et être consignées dans votre 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 suivantes permettent de contrôler la façon dont les outils de géotraitement 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.