Упаковать проект (Управление данными)

Краткая информация

Собирает и упаковывает проект ArcGIS Pro (.aprx) и его содержимое (карты и данные) в файл пакета проекта (.ppkx).

Использование

  • Данные и элементы в проекте будут собраны в пакет проекта (.ppkx), включая карты и 3D виды, данные и слои карт, наборы инструментов, элементы истории геообработки, стили, компоновки и папки или подключения (к серверам, рабочим процессам и т.п.), в зависимости от того, что используется.

  • Параметр Опубликовать вне организации позволяет управлять тем, будет ли пакет создан для внутреннего использования (внутри сети вашей организации) или для внешнего использования. Если включена опция Опубликовать вне организации, слои многопользовательской базы геоданных, сервисы пространственных объектов и данные, на которые имеются ссылки в сетевых хранилищах (UNC-путь), будут скопированы (или преобразованы) и включены в пакет проекта. Данные, хранящиеся на локальном компьютере, также будут собраны и упакованы.

    Примечание:

    Создание внутреннего пакета, содержащего данные, на которые имеются ссылки, приведет к открытию с неработающими ссылками, если к нему предоставить доступ коллегам, не имеющим доступа к сетевым ресурсам (корпоративной базе геоданных, сервису объектов и данным, на которые ссылаются через общие дисковые ресурсы [UNC-пути]).

  • Можно создавать шаблоны с помощью параметра Упаковать как шаблон. Для создания проекта можно использовать шаблон проекта (файл .aptx), определяя слои, карты и данные, а также необходимые подключения.

    Более подробно о создании шаблона проекта

  • Перед выполнением процесса сборки используйте инструмент Анализировать инструменты для Pro и Анализировать инструменты для версии для анализа наборов инструментов, являющихся частью проекта. Если обнаружены ошибки, процесс сборки можно остановить. Исправьте ошибки или удалите инструмент из проекта. Наборы инструментов можно исключить из выходного пакета проекта, сняв отметку в параметре Включить наборы инструментов.

  • Так же, как и наборы инструментов проекта, в пакет будет включена история геообработки (сведения о результатах выполнения инструмента геообработки). Данные, участвующие в процессах элементов истории, будут включены в выходной пакет, независимо от того, присутствуют они в картах и сценах проекта или нет. Любые некорректные элементы истории (вызывающие сбой процесса выполнения) или элементы, для которых не найдены данные, приведут к остановке процесса создания пакета. Необходимо удалить или исправить такие элементы истории. Элементы истории можно исключить из выходного пакета проекта, сняв отметку в параметре Включить элементы истории.

  • Подключения – папок, серверов, баз данных и рабочего процесса – включаются только во внутренний пакет. Эти элементы будут удалены, если пакет создан с включенным параметром Опубликовать вне организации.

  • Для векторных слоев используйте параметр Экстент, чтобы выбрать пространственные объекты, которые будут собираться. Для растровых слоев используйте параметр Экстент, чтобы вырезать наборы растровых данных.

  • В пакет могут быть включены дополнительные файлы. Изображения, файлы PDF, документы Word и файлы .zip могут добавляться в пакет в параметре Дополнительные файлы.

  • Внимание:

    Пакеты проекта (файлы .ppkx) могут создаваться и открываться только в ArcGIS Pro.

Параметры

ПодписьОписаниеТип данных
Входной проект

Проект (файл .aprx), который будет упакован.

File
Выходной файл

Выходной пакет проекта (файл .ppkx).

File
Опубликовать вне организации
(Дополнительный)

Определяет, будут ли проект и все данные собраны, преобразованы или скопированы в пакет (для публикации вне организации) или ссылка на них будет как есть, без преобразования или включения в пакет (для публикации внутри организации).

Примечание:

Данные и карты будут собираться и упаковываться, если проект ссылается на них по локальным путям, например, c:\gisdata\landrecords.gdb\, независимо от этого параметра.

  • Не отмечено — ссылка на данные, хранящиеся на сетевых ресурсах, таких как корпоративные базы геоданных, сервисы объектов и общие файловые ресурсы (UNC-путь) будет как есть, без преобразования или включения их в пакет. Это значение по умолчанию
  • Отмечено — данные, хранящиеся на сетевых ресурсах, будут собраны, преобразованы или скопированы в пакет. Форматы данных будут по возможности сохранены.
Boolean
Упаковать как шаблон
(Дополнительный)

