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

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

Собирает и упаковывает файл проекта (.aprx) связанных карт и данных в файл пакета проекта (.ppkx).

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

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

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

    Примечание:

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

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

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

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

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

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

  • Такие элементы как вложения, стили и задачи будут связаны по UNC-ссылкам для внутренних пакетов, если они были частью проекта. Эти элементы будут скопированы и упакованы во всех других ситуациях.

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

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

  • Внимание:

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

Параметры

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

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

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

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

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

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

Примечание:

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

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

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

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

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

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

  • Текущий экстент отображения Вид карты — Экстент будет основан на активной карте или сцене. Эта опция доступна только при наличии активной карты.
  • Экстент слоя Layer — Экстент будет основан на активном слое карты. Используйте раскрывающийся список, чтобы выбрать доступный слой, или используйте опцию Экстент данных во всех слоях, чтобы получить объединенный экстент всех активных слоев карты, за исключением базовой карты. Эта опция доступна только при наличии активной карты со слоями.
  • Обзор Обзор — Экстент будет основан на существующем наборе данных.
  • Пересечение входных данных Пересечение — Экстент будет основан на минимальном или пересекающемся экстенте всех входных данных. Если никакие входные данные не перекрываются, получится пустой экстент со всеми нулями.
  • Объединение входных данных Объединить — Экстент будет основан на максимальном или объединенном экстенте всех входных данных.
  • Сбросить экстент Сбросить — Экстент будет сброшен до значения по умолчанию.
  • Координаты, введенные вручную – Координаты должны быть числовыми значениями и находиться в системе координат активной карты.

    На карте могут использоваться разные единицы отображения

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

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

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

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

Дополнительные файлы, которые будут добавлены в пакет. Дополнительные файлы, например, .doc, .txt, .pdf и т.п., используются для предоставления дополнительной информации о содержании и назначении пакета.

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

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

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

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

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

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

Примечание:

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

  • Все версииПакет будет содержать базы геоданных и карты, совместимые со всеми версиями (ArcGIS AllSource 2.1 и более поздними).
  • Текущая версияПакет будет содержать базы геоданных и карты, совместимые с версией текущего выпуска.
  • 2.2Пакет будет содержать базы геоданных и карты, совместимые с версией 2.2.
  • 2.3Пакет будет содержать базы геоданных и карты, совместимые с версией 2.3.
  • 2.4Пакет будет содержать базы геоданных и карты, совместимые с версией 2.4.
  • 2.5Пакет будет содержать базы геоданных и карты, совместимые с версией 2.5.
  • 2.6Пакет будет содержать базы геоданных и карты, совместимые с версией 2.6.
  • 2.7Пакет будет содержать базы геоданных и карты, совместимые с версией 2.7.
  • 2.8Пакет будет содержать базы геоданных и карты, совместимые с версией 2.8.
  • 2.9Пакет будет содержать базы геоданных и карты, совместимые с версией 2.9.
  • 3.0Пакет будет содержать базы геоданных и карты, совместимые с версией 3.0.
  • 3.1Пакет будет содержать базы геоданных и карты, совместимые с версией 3.1.
  • 3.2Пакет будет содержать базы геоданных и карты, совместимые с версией 3.2.
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-мин, y-мин, x-макс, y-макс.
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 AllSource 2.1 и более поздними).
  • CURRENTПакет будет содержать базы геоданных и карты, совместимые с версией текущего выпуска.
  • 2.2Пакет будет содержать базы геоданных и карты, совместимые с версией 2.2.
  • 2.3Пакет будет содержать базы геоданных и карты, совместимые с версией 2.3.
  • 2.4Пакет будет содержать базы геоданных и карты, совместимые с версией 2.4.
  • 2.5Пакет будет содержать базы геоданных и карты, совместимые с версией 2.5.
  • 2.6Пакет будет содержать базы геоданных и карты, совместимые с версией 2.6.
  • 2.7Пакет будет содержать базы геоданных и карты, совместимые с версией 2.7.
  • 2.8Пакет будет содержать базы геоданных и карты, совместимые с версией 2.8.
  • 2.9Пакет будет содержать базы геоданных и карты, совместимые с версией 2.9.
  • 3.0Пакет будет содержать базы геоданных и карты, совместимые с версией 3.0.
  • 3.1Пакет будет содержать базы геоданных и карты, совместимые с версией 3.1.
  • 3.2Пакет будет содержать базы геоданных и карты, совместимые с версией 3.2.
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, '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.lower():
            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.management.PackageProject(project, outputFile, "EXTERNAL")

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

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

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

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