スクリプト ツールでのメッセージの書き込み

ツールを実行するときに、ArcPy は呼び出し元のアプリケーション(ArcMapArcCatalog)を完全に認識しています。この結果、Python を使用してメッセージを書き込むと、メッセージが進捗ダイアログ ボックス、[結果] ウィンドウでのツールの結果、および [Python] ウィンドウに自動的に表示されます。したがって、ツールを呼び出したモデルまたはスクリプト ツールも、書き出されたメッセージにアクセスすることができます。

メッセージの詳細については、「スクリプト ツールのメッセージの概要」をご参照ください。

ツールの実行中に書き込まれるメッセージは、ジオプロセシング関数を使用して取得することができます。メッセージを書き込むための ArcPy 関数には、次の 4 つがあります。

AddIDMessage() を呼び出すと、短いメッセージとメッセージ ID が表示されます。メッセージ ID は、問題の原因と解決策の説明へのリンクです。AddError() または AddIDMessage() を使用してエラー メッセージを追加する場合は、次のように処理されます。

メッセージの追加の例

以下の例では、入力が評価され、入力フィーチャが含まれていない場合はツールにエラー メッセージが追加され、ツールを終了するために arcpy.ExecuteError 例外が発生します。

import arcpy
input = arcpy.GetParameterAsText(0)
output = arcpy.GetParameterAsText(0)
       
# If the input has no features, add an error message, and raise
#  an arcpy.ExecuteError
if int(arcpy.GetCount_management(input).getOutput(0)) == 0:
    arcpy.AddError("{0} has no features.".format(input))
    raise arcpy.ExecuteError

関連トピック

9/14/2013