Указывает, будет ли создан шаблон проекта или пакет проекта. Шаблоны проектов могут содержать карты, компоновки, подключения к базам данных и серверам и т.д. Шаблоны проектов можно использовать для стандартизации нескольких карт для разных проектов и обеспечивают немедленную доступность соответствующих слоев в картах пользователей.

  • Не отмечено — будет создан пакет проекта. Это значение по умолчанию
  • Отмечено — будет создан шаблон проекта.

Boolean
Экстент
(Дополнительный)

Указывает экстент, который будет использован для выбора или вырезания объектов.

  • Текущий экстент отображения Вид карты — Экстент будет основан на активной карте или сцене.
  • Нарисовать экстент Закончить прямым углом - экстент будет основан прямоугольнике, нарисованном на карте или сцене.
  • Экстент слоя Слой — Экстент будет основан на активном слое карты. Выберите доступный слой или воспользуйтесь опцией Экстент данных во всех слоях. У каждого слоя карте есть следующие опции:

    • Все объекты Выбрать все - экстент всех объектов.
    • Выбранные объекты Область из выбранных объектов - экстент выбранных объектов.
    • Отображаемые объекты Extent Indicator - экстент отображаемых объектов.

  • Обзор Обзор - экстент будет основан на наборе данных.
  • Пересечение входных данных Пересечение - экстент будет основан на пересекающемся экстенте всех входных данных.
  • Объединение входных данных Объединение - экстент будет комбинацией экстентов всех входных данных.
  • Буфер обмена Вставить - экстент может быть скопирован в буфер обмена и из него.
    • Копировать экстент Копировать - копирует экстент и систему координат в буфер обмена.
    • Вставить экстент Вставить - вставляет экстент и систему координат из буфера обмена. Если буфер обмена не содержат систему координат, экстент будет использовать систему координат карты.
  • Сбросить экстент Сбросить - экстент будет сброшен до значения по умолчанию.

Если координаты заданы вручную, они должны быть числовыми значениями в системе координат активной карты. На карте могут использоваться единицы отображения, отличные от введенных координат. Используйте знак отрицательного значения для координат юга и запада.

Extent
Применить экстент только к слоям многопользовательской базы геоданных
(Дополнительный)

Определяет, будет ли указанный экстент применен ко всем слоям или только к слоям многопользовательской базы геоданных.

  • Не отмечено – экстент применяется ко всем слоям. Это значение по умолчанию
  • Отмечено – экстент применяется к только к слоям многопользовательской базы геоданных.

Boolean
Дополнительные файлы
(Дополнительный)

Дополнительные файлы, которые будут включены в пакет.

File
Краткая информация
(Дополнительный)

Краткая информация, которая будет добавлена в свойства пакета.

String
Теги
(Дополнительный)

Теги, которые будут добавлены в свойства пакета. Разделяйте несколько тегов запятой или точкой с запятой.

String
Версия пакета
(Дополнительный)

Определяет версию ArcGIS Pro, с которой будут совместимы определенные объекты, такие как проекты, карты и слои, и в которой они будут сохраняться. Сохранение в более ранней версии может быть полезно, если проект будет использоваться с более старым программным обеспечением.

Внимание:

Пакет, сохраненный в более ранней версии, может потерять функциональность или свойства, которые не поддерживались в более ранней версии.

  • Все версииСодержимое пакета будет совместимо со всеми версиями (ArcGIS Pro 2.1 и выше).
  • Текущая версияСодержимое пакета будет совместимо с текущей версией релиза ArcGIS Pro.
  • ArcGIS Pro 2.2Содержимое пакета будет совместимо с версией ArcGIS Pro 2.2.
  • ArcGIS Pro 2.3Содержимое пакета будет совместимо с версией ArcGIS Pro 2.3.
  • ArcGIS Pro 2.4Содержимое пакета будет совместимо с версией ArcGIS Pro 2.4.
  • ArcGIS Pro 2.5Содержимое пакета будет совместимо с версией ArcGIS Pro 2.5.
  • ArcGIS Pro 2.6Содержимое пакета будет совместимо с версией ArcGIS Pro 2.6.
  • ArcGIS Pro 2.7Содержимое пакета будет совместимо с версией ArcGIS Pro 2.7.
  • ArcGIS Pro 2.8Содержимое пакета будет совместимо с версией ArcGIS Pro 2.8.
  • ArcGIS Pro 2.9Содержимое пакета будет совместимо с версией ArcGIS Pro 2.9.
  • ArcGIS Pro 3.0Содержимое пакета будет совместимо с версией ArcGIS Pro 3.0.
  • ArcGIS Pro 3.1Содержимое пакета будет совместимо с версией ArcGIS Pro 3.1.
  • ArcGIS Pro 3.2Содержимое пакета будет совместимо с версией ArcGIS Pro 3.2.
  • ArcGIS Pro 3.3Содержимое пакета будет совместимо с версией ArcGIS Pro 3.3.
  • ArcGIS Pro 3.4Содержимое пакета будет совместимо с версией ArcGIS Pro 3.4.
