Web ツールを作成するには、作成の手順と共有の手順が必要です。 作成のプロセスでは、まず ArcGIS Pro で、モデルや Python スクリプト ツールを作成します。 ツールを作成し、正常に実行したら、Web ツールとして ArcGIS Enterprise ポータルで共有できます。 作成と共有の際には、一部のデータ、ツール パラメーター、共有権限について、考慮する必要があります。 このような考慮事項については、次の例と、本トピックの関連セクションに記載しています。 全体的なプロセスは、以下のワークフローで構成されます。
- ツールボックスのツールを使用して、スクリプトやモデルを構築し、ワークフローを構成します。
- ツールに必要なデータセットを収集し、ジオデータベースで使用可能にするか、プロジェクトのマップに追加します。
- ツールを実行し、ジオプロセシング履歴に、正常なエントリを作成します。
- 必要であれば、マップに出力データセットのシンボルを設定します。
- 履歴アイテムを Web ツールとして共有します。 Web ツールを共有するときに、ツールとサービスのツール プロパティを設定できます。
例: 計画案のパイプラインが住民に与える影響の調査
次のモデル ツールは、パイプラインに漏れが発生した場合に、影響を受ける人数を調査するツールのコレクションです。 このワークフローでは、パイプラインと河川との交差部分を探し、下流解析を行って、影響を受ける人数を調べます。 このモデルは、プロジェクト データとパラメーターで設定され、Web ツールとして公開されます。この場合、アナリストや一般の人が計画案のパイプライン ルートを変更し、漏れによる下流の住民への影響を確認できます。 Web ツールの結果には、パイプラインが河川と交差する部分と、影響を受ける人口のサマリーが表示されます。
ツールの設計
実用的なツールには、入力パラメーターと出力パラメーターが必ずあります。 これらのパラメーターを使用すると、ツールを実行するたびに、別の値を指定できます。そうすると、ツールは、別の解析結果を返します。 入力パラメーターと出力パラメーターに加え、ツールにはプロジェクト データと中間データもあります。 これらは通常、ツールの実行者がコントロールできないデータセットです。 モデルでは、入力パラメーターには [P] とマークが付けられます。 モデルをツールとして実行すると、[P] が付いた入力がツールのダイアログ ボックスに表示され、ツールの実行時に使用される値を設定できます。 パイプライン モデルでは、下流解析を実施する際のパイプライン経路と、バッファー距離を指定できます。 誰かがこのツールを使用すると、パイプラインの場所とバッファーのサイズが変更され、パイプラインによって、最終的に影響を受ける人数が表示されます。 この例に示す、パイプラインの交差部とトレース ラインは、モデル ツールの実行時に生成される中間データセットです。 これらの中間データセットは、ツールの実行者には必要ないため、結果として返されません。 モデルが共有されると、Web ツールを動作させるジオプロセシング サービスは、中間データの書き込み先を指定し、最終的に中間データが必要なくなったら、消去します。
すべての有効なツールにとって、入力パラメーターは重要ですが、それと同様に、出力パラメーターも重要です。 出力パラメーターを使用すると、ツールから実行者に結果が返されます。 ArcGIS Pro では、出力パラメーターは重要です。これらのデータセットは、マップに自動的に追加されるからです。 出力パラメーターのないツールでも出力は生成しますが、この情報は自動的に表示されません。 Web ツールもほぼ同じように動作します。つまり、エンド ユーザーに結果を返すには、1 つ以上の出力パラメーターが必要です。 パイプライン モデルでは、2 つの出力パラメーターが存在します。1 つは、下流のバッファーの場所を示す影響エリアの人口、もう 1 つは、影響を受ける人口全体のサマリーを示す人口サマリー テーブルです。 [impact areas population] は、中間データでもあり、出力データでもあります。 このパラメーターが中間であるのは、[統計サマリー (Summary Statistics)] ツールで必要ではあるものの、モデル パラメーター ([P]) として定義されているため、ツールが正常に完了したときに、この結果がクライアントに返されるからです。
ヒント:
スクリプト ツール の作成時にも、ツールの入力および出力パラメーター、プロジェクト データ、中間データの原則が該当します。
ツールのドキュメント化
ツールができるだけ幅広い層のユーザーに検出、理解、使用されるようにするには、Web ツールの作成方法をドキュメント化することが必要不可欠です。 効果的なドキュメント化は、まずオリジナル ツールから始めます。 モデルやスクリプト ツールにも、システム ツールと同じ種類のメタデータを提供できます。
ツールの実行
ツールが作成されたら、正常に実行する必要があります。 ツールを実行すると、ジオプロセシング履歴に、エントリが作成されます。 実行に失敗したツールは共有できません。
注意:
ModelBuilder でモデルを実行しても、[ジオプロセシング履歴] には、エントリは作成されません。 モデル ツールは、[ジオプロセシング] ウィンドウで、ツールとして実行する必要があります。
Web ツールの共有
Web ツールを共有するには、[解析] > [履歴] を選択して、[履歴] ウィンドウを開きます。 共有するアイテムを右クリックして、[共有] を選択します。 新しい Web ツールとして共有するには、[Web ツールとして共有] を選択して、[Web ツールとして共有] ウィンドウを開きます。 既存ツールを上書きするには、[Web ツールの上書き] を選択して、公開済みのすべての既存 Web ツールが [マイ コンテンツ] に表示されたウィンドウを開きます。
上書きする正しいツールを間違いなく選択して、[OK] をクリックすると、[Web ツールの上書き] ウィンドウが開きます。 先行して公開された Web ツールの構成プロセスは、次のように [Web ツールとして共有] と [Web ツールの上書き] で同様です。
または、[共有] > [Web ツール] を選択して、[Web ツールとして共有] または [Web ツールの上書き] を選択します。 [Web ツールとして共有] オプションを選択した場合は、問題なく動作しているアイテムがすべて表示されたツール共有ウィンドウから、いずれかのアイテムを選択します。
[Web ツールの上書き] オプションを選択した場合は、公開されている既存のツールが [マイ コンテンツ] に表示されたウィンドウから、上書きするアイテムを選択します。 続いて、問題なく動作しているアイテムがすべて表示されたウィンドウから、上書きするアイテムを選択します。 このワークフローの上書きの手順は、[解析] > [履歴] を選択した場合は、逆になります。
Web ツール プロパティの設定
漏出評価ツールは、フィーチャとテーブルを出力します。 このツールが生成して表示するデータ量にはサイズ制限があるため、Web ツールは、結果のマップ サービスのない非同期サービスとして設定されます。 デフォルトでは最大 1000 件のレコードですが、これで十分です。 メッセージ レベルを「エラー」にしておくと、ツール障害に関連するメッセージのみ表示できます。 Web ツールが正常に実行されると、通常の処理メッセージは、エンド ユーザーに返されません。
Web ツールは、常に [マイ コンテンツ] にあります。 ツールは、組織や全ユーザー、または特定のグループと共有できます。 漏出評価ツールは、組織内でパイプライン解析を実施する必要がある関係者と共有するには、優れたツールです。 適切なグループを選択すると、そのユーザーたちは、ツールを迅速に見つけ、使用することができます。
URL データのコピー、参照、または使用
ほとんどの Web ツールは、入力データまたはプロジェクト データが含まれます。 漏出評価モデルを Web ツールとして共有すると、入力データまたはプロジェクト データのいずれかが、[URL 以外のデータ] または [URL データ] であるかどうかを調べる必要があります。 [URL 以外] データをサーバーにコピーして、サービスが使用するデータの静的コピーを作成するか、データのコピーをスキップして、サービスがアクセスできる参照を作成することができます。 URL データは、サービス URL からの入力を指定します。
漏出評価モデルを Web ツールとして共有すると、プロジェクト データには、更新頻度が低い、静的な河川と人口のデータセットが含まれます。 これらのプロジェクト データをサーバーにコピーすることで解決できます。 公開処理により、データが収集され、必要に応じて、ファイル ジオデータベース フィーチャクラスに変換されます。それが、サーバーに抽出され、サービスによって使用されます。 この場合、[URL 以外のデータ] 見出しの下にある [すべてのデータをコピー] チェックボックスをオンにします。
解析方法が少し変更され、ユーザーが独自のパイプラインを提案しなかったとします。 パイプラインの代案は、別のプロセスから提案され、ユーザーがツールに異なる入力を提供しました。 このような場合は、計画案のパイプラインがプロジェクト データになります。 そのため、このデータセットをサーバーがアクセスできる UNC (Universal Naming Convention) パスで、エンタープライズ ジオデータベースまたはフォルダーに含め、ツールがデータセットを参照できるようにすることをお勧めします。 公開する際は、[URL 以外のデータ] 見出しの下にある [登録済みデータを参照] チェックボックスをオンにし、ArcGIS Server データ ストアを使用して、データへの参照を設定します。 公開プロセスにより、静的コピーを作成する代わりに、データベースまたはフォルダーへの参照が保持されます。 プロジェクト アナリストが後から、エンタープライズ ジオデータベースまたはフォルダーのデータを更新すると、Web ツールは、最新のパイプライン案に対して、解析を実施します。
その他の方法として、ユーザーのパイプラインに含まれず、更新頻度も低いフィーチャ データセットを指定し、Web フィーチャ レイヤー (フィーチャ サービス) またはフィーチャ サブレイヤーを含むマップ イメージ レイヤー (マップ サービス) からの入力を指定することもできます。 公開する際に、[フィーチャ レイヤーを変換] チェックボックスをオフにすると、処理時に URL データが保持されます。 このチェックボックスをオンにすると、公開時にデータがサーバーにコピーされ、ツールで使用される参照データが、サーバー上で静的になります。 入力がラスター データセットの場合、URL データに Web イメージ レイヤー (イメージ サービス) を指定します。 この場合、公開時に常に URL が維持されるため、[フィーチャ レイヤーを変換] チェックボックスをオンにする必要はありません。
入力モード
Web ツールとして共有すると、クライアントが Web ツール タスクに入力を指定する方法を決定することが重要であり、これは、パラメーターの入力モードと呼ばれます。 ツールのプロパティを構成するには、[コンテンツ] タブで、ツール名の横にある [ツールのプロパティの構成] ボタン をクリックします。
プロパティ ウィンドウで各パラメーターを展開し、それぞれの入力モードを構成します。 [入力モード] オプションで、[ユーザー定義値] を選択した場合、Web ツールの実行時に、クライアント側からデータが指定されるため、データに関する検討事項はありません。 [選択リスト] または [定数] オプションを選択した場合、データは、サーバー上のコピーまたは参照されたデータ、またはサービス URL のデータから指定されます。
Web ツールを公開すると、各入力および出力パラメーターのデフォルト値が、サーバーの REST エンド ポイントに表示されます。 パラメーターのデフォルト値を表示しない場合は、各パラメーターの [デフォルト値の削除] チェックボックスをオンにします。 すべてのパラメーターのデフォルト値を削除するには、[パラメーターの構成] 見出しの下にある [すべてのデフォルト値の削除] チェックボックスをオンにします。
解析
考えられる Web ツールを解析することで、ツールをポータルに、正常に公開できるようになります。 また、データに関する警告メッセージが表示されることもあるため、必要に応じて対応します。 漏出評価ツールには、データ ストアがすでに設定され、ツールがドキュメント化され、Web ツールで動作する対応ツールを使用しているため、警告やメッセージは表示されません。
公開
Web ツールのプロパティが設定され、分析ツールのエラーが解消されると、Web ツールをポータルに公開します。 統合し、サーバーに送信するデータの量によっては、数分かかることがあります。
Web ツールの使用
Web ツールは、[カタログ] ウィンドウの [ポータル] セクションにあり、そこから開くことができます。 ArcGIS Pro でツールを実行する以外にも、ツールを動作させるジオプロセシング サービス は、Python スクリプトや Web アプリケーションでも使用できます。