プロジェクトのパッケージ化 (Package Project) (データ管理)

概要

参照されているマップおよびデータのプロジェクト (*.aprx ファイル) を、パッケージ化されたプロジェクト ファイル (*.ppkx) に統合します。

使用法

  • プロジェクトのすべての要素は、プロジェクト パッケージ (*.ppkx) に統合されます。要素には、必要に応じてマップ、3D ビュー、マップ内のデータおよびレイヤー、ツールボックス、ジオプロセシング履歴アイテム、シンボル、レイアウトおよびフォルダーまたは接続 (サーバー、ワークフローなど) が含まれます。

  • デフォルトでは、プロジェクト パッケージは、内部使用の目的で作成されます。[組織外で共有] パラメーターを使用すると、パッケージを社内使用 (組織ネットワーク内) に作成するか、社外使用に作成するか選択できます。[組織外で共有] をオンにすると、UNC パスから参照されるエンタープライズ ジオデータベース レイヤーおよびデータがプロジェクト パッケージに含まれます。

    メモ:

    データの参照が維持される社内用パッケージを作成するには、データ ソースが、エンタープライズまたは UNC パスのいずれかから参照される必要があります。ローカル データのパスは常に統合され、パッケージ化されます。お使いの環境外で共有していたり、エンタープライズ ジオデータベースまたは UNC データ共有へのいずれかにアクセスできない同僚と共有している場合、データのみが参照される社内用パッケージを作成すると、リンクが壊れた状態で開きます。

  • テンプレートを作成するには、[テンプレートとしてパッケージ化] パラメーターを使用します。プロジェクト テンプレート (*.aptx ファイル) を使用すると、レイヤー、マップ、データ、および必要な接続を定義して、新しいプロジェクトを作成できます。

    プロジェクト テンプレートの詳細

  • プロジェクトの一部であるツールボックスは、統合プロセスが実行される前に、[ArcGIS Pro で実行するツールの分析 (Analyze Tools for Pro)] を使用して分析されます。エラーが特定されると、統合プロセスは中止します。それらのエラーを修復するか、プロジェクトからツールを削除する必要があります。ツールが使用した入力データは、データがプロジェクト内のマップの一部であるかどうかに関係なく統合されます。[ツールボックスを含む] パラメーターをオフにすることで、ツールボックスを出力プロジェクト パッケージから除外できます。

  • プロジェクト ツールボックスと同様に、ジオプロセシング履歴 (ジオプロセシング ツールを実行した結果の情報) はパッケージに含められます。履歴アイテムの実行に必要なデータは、マップまたはシーン内に存在するかどうかに関係なく、出力パッケージに含められます。(実行中に失敗した) 無効な履歴アイテムや、データが見つからない履歴アイテムがあると、パッケージ化プロセスが停止します。問題の履歴アイテムを削除または修正する必要があります。[履歴アイテムを含む] パラメーターをオフにすることで、履歴アイテムをプロジェクト パッケージから除外できます。

  • フォルダー、サーバー、データベース、ワークフローなどの接続は、組織内パッケージにのみ含められます。これらのアイテムは、パッケージが組織外で共有するために作成される場合は削除されます。

  • 組織内パッケージの場合、添付ファイル、シンボルおよびタスクなどのアイテムは、それらが UNC パスからのプロジェクトの一部である場合、参照されます。これ以外のすべての場合では、これらのアイテムはコピーおよびパッケージ化されます。

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

  • マップまたはデータを説明したファイルや、追加情報を提供するファイルをパッケージに含めることができます。画像、PDF、Word ドキュメント、および *.zip ファイルは、[追加ファイル] パラメーターを使用して参照することで、パッケージに含めることができます。

  • 注意:

    プロジェクト パッケージ (*.ppkx ファイル) を作成したり開いたりすることができるのは、ArcGIS Pro のみです。

構文

arcpy.management.PackageProject(in_project, output_file, {sharing_internal}, {package_as_template}, {extent}, {apply_extent_to_arcsde}, {additional_files}, {summary}, {tags}, {version}, {include_toolboxes}, {include_history_items}, {read_only}, {select_related_rows})
パラメーター説明データ タイプ
in_project

パッケージ化するプロジェクト (*.aprx ファイル)。

