結果のパッケージ化(Package Result) (データ管理)
サマリ
すべてのツールや入力および出力データセットなど、1 つ以上のジオプロセシング結果を 1 つの圧縮ファイル(*.gpk)にパッケージ化します。
使用法
ツールを実行するとき、実行に関する情報が結果として書き込まれます。 [結果] ウィンドウに書き込まれます。結果は、ドラッグ アンド ドロップで [結果] ウィンドウから入力として直接追加したり、結果ファイル(*.rlt)として保存した結果を入力として追加したりできます。
[ArcGIS Runtime のサポート] がオンの場合、作成されたジオプロセシング パッケージを ArcGIS Runtime 環境で使用できます。ランタイム環境をサポートすると
- ジオデータベースでないすべてのデータソースはファイル ジオデータベースに変換されます。
- マップ サービス定義ファイル(*.msd)が作成され、パッケージに追加されます。
- パッケージ化されるツールのコピーが公開用に構成された新しいツールボックス内に作成されます。
-
[データをファイル ジオデータベースへ変換] をオンにしたとき
- 一意のデータ ソースごとに、ファイル ジオデータベースが統合フォルダまたはパッケージに作成されます。
- 圧縮されたラスタ形式およびベクタ形式は、ファイル ジオデータベースに変換され、圧縮は解除されます。
- エンタープライズ ジオデータベースのデータは統合されません。エンタープライズ ジオデータベースのデータをファイル ジオデータベースに変換するには、[データを参照せずにエンタープライズ ジオデータベースのデータを含める] をオンにします。
-
[データをファイル ジオデータベースへ変換] をオフにしたとき
- 入力レイヤのデータ ソース形式が維持されます。例外は、パーソナル ジオデータベース(*.mdb)データ、VPF データ、Excel スプレッドシートまたは OLEDB 接続に基づくテーブルなどの形式です。これらの形式は、64x 環境ではサポートされないため、常にファイル ジオデータベースに変換されます。
- ADRG、CADRG/ECRG、CIB、および RPF ラスタ形式は、常にファイル ジオデータベース ラスタに変換されます。ArcGIS は、ネイティブにこれらの形式を書き出すことはできません。効率のために、それらは常にファイル ジオデータベース ラスタに変換されます。
- 出力フォルダ構造の中で、ファイル ジオデータベースはバージョン固有のフォルダに統合され、それ以外の形式はすべて commonData フォルダに統合されます。
- 圧縮されたラスタおよびベクタ形式は、[範囲] パラメータに範囲が指定されていても、クリップされません。
結合を含むか、リレーションシップ クラスに属するレイヤの場合、結合したデータ ソースまたは関連付けられたデータ ソースはすべて出力フォルダに統合されます。
フィーチャ レイヤの場合は、[範囲] パラメータを使用して、統合されるフィーチャを選択します。ラスタ レイヤの場合は、[範囲] パラメータを使用して、ラスタ データセットをクリップします。
一部のデータセットは、他のデータセットを参照しています。たとえば、4 つのフィーチャクラスを参照するトポロジ データセットなどがあります。他のデータセットを参照するそれ以外のデータセットの例として、ジオメトリック ネットワーク、ネットワーク、およびロケータを挙げることができます。これらのタイプのデータセットを基にしてレイヤを統合またはパッケージ化するときは、それに属しているデータセットも統合またはパッケージ化されます。
[スキーマのみ] パラメータをオンにすると、入力および出力データ ソースのスキーマだけを統合またはパッケージ化できます。スキーマは、フィーチャクラスまたはテーブルの構造または設計であり、フィールドおよびテーブル定義、座標系プロパティ、シンボル、定義クエリなどで構成されます。データまたはレコードは統合またはパッケージ化されません。
-
スキーマのみをサポートしないデータ ソースは、統合またはパッケージ化されません。[スキーマのみ] パラメータをオンにしているときに、スキーマのみではサポートされないレイヤが検出されると、警告メッセージが表示され、そのレイヤはスキップされます。指定した唯一のレイヤがスキーマのみではサポートされない場合、ツールは失敗します。
失敗した結果からパッケージを作成することはできません。ただし、[結果の統合(Consolidate Result)] ツールを使用して、失敗した結果が使用していたすべてのデータとツールを含むフォルダを作成することはできます。
-
ジオプロセシング パッケージを解凍するには、*.gpk ファイルを ArcMap にドラッグするか、*.gpk ファイルを右クリックして [解凍] をクリックします。かわりに、[パッケージの抽出(Extract Package)] ツールを使用して、出力フォルダを指定しても同じです。
デフォルトでは、パッケージは次の格納場所にあるユーザ プロファイルに抽出されます。
- XP - C:\Documents and Settings\<ユーザ名>\My Documents\ArcGIS\Packages
- Vista および Windows 7 - C:\Users\<ユーザ名>\Documents\ArcGIS\Packages
パッケージを解凍するデフォルトの場所を変更するには、[カスタマイズ] メニューから [ArcMap オプション] を開きます。[共有] タブの [パッケージ] セクションで、[ユーザが指定した場所を使用する] をオンにして、新しいフォルダの場所を選択します。
失敗した結果からパッケージを作成することはできません。ただし、[結果の統合(Consolidate Result)] ツールを使用して、失敗した結果が使用していたすべてのデータとツールを含むフォルダを作成することはできます。
構文
パラメータ | 説明 | データ タイプ |
in_result |
パッケージ化される結果。 入力は、ドラッグ アンド ドロップで [結果] ウィンドウから直接追加された結果か、結果ファイル(*.rlt)を選択します。 | File; String |
output_file |
出力パッケージ ファイル(*.gpk)の名前と場所。 | File |
convert_data (オプション) |
入力レイヤをファイル ジオデータベースに変換するか、それとも元のフォーマットを保持するかを指定します。
| Boolean |
convert_arcsde_data (オプション) |
入力エンタープライズ ジオデータベース レイヤをファイル ジオデータベースに変換するか、その元の形式を維持するかを指定します。
| Boolean |
extent (オプション) |
範囲パラメータに X-Min Y-Min X-Max Y-Max という形式を使用して座標を入力することによって範囲を指定します。特定レイヤの範囲を使用するには、レイヤ名を指定します。
| Extent |
apply_extent_to_arcsde (オプション) |
指定された範囲をすべてのレイヤに適用するか、エンタープライズ ジオデータベースのレイヤだけに適用するかを決定します。
| Boolean |
schema_only (オプション) |
入力および出力データセットのスキーマだけを統合またはパッケージ化するかどうかを指定します。
| Boolean |
arcgisruntime (オプション) |
パッケージが ArcGIS Runtime をサポートするかどうかを指定します。ArcGIS Runtime をサポートすると、すべてのデータ ソースがファイル ジオデータベースに変換され、パッケージに *.msd ファイルが作成されます。
| Boolean |
additional_files (オプション) |
ファイルをパッケージに追加します。*.doc、*.txt、*.pdf などの追加ファイルは、パッケージのコンテンツや目的に関する詳細を提供します。 | File |
summary (オプション) |
サマリ情報をパッケージのプロパティに追加します。 | String |
tags (オプション) |
タグ情報をパッケージのプロパティに追加します。カンマやセミコロンで区切ることで、複数のタグを追加できます。 | String |
コードのサンプル
次の Python スクリプトは、Python ウィンドウから PackageResult(結果のパッケージ化)ツールを使用する方法を示しています。
import arcpy
arcpy.env.workspace = "C:/ResultFiles"
arcpy.PackageResult_management('Parcel.rlt', 'Parcel.gpk', "PRESERVE", "CONVERT_ARCSDE", "#", "ALL", "ALL", "DESKTOP", r"C:\docs\readme.txt", "Summary text", "Tag1; tag2; tag3")
指定したフォルダ内に存在するすべての結果ファイルを検索し、結果ファイルごとに個別のジオプロセシング パッケージを作成します。
# Name: PackageResultEx1.py
# Description: Find all the result files that reside in a specified folder and create a geoprocessing package for each result file.
# import system modules
import os
import arcpy
from arcpy import env
# Set environment settings
env.overwriteOutput = True
env.workspace = "C:/ResultFiles"
# Loop through the workspace, find all the result files (.rlt) and create a geoprocessing package using the same name as the original result file.
for rlt in arcpy.ListFiles("*.rlt"):
print "Packaging " + rlt
arcpy.PackageResult_management(rlt, os.path.splitext(lyr)[0] + '.gpk', "PRESERVE", "CONVERT_ARCSDE", "#", "ALL", "ALL", "DESKTOP", r"C:\docs\readme.txt", "Summary text", "Tag1; tag2; tag3")
指定したフォルダ内に存在するすべての結果ファイルを検索し、すべての結果ファイルに対して 1 つのジオプロセシング パッケージを作成します。
# Name: PackageResultEx2.py
# Description: Find all the result files that reside in a specified folder and create a single geoprocessing package.
# import system modules
import os
import arcpy
from arcpy import env
# Set environment settings
env.overwriteOutput = True
env.workspace = "C:/ResultFiles"
# Find all the result files (.rlt) in a workspace and create a single geoprocessing package.
rlts = arcpy.ListFiles("*.rlt")
arcpy.PackageResult_management(rlts, 'all_layers.gpk', "PRESERVE", "CONVERT_ARCSDE", "#", "ALL", "ALL", "DESKTOP", r"C:\docs\readme.txt", "Summary text", "Tag1; tag2; tag3")