レイヤーのパッケージ化 (Package Layer) (データ管理)

概要

1 つまたは複数のレイヤーおよびすべての参照先データ ソースをパッケージ化し、単一の圧縮 *.lpkx ファイルを作成します。

使用法

  • このツールはサポートされていないレイヤー タイプを見つけると警告を出します。サポートされていないレイヤーは出力に書き込まれません。

  • ツールを実行するには、すべての入力レイヤーに説明を追加する必要があります。説明を追加するには、レイヤーを右クリックし、[プロパティ] をクリックして、説明を入力します。

  • メモ:
    ArcGIS Pro で作成されたレイヤー パッケージは、ArcGIS 10 および ArcGIS 9.3.1 と下位互換性がありません。ArcGIS Pro で作成されたパッケージは、ArcGIS Pro だけで開くことができます。
  • [データをファイル ジオデータベースへ変換] をオン (Python では convert_data = 'CONVERT') にしたとき、以下が発生します。

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

  • [データをファイル ジオデータベースへ変換] をオフ (Python では convert_data = 'PRESERVE') にしたとき、以下が発生します。

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

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

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

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

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

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

  • レイヤー パッケージ (*.lpkx) を解凍するには、[カタログ] ウィンドウからそのパッケージを含むフォルダーに移動し、右クリックして、[現在のマップに追加] をクリックします。代わりに、[パッケージの抽出 (Extract Package)] ツールを使用して、出力フォルダーを指定しても解凍できます。

    デフォルトでは、[現在のマップに追加] を使用すると、パッケージは常に、次のユーザー プロフィールに抽出されます: C:\Users\<username>\Documents\ArcGIS\Packages

構文

arcpy.management.PackageLayer(in_layer, output_file, {convert_data}, {convert_arcsde_data}, {extent}, {apply_extent_to_arcsde}, {schema_only}, {version}, {additional_files}, {summary}, {tags}, {select_related_rows})
パラメーター説明データ タイプ
in_layer
[in_layer,...]

パッケージ化するレイヤー。

Layer
output_file

作成する出力パッケージ ファイル (*.lpkx) の格納場所と名前。

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
version
[version,...]
(オプション)

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

メモ:

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

  • ALL パッケージには、すべてのバージョン (ArcGIS Pro 1.2 以降) と互換性があるジオデータベースおよびレイヤー ファイルが含まれています。
  • CURRENT パッケージには、現在のリリースのバージョンと互換性があるジオデータベースおよびレイヤー ファイルが含まれています。
  • 2.xパッケージには、バージョン 2.0 以降と互換性があるジオデータベースおよびレイヤー ファイルが含まれています。
  • 1.2パッケージには、バージョン 1.2 以降と互換性があるジオデータベースおよびレイヤー ファイルが含まれています。
String
additional_files
[additional_files,...]
(オプション)

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

File
summary
(オプション)

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

String
tags
(オプション)

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

String
select_related_rows
(オプション)

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

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

コードのサンプル

PackageLayer (レイヤーのパッケージ化) の例 1 (Python ウィンドウ)

次の Python スクリプトで、PackageLayer ツールを Python ウィンドウ内から使用する方法を示します。

# This code assumes the current project has a map open with a layer named "Streets"
import arcpy
outputFile = "c:/packages/streetsLayer.lpkx"
arcpy.PackageLayer_management("Streets", outputFile, "PRESERVE", 
                              "CONVERT_ARCSDE", "#", "ALL", "ALL", "CURRENT", 
                              "C:/readme.docx", "Summary of package", 
                              "parcel,montgomery")
PackageLayer (レイヤーのパッケージ化) の例 2 (スタンドアロン スクリプト)

特定のプロジェクトの最初のマップに含まれるすべてのフィーチャ レイヤーを個別のレイヤー パッケージ ファイルにパッケージ化します。

# import system modules
import os
import arcpy
prj = arcpy.mp.ArcGISProject(r"\\fileServe\projects\Timbuktu\Timbuktu.aprx")
maps = prj.listMaps()[0]
lyrs = maps.listLayers()
for lyr in lyrs:
    if lyr.isFeatureLayer:
        arcpy.PackageLayer_management(lyr, os.path.join("c:/temp", lyr.name + ".lpkx"))

ライセンス情報

  • Basic: はい
  • Standard: はい
  • Advanced: はい

関連トピック