File
output_file

出力プロジェクト パッケージ (*.ppkx ファイル)。

File
sharing_internal
(オプション)

プロジェクトを組織内利用のために統合するのか、またはすべてのデータ エレメントを移動して外部で共有できるようにするかを指定します。

  • INTERNAL エンタープライズ ジオデータベースおよび UNC パスからのデータなどのエンタープライズ データ ソースはローカル フォルダーにコピーされません。これがデフォルトです。
  • EXTERNAL可能な限り、データ形式がコピーされ、維持されます。
Boolean
package_as_template
(オプション)

プロジェクト テンプレートまたはプロジェクト パッケージを作成するかどうかを指定します。テンプレートには、マップ、レイアウト、データベースおよびサーバーへの接続などを含めることができます。プロジェクト テンプレート使用すると、さまざまなプロジェクトに一連のマップを簡単に標準化することができ、すべてのユーザーが正しいレイヤーをマップ内で迅速に使用できるようになります。

プロジェクト テンプレートの詳細

  • PROJECT_PACKAGE 通常のプロジェクト パッケージが作成されます。これがデフォルトです。
  • PROJECT_TEMPLATEプロジェクト テンプレート (*.aptx ファイル) が作成されます。
Boolean
extent
(オプション)

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

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

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

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

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

File
summary
(オプション)

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

String
tags
(オプション)

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

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

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

メモ:

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

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

プロジェクト ツールボックスを統合し、出力パッケージに含めるかどうかを指定します。すべてのプロジェクトには、デフォルトのツールボックスが必要となるため、デフォルトのツールボックスは、この設定に関係なく含まれます。

  • TOOLBOXESプロジェクト ツールボックスが出力パッケージに含まれます。これがデフォルトです。
  • NO_TOOLBOXESプロジェクト ツールボックスは出力パッケージから除外されます。
Boolean
include_history_items
(オプション)

ジオプロセシング履歴アイテムを統合し、出力パッケージに含めるかどうかを指定します。含まれる履歴アイテムには、その履歴アイテムを再実行するために必要なデータが統合されています。

  • HISTORY_ITEMS履歴アイテムが出力パッケージに含まれます。これがデフォルトです。
  • NO_HISTORY_ITEMS履歴アイテムは出力パッケージから除外されます。
  • VALID_HISTORY_ITEMS_ONLY有効な履歴アイテムだけが出力パッケージに含められます。元の入力レイヤーまたはツールが見つからない場合、履歴アイテムは無効になります。
String
read_only
(オプション)

プロジェクトを読み取り専用にするかどうかを指定します。読み取り専用プロジェクトは更新および保存できません。

  • READ_ONLYプロジェクトは読み取り専用になります。
  • READ_WRITEプロジェクトは書き込み可能になります。これがデフォルトです。
Boolean
select_related_rows
(オプション)

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

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

コードのサンプル

PackageProject (プロジェクトのパッケージ化) の例 1 (Python ウィンドウ)

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

import arcpy
p = arcpy.mp.ArcGISProject("CURRENT")
arcpy.PackageProject_management(p.filePath, 'E:\\gisShare\\projects\\Pipelines\\SE_Pipeline.ppkx', 'INTERNAL')
PackageProject (プロジェクトのパッケージ化) の例 2 (スタンドアロン スクリプト)

次の Python スクリプトは、ファイル名に「oil」を含む、ディレクトリのすべてのプロジェクトをプロジェクト パッケージ (*.ppkx) に変換します。

import os
import arcpy
enterpriseProjectDir = "\\\\centralFileServer\\gisData\\ArcGISProProjects"
sharedProjectDir = "c:\\publicFiles\\sharedProjects"
walk = arcpy.da.Walk(enterpriseProjectDir, datatype="Project")
for dirpath, dirnames, filenames in walk:
    for filename in filenames:
        if "OIL" in filename.upper():
            project = os.path.join(dirpath, filename)
            outputFile = os.path.join(sharedProjectDir, os.path.splitext(os.path.basename(project))[0] + ".ppkx")
            print("Packaging: {0} to {1}".format(project, outputFile))
            arcpy.PackageProject_management(project, outputFile, "EXTERNAL")

ライセンス情報

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

関連トピック