Python アドインアプリケーションエクステンションの作成—ヘルプ

Python アドインアプリケーションエクステンションの作成

Python アドインアプリケーションエクステンションの作成

アプリケーションエクステンションは、ArcGIS for Desktop を補足する機能をさまざまな方法で提供できます。

アプリケーションエクステンションは、多くの場合、類似タスクを実行する関連機能のセットをグループ化するために使用されます。たとえば、ArcMap のエクステンションには ArcGIS 3D Analyst エクステンションや Business Analyst エクステンションなどがあります。
アプリケーションエクステンションは、通常、ホストアプリケーションによって公開されるさまざまなイベントをリスニングし、これらに応答します。たとえば、レイヤが追加または削除されるとイベントがトリガされ、エクステンションはこれに応答してマップドキュメントを自動的に保存します。
アプリケーションエクステンションを使用して、アドインを含むコンポーネント（ボタンやツール）間でアクティビティティを調整します。たとえば、マップに特定のレイヤセットが追加されていない場合は、ツールバー上のツールセットを有効化しないようにできます。

アプリケーションエクステンションは、必要なときに読み込むように、または関連付けられたアプリケーションの起動時に自動的に読み込むように構成できます。[カスタマイズ] メニューに配置される標準的な ArcGIS の [エクステンション] ダイアログボックスに表示するように、エクステンションを構成することもできます。

このトピックでは、アプリケーションエクステンションを作成する方法を手順に従って説明します。このワークフローを開始する前に、ArcMap のアドインプロジェクトを作成して、プロジェクト設定を指定していることを確認してください。詳細については、「アドインプロジェクトの作成」をご参照ください。このワークフローでは ArcMap のエクステンションを作成する方法を説明しますが、他の ArcGIS for Desktop アプリケーションでも、メニューの作成方法に違いはありません。このトピックでは、ドキュメントを開くごとに、または新しいドキュメントを作成するごとに ArcMap にベースレイヤを追加するエクステンションの作成手順を検証します。その後、Python アドインウィザードで作成された Python クラスを詳しく検証して、エクステンションに機能を提供するプロパティとメソッドを確認します。

アドインアプリケーションエクステンションを作成する処理は、以下の 2 つの手順で構成されます。

アプリケーションエクステンションを作成します。

必要なプロジェクト設定を入力したら、[アドインのコンテンツ] タブをクリックします。まず、[エクステンション] を右クリックして [新規エクステンション] をクリックします。

エクステンションには多くのプロパティを入力できます。以下のリストに、すべてのプロパティとその説明を示します。これらのプロパティは、プロジェクトの config.xml ファイルに格納されます。

プロパティ	説明
名前（必須）	アプリケーションエクステンションの名前を表します。次の画面に示すように、デスクトップアプリケーションの [エクステンション] ダイアログボックスで使用される名前です。
クラス名（必須）	エクステンションを表す Python クラス。Python クラスは、エクステンションのビジネスロジックを書き込む場所です。このクラスは、アプリケーションエクステンションがデスクトップアプリケーションで使用されるときに呼び出されるため重要です。クラスを構築するときは、Python の命名規則を使用します。Python クラスでは、各単語の先頭を大文字にする表記法が使用されます。この例では、AddBaseLayer という名前のクラスを作成します。
ID（必須）	エクステンションを識別するための一意の名前です。1 つのプロジェクトに複数のエクステンションを作成することができるため、この ID を使用して各アプリケーションエクステンションを区別します。デフォルトの ID を、意味のある値に置き換えると理想的です。ID にスペースを含めることはできません。単語を区切る場合はアンダースコアを使用してください。Python のキーワードも使用しないでください。予約語については、Python のドキュメントをご参照ください。アドインの名前空間が ID の前に付加されます。名前空間は config.xml ファイルに格納されます。
説明（オプション）	アプリケーションエクステンションの目的を説明します。たとえば、3D Analyst エクステンションはサーフェスモデリングと 3D ビジュアライゼーションのツールを提供します。説明は [エクステンション] ダイアログボックスの下部に表示されます。
自動的に読み込む（オプション）	デスクトップアプリケーションを開いたときに、アプリケーションエクステンションを読み込むことができます。デフォルトで、このチェックボックスはオンです。このチェックボックスがオンの場合、Python スクリプトの enabled プロパティが True に設定されます。

プロパティの入力が完了したら、ウィザードの下部にある [保存] ボタンをクリックします。これにより、必要なすべてのファイルとフォルダが作業フォルダに作成されます。

Python スクリプトを編集します。
続いて Python スクリプトを編集し、マップドキュメントを開くか作成するごとにベースレイヤを追加する機能を含むように Python クラスを更新します。この処理は、ArcMap の openDocument および newDocument イベントをリスニングし、これらに応答することで行います。カスタムエクステンションに機能を追加するには、以下の手順を実行します。
1. 作業フォルダ内の Install フォルダにある、ウィザードが作成した Python スクリプトを編集します。
  ウィザードで入力した名前と同じ名前のクラスが存在します。クラス名は config.xml で参照されているため、このクラス名は変更しないでください。エクステンションクラス内の各関数の詳細については、「エクステンションクラス」をご参照ください。
2. newDocument および openDocument イベント関数を、以下のように更新します。
  このコードは、ベースレイヤが存在しない場合に、アクティブデータフレームにベースレイヤを追加する機能を提供します。
```
def newDocument(self):

    """
    Adds a base layer if it is not already added to the active data frame of the map.
    """

    # Provide a layer file and the layer name as it would appear in the Table of contents. 
    base_layer = r'C:\GISData\module5\World_Street_Map.lyr'
    base_layer_name = 'World Street Map'
    mxd = arcpy.mapping.MapDocument('current')
    active_view = mxd.activeView
    df = arcpy.mapping.ListDataFrames(mxd, active_view)[0]
    if arcpy.mapping.ListLayers(mxd, base_layer_name) == []:
        arcpy.mapping.AddLayer(df, arcpy.mapping.Layer(base_layer))
        arcpy.RefreshTOC()
    else:
        return   
	
def openDocument(self):
    """
    Adds a base layer if it is not already added to the active data frame of the map.
    """

    base_layer = r'C:\GISData\module5\World_Street_Map.lyr'
    base_layer_name = 'World Street Map'
    mxd = arcpy.mapping.MapDocument('current')
    active_view = mxd.activeView
    df = arcpy.mapping.ListDataFrames(mxd, active_view)[0]
    if arcpy.mapping.ListLayers(mxd, base_layer_name) == []:
        arcpy.mapping.AddLayer(df, arcpy.mapping.Layer(base_layer))
        arcpy.RefreshTOC()
    else:
        return
```
3. 実装していないすべての関数をスクリプトから削除します。
  実装されていないすべての関数をスクリプトから削除する必要があります。これらの関数がアプリケーションから呼び出されないことを保証します。
4. スクリプトを保存します。
アプリケーションエクステンションをテストします。
アプリケーションエクステンションを作成してスクリプトコードを追加したら、共有する前にアドインファイルを作成してテストすることが重要です。これらの手順については、「アドインのテスト」をご参照ください。
アプリケーションエクステンションを配備および共有します。
アドインの配備と共有の手順については、「アドインの共有とインストール」をご参照ください。

Python アドイン アプリケーション エクステンションの作成

関連トピック

Python アドインアプリケーションエクステンションの作成