Skip to main content

出力フィーチャ サービスでの Web ツールの使用

通常のフィーチャ出力で Web ツールを使用する場合、出力はサーバーで生成され、フィーチャとしてクライアントに返されます。 出力フィーチャ サービスはホスティング サーバー上に常駐しているため、結果をローカル ドライブに保存せずに、ネットワーク上で出力フィーチャ データおよび非空間テーブルにサービスを提供することができます。 これにより、結果データをクライアントに転送する際のオーバーヘッドが回避されるので、出力フィーチャの結果サイズが大きい場合に Web ツールの効率性を向上することができます。 また、自分のデータを Web クライアント、デスクトップ アプリ、フィールド アプリなど、さまざまなクライアントで使用可能にすることもできます。

作成

この機能を使用するには、出力をフィーチャクラスまたはテーブルにする必要があります。

出力がオプションであるか必須であるかに関係なく、Web ツールを設計する際に何も変更する必要はありません。

公開

Web ツールを出力フィーチャ サービスと共有する場合は、次のソフトウェア要件を満たす必要があります。

  • ArcGIS Pro 2.3 以降が必要です。

  • ArcGIS Server および Portal for ArcGIS 10.7 以降が必要です。

  • ArcGIS Server は、Portal for ArcGIS にフェデレートされている必要があります。

  • Portal for ArcGIS にはホスティング サーバーが必要です。

ツールを実行した後、Web ツールとして共有 ウィンドウで次の設定を行います。

  • Web ツールは、ポータルまたは ArcGIS Enterprise のグループとしか共有できません。 すべてのユーザー オプションをオフのままにして、ツールを使用する際の権限の問題を回避します。

  • 実行モード オプションを 非同期 に設定します。

  • マップ イメージ レイヤーの出力を表示 オプションをオフのままにしておきます。

  • サーバーから返される最大レコード数 設定は、出力フィーチャ サービスに何も影響を与えません。

  • 公開後の出力で出力フィーチャ サービス パラメーターを無効にするには、ツールのプロパティの構成 ボタン をクリックして、出力フィーチャ サービス パラメーター (オプション) の追加 オプションをオフにします。

CreateGPSDDraft 関数を使用して Web ツールを公開する場合は、server_type 引数を MY_HOSTED_SERVICES として指定します。 出力フィーチャ サービス名 パラメーター (オプション) を削除することはできません。

GeoprocessingSharingDraft クラスを使用する場合、任意の 出力フィーチャ サービス名 パラメーターを使用するかどうかに応じて、enableOutputFeatureService プロパティを True または False に設定します。

新しい出力フィーチャ サービスで Web ツールを使用

フィーチャ出力またはテーブル出力で Web ツールを使用する場合は、出力フィーチャ サービス名 という追加のオプション入力パラメーターをオプション リストの末尾で使用できるようになります。 既存の出力フィーチャ サービスの上書きに使用される 既存の出力ホスト フィーチャ サービスを上書き オプションと 上書きに失敗した場合、新しい出力ホスト フィーチャ サービスを作成 オプションを次に示します。 この出力パラメーターは、公開処理中に生成されます。 Web ツールが公開された後で、このパラメーターを削除したり名前変更したりすることはできません。 Web ツールを新しい出力フィーチャ サービスで正常に使用するには、次の要件を満たしたサービス名をテキスト ボックスに指定します::

  • 出力フィーチャ サービスの名前は、ポータルでホスティングされるすべてのサービス全体で一意である必要があります。すべての出力フィーチャ サービスは、ポータルの Hosted フォルダーに常駐するからです。

  • この名前は、英数字とアンダースコア (_) でのみ構成することができます。また、この名前が 120 文字を超えてはなりません。

  • ポータル ユーザーには、出力フィーチャ サービスを作成する権限が必要です。 この権限を持つロールは、公開者か管理者のみです。 カスタム ロールのポータル ユーザーの場合、ロールにはメンバー/表示、コンテンツ/ホスト フィーチャ レイヤーの公開、コンテンツと解析/標準フィーチャ解析の権限が必要です。

Web ツールを出力フィーチャ サービスで使用する場合、元の結果が常駐するサーバー上の場所にかかわらず、すべての出力フィーチャはホスティング サーバーのデータ ストアにコピーされます。

注意:

ポータルとフェデレートされた ArcGIS Server サイトに Web ツールを公開する場合は、ホスティング サーバーで allowconnection コマンドを実行する必要があります。 この操作を実行しないと、結果をホスティング サーバーにコピーすることができません。

