概要
プロジェクト (*.aprx ファイル) と参照されているマップおよびデータを指定の出力フォルダーに統合します。
使用法
プロジェクトのすべてのエレメント (マップ、レイヤーが参照するデータ、ツールボックス、スタイル、レイアウト、接続 (該当する場合) など) が統合され、.aprx ファイルに含められます。
[組織外で共有] パラメーターは、データをフォルダーに統合するかどうかを制御します。
- オフ - フォルダー、サーバー、データベース、ワークフロー、Data Reviewer などの接続は、組織内用パッケージにのみ含められます。UNC パスおよびエンタープライズ ジオデータベース レイヤー、スタイル、接続は、統合されたプロジェクト内でも引き続き参照されます (Python では、sharing_interal パラメーターを INTERNAL に設定します)。
- オン - パッケージに必要なすべてのデータ ソースを統合フォルダーにコピーします (Python では、sharing_interal パラメーターを EXTERNAL に設定します)。エンタープライズ ジオデータベース接続や UNC フォルダーへのパスなど、ネットワークの外部で利用できないアイテムは含められません。ただし、これらのソースにあるデータは、プロジェクト内のマップまたはレイアウトに含まれている場合には、出力フォルダーにコピーされます。
メモ:
プロジェクトが、データとマップを、c:\gisdata\landrecords.gdb\ などのローカル パスから参照している場合は、[組織外で共有] パラメーターの設定に関係なく、それらも統合されます。
テンプレートを作成するには、[テンプレートとして統合] パラメーターを使用します。プロジェクト テンプレートを使用すると、レイヤー、マップ、データ、および必要な接続を定義して、プロジェクトを作成できます。
プロジェクトの一部であるツールボックスは、統合ルーチンを実行する前に、[ArcGIS Pro 用ツールの分析 (Analyze Tools For Pro)] ツールを使用して解析されます。エラーが発生すると統合プロセスは停止します。これらのエラーを修正するか、プロジェクトからツールを削除する必要があります。ツールに必要な入力データは、そのデータがプロジェクト内のマップの一部であるかどうかに関係なく、統合されます。
フォルダー、サーバー、データベース、ワークフロー、Data Reviewer などの接続は、組織内用パッケージにのみ含められます。これらのアイテムは、パッケージが組織外で共有するために作成される場合は削除されます。
組織内パッケージの場合、添付ファイル、シンボルおよびタスクなどのアイテムは、それらが UNC パスからのプロジェクトの一部である場合、参照されます。これ以外のすべての場合では、これらのアイテムはコピーおよびパッケージ化されます。
フィーチャ レイヤーの場合は、[範囲] パラメーターを使用して、統合されるフィーチャを選択します。ラスター レイヤーの場合は、[範囲] パラメーターを使用して、ラスター データセットをクリップします。
構文
arcpy.management.ConsolidateProject(in_project, output_folder, {sharing_internal}, {extent}, {apply_extent_to_enterprise_geo}, {package_as_template}, {preserve_sqlite}, {version}, {select_related_rows})| パラメーター | 説明 | データ タイプ |
in_project | 統合するプロジェクト (*.aprx ファイル)。 | File |
output_folder | 統合したプロジェクトとデータを格納する出力フォルダー。指定されたフォルダーが存在しない場合、新しいフォルダーが作成されます。 | Folder |
sharing_internal (オプション) | 外部で共有できるようにプロジェクトおよびすべてのデータを出力フォルダーに統合するかどうかを指定します。
| Boolean |
extent (オプション) | フィーチャを選択またはクリップするために使用される範囲を指定します。
| Extent |
apply_extent_to_enterprise_geo (オプション) | [extent] パラメーターをすべてのレイヤーに適用するか、エンタープライズ ジオデータベース レイヤーにのみ適用するかを指定します。
| Boolean |
package_as_template (オプション) | プロジェクトをテンプレートとして統合するか通常のプロジェクトとして統合するかを指定します。テンプレートには、マップ、レイアウト、データベースおよびサーバーへの接続などを含めることができます。プロジェクト テンプレートを使用すると、プロジェクト内で使用する一連のマップを標準化することが可能になり、すべてのユーザーが正しいレイヤーをマップ内で迅速に使用できるようになります。
| Boolean |
preserve_sqlite (オプション) | SQLite ジオデータベースを維持するか、ファイル ジオデータベースに変換するかを指定します。 メモ:このパラメーターは、*.geodatabase ファイルにのみ適用され、主に ArcGIS Runtime アプリでのオフライン ワークフローに使用されます。ファイル拡張子が * .sqlite または *.gpkg の SQLite データベースはファイル ジオデータベースに変換されます。
| Boolean |
version (オプション) | 統合されたプロジェクトを名前を付けて保存するArcGIS Pro バージョンを指定します。以前のバージョンに保存すると、ツールの下位互換性が確保されます。ツールボックスを以前のバージョンに統合しようとした際に、それより新しいバージョンでしか使用できない機能が含まれていると、エラーが発生します。以前のバージョンと互換性のないツールを削除するか、互換性のあるバージョンを指定する必要があります。
| String |
select_related_rows (オプション) | 指定した範囲を関連するデータ ソースに適用するかどうかを指定します。
| Boolean |
コードのサンプル
次の Python スクリプトで、ConsolidateProject ツールを Python ウィンドウから使用する方法を示します。
import arcpy
arcpy.ConsolidateProject_management('c:\\projects\\SE_Pipelines\\PipeDevelopment.aprx', 'E:\\gisShare\\projects\\Pipelines\\SE_Pipeline', 'INTERNAL')次のスクリプトは、プロジェクト ファイル (*.aprx) が UNC 共有パス上にある入力ディレクトリを使用して、プロジェクトをローカル ドライブに統合します。INTERNAL キーワードを使用すると、このデータに新しいローカル プロジェクトからアクセスできます。
import os
import arcpy
enterpriseProjectDir = "\\\\centralFileServer\\gisData\\ArcGISProProjects"
localProjectDir = "c:\\GISdata\\localProjects"
walk = arcpy.da.Walk(enterpriseProjectDir, datatype="Project")
for dirpath, dirnames, filenames in walk:
for fname in filenames:
project = os.path.join(dirpath, fame)
outputFolder = os.path.join(localProjectDir, os.path.splitext(os.path.basename(project))[0])
print("Consolidating: {0} to {1}".format(project, outputFolder))
arcpy.ConsolidateProject_management(project, outputFolder, "INTERNAL")ライセンス情報
- Basic: はい
- Standard: はい
- Advanced: はい