ツール実行履歴の表示
ジオプロセシング ツールを実行するたびに、ツールとそのパラメータに関する情報が保存されます。この保存された情報はジオプロセシング履歴と呼ばれます。この履歴情報は、どのようにしてデータが作成されたかを確認する場合に非常に便利で、処理を再実行するために使用できます。この履歴情報は次の 3 つの場所に格納されます。
- 結果ウィンドウ。実行されたツール名とその実行結果の履歴を確認するための最初の場所になります。
- 履歴ログ ファイルには、各ジオプロセシング操作に関する情報が書き込まれます。このログ ファイルに含まれる情報は、基本的に、結果ウィンドウに表示される情報と同じです。
- ツールの出力データのメタデータ。
モデル内部で実行されたツールに関する情報は記録されません。
スクリプト ツールおよびスタンドアロン スクリプト(オペレーティング システムのプロンプトなど、ArcGIS アプリケーション以外から実行されるスクリプト)については、SetLogHistory 関数を使用して履歴ログを有効にできます。Python コード例を以下に示します。
import arcpy
arcpy.SetLogHistory(True)
この場合、スクリプト内から実行される各ツールのログが有効になります。
履歴ログの有効化
履歴ログ ファイルの書き込みを有効にするには、次の手順を実行します。
- [標準] ツールバーで、[ジオプロセシング] → [ジオプロセシング オプション] の順にクリックします。
- [ジオプロセシング操作をログ ファイルに保存] チェックボックスをオン(有効)にします。
履歴ログ ファイル
履歴ログ ファイルの書き込み先
ArcMap や ArcCatalog などのアプリケーションのセッションごとに、1 つのログ ファイルが存在します。アプリケーションを開いた時点から終了する時点までに実行されたすべての作業によって、セッションが定義されます。
Windows XP では、ログ ファイルは C:\Documents and Settings\<ユーザ名>\Application Data\ESRI\Desktop10.1\ArcToolbox\History に書き込まれます。
Windows Vista および Windows 7 では、ログ ファイルは C:\Users\<ユーザ名>\AppData\(Local or LocalLow or Roaming)\ESRI\Desktop10.1\ArcToolbox\History に書き込まれます。
ログ ファイルの名前には、アプリケーションを開いたときの日時が含まれています。H<月><日><年>_<時><分><秒>.xml
ログ ファイルのコンテンツ
ログ ファイルは XML(Extensible Markup Language)ファイルであるため、Internet Explorer などのインターネット ブラウザで表示するのが最も便利です。ファイルをドラッグしてブラウザにドロップするか、あるいはブラウザで [ファイル] → [開く] の順にクリックします。次の図は、Internet Explorer に表示されたログ ファイルを示しています。
個々のツールの実行に関する情報は、<ResultView> タグと </ResultView> タグの間にあります。ログ ファイルをブラウザに表示しているときは、- または + をクリックして、タグを折りたたんだり展開したりできます。
各タグ内の構造およびコンテンツは、説明の必要がないものばかりです。一部のタグに関する注意は以下のとおりです。
<ToolSource>
ツールを含んでいるツールボックスへのカタログ パスです。
<Parameter>
パラメータ タグには Name と Type の 2 つの属性があります。
- Label は、ツールのダイアログ ボックスに表示される、パラメータのラベルです。
- Type には次の 3 つのタイプのうちのいずれか 1 つが含まれます。
- Dataset は、値がディスク上のデータセットへのカタログ パスであることを示します。
- Layer は、値がコンテンツの ArcMap テーブル内のレイヤの名前であることを示します。このレイヤが参照するデータセットは <LayerInfo> タグ内にあります。
- Scalar には、文字列、数字、距離単位など、その他すべての値が含まれます。
<LayerInfo>
ツールの実行で使用されるレイヤごとに、<LayerInfo> 内に 1 つの <Layer> タグが存在します。<Layer> タグには、属性としてレイヤ名が含まれるとともに、そのレイヤによって使用されるデータセットへのカタログパスが含まれます。
<Environments>
<Environments> タグ内には、ツール実行時の環境設定を含む個別の <Environment> タグが存在します。各 <Environment> タグには、環境名と環境設定を含む名前属性が含まれます。値を保持している環境設定のみが一覧表示されます。つまり、空白値の設定には <Environment> が存在しません。
<Errors>
ツール実行時にエラーが発生した場合は、このタグにエラーが表示されます。進捗状況ダイアログ ボックスに書き込まれるメッセージや結果ウィンドウ内の結果とは異なり、このタグには内部システム エラーが表示されます。
メタデータのジオプロセシング履歴
新しい出力データを作成したり、入力データを更新したりするジオプロセシング ツールが実行されるたびに、そのジオプロセシング ツールの実行に関するメタデータ(ツール名、ツールの場所、使用パラメータなど)追加されます。
データセットのメタデータを表示するには、カタログ ウィンドウまたは ArcCatalog でデータセットを右クリックし、[アイテム説明] を選択します。
[アイテム説明] ウィンドウにメタデータが表示されるようにするには、ジオプロセシング履歴が表示されるメタデータ スタイルを先に選択しておく必要があります。メタデータ スタイルを変更する場合は、「メタデータ スタイルの変更」の手順に従って、スタイルを [アイテム説明](デフォルトのスタイル)以外の値に設定します。
メタデータ スタイルの変更後に、データセットを右クリックして、[アイテム説明] を選択すると、[アイテム説明] ウィンドウにジオプロセシングのセクションが表示されます。