Topographic Production サービス

ライセンス:

このリソースを使用するには、ArcGIS GIS Server Advanced ライセンスおよび ArcGIS Topographic Mapping サーバー エクステンション ライセンスが必要です。

Topographic Production サービスは、マップ サービスに対する SOE (サーバー オブジェクト エクステンション) です。 これにより、業界標準のマップ プロダクト仕様に基づいた地形図の作成など、地形図作成機能をマップ サービス上で実行できるようになります。

Topographic Production サービスの詳細

REST SOE の詳細

ArcGIS Server Services Directory の詳細

サービスの公開

ArcGIS Pro の Topographic Mapping エクステンションを使用すると、Topographic Production サービスを公開できます。

ArcGIS Server での構成

サービスが公開された後、ArcGIS Server Manager でサービスが実行できる操作やその他のプロパティを構成できます。 これらの設定は、Topographic Production チェックボックスをオンにするか、Topographic Production をクリックすると表示され、チェックボックスがオンになっている場合にのみ適用されます。

演算

次のリソースと操作が SOE でサポートされています:

• addProduct - マップの生成に使用できるサービスにマップ プロダクトの定義を追加します。

• calculateExtent - 指定したプロダクトとバージョンでカスタム AOI (対象地域) を計算します。

• delete - 実行されたジョブやキャンセルされたジョブを削除し、クエリーに表示されなくするとともにサーバー領域を占有しないようにします。

• generateProduct - 既存のマップ プロダクト定義に基づいてレイアウトまたはマップを作成するプロセスを自動化します。

• removeProduct - Topographic Production サービスからマップ プロダクトを削除します。

• updateProduct - 既存のマップ プロダクトのプロパティを更新します。

• products - Topographic Production サービスでサポートされているマップ プロダクトを取得します。

  • product - Topographic Production サービスでサポートされているプロダクトから 1 つのマップ プロダクトを取得します。

• jobs - 実行されたジョブに関する操作を含みます。

  • cancel - generateProduct エンドポイントを使用して送信されたジョブをキャンセルします。

  • job - generateProduct エンドポイントによって実行されたジョブのステータスをトラッキングします。 そのジョブのステータス、開始日、最終変更日、およびメッセージを返します。

  • query - generateProduct エンドポイントによって実行されたジョブのステータスをトラッキングします。 一連のジョブのステータス、開始日、最終変更日、およびメッセージを返します。

• workflows - ArcGIS Workflow Manager を使用する地形図作成ワークフローに関するリソースと操作を含みます。

  • taskGroups - SOE タスク グループに関する操作を含みます。

    • addTaskGroup - ワークフロー定義と組織に必要な詳細を組み合わせて、createTaskGroupJob 操作で SOE ジョブを作成するために使用できる SOE タスク グループを生成します。

    • createTaskGroupJob - SOE タスク グループを使用して SOE タスク グループ ジョブを作成し、Workflow Manager の親ジョブとその子ジョブを生成します。

    • getTaskGroups - SOE タスク グループに関する詳細を返します。

    • insertTasks - 既存の SOE タスク グループ作成ジョブに一連のタスクを挿入します。

    • removeTaskGroup - SOE タスク グループを削除します。

    • updateTaskGroup - SOE タスク グループを更新します。

  • tasks - タスク グループ ジョブに関する操作を含みます。

    • updateTask - タスク グループ ジョブ内のタスクのパラメーター値を更新します。

    • executeTaskJob - createTaskGroupJob 操作によって作成された SOE タスク グループ ジョブを実行します。

    • getTask - SOE タスク ジョブに関する詳細を返します

  • projects - 地形図作成サーバーと Workflow Manager のサービスベース ワークフローの統合を有効にする操作を含みます。

    • addProject - プロジェクトとそのすべてのフェーズを定義する JSON オブジェクトを受け付ける、単一パラメーターの操作。

    • queryProject - プロジェクトを表す JSON オブジェクトの配列を返します。

    • removeProject - プロジェクトを削除します。

    • updateProject - プロジェクトの JSON で定義されているプロパティを更新します。

Topographic Production データベース

ジオデータベースは、データを保存するために Topographic Production Service によって使用されます。 使用されるジオデータベース タイプは、SDE (空間データベース エンジン) 接続ファイルによって決定されます。 Server Manager では、SDE 接続ファイルへのパスを Topographic Production データベース テキスト ボックスに指定する必要があります。 ArcGIS Server アカウントには、.sde 接続ファイルの場所に対する読み取りアクセス権が必要です。

ヒント:

このファイルへのパスは、ArcGIS Pro で Topographic Production サービスを公開する際に、tmserverDatabase テキスト ボックスを使用して指定することもできます。

