結果のパッケージ化 (Package Result) (データ管理)

サマリー

すべてのツールや入力および出力データセットなど、1 つ以上のジオプロセシング結果を 1 つの圧縮ファイル (*.gpkx) にパッケージ化します。

使用法

  • ツールを実行すると、ジオプロセシング履歴アイテムが [カタログ] ウィンドウの [ジオプロセシング履歴] セクションに追加されます。 [結果のパッケージ化] ツールの入力として、このアイテムを使用します。

    Python からツールを実行すると、Result オブジェクトが返されます。 Result オブジェクトの resultID プロパティは、このツールへの入力として使用できます。 下の 2 番目のコードのサンプルは、Result オブジェクトの resultID プロパティの使用方法を示しています。

  • [ArcGIS Runtime のサポート] がオンの場合、作成されたジオプロセシング パッケージを ArcGIS Runtime SDK 環境で使用できます。 ランタイム環境をサポートすると、次のようになります。

    • ジオデータベース以外のすべてのデータ ソースは、ファイル ジオデータベースに変換されます。
    • パッケージ化されるツールのコピーが公開用に構成された新しいツールボックス内に作成されます。

    注意:

    ArcGIS Pro 2.1 以降では、ArcGIS Runtime をサポートするジオプロセシング パッケージを作成できます。

  • [データをファイル ジオデータベースへ変換] パラメーターをオンにしたとき、以下が発生します。

    • 一意のデータ ソースごとに、ファイル ジオデータベースが統合フォルダーまたはパッケージに作成されます。
    • 圧縮されたラスター形式およびベクター形式は、ファイル ジオデータベースに変換され、圧縮は解除されます。
    • エンタープライズ ジオデータベースのデータは統合されません。 エンタープライズ ジオデータベースのデータをファイル ジオデータベースに変換するには、[データを参照せずにエンタープライズ ジオデータベースのデータを含める] パラメーターをオンにします。

  • [データをファイル ジオデータベースへ変換] パラメーターをオフにしたとき、以下が発生します。

    • 可能な場合、入力レイヤーのデータ ソース形式が維持されます。
    • ADRG、CADRG/ECRG、CIB、および RPF ラスター形式は、常にファイル ジオデータベース ラスターに変換されます。 ArcGIS は、ネイティブにこれらの形式を書き出すことはできません。 効率のために、それらは常にファイル ジオデータベース ラスターに変換されます。
    • 出力フォルダー構造の中で、ファイル ジオデータベースはバージョン固有のフォルダーに統合され、それ以外の形式はすべて commonData フォルダーに統合されます。
    • 圧縮されたラスターおよびベクター形式は、[範囲] パラメーターに範囲が指定されていても、クリップされません。

  • 結合を含むか、リレーションシップ クラスに属するレイヤーの場合、結合したデータ ソースまたは関連付けられたデータ ソースはすべて出力フォルダーに統合されます。 デフォルトでは、結合したデータ ソースまたは関連付けられたデータ ソースは、[範囲] パラメーターを使用して指定された範囲に基づいて、全体が統合されるか、[関連行の選択] パラメーター値に応じて統合されます。

  • フィーチャ レイヤーの場合は、[範囲] パラメーターを使用して、統合するフィーチャを選択します。 ラスター レイヤーの場合は、[範囲] パラメーターを使用して、ラスター データセットをクリップします。

  • 一部のデータセットは、他のデータセットを参照しています。 たとえば、4 つのフィーチャクラスを参照するトポロジ データセットなどがあります。 他のデータセットを参照するそれ以外のデータセットの例として、ジオメトリック ネットワーク、ネットワーク、およびロケーターを挙げることができます。 これらのタイプのデータセットを基にしてレイヤーを統合またはパッケージ化するときは、それに属しているデータセットも統合またはパッケージ化されます。

  • [スキーマのみ] パラメーターをオンにした場合は、入力および出力データ ソースのスキーマのみが統合またはパッケージ化されます。 スキーマは、フィーチャクラスまたはテーブルの構造または設計であり、フィールドおよびテーブル定義、座標系プロパティ、シンボル、フィルター設定などで構成されます。 データまたはレコードは統合またはパッケージ化されません。

  • スキーマのみをサポートしないデータ ソースは、統合またはパッケージ化されません。 [スキーマのみ] パラメーターをオンにしているときに、スキーマのみではサポートされないレイヤーが検出されると、警告メッセージが表示され、そのレイヤーはスキップされます。 指定した唯一のレイヤーがスキーマのみではサポートされない場合、ツールは失敗します。

  • ジオプロセシング パッケージを解凍するには、[パッケージの抽出] ツールを使用して、コンテンツをフォルダーに抽出します。 抽出後、ディレクトリを参照し、ツールとデータを調べます。 または、[カタログ] ウィンドウのフォルダーからパッケージを右クリックして、現在のマップに抽出します。 このツールは、[ジオプロセシング履歴] セクションからアクセスできます。

    デフォルトでは、[カタログ] ウィンドウからパッケージを抽出すると、コンテンツはユーザー プロファイルに抽出されます。

