概要
参照されているマップおよびデータのプロジェクト (*.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 (オプション) | プロジェクトを組織内利用のために統合するのか、またはすべてのデータ エレメントを移動して外部で共有できるようにするかを指定します。
| Boolean |
package_as_template (オプション) | プロジェクト テンプレートまたはプロジェクト パッケージを作成するかどうかを指定します。テンプレートには、マップ、レイアウト、データベースおよびサーバーへの接続などを含めることができます。プロジェクト テンプレート使用すると、さまざまなプロジェクトに一連のマップを簡単に標準化することができ、すべてのユーザーが正しいレイヤーをマップ内で迅速に使用できるようになります。
| Boolean |
extent (オプション) | フィーチャを選択またはクリップするために使用される範囲を指定します。
| Extent |
apply_extent_to_arcsde (オプション) | 指定した範囲をすべてのレイヤーに適用するか、エンタープライズ ジオデータベースのレイヤーだけに適用するかを指定します。
| Boolean |
additional_files [additional_files,...] (オプション) | ファイルをパッケージに追加します。*.doc、*.txt、*.pdf などの追加ファイルは、パッケージのコンテンツや目的に関する詳細を提供します。 | File |
summary (オプション) | 概要情報をパッケージのプロパティに追加します。 | String |
tags (オプション) | タグ情報をパッケージのプロパティに追加します。カンマやセミコロンで区切ることで、複数のタグを追加できます。 | String |
version [version,...] (オプション) | 出力パッケージ内に作成される、ジオデータベースのバージョンを指定します。バージョンを指定すると、パッケージを ArcGIS の以前のバージョンと共有できるようになり、後方互換性がサポートされます。 メモ:パッケージを以前のバージョンで保存すると、新しいバージョンでのみ利用できるプロパティが失われる可能性があります。
| String |
include_toolboxes (オプション) | プロジェクト ツールボックスを統合し、出力パッケージに含めるかどうかを指定します。すべてのプロジェクトには、デフォルトのツールボックスが必要となるため、デフォルトのツールボックスは、この設定に関係なく含まれます。
| Boolean |
include_history_items (オプション) | ジオプロセシング履歴アイテムを統合し、出力パッケージに含めるかどうかを指定します。含まれる履歴アイテムには、その履歴アイテムを再実行するために必要なデータが統合されています。
| String |
read_only (オプション) | プロジェクトを読み取り専用にするかどうかを指定します。読み取り専用プロジェクトは更新および保存できません。
| Boolean |
select_related_rows (オプション) | 指定した範囲を関連するデータ ソースに適用するかどうかを指定します。
| Boolean |
コードのサンプル
次の Python スクリプトで、PackageProject ツールを Python ウィンドウから使用する方法を示します。
import arcpy
p = arcpy.mp.ArcGISProject("CURRENT")
arcpy.PackageProject_management(p.filePath, 'E:\\gisShare\\projects\\Pipelines\\SE_Pipeline.ppkx', 'INTERNAL')次の 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: はい