ジオプロセシング サービスの設定

ツールをジオプロセシング サービスとして公開するときに選択した設定により、クライアント アプリケーションによってどのように使われるかが決定します。 サービスで最も一般的、かつ頻繁に変更されるパラメーターは、公開時に設定できます。 それほど使われない設定は、ツールが公開された後に ArcGIS Server Manager で変更できます。 一部の「高度な設定」は、ArcGIS Server Administrator の Web ページでしか設定できません。 このような高度な設定を変更しなければならないジオプロセシング サービスはほとんどありません。

設定

[ジオプロセシング サービスの公開] 公開ウィザードの 3 つのパネル ([一般][構成][コンテンツ]) を使用し、公開時のジオプロセシング サービスの設定を管理したり、修正したりできます。

ヒント:

公開後は、公開されたサービスの設定の管理と変更については、ArcGIS Server Manager を使用します。

一般

パラメーター説明

名前

サーバーで公開されるジオプロセシング サービスの名前。 この名前はサーバー上で一意でなくてはならず、空白や特殊記号は使えません。 これはツールのメタデータから継承されます。

サマリー

ジオプロセシング サービスをドキュメント化し、検索可能にするサマリーとタグ。 この値はツールのメタデータから継承されます。 Web ツールを公開するために、この値を入力する必要があります。 最大 128 個のタグを入力できます。

タグ

データ

  • [URL 以外のデータ] - データがサーバーにコピーされるか (静的になる)、ジオプロセシング サービスで参照されるかを決定します。 [登録済みデータを参照] オプションを使用するには、サーバー データ ストアで一致するエントリを「データに設定」する必要があります。 サーバーのデータ ストアがデータを設定していない場合は、公開中にコピーされます。 これは、「ジオプロセシング サービスとして公開」する場合や、「接続されたサービス定義として保存」する場合にのみ適用されます。 「結果をオフライン サービス定義として保存」した場合、[参照データ] オプションを選択する場合はパラメーターのすべてのデータを参照できることを確認してください。これは、サーバーのデータ ストアがデータを設定していない場合、データをコピーする以外の方法はないためです。
  • [URL データ] - 公開時にデータを URL のままにするか別のデータ タイプに変換するかを制御します。 このオプションは ArcGIS Pro 3.2 以降で使用できます。 URL データは別のタイプの「Web レイヤー」または「サービス」の URL を参照します。 現在のリリースでは「フィーチャ レイヤー」または「フィーチャ サービス」のみを構成できます。 [フィーチャ レイヤーを変換] チェックボックスがオンになっている場合、このパラメーターまたはプロジェクト データのフィーチャ レイヤーまたはサービスが公開時にフィーチャクラスに変換されます。 オフになっている場合、フィーチャ レイヤーの URL が保持されます。

ロケーション

[フォルダー] - ジオプロセシング サービス アイテムが作成されるサーバー フォルダーを選択または作成します。 デフォルトはサーバーのルートです。

構成

パラメーター説明

アップロード

クライアントがサーバーにファイルをアップロードし、ジオプロセシング サービスがそれを入力として使用できるかどうかを設定します。 アップロード操作は主に Web クライアントが使用しますが、サーバーにファイルを送信して処理を実行する手段が必要となります。 アップロード処理では、アップロードが完了すると、ファイルの個別値が返されます。Web アプリケーションは、この個別値をジオプロセシング サービスに渡します。

このオプションは、デフォルトで無効に設定されています。 サービスへのアップロードを許可することにより、セキュリティ上のリスクが生じる可能性があります。 必要な場合にのみ有効にしてください。

実行モード: [同期] または [非同期]

同期と非同期は、クライアント (ジオプロセシング サービスを使用するアプリケーション) がどのようにジオプロセシング サービスとやり取りし、結果を取得するかを定義するものです。 ジオプロセシング サービスが同期に設定されている場合、クライアントはタスクが終了するまで待ちます。 通常、同期サービスは短時間で実行されます (数秒以内)。 非同期サービスは一般的に実行時間が長いため、クライアントはサーバーに対してサービスが終了したかどうかを定期的に問い合わせて、終了したら結果を得る必要があります。 非同期サービスを使用する Web アプリには、ステータスを検査して実行終了後に結果を処理するロジックを実装する必要があります。 ArcGIS Desktop クライアントは、どちらのタイプもネイティブに処理します。

マップ イメージ レイヤーの出力を表示

ジオプロセシング サービスを公開するときに、出力をマップ イメージとして表示するよう選択できます。 サーバー上でマップ イメージが作成され、クライアントに画像 (スタイル情報を含んだ .tiff ファイル) として返送されます。 返されるマップ イメージのシンボル、ラベル設定、透過表示および他のすべてのプロパティは、ArcGIS Pro セッションの出力レイヤーが公開された当初のものと同じです。 [マップ イメージ レイヤーの出力を表示] を使用する理由は以下のとおりです。

  • クライアントがシンボル化して描画しなければならない大量のフィーチャをツールが出力する場合に、クライアントはマップ イメージを高速かつ容易に受信できます。
  • データ分布の観点から、クライアントにはフィーチャを送信せず、マップ イメージだけを送信します。
  • ツールの結果は、ネットワークやトポロジなどの非可搬性データセットです。 クライアントに出力を送信する唯一の方法は、マップ イメージです。