ArcGIS Pro での Topographic Production サービスの公開の詳細

地形図サーバー ジオデータベースには、複数のテーブルが含まれています。 TPS_Property テーブルには、サービスが ArcGIS Pro から公開されるときに定義されるプロパティが含まれており、公開後に ArcGIS Server Manager からアクセスできます。 このテーブルには、地形図作成 SOE を有効にした状態で公開された各サービスのプロパティも保存されます。 ArcGIS Enterprise 11.2 では、テーブルに ObjectID、ServiceIdentifier、Name、Value プロパティが含まれています。

注意:

ServiceIdentifier 列には、サービスのユニーク ID が含まれます。 ID の値が -1 の場合、そのプロパティはすべてのサービスに適用されるグローバル プロパティです。

TPS_Property テーブルの各行がプロパティです。 次の表では、各プロパティについて説明します:

プロパティ	説明
AdditionalOutputPaths	generateProduct 操作の追加の出力ファイル パス。 ファイル パスはセミコロンで区切る必要があります。 注意: 指定されたファイルへの読み取りおよび書き込みアクセス権が ArcGIS Server アカウントに付与されていない場合、これらの場所に出力をコピーする操作は失敗します。 指定された場所にあるデータおよび出力ファイルは、CleanupInterval プロパティで定義されたクリーンアップ中に削除されます。
AdminGroupId	ArcGIS Topographic Mapping サーバー エクステンションに含まれる Web アプリで、ユーザー グループがジョブをキャンセルまたは削除できるようにするグローバル プロパティ。 グループにこれらの権限を付与するには、Web アプリ用に作成するグループに対応するグループ ID の値と一致するように AdminGroupId プロパティを更新します。 スタンドアロン ArcGIS Server デプロイメントでは、このプロパティの値に、ArcGIS Server 管理者ロール タイプを持つユーザーのロール名を指定することで、グループにこれらの権限を割り当てることができます。 ArcGIS Server Manager でのロールの詳細
AllowedSDEAuthMode	許可される SDE 認証モード。 サポートされているバージョンは以下のとおりです。 注意: この値を更新してモードを変更することは、セキュリティー上のリスクを伴います。 この設定を変更することはおすすめしません。 OSA - オペレーティング システム認証 (オペレーティング システムまたはネットワーク ドメインによって実行される認証)。 これがデフォルトです。 DBMS - データベース管理システムはユーザー名とパスワードを管理します。 Basic - シンプルなユーザー名とパスワードによる認証。認証情報は ArcGIS Server または SDE 構成によって保存および管理されます。
AllowedServices	組織が安全と判断した、フェデレーション環境の外部にあるサービスのリスト。 このリストにはパブリック サービスのみを含める必要があり、カンマ区切り値を指定できます。 サービスの URL 構造は、許可されるサービスに影響します。 例: https://sampleserver6.arcgisonline.com/arcgis/rest/services/Census/MapServer/3 - 状態のレイヤー サービスのみを許可します (3 は状態)。 https://sampleserver6.arcgisonline.com/arcgis/rest/services/Census/MapServer - そのマップ サーバー内のレイヤー サービスを許可します。 https://sampleserver6.arcgisonline.com/arcgis/ - sampleserver6.arcgisonline.com ドメイン上のすべてのサービスを許可します。
AutoUpdateProducts	サーバーの再起動時に、.json ファイルで行われたマップ プロダクト定義への更新を、地形図サーバー ジオデータベース内のマップ プロダクト定義に反映するかどうかを指定します。 True - サービスが再起動されると、データベース内の既存のマップ プロダクト定義が、Enterprise 製品データ ファイルとともにインストールされた .json ファイルのマップ プロダクト定義で自動的に更新されます。 これがデフォルトです。 False - サービスが再起動されても、既存のマップ プロダクト定義は、Enterprise 製品データ ファイルとともにインストールされた .json ファイルのマップ プロダクト定義で自動的には更新されません。
CleanupInterval	マップ プロダクトの作成に使用された一時データおよび出力マップ プロダクトがサーバーから削除されるまでの時間 (時)。 デフォルトは 24 です。
DateTimeFormat	ジョブの出力ファイル名に日時を含むトークンが使用されている場合の日時形式。
DistributedJobFolders	このプロパティは今後のリリースで使用するために予約されており、現在はサポートされていません。
DistributedProcessing	このプロパティは今後のリリースで使用するために予約されており、現在はサポートされていません。
ExtractionProgress	ジョブのデータが抽出されている間に、ジョブの進行状況を更新するかどうかを指定します。 デフォルトは False です。 ヒント: 大規模なデプロイメントを操作する場合、値を False にするとデータベースのトラフィックが減少します。
extractionTimeout	データ抽出がタイムアウトするまでの実行時間 (秒)。
<file type>	注意: これはグローバル プロパティであり、ServiceIdentifier 値を -1 に設定します。 サポートされているファイル タイプは次のとおりです。 .aprx .dt2 .gdb .pagx .pdf .tiff .zip ジョブの出力ファイル名を定義するには、次のトークンを使用できます: [JobName] - generateProduct SOE 操作の outputName パラメーター値、または MPS アプリでのエクスポートの名前。 [JobId] - generateProduct SOE 操作または MPS アプリを使用してマップ プロダクトをエクスポートする際に作成される GUID (Globally Unique Identifier)。 [JobStartDate] - ジョブの開始日 (ローカル UTC 時間形式)。 [User] - ジョブを開始したユーザー。 [ProductName] - ジョブで指定されたマップ プロダクト名。 [ProductVersion] - ジョブで指定されたマップ プロダクトのバージョン。 [SheetIdentifier] - 選択されたインデックスの NRN (National Reference Number) 値。 [MGRS:] - シートの位置を提供する MGRS (Military Grid Reference System)。 [MGRS] - 4Q [MGRS:100km] - 4QFJ [MGRS:10km] - 4QFJ16 [MGRS:1km] - 4QFJ1267 [MGRS:100m] - 4QFJ123678 [MGRS:10m] - 4QFJ12346789 [MGRS:1m] - 4QFJ1234567890 [MGRS:ICM] - 1234 [AOI.] - AOI インデックス属性テーブルの値。 注意: 指定されたフィールドに NULL 値が含まれている場合、このトークンが名前に表示されます。 形式にファイル タイプの拡張子がない場合は、自動的にアペンドされます。 注意: ファイル名の競合を避けるため、[JobId] トークン、[JobStartDate] トークン、またはその両方を含めてください。
jobHistory	マップ作成ジョブに関連するデータがデータベースに保存される日数。 デフォルトは 365 です。 設定された日数が経過すると、データベース内のジョブ関連のレコードは完全に削除されます。
LastCleanup	ジョブの一時データがサーバーから最後に削除された日時。
productType	サービスによってサポートされるマップ プロダクト タイプ。 複数の値は、TM, JOG のようにカンマで区切る必要があります。 マップ プロダクト定義には type プロパティが含まれ、サービスは指定された値と一致する値を持つマップ プロダクトを返します。
resourceCheckInterval	クリーンアップをトリガーするために設定されたリソース閾値が満たされているかどうかを確認する時間間隔。 リソースにはディスク容量が含まれます。 デフォルト値は 300s (300 秒) です。 重要: これはソフト クリーンアップとみなされ、TopographicProduction フォルダーの下にある一時ジョブ ファイルは削除され、TPS_JOB テーブル内のジョブ レコードは cleaned 値で更新されますが、追加のディレクトリーにコピーされたファイルはそのまま残されます。
storageHighThreshold	最も古いジョブから強制的なクリーンアップをトリガーするディスク使用率。 デフォルト値は %90 (90%) です。 重要: これはソフト クリーンアップとみなされ、TopographicProduction フォルダーの下にある一時ジョブ ファイルは削除され、TPS_JOB テーブル内のジョブ レコードは cleaned 値で更新されますが、追加のディレクトリーにコピーされたファイルはそのまま残されます。
storageLowThreshold	高いディスク使用率が原因で強制的な SOE クリーンアップがトリガーされたときに到達するディスク使用率。 デフォルト値は %80 (80%) です。 重要: これはソフト クリーンアップとみなされ、TopographicProduction フォルダーの下にある一時ジョブ ファイルは削除され、TPS_JOB テーブル内のジョブ レコードは cleaned 値で更新されますが、追加のディレクトリーにコピーされたファイルはそのまま残されます。
UseJobIdFolder	ジョブのデフォルト出力フォルダーの名前をジョブ ID に基づいて付与するかどうかを指定するグローバル プロパティ。 デフォルトは True です。 値が False に設定されている場合、jobStatus レスポンス内の出力 URL にはジョブ ID が含まれません。
Version	地形図サーバー ジオデータベースのバージョン。 注意: ArcGIS Enterprise 12.1 以降、この値は Enterprise の現在のバージョンと一致します。
WorkflowItemIdentifier	地形図作成ワークフロー アイテムに関連する ID 文字列。
WorkflowLocalJobFolder	ローカル ジョブのデータを含むフォルダーの場所へのパス。