ArcMap

Python アドインの基本的な概念

このドキュメントでは、Python を使用したアドインの作成方法を理解するために必要な概念を説明します。

Python アドイン ウィザード

アドインの開発を簡単に行うために、Python アドイン ウィザードを使用してカスタマイズのタイプを指定することをお勧めします。Python アドイン ウィザードは、アドインの動作に必要なファイルとフォルダーを自動的に作成することで、開発時間を短縮してエラーが発生する可能性を小さくします。

Python アドイン ウィザードをダウンロードします。

ダウンロード ファイルは、ウィザードをサポートするために必要なすべてのファイルを含む圧縮された ZIP ファイル (*.zip) です。ウィザードを使用するには、圧縮ファイルの内容をフォルダーに展開して、addin_assistant.exe という名前の実行可能ファイルを bin フォルダーに配置する必要があります。この実行可能ファイルをダブルクリックすると、ウィザードが起動されます。Python アドイン ウィザードの使用例は、アドインを作成するトピックで説明しています。

ファイルとフォルダーの構造

アドインは、扱いやすいように 1 つの圧縮ファイルにパッケージ化されたファイルとフォルダーのコレクションです。ユーザーと ESRI ArcGIS Add-In Installation Utilityがアドインを簡単に識別できるように、「.esriaddin」の拡張子が付けられています。たとえば、アドインを Windows エクスプローラー、Web サイト、または電子メール内でダブルクリックすると、Add-In Installation Utilityが自動的にアドインをコンピューターにインストールし、事前設定されたフォルダーに配備します。

ESRI ArcGIS Add-In Installation Utility

アドイン アーカイブのルート レベルには、config.xml ファイルが配置されています。このファイルはアドインを説明する情報を含み、カスタマイズを宣言します。このファイルは、[保存] ボタンを押したときに Python アドイン ウィザードによって作成され、アドインを表す情報 (ArcGIS 製品、キャプション、ツールチップ、ヘルプ情報、画像、レイアウトの詳細など) をすべて含みます。

アドインには Install フォルダーも用意されます。Install フォルダーの主な目的は、アドインの Python スクリプト (動作する部分) を格納することです。たとえば、ボタンは構成ファイルで宣言されますが、ボタンのカスタム動作は関連付けられた Python スクリプトで定義されます。

Install フォルダーにはフォルダーおよびファイルを追加作成できます。これらのファイルとフォルダーは、データをアドインの一部として含める場合に役立ちます。このデータには、レイヤー ファイル、ツールボックス、*.xml ファイルなどを含めることができます。インストール場所内に配置したデータにアクセスするには、組み込み関数の __file__ を利用します。次の例は、インストール フォルダー内に作成した data フォルダーのレイヤー ファイルにアクセスする方法を示しています。

eq_layer = os.path.join(os.path.dirname(__file__), r'data\earth_quakes.lyr')

宣言されるほとんどのアドイン タイプには、グラフィックスが関連付けられています。ウィザードを利用して入力されたすべてのグラフィックスは、構成ファイル内で参照され、アーカイブのルート レベルにある Images フォルダーにコピーされます。

次の図は、アドイン ファイル (*.esriaddin) のファイルおよびフォルダー構造を示しています。

ファイルとフォルダーの構造

makeaddin.py

makeaddin.py Python ファイルは、Python アドイン ウィザードによって作成されるユーティリティ スクリプトで、プロジェクト フォルダー内のファイルとフォルダーを圧縮されたアドイン ファイルにパッケージ化するために使用されます。このファイルをダブルクリックすると、アドイン ファイルが作成されます。アドインに変更を加えるごとに、このスクリプトを実行して最新の更新を含むアドイン ファイルを再パッケージ化する必要があります。

事前設定されたフォルダーの場所

アドインは ArcGIS Desktop を起動したときに、ユーザーごとまたはデスクトップごとの事前設定されたフォルダーで自動的に検出されます。たとえば、次のように指定します。

  • Vista/7: C:\Users\<ユーザー名>\Documents\ArcGIS\AddIns\Desktop10.1
  • XP: C:\Documents and Settings\<ユーザー名>\My Documents\ArcGIS\AddIns\Desktop10.1

アドインは、ESRI ArcGIS Add-In Installation Utility と [アドイン マネージャー] ダイアログ ボックスを使用して、自動的に追加および削除されます。ArcGIS Desktop 内の [アドイン マネージャー] ダイアログ ボックスでも、独自の事前設定されたフォルダーを追加してネットワーク共有にすることができます。

アドイン マネージャーの [オプション] タブ

また、アドインは Install フォルダーの内容を自動的に一時フォルダーに解凍します。たとえば、次のように指定します。

  • Vista/7: C:\Users\<ユーザー名>\AppData\Local\ESRI\Desktop10.1\AssemblyCache
  • XP: C:\Documents and Settings\<ユーザー名>\Local Settings\Application Data\ESRI\Desktop10.1\AssemblyCache

アドイン フレームワークは、アドインがシステムからインストール解除されていることを検出すると、このデータを自動的に削除します。