注意:

出力マップ イメージは、ジオプロセシング サービスを [非同期] に設定した場合のみ使用できます。

メッセージ レベル

ジオプロセシング サービスを実行したクライアントに、次のようにさまざまなレベルのメッセージを返すことができます。

  • [なし] - クライアントにジオプロセシング メッセージは返されません。実行が成功したか失敗したかということのみ返されます。 これがデフォルトです。
  • [エラー] - エラーを表示するツール メッセージのみがクライアントに返されます。
  • [警告] - ツールのエラー メッセージと警告メッセージがすべてクライアントに返されます。
  • [情報] - 実行により出力されたツール メッセージがすべてクライアントに返されます。
注意:

レベルに関係なく、すべてのメッセージにはデータセットのパスと名前が含まれる可能性があり、これによってセキュリティ上のリスクが生じる可能性があります。 [情報] レベルは冗長であり、一般に、データセットのパスと名前への参照が含まれています。 通常、開発中はメッセージを返して、稼働中はこれをオフにしておくようにします。

返されるレコードの最大数

サーバーがクライアントに返すことのできる結果の最大数です。 この値を大きな数字に設定すると、GIS サーバーで数多くの個別レコードまたはフィーチャをクライアントに返す処理をすることができます。 フィーチャをまったく返さないようにするには、この値を 0 に設定します。 通常、この値を 0 に設定するのは、[マップ イメージ レイヤーの出力を表示] を有効にした場合のみです。

前述した設定は、ジオプロセシング サービスの公開後に ArcGIS Server Manager でも変更できます。

コンテンツ

次の設定は、ジオプロセシング サービスの公開時にしか変更できません。

ツールの追加

ジオプロセシング履歴から既存のジオプロセシング サービスに他のツールを追加するには、[コンテンツ] タブの [ツールの追加] ツールの追加 ボタンをクリックします。 ツールを削除するには、ツール名をクリックし、[削除] を選択します。

ツールのプロパティの構成

ツール プロパティを構成するには、ツール名の横にある編集ボタン ツールのプロパティの構成 をクリックします。

プロパティ説明

名前

ツールの名前。 デフォルトは、ツール メタデータに基づきます。

説明

ツールの説明。 説明は、ツールのメタデータから継承しません。 空の場合は、説明を指定すると、履歴から共有されるたびに保持されます。

次のプロパティは、各パラメーターに対して構成できます。

プロパティ説明

名前

パラメーターの名前と説明。 どちらのプロパティもパラメーター名と、ツールのメタデータの説明から継承します。 ここで変更することもできますが、元のツールのメタデータには影響しません。

説明

タイプ

パラメーター タイプは、クライアントがツールを正常に実行するために、値を指定する必要があるかどうかを定義します。 [コンテンツ] タブでは、オプション パラメーターを必須パラメーターに変更することしかできません。 必須パラメーターをオプション パラメーターに変更するには、共有ウィンドウを終了し、ツールのプロパティを編集してから、ツールを再実行して、新しい結果を作成する必要があります。

データ タイプをコンポジットに維持

このプロパティは、パラメーターがコンポジット データ タイプである場合にのみ使用できます。 パラメーターをコンポジットデータ タイプとして公開するかどうかを指定します (オン)。 デフォルトはオフです。

入力モード

クライアントがフィーチャをタスクに入力する方法を指定します。 GUI の設計と使用法については、パラメーターの入力モードをご参照ください。

  • [ユーザー定義値] - クライアントが、パラメーターの値を指定します。
  • [選択リスト] - 文字列 (選択リスト) のリストを提供し、クライアントは選択リストから、1 つ以上の文字列を選択する必要があります。 入力のデータ タイプに応じて、文字列が決定されます。この文字列は、レイヤーの名前や、単純なキーワード オプションなどです。
  • [定数] - 結果を作成したときに、パラメーターに指定した値が使用されます。 その値は定数であり、クライアントは変更できないため、サービス公開時のタスク パラメーターにはなりません。
  • [混合モード: ユーザー定義と選択リスト] - コンポジットまたは値テーブル パラメーターでのみ使用できます。 入力モードは、コンポジットの各データ タイプか、値テーブルの各列の各データ タイプに対して構成できます。 選択リストをサポートしていないデータ タイプがある場合は、ユーザー定義のオプションのみを構成に使用できます。

データ タイプを文字列に変換