パラメーター

ラベル説明データ タイプ
結果

パッケージ化する結果。

入力は、現在のプロジェクトの履歴による結果か、Python スクリプトでツールが使用されている場合は Result オブジェクトの resultID プロパティにすることができます。

File; String
出力ファイル

出力パッケージ ファイル (*.gpkx) の名前と場所。

File
データをファイル ジオデータベースへ変換
(オプション)

入力レイヤーをファイル ジオデータベースに変換するか、その元の形式で維持するかを指定します。

  • オン - すべてのデータがファイル ジオデータベースに変換されます。 このオプションは、エンタープライズ ジオデータベースのデータ ソースには適用されません。 エンタープライズ ジオデータベースのデータを含めるには、[データを参照せずにエンタープライズ ジオデータベースのデータを含める] パラメーターをオンにします。
  • オフ - 可能な限り、データ形式が維持されます。 これがデフォルトです。
Boolean
データを参照せずにエンタープライズ ジオデータベースのデータを含める
(オプション)

入力エンタープライズ ジオデータベース レイヤーをファイル ジオデータベースに変換するか、その元の形式で維持するかを指定します。

  • オン - すべてのエンタープライズ ジオデータベースのデータ ソースがファイル ジオデータベースに変換されます。 これがデフォルトです。
  • オフ - すべてのエンタープライズ ジオデータベースのデータ ソースは維持され、結果として得られるパッケージ内で参照されます。
Boolean
範囲
(オプション)

フィーチャを選択またはクリップするために使用する範囲を指定します。

  • [デフォルト] - 範囲はすべての入力の最大範囲に基づきます。これがデフォルトです。
  • [入力データのすべての領域] - この範囲は、すべての入力の最大範囲に基づきます。
  • [入力データの共通領域] - この範囲は、すべての入力に共通する最小領域に基づきます。
  • [現在の表示範囲] - 範囲は、表示範囲と同じになります。アクティブなマップが存在しない場合、このオプションは使用できません。
  • [以下の指定に一致] - この範囲は、指定された最小および最大範囲値に基づきます。
  • [参照] - 範囲は、既存のデータセットに基づきます。
Extent
エンタープライズ ジオデータベース レイヤーのみに範囲を適用
(オプション)

指定した範囲をすべてのレイヤーに適用するか、エンタープライズ ジオデータベースのレイヤーだけに適用するかを指定します。

  • オフ - 範囲がすべてのレイヤーに適用されます。 これがデフォルトです。
  • オン - 範囲がエンタープライズ ジオデータベース レイヤーにのみ適用されます。
Boolean
スキーマのみ
(オプション)

入力および出力データセットのすべてのフィーチャとレコードを統合またはパッケージ化するか、入力および出力データセットのスキーマだけを統合またはパッケージ化するかどうかを指定します。

  • オフ - 入力および出力データセットのすべてのフィーチャおよびレコードが統合フォルダーまたはパッケージに入ります。 これがデフォルトです。
  • オン - 入力および出力データセットのスキーマだけが統合またはパッケージ化されます。 フィーチャとレコードは、出力フォルダーで統合またはパッケージ化されません。
Boolean
ArcGIS Runtime のサポート
(オプション)

パッケージが ArcGIS Runtime をサポートするかどうかを指定します。 ArcGIS Runtime をサポートすると、すべてのデータ ソースがファイル ジオデータベースに変換され、パッケージにサーバー互換ツールが作成されます。

  • オフ - 出力パッケージは ArcGIS Runtime をサポートしません。 これがデフォルトです。
  • オン - 出力パッケージは ArcGIS Runtime をサポートします。
Boolean
追加ファイル
(オプション)

ファイルをパッケージに追加します。 *.doc、*.txt、*.pdf などの追加ファイルは、パッケージのコンテンツや目的に関する詳細を提供します。

