Web ツール作成と共有のクイックツアー—ArcGIS Pro

Web ツールを作成するには、作成の手順と共有の手順が必要です。作成のプロセスでは、まず ArcGIS Pro でモデルや Python スクリプトツールを作成します。ツールを作成し正常に実行したら、Web ツールとして ArcGIS Enterprise ポータルで共有できます。作成と共有の際には、一部のデータ、ツールパラメーター、共有権限について考慮する必要があります。このような考慮事項については、次の例と、本トピックの関連セクションに記載しています。全体的なプロセスは、以下のワークフローで構成されます。

ツールボックスのツールを使用してスクリプトやモデルを構築し、ワークフローを構成します。
ツールに必要なデータセットを収集し、ジオデータベースで使用可能にするか、プロジェクトのマップに追加します。
ツールを実行し、ジオプロセシング履歴に正常なエントリを作成します。
必要であれば、マップに出力データセットのシンボルを設定します。
履歴アイテムを Web ツールとして共有します。Web ツールを共有するときに、ツールとサービスのツールプロパティを設定できます。

例: 提案するパイプラインが住民に与える影響の検証

次のモデルツールは、パイプラインに漏れが発生した場合に影響を受ける人数を検証するツールのコレクションです。このワークフローではパイプラインと河川との交差部分を探し、下流解析を行って影響を受ける人数を調べます。このモデルはプロジェクトデータとパラメーターで設定され、Web ツールとして公開されます。この場合、アナリストや一般の人が提案されたパイプライン経路を変更し、漏れによる下流の住民への影響を確認できます。Web ツールの結果には、パイプラインが河川と交差する部分と、影響を受ける人口のサマリーが表示されます。

ツールの設計

実用的なツールには、入力パラメーターと出力パラメーターが必ずあります。これらのパラメーターを使用すると、ツールを実行するたびに別の値を指定できます。そうすると、ツールは別の解析結果を返します。入力パラメーターと出力パラメーターに加え、ツールにはプロジェクトデータと中間データもあります。これらは、通常はツールの実行者がコントロールできないデータセットです。モデルでは、入力パラメーターには「P」とマークが付けられます。モデルをツールとして実行すると、「P」が付いた入力がツールのダイアログボックスに表示され、ツールの実行時に使用される値を設定できます。パイプラインモデルでは、下流解析を実施する際のパイプライン経路と、バッファー距離を指定できます。誰かがこのツールを使用すると、パイプラインの場所とバッファーのサイズが変更され、パイプラインに最終的に影響を受ける人数が表示されます。この例に示すパイプラインの交差部と解析ラインは、モデルツールの実行時に生成される中間データセットです。これらの中間データセットは、ツールの実行者には必要ないため、結果として返されません。モデルが共有されると、Web ツールを動作させるジオプロセシングサービスは中間データの書き込み先を指定し、最終的に中間データが必要なくなったら消去します。

すべての有効なツールにとって入力パラメーターは重要ですが、それと同様に出力パラメーターも重要です。出力パラメーターを使用すると、ツールから実行者に結果が返されます。ArcGIS Pro では、出力パラメーターは重要です。これらのデータセットはマップに自動的に追加されるからです。出力パラメーターのないツールでも出力は生成しますが、この情報は自動的に表示されません。Web ツールもほぼ同じように動作します。つまり、エンドユーザーに結果を返すには、1 つ以上の出力パラメーターが必要です。パイプラインモデルでは、2 つの出力パラメーターが存在します。1 つは、下流のバッファーの場所を示す影響エリアの人口、もう 1 つは影響を受ける人口全体のサマリーを示す人口サマリーテーブルです。影響を受けるエリアの人口は、中間データでもあり出力データでもあります。このパラメーターが中間であるのは、統計情報のサマリーツールで必要ではあるもののモデルパラメーター (P) として定義されているため、ツールが正常に完了したときにこの結果がクライアントに返されるからです。

ヒント:

スクリプトツールの作成時にも、ツールの入力および出力パラメーター、プロジェクトデータ、中間データの原則が該当します。

ツールのドキュメント化

ツールができるだけ幅広い層のユーザーに検出、理解、使用されるようにするには、Web ツールの作成方法をドキュメント化することが必要不可欠です。効果的なドキュメント化は、まずオリジナルツールから始めます。モデルやスクリプトツールにも、システムツールと同じ種類のメタデータを提供できます。

ツールのドキュメント化の詳細

ツールの実行