String
Включить наборы инструментов
(Дополнительный)

Определяет, будут ли наборы инструментов проекта и данные, на которые ссылаются инструменты в этих наборах инструментов, собраны и включены в выходной пакет. Для всех проектов требуется набор инструментов по умолчанию, который будет включен в выходной пакет независимо от этого параметра. Набор инструментов, находящийся в подключенной папке, не считается набором инструментов проекта и игнорируется этой установкой.

  • Отмечено – наборы инструментов проекта будут включены в выходной пакет. Это значение по умолчанию
  • Не отмечено – наборы инструментов проекта не будут включены в выходной пакет.
Boolean
Включить элементы истории
(Дополнительный)

Определяет, будут ли элементы истории геообработки собраны и включены в выходной пакет. Включенные элементы истории будут также добавлять данные, необходимые для повторного запуска элементов истории.

  • Элементы истории будут включеныЭлементы истории проекта будут включены в выходной пакет. Это значение по умолчанию
  • Элементы истории не будут включеныЭлементы истории проекта не будут включены в выходной пакет.
  • Только корректные элементы истории проекта будут включеныТолько корректные элементы истории проекта будут включены в выходной пакет. Элементы истории некорректны, если не найден любой из исходных входных слоев или инструментов.
String
Пакет только для чтения
(Дополнительный)

Определяет, будет ли проект предназначен только для чтения. Проекты только для чтения нельзя изменить или сохранить.

  • Отмечено – проект будет только для чтения.
  • Не отмечено – проект будет доступен для записи. Это значение по умолчанию
Boolean
Сохранить только те строки, которые связаны с объектами в пределах экстента
(Дополнительный)

Указывает, будет ли указанный экстент применен к связанным источникам данных.

  • Не отмечено — связанные источники данных будут объединены в полном объеме. Это значение по умолчанию
  • Отмечено — будут объединены только связанные данные, соответствующие записям в указанном экстенте.
Boolean
Сохранить мобильную базу геоданных
(Дополнительный)

Определяет, будут ли данных входной мобильной базы геоданных сохранены в результатах или записаны в формат файловой базы геоданных Если входные данные представляют собой набор данных мобильной базы геоданных, то результатом будет мобильная база геоданных.

  • Не отмечено - данные мобильной базы геоданных будут конвертированы в формат файловой базы геоданных. Это значение по умолчанию
  • Отмечено - данные мобильной базы геоданных будут сохранены как мобильные базы геоданных в выходных данных. База геоданных будет включена полностью.
Boolean

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}, {preserve_sqlite})
ИмяОписаниеТип данных
in_project

Проект (файл .aprx), который будет упакован.

File
output_file

Выходной пакет проекта (файл .ppkx).

File
sharing_internal
(Дополнительный)

Определяет, будут ли проект и все данные собраны, преобразованы или скопированы в пакет (для публикации вне организации) или ссылка на них будет как есть, без преобразования или включения в пакет (для публикации внутри организации).

  • INTERNALСсылка на данные, хранящиеся на сетевых ресурсах, таких как корпоративные базы геоданных, сервисы объектов и общие файловые ресурсы (UNC-путь) будет как есть, без преобразования или включения их в пакет. Это значение по умолчанию
  • EXTERNALДанные, хранящиеся на сетевых ресурсах, будут собраны, преобразованы или скопированы в пакет. Форматы данных будут по возможности сохранены.
Boolean
package_as_template
(Дополнительный)

Указывает, будет ли создан шаблон проекта или пакет проекта. Шаблоны проектов могут содержать карты, компоновки, подключения к базам данных и серверам и т.д. Шаблоны проектов можно использовать для стандартизации нескольких карт для разных проектов и обеспечивают немедленную доступность соответствующих слоев в картах пользователей.

