アドインは、開発者またはユーザーが「ArcGIS Pro SDK 3.2 for .NET」を使用して作成するカスタム機能です。 アドインは ArcGIS Pro とシームレスに統合されています。 多くの場合、アドインを使用してユーザー インターフェイスをカスタマイズし、新しい 1 つのツールまたは一連のツールを提供します。アドインは、[アドイン] リボン タブ、その他のタブ、またはカスタム ウィンドウなどのアプリケーションの他の領域に表示されます。
注意:
ArcGIS Pro 3.0 以降のリリースでは、ArcGIS Pro SDK 3.0 以降のバージョンでコンパイルされたアドインのみが読み込まれます。 詳細については、「ProConcepts 3.0 Migration Guide」をご参照ください。
アドインは、拡張子が .esriAddInX の 1 つの圧縮ファイルとしてパッケージ化されています。 このファイルは、電子メールで送信したり、ポータルからダウンロードしたり、他の通常のファイルと同様にやり取りしたりできる単純なファイル タイプです。
アドインは、インストール ユーティリティを使用してデフォルトのローカル フォルダーにインストールするか、既知のフォルダーとして指定されたフォルダーから読み込むことができます。 両方の方法を後続のセクションで説明します。 アドインの表示と削除は、ArcGIS Pro の [設定] ページで [アドイン マネージャー] を使用して行います。
アドインには独自の機能が備わっていますが、セキュリティ上のリスクをもたらしたり、ソフトウェアの動作を不安定にしたりすることもあります。 アドインの提供元を確認し、信頼できるかどうかを判断することが重要となります。
ユーザー独自のアドインを作成するには、ArcGIS Pro SDK が必要です。 ArcGIS Developer サイトには、「初めてアドインを作成」する際に役立つチュートリアルが用意されています。
インストール ユーティリティを使用してアドインをインストール
インストール ユーティリティを使用してアドインをインストールすると、そのアドインはデフォルトの場所 (%System Drive%\Users\<username>\Documents\ArcGIS\AddIns\ArcGISPro) にコピーされます。 このユーティリティは、ファイルをコピーする前に、それよりも新しいバージョンのアドインがその場所にまだ存在しないことを確認します。
- コンピューターまたはネットワーク ドライブ上のアドイン ファイル (*.esriAddInX) のフォルダーの場所を参照します。
- 該当するファイルをダブルクリックして、[Esri ArcGIS アドイン インストール ユーティリティ] ウィンドウを開きます。
[Esri ArcGIS アドイン インストール ユーティリティ] ウィンドウに記載されている情報を確認します。
- 続行するには、[アドインのインストール] をクリックします。
該当するアドインがデフォルトの場所にコピーされてからインストールされます。 ファイルのコピーはそのファイルを参照した場所にまだ存在します。
- ArcGIS Pro が開いたら、一度終了してから再起動します。
これで、インストールしたアドインを使用できるようになります。
注意:
アドインが ArcGIS Pro 2.x バージョン向けに記述されている場合、警告プロンプトが表示されます。 インストールを続行した場合、アドインはデフォルトの場所にコピーされますが、読み込まれません。
既知のフォルダーからアドインを読み込み
ローカル フォルダーまたはネットワーク フォルダーをアドインの既知の場所として指定できます。 起動時に、ArcGIS Pro はこのフォルダーをチェックし、この場所にあるすべてのアドインを自動的に読み込みます。
ネットワーク ドライブ上の既知のフォルダーを指定する方法は、作業環境に存在する多数のユーザーが同じアドインを使用することになるので非常に便利な方法です。 一方で、ArcGIS Pro の起動時間が遅くなることがあります。 ネットワーク フォルダーを使用する場合は、ルート フォルダーのサブフォルダーを使用し、そのサブフォルダーにアドイン ファイルだけを格納することをお勧めします。
- 次のいずれかの方法で、ArcGIS Pro の設定ページを開きます。
- 開いているプロジェクトのリボンで [プロジェクト] タブをクリックします。
- 開始ページで [設定] タブ
をクリックします。
- サイド タブのリストにある [アドイン マネージャー] をクリックします。
- [アドイン マネージャー] で [オプション] をクリックします。
- [オプション] タブで、[フォルダーの追加] をクリックします。
- 参照ダイアログ ボックスで、既知のフォルダーとして指定するフォルダーを参照します。
- 該当するフォルダーをクリックして選択します。 [OK] をクリックします。
そのフォルダーへの絶対パスが既知のフォルダーのリストに表示されます。
注意:
デフォルトでは、このオプションが選択されているため、既知のフォルダーに存在するアドインがすべて読み込まれます。 Esri が提供しているアドインだけを読み込む場合や信頼できる公開者のデジタル署名があるアドインだけを読み込む場合は、別のオプションを選択できます。
- ArcGIS Pro を終了します。
- File Explorer を使用して、1 つまたは複数の .esriAddInX ファイルをディスク上の場所にある既知のフォルダーにコピーします。
- ArcGIS Pro を起動します。
既知のフォルダーに格納されているアドインが読み込まれます。 ArcGIS Pro を起動するごとに、このフォルダーのチェックが行われ、新しく追加されたアドインや削除されたアドインがないかが確認されます。
ヒント:
既知のフォルダーの使用を中止する場合は、既知のフォルダーのリスト内の該当するフォルダーをクリックしてから、[フォルダーの削除] をクリックします。 ArcGIS Pro を再起動します。
アドインの表示
[アドイン マネージャー] で使用可能なアドインを確認できます。
- 次のいずれかの方法で、ArcGIS Pro の設定ページを開きます。
- 開いているプロジェクトのリボンで [プロジェクト] タブをクリックします。
- 開始ページで [設定] タブ をクリックします。
- サイド タブのリストにある [アドイン マネージャー] をクリックします。
- [アドイン マネージャー] の [アドイン] タブでアドインをクリックすると、そのアドインに関する情報が表示されます。
アドインの削除
アドインが不要になった場合は削除できます。 インストール済みのアドインを削除すると、そのアドインが ArcGIS Pro からアンインストールされ、.esriAddInX ファイルがシステムのゴミ箱に移されます。
注意:
[アドイン マネージャー] を使用して、ネットワーク ドライブ上の既知のフォルダーから読み込まれたアドインを削除する場合は、.esriAddInX ファイルが完全に削除されます。これは、File Explorer を使用してディスク上の場所からファイルを削除する場合とまったく同じです。
- [アドイン マネージャー] を開いて、上記の「アドインの表示」セクションに記載されている通りにアドインを選択します。
- [このアドインを削除] をクリックします。
該当するアドインには削除対象のマークが付けられますが、現在の ArcGIS Pro セッションでまだ使用できます。
- ArcGIS Pro を終了して再起動します。
該当するアドインがアンインストールされ、[アドイン マネージャー] から削除されます。
注意:
[アドイン マネージャー] の [共有アドイン] 見出しに表示されているアドインは、ソフトウェア管理者が管理しているため、削除することができません。 詳細については、後続の「管理設定の実行」セクションをご参照ください。
アドインの無効化
アドインのインストール後に、ArcGIS Pro が予期しない動作をしたり、動作を停止したりした場合は、特殊なパラメーターで Windows コマンド プロンプトから ArcGIS Pro を起動して、アドインを無効にすることができます。 アドインを無効にするとソフトウェアが正常に動作する場合は、1 つ以上のアドインの削除が必要になることもあります。
アドインを無効にするには、次のコマンドを使用してコマンド ラインから ArcGIS Pro を起動します。
"%ProgramFiles%\ArcGIS\Pro\bin\ArcGISPro.exe" /disableaddins
[アドイン マネージャー] にアドインが表示されなくなります。 アドインをもう一度有効にするには、通常通りに ArcGIS Pro を終了して再起動します。
管理設定の実行
ソフトウェア管理者として、ユーザーがアドインにアクセスしないようにレジストリに編集を加え、既知のフォルダーを指定し、アドインのセキュリティ レベルを設定することができます。
Windows レジストリ エディターの HKEY_LOCAL_MACHINE > SOFTWARE > ESRI > ArcGISPro > Settings で、[Add-In Folders] キーを作成し、文字列値を使用して既知のフォルダーを指定します。 これらのフォルダーに配置されているアドイン ファイルが [アドイン マネージャー] に共有アドインとして表示されます。 このようにレジストリに編集を加える方法の詳細については、「ArcGIS Pro レジストリ キー」をご参照ください。