このプロパティは、面積単位データ タイプにのみ適用されます。 これは、面積単位を文字列データ タイプに変換するか (オン)、または面積単位として公開するか (オフ) を指定します。 デフォルトはオフです。

デフォルト値の削除

ArcGIS Pro 3.3 以降、これをオンにすると、ツール実行時に使用されたデフォルト値は、公開プロセスの際に削除されます。 デフォルトはオフです。

デフォルト値

ツールのデフォルト値は、ツールの実行中に指定されるパラメーター値によって決定されます。 パラメーターのデフォルト値を追加または変更するには、対応するパラメーターで、ツールを再度実行する必要があります。

デフォルト レイヤーのみを使用

このプロパティは、選択リストの入力モードのみに適用されます。 ツールの実行時に使用されるオプションのみを、このチェックボックスの下のリスト ビューで、オンにするかどうかを指定します (オン)。 デフォルトはオフです。

ジオメトリ タイプ

このプロパティは、フィーチャのみに適用されます。 ジオメトリ タイプは、結果の作成に使用された入力フィーチャと出力フィーチャから派生します。 [コンテンツ] タブで、変更することはできません。 指定されたジオメトリ タイプのフィーチャを使用してツールを再実行したら、その操作によって作成された結果を共有する必要があります。

スキーマ

このプロパティは、フィーチャとテーブルのみに適用されます。 スキーマは、クライアントがツールへの入力用のフィーチャを作成する際に指定する必要のあるフィールド (属性) のリストです。 このフィールドのリストは、結果を作成したツールへの入力または出力として使用されるレイヤーまたはデータセットと同じです。

次の構成パラメーターは、ツール全体に適用されます。

パラメーター説明

出力フィーチャ サービス パラメーター (オプション) の追加

Web ツールを使用するときに、出力をフィーチャ サービスとして保存できるかどうかを指定する任意の出力パラメーターです (オン)。 このパラメーターは、非同期モードで Web ツールとして公開するときのみ、サポートされています。 そうでなければ、構成で使用できません。 デフォルト設定はオンです。

すべてのデフォルト値の削除

ArcGIS Pro 3.3 以降、これをオンにすると、ツールの実行時に使用されたすべてのデフォルト値は削除され、上記のツール パラメーター構成の [デフォルト値の削除] チェックボックスが自動的にオンになります。 デフォルトはオフです。

ArcGIS Server Manager の設定

以下のサブセクションのパラメーター設定は、ArcGIS Server Manager でしか変更できません。 前述した構成設定は、サービスの公開後に、ArcGIS Server Manager でも変更できます。

注意:

設定を変更すると、サービスが再起動されます。

パラメーター

次のパラメーター設定を利用できます。

パラメーター説明

クラスター

サービスが実行されるクラスターです。 この設定は、ArcGIS Server がクラスターに参加している場合にのみ変更できます。

ディレクトリ

ツールの実行時に、サーバーがファイルを書き込むために使用するディレクトリです。

機能

次の機能のパラメーター設定を利用できます。

パラメーター説明

WPS

ジオプロセシング サービスで WPS ケーパビリティを有効にすると、他のクライアントが OGC 標準プロトコルを通じてツールに接続して、それを使用することができます。

WPS の詳細

プール

次のプール パラメーター設定を利用できます。

パラメーター説明

インスタンスの数

サービスの最小インスタンス数と最大インスタンス数。 デフォルト値は、最小値が 1、最大値が 2 です。 最小値を 0 に設定すると、システムのリソースが減少します。インスタンスは、クライアントからリクエストを受けると開始します。

クライアントがサービスを使用できる最大時間

インスタンスを使用できる秒単位の最大時間です。 実行時間の長いジオプロセシング タスクでは、場合によっては、デフォルトの 600 秒 (10 分) を長くする必要があります。 また、クライアントがサービスを使わないよう、この時間を短くできます。

クライアントがインスタンス取得を待つ最大時間

クライアントがインスタンスへの接続を待つ秒単位の最大時間です。 すべてのインスタンスがリクエストの処理に使用されている場合、以降のリクエストは、キューに配置されます。 インスタンスを取得する前に、タイムアウトが経過すると、タスクは失敗します。 デフォルト値は 60 秒 (1 分) です。

使用されていないインスタンスが実行を継続できる最大時間

プールが縮小するまでインスタンスがアクティブであり続ける秒単位の最大時間です。 使用されていないインスタンスが実行を継続できる最大時間が経過すると、インスタンスの最小数より多い、使用されなかったインスタンスは停止します。

プロセス

次のプロセスのパラメーター設定を利用できます。

パラメーター説明

リサイクル

サービスをリサイクルする頻度とタイミングを制御します。 デフォルトでは 24 時間ごと、真夜中に開始します。

ジオプロセシング サービスは、低分離性でも高分離性でも実行できる他のサービス タイプとは異なり、高分離性でのみ実行されます。


このトピックの内容
  1. 設定
  2. ArcGIS Server Manager の設定