Web ツールとジオプロセシング サービスの設定
ツールを Web ツールまたはジオプロセシング サービスとして共有するときに、プロパティ設定により、クライアント アプリケーションによって、どのように使われるかが決まります。 最も一般的、かつ頻繁に変更されるパラメーターは、共有時に設定できます。 それほど使われない設定は、ツールが共有された後に、ArcGIS Server Manager で変更できます。 高度なサービス プロパティの一部は ArcGIS Server Administrator REST API でのみ設定できます。
ArcGIS Pro の設定
次のサブセクションでは、接続されたサービス定義またはオフライン サービス定義の作成を含め、ArcGIS Pro の Web ツールまたはジオプロセシング サービスの共有時に使用できる設定について説明します。
一般 タブの設定
共有 ウィンドウを最初に起動すると、デフォルト タブである 一般 タブで以下の設定を行うことができます。 Web ツールの共有後の ArcGIS Server Manager や、ポータル内の Web ツールのアイテム ページで、多くのパラメーターを変更できます。
名前
ポータルで共有される Web ツールの名前。 この名前はポータル上で一意でなくてはならず、空白や特殊記号は使えません。 このパラメーターは、ツールのメタデータから継承されます。
サマリー と タグ
ドキュメントを説明し、Web ツールを検索可能にするサマリーとタグ。 これらのパラメーターは、ツールのメタデータから継承されます。
タグ ドロップダウン メニューを使用すると、既存のタグを選択できます。 最大 128 個のタグを選択できます。
カテゴリー
Web ツールのアイテムのカテゴリー。 この設定は、スタンドアロンの ArcGIS Server に公開したジオプロセシング サービスには使用できません。
バージョン
ツールを共有する ArcGIS Enterprise または ArcGIS Server のバージョン。 このパラメーターは、Web ツール用のオフライン サービス定義またはジオプロセシング サービス用のオフライン サービス定義を保存する場合にのみ有効になります。
データ、ツール、スクリプト
データ、ツール、スクリプトの統合および公開の動作を構成するオプション。
サービス定義にデータ、ツールボックス、スクリプトを含める - 参照されるすべてのデータ、ツールボックス、スクリプトをサービス定義にパッケージ化するかを決定します。 このオプションをオンにすると、特定の統合設定が自動的にオンまたはオフの状態に固定されます。 ほとんどのワークフローでは、Web ツールやジオプロセシング サービスに 高度な共有シナリオ がない限り、このオプションは選択したままにします。 このオプションは、デフォルトで有効になっています。
URL 以外のデータ - データがサーバーにコピーされるか (静的になる)、Web ツールで参照されるかを制御します。 登録済みデータを参照 オプションを使用するには、サーバー データ ストアで一致するエントリーをデータに設定する必要があります。 サーバーのデータ ストアがデータを設定していない場合は、公開中にコピーされます。 これは、Web ツールとして公開または上書きする場合や、接続されたサービス定義として保存する場合にのみ適用できます。 結果をオフライン サービス定義として保存する際、参照データ オプションを使用している場合は、パラメーターのすべてのデータを参照できることを確認してください。これは、サーバーのデータ ストアがデータを設定していない場合、データをコピーする以外の方法はないためです。 サービス定義にデータ、ツールボックス、スクリプトを含める オプションをオフにすると、データのコピーが不可能になり、このオプションは 登録済みデータを参照 の状態に固定されます。 デフォルト オプションは 登録済みデータを参照 です。
URL データ - 公開時に、URL で参照されるデータをそのままにするか、URL からデータをダウンロードして別のデータ タイプに変換するかを制御します。 この設定により、ArcGIS Pro が元の URL 参照を使用してサービスを公開するか、公開時にデータを取得および変換するかを決定します。 このオプションは ArcGIS Pro 3.2 以降で使用できます。 URL データは、別のタイプの Web レイヤーまたはサービスの URL を参照します。 フィーチャ レイヤー、フィーチャ サービス、または Web イメージ レイヤーのフィーチャ サブレイヤーのみを構成できます。 フィーチャ レイヤーを変換 チェックボックスがオンになっている場合、このパラメーターまたはプロジェクト データのフィーチャ レイヤーまたはサービスが公開時に、フィーチャクラスに変換されます。 オフになっている場合、フィーチャ レイヤーの URL が保持されます。 Web イメージ レイヤーの URL を変換するオプションはなく、公開時は常に Web イメージ レイヤーの URL が維持されます。 サービス定義にデータ、ツールボックス、スクリプトを含める オプションをオフにすると、URL データの変換が不可能になり、このオプションはオフの状態に固定されます。 このオプションはデフォルトで有効になっています。
統合オプション - 統合オプションの使用の詳細
位置
Web ツール アイテムまたはジオプロセシング サービスの作成場所を指定します。
ArcGIS Enterprise に公開した Web ツールのアイテムの場合、オプションは次のとおりです。
フォルダー - Web ツール アイテムが作成されるポータル フォルダーを選択または作成します。 デフォルトは、ポータルのルートです。
サーバーおよびフォルダー - サーバーでは、Web ツールは 1 つ以上のフェデレーション サーバーを持つポータルで、共有する必要があります。 ポータルに複数のフェデレーション サーバーがある場合は、Web ツールが公開されるサーバーを選択します。 フォルダーでは、既存のフォルダーを選択するか、ArcGIS Server サイトにフォルダーを作成します。 デフォルトは、ArcGIS Server サイトのルート フォルダーです。
スタンドアロンの ArcGIS Server サイトに公開したジオプロセシング サービスの場合、オプションは以下のとおりです。
- フォルダー - ジオプロセシング サービス アイテムが作成されるサーバー フォルダーを選択または作成します。 デフォルトは、サーバーのルート フォルダーです。
共有
ArcGIS Enterprise に公開した Web ツールでのみ使用でき、Web ツールを共有する相手およびグループを指定します。 Web ツールは、常に マイ コンテンツ で共有されます。 Web ツールを すべてのユーザー と共有すると、アイテムはパブリックになります。ポータル Web サイトにアクセスできるユーザーは誰でも、そのアイテムを見つけて使用することができ、グループの所有者は、そのアイテムをグループ コンテンツに含めることができます。 Web ツールを ArcGIS Enterprise と共有すると、Web ツールは、アイテムにアクセス権を持つポータルのすべてのメンバーと共有されます。 自分が所属しているグループに共有できます。
構成 タブの設定
アップロード、検証、実行モード、マップ イメージ レイヤーの出力を表示、メッセージ レベル、返されるレコードの最大数 は、サービスの機能とパラメーターの構成 サブタブで設定できます。
インスタンスの数、サービス タイムアウト - 最大使用時間、サービス タイムアウト - 最大待ち時間、サービス タイムアウト - 最大アイドル時間 は、プールの構成 サブタブで設定できます。 これらの設定を指定する際のその他の考慮事項については、「サービスのチューニングと構成」をご参照ください。
アップロード
クライアントがサーバーにファイルをアップロードし、Web ツールがそれを入力として使用できるかどうかを指定します。 アップロード操作は通常、Web クライアントが使用しますが、サーバーにファイルを送信して、処理を実行する手段が必要となります。 アップロード処理では、アップロードが完了すると、ファイルの個別値が返されます。Web アプリは、この個別値を Web ツールに渡します。
デフォルトはオフです。
検証
Web ツールまたはジオプロセシング サービスのすべてのタスクに対して検証操作を有効にします。 この操作により、クライアントはツールを実行する前に検証操作を使用できます。 実行モードにかかわらず、検証操作は同期の呼び出しのみをサポートしています。 検証の要求を行うクライアントは、検証の応答を受け取るまで待機する必要があります。
デフォルトはオフです。
実行モード
クライアント (Web ツールを使用するアプリケーション) がどのように Web ツールとやり取りし、結果を取得するかを指定します。 Web ツールが 同期 に設定されている場合、クライアントは、タスクが終了するまで待ちます。 通常、同期サービスは短時間で実行されます (数秒以内)。 非同期 に設定されたサービスは一般的に実行時間が長いため、クライアントは、サーバーに対してサービスが終了したかどうかを定期的に問い合わせて、終了したら結果を得る必要があります。 非同期サービスを使用する Web アプリには、ステータスを検査して、実行終了後に結果を処理するロジックを実装する必要があります。
デフォルトは 非同期 です。
マップ イメージ レイヤーの出力を表示
Web ツールまたはジオプロセシング サービスを公開するときに、出力をマップ イメージとして表示できます。 サーバー上でマップ イメージが作成され、クライアントに画像 (スタイル情報を含んだ .tiff ファイル) として返送されます。 マップ イメージのシンボル、ラベル設定、透過表示および他のプロパティは、ArcGIS Pro セッションの出力レイヤーが公開された当初のものと同じです。 このパラメーターを使用する場合、以下を検討してください。
クライアントがシンボル化して描画しなければならない大量のフィーチャをツールが出力する場合に、クライアントは、マップ イメージを高速に受信できます。
データ分布の観点から、クライアントにはフィーチャを送信せず、マップ イメージだけを送信します。
ツールの結果は、ネットワークやトポロジーなどの非可搬性データセットです。 クライアントに出力を送信する唯一の方法は、マップ イメージです。
注意:
出力マップ イメージは、Web ツールの 実行モード パラメーターを 非同期 に設定した場合のみ使用できます。 このパラメーターは、Web ツールを Kubernetes に公開するときはサポートされていません。
デフォルトはオフです。
メッセージ レベル
Web ツールを実行したクライアントに、次のレベルのメッセージを返します:
なし - クライアントにジオプロセシング メッセージは返されません。操作が成功したか失敗したかということのみ返されます。 これがデフォルトです。
エラー - エラーを表示するツール メッセージのみが、クライアントに返されます。
警告 - ツールのエラー メッセージと警告メッセージが、すべてクライアントに返されます。
情報 - 操作により、出力されたツール メッセージがすべて、クライアントに返されます。
注意:
レベルに関係なく、すべてのメッセージには、データセットのパスと名前が含まれる可能性があり、これによって、セキュリティー上のリスクが生じる可能性があります。 情報 レベルは、詳細であり、一般に、データセットのパスと名前への参照が含まれています。 通常は、開発およびテスト環境では 情報 または 警告 レベルのメッセージを返し、運用環境では なし または エラー レベルを使用します。
デフォルトは なし です。
返されるレコードの最大数
サーバーがクライアントに返すことのできる結果の最大数です。 この値を大きな数字に設定すると、GIS サーバーで数多くの個別レコードまたはフィーチャをクライアントに返す処理をすることができます。 フィーチャを返さないようにするには、この値を 0 に設定します。 出力フィーチャ サービス パラメーター (オプション) の追加 パラメーターがオンの場合、このプロパティは効果がありません。
デフォルトは 1000 です。
インスタンスの数
ArcGIS Enterprise または ArcGIS Enterprise on Kubernetes の gp-server-sync ポッドに対して、各サーバー コンピューター上で一度に実行できるジオプロセシング サービスのインスタンスの最小数と最大数。
サービス タイムアウト - 最大使用時間
インスタンスを使用できる秒単位の最大時間です。 実行時間の長いジオプロセシング タスクでは、場合によっては、デフォルトの 600 秒 (10 分) を長くする必要があります。 また、クライアントがインスタンスを濫用しないように、このタイムアウト時間を短くできます。
サービス タイムアウト - 最大待ち時間
クライアントがインスタンスへの接続を待つ秒単位の最大時間です。 すべてのインスタンスがリクエストの処理に使用されている場合、以降のリクエストは、キューに配置されます。 インスタンスを取得する前に待ち時間が経過すると、タスクは失敗します。 デフォルト値は 60 秒 (1 分) です。
サービス タイムアウト - 最大アイドル時間
プールが縮小するまでインスタンスがアクティブであり続ける秒単位の最大時間です。 使用されていないインスタンスが実行を継続できる最大時間が経過すると、インスタンスの最小数より多い、使用されなかったインスタンスは停止します。
コンテンツ タブの設定
下記の設定は、Web ツールまたはジオプロセシング サービスの公開時にしか変更できません。 公開されたツールやジオプロセシング サービスでこれらを変更するには、新しいツールまたはサービスを作成するか、既存のものを上書きする必要があります。 各ツールのプロパティを構成する場合は、ツール名の横にある編集ボタン 
をクリックすると、選択したツールのプロパティがツール ビューの下で構成できるようになります。 最初のツール、またはツールボックス内の唯一のツールの場合は、編集ボタンをクリックしなくてもデフォルトでツールのプロパティが表示されます。 ツールを追加するには、ツールの追加 ボタンを使用します。
デフォルト構成
このセクションで構成される、出力フィーチャ サービス パラメーター (オプション) の追加、出力イメージ サービス パラメーター (オプション) の追加、すべてのデフォルト値の削除 の各オプションは、すべてのツールに適用されます。 ツールにフィーチャやラスターの出力パラメーターがない場合、出力フィーチャ サービス パラメーター (オプション) の追加 または 出力イメージ サービス パラメーター (オプション) の追加 は表示されません。 また、これらの 2 つの設定を構成して、ツールごとにフィーチャまたはラスターの出力パラメーターを設定することもできます。 単一パラメーターのデフォルト値を削除するには、デフォルト値の削除 パラメーターを構成します。
- 出力フィーチャ サービス パラメーター (オプション) の追加
Web ツールを使用するときに、すべてのフィーチャ出力をホスト フィーチャ サービスとして保存できるかどうかを指定する任意の入力パラメーターです。 このパラメーターは、ArcGIS Enterprise に公開した非同期実行モードで Web ツールとして公開するときのみ、サポートされています。 そうでなければ、構成で使用できません。 パラメーターはデフォルトでオンになっています。
- 出力イメージ サービス パラメーター (オプション) の追加
Web ツールまたはジオプロセシング サービスを使用するときに、すべてのラスター出力をイメージ サービスとして保存できるかどうかを指定する任意の入力パラメーターです。
出力イメージ サービスを使用した Web ツールおよびジオプロセシング サービスの使用の詳細
- すべてのデフォルト値の削除
ArcGIS Pro 3.3 以降、これをオンにすると、ツールの実行時に使用したすべてのデフォルト値は削除され、上記のツール パラメーター構成の デフォルト値の削除 チェックボックスが自動的にオンになります。 デフォルトはオフです。
ツールの追加
ジオプロセシング履歴から既存の Web ツールまたはジオプロセシング サービスに他のツールを追加するには、コンテンツ タブの ツールの追加 ボタン 
をクリックします。 ツールを削除するには、ツール名をクリックして 削除 を選択するか、ゴミ箱アイコンをクリックします。
ツールの 名前
ツールの名前。 デフォルトは、ツール メタデータに基づきます。
ツールの 説明
ツールの説明。 説明は、ツールのメタデータから継承しません。 空の場合は、説明を指定すると、履歴から共有されるたびに保持されます。
パラメーターの 名前 と 説明
パラメーターの名前と説明。 どちらのプロパティもパラメーター名と、ツールのメタデータの説明から継承します。 これらのプロパティを変更しても、元のツールのメタデータには影響しません。
パラメーターの タイプ
パラメーター タイプは、クライアントがツールを正常に実行するために、値を指定する必要があるかどうかを定義します。 コンテンツ タブでは、オプション パラメーターを必須パラメーターに変更することしかできません。 必須パラメーターをオプション パラメーターに変更するには、共有ウィンドウを終了し、ツールのプロパティを編集してから、ツールを再実行して、新しい結果を作成する必要があります。
データ タイプをコンポジットに維持
このプロパティは、パラメーターがコンポジット データ タイプである場合にのみ使用できます。 パラメーターをコンポジットデータ タイプとして公開するかどうかを指定します (オン)。 デフォルトはオフです。
パラメーターの 入力モード
クライアントがフィーチャをタスクに入力する方法を指定します。
ユーザー定義値 - クライアントが、パラメーターの値を指定します。
選択リスト - 文字列 (選択リスト) のリストを提供し、クライアントは選択リストから、1 つ以上の文字列を選択する必要があります。 入力のデータ タイプに応じて、文字列が決定されます。この文字列は、レイヤーの名前や、単純なキーワード オプションなどです。
定数 - 結果を作成したときにパラメーターに入力された値が使用されます。 その値は定数であり、クライアントは変更できないため、サービス公開時のタスク パラメーターにはなりません。
混合モード: ユーザー定義と選択リスト - コンポジットまたは値テーブル パラメーターでのみ使用できます。 コンポジットの各データ タイプ、または値テーブルの各列の各データ タイプに対して、入力モードを構成します。 選択リストをサポートしていないデータ タイプがある場合は、ユーザー定義値 オプションのみを構成に使用できます。
パラメーターの データ タイプを文字列に変換
このプロパティは、面積単位データ タイプにのみ適用されます。 これは、面積単位を文字列データ タイプに変換するか (オン)、または面積単位として公開するか (オフ) を指定します。 デフォルトはオフです。
パラメーターの デフォルト値の削除
ArcGIS Pro 3.3 以降、これをオンにすると、ツール実行時に使用したデフォルト値は、公開プロセスの際に削除されます。 デフォルトはオフです。
パラメーターの デフォルト値
ツールのデフォルト値は、ツールの実行中に指定されるパラメーター値によって決定されます。 パラメーターのデフォルト値を追加または変更するには、対応するパラメーターで、ツールを再度実行する必要があります。
パラメーターの デフォルト レイヤーのみを使用
このプロパティは、選択リストの入力モードのみに適用されます。 ツールの実行時に使用するオプションのみを、このチェックボックスの下のリスト ビューで、オンにするかどうかを指定します (オン)。 デフォルトはオフです。
パラメーターの ジオメトリー タイプ
このプロパティは、フィーチャのみに適用されます。 ジオメトリー タイプは、結果の作成に使用された入力フィーチャと出力フィーチャから派生します。 コンテンツ タブで、変更することはできません。 指定されたジオメトリー タイプのフィーチャを使用してツールを再実行し、その操作によって作成された結果を共有します。
パラメーターの スキーマ
このプロパティは、フィーチャとテーブルのみに適用されます。 スキーマは、クライアントがツールへの入力用のフィーチャを作成する際に指定する必要のあるフィールド (属性) のリストです。 このフィールドのリストは、結果を作成したツールへの入力または出力として使用されるレイヤーまたはデータセットと同じです。
ArcGIS Server Manager の設定
次のサブセクションのパラメーター設定は、サービス公開後に ArcGIS Server Manager で変更できますが、ArcGIS Enterprise Manager for ArcGIS Enterprise on Kubernetes は除外されます。
注意:
設定を変更すると、サービスが再起動されます。
パラメーター
次のパラメーター設定を利用できます。
|
パラメーター |
説明 |
|---|---|
|
クラスター |
サービスが実行されるクラスターです。 この設定は、ArcGIS Server がクラスターに参加している場合にのみ変更できます。 |
|
ディレクトリー |
ツールの実行時に、サーバーがファイルを書き込むために使用するディレクトリーです。 |
機能
次の機能のパラメーター設定を利用できます。
|
パラメーター |
説明 |
|---|---|
|
WPS |
ジオプロセシング サービスで WPS ケーパビリティーを有効にすると、他のクライアントが OGC 標準プロトコルを通じてツールに接続して、それを使用することができます。 |
プロセス
次のプロセスのパラメーター設定を利用できます。
|
パラメーター |
説明 |
|---|---|
|
リサイクル |
サービスをリサイクルする頻度とタイミングを制御します。 デフォルトでは 24 時間ごと、真夜中に開始します。 ジオプロセシング サービスは、低分離性でも高分離性でも実行できる他のサービス タイプとは異なり、高分離性でのみ実行されます。 |
Portal for ArcGIS のアイテム設定
ArcGIS Enterprise 12.0 以降では、ポータルの Web ツール アイテムのアイテム ページで多くの設定を管理できます。 ツールの公開後に更新できる設定については「Web ツールの管理」をご参照ください。