Web ツールの実行時に、サーバーから結果のフィーチャ サービスに URL が提供されます。 Web ツールを ArcGIS Pro で使用すると、結果がサービス URL を持つレイヤーとしてコンテンツ ウィンドウに追加されます。 REST エンドポイントから Web ツールを使用する場合、結果は URL の JSON 表現です。

注意:

出力フィーチャ サービス名 パラメーターは任意で設定します。 出力フィーチャ サービス名 パラメーターを未指定のままにして Web ツールを使用すると、通常の出力フィーチャまたはテーブルが生成されます。

元の出力パラメーター プロパティは、フィーチャ サービスがレンダリングされる方法を左右します。 一般的なシナリオを以下に示します。

  • 複数の出力 - 複数の出力フィーチャ パラメーターがある場合、各出力結果は出力フィーチャ サービスにレイヤーとして追加されますが、Web ツールを実行する際には 1 つの出力フィーチャ サービスしかありません。 これらのレイヤーの空間参照が異なっている場合は、すべてのレイヤーが最初のレイヤーの空間参照に投影されます。

  • 空の出力 - Web ツールを実行する際に出力パラメーターの結果が空の場合は、空のフィーチャを持つレイヤーが生成され、サービスに追加されます。

  • オプションまたは派生した出力 - 出力パラメーターのタイプがオプションまたは派生の場合は、Web ツールを実行する際に出力が生成されない可能性があります。 この場合、どのレイヤーもサービスに追加されません。

  • 複数の値を持つ出力 - 複数の値を含む出力を持つ Web ツールの実行は、フィーチャ出力サービスをサポートしていません。

  • シンボル - ツールの出力に対してシンボルが定義されている場合は、出力フィーチャ サービスでそのシンボルが保持されます。 ツールの作成中にシンボルが定義されなかった場合は、デフォルトのシンボルが使用されます。

既存のホスト フィーチャ サービスを上書き

ArcGIS Pro 3.0 および ArcGIS Enterprise 11 以降から既存の出力フィーチャ サービスを上書きすることができます。 出力フィーチャ サービスを上書きする前に、次の要件と権限を考慮してください。

次の要件は、クライアントの空間参照とタイプに関連しています。

  • 現在の解析出力の空間参照と既存の出力フィーチャ サービスのレイヤーが異なる場合は、サービスを上書きすることができません。

  • JSON 形式の出力フィーチャ サービス名で ArcGIS REST API を使用して ArcGIS Pro 3.0 以降からのみ上書きできます。 Python、Map Viewer Classic、Web AppBuilder からの上書きはサポートされていません。

既存の出力フィーチャ サービスを上書きする権限は、ArcGIS Enterprise ログイン アカウントのロールに関連しています。

  • このロールには、公開者および管理者に制限された出力フィーチャ サービスを作成する権限が必要です。 カスタム ロールでは、メンバー/表示、コンテンツ/ホスト フィーチャ レイヤーの公開、コンテンツ/作成、更新、および削除、コンテンツと解析/標準フィーチャ解析の権限を有効にする必要があります。

  • 管理者ロールでは、すべてのホスト フィーチャ サービスを上書きできます。

  • 公開者は、所有しているホスト フィーチャ サービスしか上書きすることができません。

ArcGIS Pro 3.0 から上書きするには、以下の手順を実行します:

  • Web ツールのタスクを開き、出力フィーチャ サービス名 オプションをオンにします。 次のパラメーターでは、既存の出力ホスト フィーチャ サービスを上書き チェックボックスがオフになっており、上書きに失敗した場合、新しい出力ホスト フィーチャ サービスを作成 チェックボックスが無効になっています。

  • テキスト ボックスを使用して、既存のサービス名または JSON 式を入力値として指定するか、参照 ボタンをクリックして、上書きするサービスを選択します。

  • 上書きに失敗した場合、新しい出力ホスト フィーチャ サービスを作成 チェックボックスをオンにして、上書きに失敗した場合、新しい出力ホスト フィーチャ サービスを作成 が有効になっていることを確認します。 チェックボックスをオンにするかオフのままにして、実行 をクリックして上書きします。

  • 上書きに失敗した場合、新しい出力ホスト フィーチャ サービスを作成 チェックボックスがオフになっている状態で上書きに失敗すると、エラー メッセージが返されます。 このチェックボックスがオンになっている場合は、上書きに失敗すると、新しい出力ホスト フィーチャ サービスが作成され、最初に失敗した試行の後で _1 が付記されます。 試行回数が増すごとに、付記される数値が _2、_3 のように増加します。