Более подробно о создании шаблона проекта

  • PROJECT_PACKAGEБудет создан пакет проекта. Это значение по умолчанию
  • PROJECT_TEMPLATEБудет создан шаблон проекта
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,...]
(Дополнительный)

Дополнительные файлы, которые будут включены в пакет.

File
summary
(Дополнительный)

Краткая информация, которая будет добавлена в свойства пакета.

String
tags
(Дополнительный)

Теги, которые будут добавлены в свойства пакета. Разделяйте несколько тегов запятой или точкой с запятой.

String
version
[version,...]
(Дополнительный)

Определяет версию ArcGIS Pro, с которой будут совместимы определенные объекты, такие как проекты, карты и слои, и в которой они будут сохраняться. Сохранение в более ранней версии может быть полезно, если проект будет использоваться с более старым программным обеспечением.

Внимание:

Пакет, сохраненный в более ранней версии, может потерять функциональность или свойства, которые не поддерживались в более ранней версии.

  • ALLСодержимое пакета будет совместимо со всеми версиями (ArcGIS Pro 2.1 и выше).
  • CURRENTСодержимое пакета будет совместимо с текущей версией релиза ArcGIS Pro.
  • 2.2Содержимое пакета будет совместимо с версией ArcGIS Pro 2.2.
  • 2.3Содержимое пакета будет совместимо с версией ArcGIS Pro 2.3.
  • 2.4Содержимое пакета будет совместимо с версией ArcGIS Pro 2.4.
  • 2.5Содержимое пакета будет совместимо с версией ArcGIS Pro 2.5.
  • 2.6Содержимое пакета будет совместимо с версией ArcGIS Pro 2.6.
  • 2.7Содержимое пакета будет совместимо с версией ArcGIS Pro 2.7.
  • 2.8Содержимое пакета будет совместимо с версией ArcGIS Pro 2.8.
  • 2.9Содержимое пакета будет совместимо с версией ArcGIS Pro 2.9.
  • 3.0Содержимое пакета будет совместимо с версией ArcGIS Pro 3.0.
  • 3.1Содержимое пакета будет совместимо с версией ArcGIS Pro 3.1.
  • 3.2Содержимое пакета будет совместимо с версией ArcGIS Pro 3.2.
  • 3.3Содержимое пакета будет совместимо с версией ArcGIS Pro 3.3.
  • 3.4Содержимое пакета будет совместимо с версией ArcGIS Pro 3.4.
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
preserve_sqlite
(Дополнительный)

Определяет, будут ли данных мобильной базы геоданных сохранены в результатах или записаны в формат файловой базы геоданных Если входные данные представляют собой набор данных мобильной базы геоданных, то результатом будет мобильная база геоданных.

  • CONVERT_SQLITEДанные мобильной базы геоданных будут конвертированы в формат файловой базы геоданных. Это значение по умолчанию
  • PRESERVE_SQLITEДанные мобильной базы геоданных будут сохранены как мобильные базы геоданных в выходных данных. База геоданных будет включена полностью.
Boolean

Пример кода

PackageProject, пример 1 (окно Python)

Скрипт Python, демонстрирующий использование функции PackageProject в окне Python.

import arcpy
p = arcpy.mp.ArcGISProject("CURRENT")
arcpy.management.PackageProject(p.filePath, f'E:\gisShare\projects\Pipelines\SE_Pipeline.ppkx', 'INTERNAL')
PackageProject, пример 2 (автономный скрипт)

Следующий скрипт Python преобразовывает все проекты из директории со словом oil в имени файла в пакет проекта (.ppkx).

import os
import arcpy

enterpriseProjectDir = r"\\centralFileServer\gisData\ArcGISProProjects"
sharedProjectDir = r"c:\publicFiles\sharedProjects"

walk = arcpy.da.Walk(enterpriseProjectDir, datatype="Project")

for dirpath, dirnames, filenames in walk:
    for filename in filenames:
        if "oil" in filename.lower():
            project = os.path.join(dirpath, filename)
            out_ppkx = os.path.join(sharedProjectDir, os.path.splitext(os.path.basename(project))[0] + ".ppkx")
            print(f"Packaging: {project} to {out_ppkx}")
            arcpy.management.PackageProject(project, out_ppkx, "EXTERNAL")

Параметры среды

Особые случаи

Коэффициент параллельной обработки

Если параметр среды не указан, инструмент использует одну вторую доступных ядер.

Информация о лицензиях

  • Basic: Да
  • Standard: Да
  • Advanced: Да

Связанные разделы