Affichage de l'historique d'exécution d'un outil

Chaque fois que vous exécutez un outil de géotraitement, les informations relatives à cet outil et à ses paramètres sont enregistrées. Ces informations enregistrées sont appelées historique de géotraitement. Ces informations historiques sont très utiles pour déterminer comment les données ont été créées et comment les utiliser pour exécuter de nouveau un processus. Les informations historiques sont stockées à trois endroits :

1. La fenêtre Résultats. C'est le premier emplacement où rechercher un historique des outils exécutés et les résultats correspondants.
2. Un fichier journal d'historique qui contient des informations sur chaque opération de géotraitement. Les informations contenues dans le fichier journal sont essentiellement les mêmes que celles se trouvant dans la fenêtre Résultats.
3. Les métadonnées des données en sortie d'un outil, ou dans les données en entrée de l'outil si ce dernier modifie les données en entrée.

Les informations concernant l'exécution des outils dans des modèles ne sont pas enregistrées dans le fichier journal d'historique. Toutefois, les métadonnées sont mises à jour par l'exécution des outils dans des modèles.

Remarque :

La journalisation peut affecter les performances des outils, en particulier dans les modèles qui utilisent les itérateurs. Vous pouvez par exemple avoir un modèle qui exécute l'outil Ajouter des milliers de fois en ajoutant des entités à la même classe d'entité. Si la journalisation est activée, chaque itération dans le modèle actualise les métadonnées de la classe d'entité, ce qui ralentit les performances du modèle.

Dans le cas d'outils de script et de scripts autonomes (les scripts exécutés en dehors d'une application ArcGIS, à partir de l'invite du système d'exploitation, par exemple), il est possible d'activer la consignation dans l'historique à l'aide de la fonction SetLogHistory, comme il est indiqué dans l'extrait de code Python suivant :

import arcpy
arcpy.SetLogHistory(True)

Chaque exécution d'un outil dans le script est alors consignée.

Activation de la consignation dans l'historique

Pour activer l'écriture de fichiers journaux d'historique, procédez comme suit :

1. Dans la barre d'outils Standard, cliquez sur Géotraitement > Options de géotraitement.
2. Activez (cochez) la case Consigner les opérations de géotraitement dans un fichier journal.

Fichiers journaux d'historique

Emplacement des fichiers journaux d'historique

Un seul fichier journal est créé pour chaque session d'une application (ArcMap ou ArcCatalog, par exemple). Une session représente toutes les tâches exécutées entre l'ouverture et la fermeture de l'application.

Sur Windows XP, les fichiers journaux sont écrits dans C:\Documents and Settings\<user name>\Application Data\ESRI\Desktop10.2\ArcToolbox\History.

Sur Windows Vista et Windows 7, les fichiers journaux sont écrits dans C:\Users\<user name>\AppData\(Local or LocalLow or Roaming)\ESRI\Desktop10.2\ArcToolbox\History.

Le nom du fichier journal contient la date et l'heure d'ouverture de l'application : H<month><day><year>_<hour><minute><second>.xml.

Contenu du fichier journal

Le fichier journal est un fichier XML (eXtensible Markup Language) que vous pouvez afficher dans un navigateur Web comme Internet Explorer. Pour ouvrir le fichier, vous pouvez le placer dans votre navigateur par glisser-déposer ou cliquer sur Fichier > Ouvrir. L'illustration suivante montre un fichier journal affiché dans Internet Explorer.

Les informations concernant l'exécution d'un outil se trouvent entre les balises <ResultView> et </ResultView>. Si vous consultez le fichier journal d'historique dans un navigateur, vous pouvez réduire ou développer les balises en cliquant sur - ou +, comme indiqué ci-dessous.

Une balise <ResultView> contient toutes les informations concernant l'exécution d'un outil.

La structure et le contenu dans chaque balise sont évidents. Quelques remarques concernant les balises :

<ToolSource>

Indique le chemin d'accès du catalogue à la boîte à outils contenant l'outil.

<Parameter>

La balise de paramètre comporte deux attributs, Label et Type.

• Label est l'appellation du paramètre indiquée dans la boîte de dialogue de l'outil.
• Type contient un type parmi les trois possibles :
  • Dataset signifie que la valeur est le chemin d'accès du catalogue à un jeu de données sur le disque.
  • Layer signifie que la valeur est le nom d'une couche dans la table des matières d'ArcMap. Le jeu de données auquel la couche fait référence est indiqué dans la balise <LayerInfo>.
  • Scalar contient toutes les autres valeurs, notamment des chaînes, des nombres ou des unités linéaires.

<LayerInfo>

Dans <LayerInfo>, une balise <Layer> est associée à chaque couche utilisée dans l'exécution d'un outil. La balise <Layer> indique le nom de la couche comme attribut et le chemin d'accès du catalogue au jeu de données utilisé par la couche.

<Environments>

La balise <Environments> comporte des balises <Environment> contenant les paramètres d'environnement pendant l'exécution d'un outil. Chaque balise <Environment> comporte un attribut de nom contenant le nom et le paramètre d'environnement. Seuls les paramètres d'environnement contenant des valeurs sont indiqués. Autrement dit, il n'y aura pas de balise <Environment> pour des paramètres ne contenant aucune valeur.

<Errors>

Si des erreurs se sont produites pendant l'exécution d'un outil, elles sont répertoriées ici. Les erreurs système internes sont également répertoriées ici, contrairement aux messages écrits dans la boîte de dialogue de progression ou aux résultats de la fenêtre Résultats.

Historique de géotraitement dans les métadonnées

Chaque outil de géotraitement créant de nouvelles données en sortie ou mettant à jour les données en entrée ajoute des métadonnées concernant l'exécution de cet outil. Ces données comprennent le nom de l'outil, son emplacement et les paramètres utilisés. Ce comportement peut être désactivé dans les applications bureautiques en désélectionnant l'option Consigner les opérations de géotraitement dans un fichier journal qui se trouve dans la boîte de dialogue Géotraitement > Options de géotraitement. Dans un script Python, la journalisation de l'historique de géotraitement peut être désactivée à l'aide de la fonction SetLogHistory.

Les métadonnées pour un jeu de données s'affichent en cliquant avec le bouton droit sur un jeu de données dans la fenêtre Catalogue ou dans ArcCatalog et en choisissant Description d'élément.

Remarque :

Pour que la fenêtre Description d'élément affiche des métadonnées, vous devez d'abord choisir un style de métadonnées qui affichera l'historique de géotraitement. Pour modifier le style de métadonnées, suivez les instructions de la rubrique Choix d'un style de métadonnées et définissez le style sur n'importe quelle valeur, exceptée Description d'élément (le style par défaut).

Après avoir modifié le style de métadonnées, vous pouvez cliquer avec le bouton droit un jeu de données et choisir Description d'élément. Une section dédiée au géotraitement s'affichera dans la fenêtre Description d'élément.