File
概要
(オプション)

概要情報をパッケージのプロパティに追加します。

String
タグ
(オプション)

タグ情報をパッケージのプロパティに追加します。 カンマやセミコロンで区切ることで、複数のタグを追加できます。

String
パッケージのバージョン
(オプション)

出力パッケージ内に作成される、ジオデータベースのバージョンを指定します。 バージョンを指定すると、パッケージを ArcGIS の以前のバージョンと共有し、後方互換性がサポートされます。

注意:

パッケージを以前のバージョンで保存すると、新しいバージョンでのみ利用できるプロパティが失われる可能性があります。

  • すべてのバージョンパッケージには、すべてのバージョン (ArcGIS Pro 2.1 以降) と互換性があるジオデータベースおよびマップが含まれています。
  • 現在のバージョンパッケージには、現在のリリースのバージョンと互換性があるジオデータベースおよびマップが含まれています。
  • 2.1
  • 2.2パッケージには、バージョン 2.2 と互換性があるジオデータベースおよびマップが含まれています。
  • 2.3パッケージには、バージョン 2.3 と互換性があるジオデータベースおよびマップが含まれています。
  • 2.4パッケージには、バージョン 2.4 と互換性があるジオデータベースおよびマップが含まれています。
  • 2.5パッケージには、バージョン 2.5 と互換性があるジオデータベースおよびマップが含まれています。
  • 2.6パッケージには、バージョン 2.6 と互換性があるジオデータベースおよびマップが含まれています。
  • 2.7パッケージには、バージョン 2.7 と互換性があるジオデータベースおよびマップが含まれています。
  • 2.8パッケージには、バージョン 2.8 と互換性があるジオデータベースおよびマップが含まれています。
  • 2.9パッケージには、バージョン 2.9 と互換性があるジオデータベースおよびマップが含まれています。
  • 3.0パッケージには、バージョン 3.0 と互換性があるジオデータベースおよびマップが含まれています。
String
範囲内のフィーチャに関連する行のみを維持
(オプション)

指定した範囲を、関連するデータ ソースに適用するかどうかを指定します。

  • オフ - 関連するデータ ソースが全体的に統合されます。 これがデフォルトです。
  • オン - 指定した範囲内のレコードに対応する関連データだけが統合されます。
Boolean

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
(オプション)

入力レイヤーをファイル ジオデータベースに変換するか、その元の形式で維持するかを指定します。

  • CONVERTデータはファイル ジオデータベースに変換されます。 このオプションは、エンタープライズ ジオデータベースのデータ ソースには適用されません。 エンタープライズ ジオデータベースのデータに変換するには、convert_arcsde_data パラメーターを CONVERT_ARCSDE に設定します。
  • PRESERVE可能な限り、データ形式が維持されます。 これがデフォルトです。
Boolean
convert_arcsde_data
(オプション)

入力エンタープライズ ジオデータベース レイヤーをファイル ジオデータベースに変換するか、その元の形式で維持するかを指定します。

  • CONVERT_ARCSDEエンタープライズ ジオデータベースのデータはファイル ジオデータベースに変換され、統合フォルダーまたはパッケージに加えられます。 これがデフォルトです。
  • PRESERVE_ARCSDEエンタープライズ ジオデータベースのデータは維持され、統合フォルダーまたはパッケージ内で参照されます。
Boolean
extent
(オプション)

フィーチャを選択またはクリップするために使用する範囲を指定します。

  • MAXOF - すべての入力の最大範囲が使用されます。
  • MINOF - すべての入力に共通する最小領域が使用されます。
  • DISPLAY - 範囲は、表示範囲と同じになります。
  • [レイヤー名] - 指定したレイヤーの範囲が使用されます。
  • Extent オブジェクト - 指定したオブジェクトの範囲が使用されます。
  • [座標のスペース区切りの文字列] - 指定した文字列の範囲が使用されます。座標は、x-min、y-min、x-max、y-max の順序で表されます。
Extent
apply_extent_to_arcsde
(オプション)

指定した範囲をすべてのレイヤーに適用するか、エンタープライズ ジオデータベースのレイヤーだけに適用するかを指定します。

  • ALL指定した範囲がすべてのレイヤーに適用されます。 これがデフォルトです。
  • ARCSDE_ONLY指定した範囲がエンタープライズ ジオデータベースのレイヤーのみに適用されます。