ツールが作成されたら、正常に実行する必要があります。ツールを実行すると、ジオプロセシング履歴にエントリが作成されます。実行に失敗したツールは共有できません。

メモ:

ModelBuilder でモデルを実行しても、[ジオプロセシング履歴] にはエントリは作成されません。モデルツールは、[ジオプロセシング] ウィンドウでツールとして実行する必要があります。

Web ツールの共有

Web ツールを共有するには、[解析] > [履歴] を選択して [履歴] ウィンドウを開きます。共有するアイテムを右クリックして [共有] を選択します。新しい Web ツールとして共有するには、[Web ツールとして共有] を選択して [Web ツールとして共有] ウィンドウを開きます。既存ツールを上書きするには、[Web ツールの上書き] を選択して、公開済みのすべての既存 Web ツールが [マイコンテンツ] に表示されたウィンドウを開きます。

[Web ツールの上書き] 選択ウィンドウ

上書きする正しいツールを間違いなく選択して [OK] をクリックすると、[Web ツールの上書き] ウィンドウが開きます。先行して公開された Web ツールの構成プロセスは、次のように [Web ツールとして共有] と [Web ツールの上書き] で同様です。

または、[共有] > [Web ツール] を選択して、[Web ツールとして共有] または [Web ツールの上書き] を選択します。[Web ツールとして共有] オプションを選択した場合は、問題なく動作しているアイテムがすべて表示されたツール共有ウィンドウからいずれかのアイテムを選択します。

[Web ツールの上書き] オプションを選択した場合は、公開されている既存のツールが [マイコンテンツ] に表示されたウィンドウから、上書きするアイテムを選択します。続いて、問題なく動作しているアイテムがすべて表示されたウィンドウから、上書きするアイテムを選択します。このワークフローの上書きの手順は、[解析] > [履歴] を選択した場合は逆になります。

Web ツールプロパティの設定

漏出評価ツールはフィーチャとテーブルを出力します。このツールが生成して表示するデータ量にはサイズ制限があるため、Web ツールは結果のマップサービスのない非同期サービスとして設定されます。デフォルトでは最大 1000 件のレコードですが、これで十分です。メッセージレベルをエラーにしておくと、ツール障害に関連するメッセージのみ表示できます。Web ツールが正常に実行されると、通常の処理メッセージはエンドユーザーに返されません。

Web ツールは、常に [マイコンテンツ] にあります。ツールは、組織や全ユーザー、または特定のグループと共有できます。漏出評価ツールは、組織内でパイプライン解析を実施する必要がある関係者と共有するには優れたツールです。適切なグループを選択すると、そのユーザーたちはツールを迅速に見つけ、使用することができます。

データのコピーと参照

すべての Web ツールは、データを入力として使用するか、プロジェクトデータを使用します。漏出評価モデルを Web ツールとして共有すると、ユーザーからのデータを受け入れ、それをモデルで参照されるプロジェクトデータに対して処理します。ツール共有のこの時点では、データをサーバーにコピーして、サービスがデータの静的コピーを使用できるようにするか、またはサービスがアクセスできる参照を作成するかを決定する必要があります。今回のワークフローでは、プロジェクトデータには河川と人口のデータセットが含まれており、そのいずれも静的です。つまり、データセットが更新されることはほとんどありません。ここでは、データをサーバーにコピーする方が適しています。この処理により、データが収集されて (必要に応じて) ファイルジオデータベースフィーチャクラスに変換されます。それがサーバーに抽出され、サービスによって使用されます。

解析方法が少し変更され、ユーザーが独自のパイプラインを提案しなかったとします。パイプラインの代案は別のプロセスから提案され、ユーザーがツールに異なる入力を提供しました。このような場合は、提案されたパイプラインがプロジェクトデータになります。そのため、このデータをエンタープライズジオデータベースに入れ、ツールが参照できるようにすることをお勧めします。公開時には、ArcGIS Server データストアを使用してデータへの参照を設定します。公開プロセスにより、静的コピーを作成する代わりにデータベースへの参照が保持されます。プロジェクトアナリストが後からエンタープライズジオデータベースのデータを更新すると、Web ツールは最新のパイプライン案に対して解析を実施します。

分析

Web ツール共有の [分析] プロセスは、ツールをポータルに正常に公開できるよう実施されます。また、データに関する警告メッセージが表示されることもあるため、必要に応じて対応します。漏出評価ツールにはデータストアがすでに設定され、ツールがドキュメント化され、Web ツールで動作する対応ツールを使用しているため、警告やメッセージは表示されません。