Skip To Content

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

Сводка

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

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

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

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

    Примечание:

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

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

    Более подробно о шаблонах проектов.

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

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

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

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

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

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

  • Внимание:

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

Синтаксис

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})
ParameterОбъяснениеТип данных
in_project

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

File
output_file

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

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

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

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

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

Более подробно о шаблонах проектов.

  • PROJECT_PACKAGE Будет создан обычный проект пакета. Используется по умолчанию.
  • PROJECT_TEMPLATEБудет создан шаблона проекта (файл .aptx).
Boolean
extent
(Дополнительный)

Задает экстент, введя вручную координаты в параметре экстента, используя формат X-Min Y-Min X-Max Y-Max. Для использования экстента конкретного слоя укажите имя слоя.

  • MAXOFОбъединение входных данных
  • MINOFПересечение входных данных
  • DISPLAYЭкстент, как у текущего изображения
  • <Layer>Экстент, как у указанного слоя
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..
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: Да

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