Boolean
schema_only
(オプション)

入力および出力データセットのすべてのレコードを統合またはパッケージ化するか、入力および出力データセットのスキーマだけを統合またはパッケージ化するかどうかを指定します。

  • ALL入力および出力データセットのすべてのレコードが統合またはパッケージ化されます。 これがデフォルトです。
  • SCHEMA_ONLY入力および出力データセットのスキーマだけが統合またはパッケージ化されます。
Boolean
arcgisruntime
(オプション)

パッケージが ArcGIS Runtime をサポートするかどうかを指定します。 ArcGIS Runtime をサポートすると、すべてのデータ ソースがファイル ジオデータベースに変換されます。

  • DESKTOP出力パッケージは ArcGIS Runtime をサポートしません。 これがデフォルトです。
  • RUNTIME出力パッケージは ArcGIS Runtime をサポートします。
Boolean
additional_files
[additional_files,...]
(オプション)

ファイルをパッケージに追加します。 *.doc、*.txt、*.pdf などの追加ファイルは、パッケージのコンテンツや目的に関する詳細を提供します。

File
summary
(オプション)

概要情報をパッケージのプロパティに追加します。

String
tags
(オプション)

タグ情報をパッケージのプロパティに追加します。 カンマやセミコロンで区切ることで、複数のタグを追加できます。

String
version
[version,...]
(オプション)

出力パッケージ内に作成される、ジオデータベースのバージョンを指定します。 バージョンを指定すると、パッケージを ArcGIS の以前のバージョンと共有し、後方互換性がサポートされます。

注意:

パッケージを以前のバージョンで保存すると、新しいバージョンでのみ利用できるプロパティが失われる可能性があります。

  • ALLパッケージには、すべてのバージョン (ArcGIS Pro 2.1 以降) と互換性があるジオデータベースおよびマップが含まれています。
  • CURRENTパッケージには、現在のリリースのバージョンと互換性があるジオデータベースおよびマップが含まれています。
  • 2.2パッケージには、バージョン 2.2 と互換性があるジオデータベースおよびマップが含まれています。
  • 2.3パッケージには、バージョン 2.3 と互換性があるジオデータベースおよびマップが含まれています。
  • 2.4パッケージには、バージョン 2.4 と互換性があるジオデータベースおよびマップが含まれています。
  • 2.5パッケージには、バージョン 2.5 と互換性があるジオデータベースおよびマップが含まれています。
  • 2.6パッケージには、バージョン 2.6 と互換性があるジオデータベースおよびマップが含まれています。
  • 2.7パッケージには、バージョン 2.7 と互換性があるジオデータベースおよびマップが含まれています。
  • 2.8パッケージには、バージョン 2.8 と互換性があるジオデータベースおよびマップが含まれています。
  • 2.9パッケージには、バージョン 2.9 と互換性があるジオデータベースおよびマップが含まれています。
  • 3.0パッケージには、バージョン 3.0 と互換性があるジオデータベースおよびマップが含まれています。
String
select_related_rows
(オプション)

指定した範囲を、関連するデータ ソースに適用するかどうかを指定します。

  • KEEP_ONLY_RELATED_ROWS指定した範囲内のレコードに対応する関連データだけが統合されます。
  • KEEP_ALL_RELATED_ROWS関連するデータ ソースが全体的に統合されます。 これがデフォルトです。
Boolean

コードのサンプル

PackageResult の例 1 (Python ウィンドウ)

次の Python スクリプトは、PackageResult 関数を Python ウィンドウで使用する方法を示しています。

import arcpy
arcpy.env.workspace = "C:/ResultFiles" 
arcpy.management.PackageResult('Parcel.rlt', 'Parcel.gpk', "PRESERVE", 
                               "CONVERT_ARCSDE", "#", "ALL", "ALL", 
                               "DESKTOP", r"C:\docs\readme.txt", 
                               "Summary text", "Tag1; tag2; tag3")
PackageResult の例 2 (スタンドアロン スクリプト)

次の 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.management.PackageResult(parcelUpdate.resultID, "c:/gpks/parcelgpk.gpkx", 
                               "PRESERVE", "CONVERT_ARCSDE", "#", "ALL", 
                               "ALL", "DESKTOP", "#", "Summary text", "Tag1")

環境

このツールは、ジオプロセシング環境を使用しません。

ライセンス情報

  • Basic: Yes
  • Standard: Yes
  • Advanced: Yes

関連トピック