概要
すべてのツールや入力および出力データセットなど、1 つ以上のジオプロセシング結果を 1 つの圧縮ファイル (*.gpkx) にパッケージ化します。
使用法
ツールを実行すると、ジオプロセシング履歴アイテムが [カタログ] ウィンドウの [ジオプロセシング履歴] セクションに追加されます。[結果のパッケージ化 (Package Result)] ツールの入力として、このアイテムを使用します。
Python からツールを実行すると、ツールの実行から Result オブジェクトが返されます。Result オブジェクトの resultID プロパティは、このツールへの入力として使用できます。「コードのサンプル」セクションの 2 つ目の例は、Result オブジェクトの resultID プロパティの使用方法を示しています。
[ArcGIS Runtime のサポート] がオン (Python では arcgisruntime="RUNTIME") の場合、作成されたジオプロセシング パッケージを ArcGIS Runtime SDK 環境で使用できます。ランタイム環境をサポートすると、次のようになります。
- ジオデータベース以外のすべてのデータ ソースは、ファイル ジオデータベースに変換されます。
- パッケージ化されるツールのコピーが公開用に構成された新しいツールボックス内に作成されます。
メモ:
ArcGIS Pro 2.1 以降では、ArcGIS Runtime をサポートするジオプロセシング パッケージを作成できます。
[データをファイル ジオデータベースへ変換] をオン (Python では convert_data = 'CONVERT') にしたとき、以下が発生します。
- 一意のデータ ソースごとに、ファイル ジオデータベースが統合フォルダーまたはパッケージに作成されます。
- 圧縮されたラスター形式およびベクター形式は、ファイル ジオデータベースに変換され、圧縮は解除されます。
- エンタープライズ ジオデータベースのデータは統合されません。エンタープライズ ジオデータベースのデータをファイル ジオデータベースに変換するには、[データを参照せずにエンタープライズ ジオデータベースのデータを含める] をオンにします。
[データをファイル ジオデータベースへ変換] をオフ (Python では convert_data = 'PRESERVE') にしたとき、以下が発生します。
- 可能な場合、入力レイヤーのデータ ソース形式が維持されます。
- ADRG、CADRG/ECRG、CIB、および RPF ラスター形式は、常にファイル ジオデータベース ラスターに変換されます。ArcGIS は、ネイティブにこれらの形式を書き出すことはできません。効率のために、それらは常にファイル ジオデータベース ラスターに変換されます。
- 出力フォルダー構造の中で、ファイル ジオデータベースはバージョン固有のフォルダーに統合され、それ以外の形式はすべて commonData フォルダーに統合されます。
- 圧縮されたラスターおよびベクター形式は、[範囲] パラメーターに範囲が指定されていても、クリップされません。
結合を含むか、リレーションシップ クラスに属するレイヤーの場合、結合したデータ ソースまたは関連付けられたデータ ソースはすべて出力フォルダーに統合されます。デフォルトでは、結合したデータ ソースまたは関連付けられたデータ ソースは、[範囲] パラメーターを使用して指定された範囲に基づいて、全体が統合されるか、[関連行の選択] パラメーターに応じて統合されます。
フィーチャ レイヤーの場合は、[範囲] パラメーターを使用して、統合するフィーチャを選択します。ラスター レイヤーの場合は、[範囲] パラメーターを使用して、ラスター データセットをクリップします。
一部のデータセットは、他のデータセットを参照しています。たとえば、4 つのフィーチャクラスを参照するトポロジ データセットなどがあります。他のデータセットを参照するそれ以外のデータセットの例として、ジオメトリック ネットワーク、ネットワーク、およびロケーターを挙げることができます。これらのタイプのデータセットを基にしてレイヤーを統合またはパッケージ化するときは、それに属しているデータセットも統合またはパッケージ化されます。
[スキーマのみ] パラメーターをオンにした場合は、入力および出力データ ソースのスキーマのみが統合またはパッケージ化されます。スキーマは、フィーチャクラスまたはテーブルの構造または設計であり、フィールドおよびテーブル定義、座標系プロパティ、シンボル、フィルター設定などで構成されます。データまたはレコードは統合またはパッケージ化されません。
スキーマのみをサポートしないデータ ソースは、統合またはパッケージ化されません。[スキーマのみ] パラメーターをオンにしているときに、スキーマのみではサポートされないレイヤーが検出されると、警告メッセージが表示され、そのレイヤーはスキップされます。指定した唯一のレイヤーがスキーマのみではサポートされない場合、ツールは失敗します。
ジオプロセシング パッケージを解凍するには、[パッケージの抽出 (Extract Package)] ツールを使用して、コンテンツをフォルダーに抽出します。抽出後、ディレクトリに移動し、ツールとデータを調べます。または、[カタログ] ウィンドウのフォルダーからパッケージを右クリックして、現在のマップに抽出します。このツールは、[ジオプロセシング履歴] セクションからアクセスできます。
デフォルトでは、[カタログ] ウィンドウからパッケージを抽出すると、コンテンツはユーザー プロファイルに抽出されます。
構文
arcpy.management.PackageResult(in_result, output_file, {convert_data}, {convert_arcsde_data}, {extent}, {apply_extent_to_arcsde}, {schema_only}, {arcgisruntime}, {additional_files}, {summary}, {tags}, {version}, {select_related_rows})| パラメーター | 説明 | データ タイプ |
in_result [in_result,...] | パッケージ化する結果。 入力は、現在のプロジェクトの履歴による結果か、Python スクリプトでツールが使用されている場合は Result オブジェクトの resultID プロパティにすることができます。 | File; String |
output_file | 出力パッケージ ファイル (*.gpkx) の名前と場所。 | File |
convert_data (オプション) | 入力レイヤーをファイル ジオデータベースに変換するか、その元の形式で維持するかを指定します。
| Boolean |
convert_arcsde_data (オプション) | 入力エンタープライズ ジオデータベース レイヤーをファイル ジオデータベースに変換するか、その元の形式で維持するかを指定します。
| Boolean |
extent (オプション) | フィーチャを選択またはクリップするために使用される範囲を指定します。
| Extent |
apply_extent_to_arcsde (オプション) | 指定した範囲をすべてのレイヤーに適用するか、エンタープライズ ジオデータベースのレイヤーだけに適用するかを指定します。
| Boolean |
schema_only (オプション) | 入力および出力データセットのスキーマだけを統合またはパッケージ化するかどうかを指定します。
| Boolean |
arcgisruntime (オプション) | パッケージが ArcGIS Runtime をサポートするかどうかを指定します。ArcGIS Runtime をサポートすると、すべてのデータ ソースがファイル ジオデータベースに変換されます。
| Boolean |
additional_files [additional_files,...] (オプション) | ファイルをパッケージに追加します。*.doc、*.txt、*.pdf などの追加ファイルは、パッケージのコンテンツや目的に関する詳細を提供します。 | File |
summary (オプション) | 概要情報をパッケージのプロパティに追加します。 | String |
tags (オプション) | タグ情報をパッケージのプロパティに追加します。カンマやセミコロンで区切ることで、複数のタグを追加できます。 | String |
version [version,...] (オプション) | 出力パッケージ内に作成される、ジオデータベースのバージョンを指定します。バージョンを指定すると、パッケージを ArcGIS の以前のバージョンと共有できるようになり、後方互換性がサポートされます。 メモ:パッケージを以前のバージョンで保存すると、新しいバージョンでのみ利用できるプロパティが失われる可能性があります。
| String |
select_related_rows (オプション) | 指定した範囲を関連するデータ ソースに適用するかどうかを指定します。
| Boolean |
コードのサンプル
次の 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")次の Python スクリプトで、Python ウィンドウまたはカスタム ツールの Result オブジェクトを持つスクリプトから、PackageResult ツールを使用する方法を示します。
import arcpy
# Import toolbox with custom model inside
arcpy.ImportToolbox("c:/gisworkflows/ParcelTools.tbx")
# Run the tool and assign to a result variable
parcelUpdate = arcpy.ParcelUpdater_ParcelTools("c:/data/parcels.gdb/ward3", "UPDATE")
arcpy.PackageResult_management(parcelUpdate.resultID, "c:/gpks/parcelgpk.gpkx",
"PRESERVE", "CONVERT_ARCSDE", "#", "ALL",
"ALL", "DESKTOP", "#", "Summary text", "Tag1")環境
ライセンス情報
- Basic: はい
- Standard: はい
- Advanced: はい