Подпись | Описание | Тип данных |
Входной проект | Проект (файл .aprx), который будет упакован. | File |
Выходной файл | Выходной пакет проекта (файл .ppkx). | File |
Опубликовать вне организации (Дополнительный) | Указывает, будет ли проект собираться для внутренней использования, или же следует переместить все элементы данных для внешнего применения. Примечание:Данные и карты будут собираться и упаковываться, если проект ссылается на них по локальным путям, например, c:\gisdata\landrecords.gdb\, независимо от этого параметра.
| Boolean |
Упаковать как шаблон (Дополнительный) | Указывает, будет ли создан шаблон проекта или пакет проекта. Шаблоны проектов могут содержать карты, компоновки, подключения к базам данных и серверам и т.д. Шаблоны проектов можно использовать для стандартизации нескольких карт для разных проектов и обеспечивают немедленную доступность соответствующих слоев в картах пользователей.
| Boolean |
Экстент (Дополнительный) | Указывает экстент, который будет использован для выбора или вырезания объектов.
| Extent |
Применить экстент только к слоям многопользовательской базы геоданных (Дополнительный) | Определяет, будет ли указанный экстент применен ко всем слоям или только к слоям многопользовательской базы геоданных.
| Boolean |
Дополнительные файлы (Дополнительный) | Добавляет файлы в пакет. Дополнительные файлы, например, .doc, .txt, .pdf и т.п., используются для предоставления дополнительной информации о содержании и назначении пакета. | File |
Краткая информация (Дополнительный) | Добавление краткого описания в свойства пакета. | String |
Теги (Дополнительный) | Добавление информации о тегах в свойства пакета. Можно добавить несколько тегов с разделением запятой или точкой с запятой. | String |
Версия пакета (Дополнительный) | Указывает версию базы геоданных, которая будет создана в результирующем пакете. Указание версии позволяет осуществлять общий доступ к пакетам из предыдущих версий ArcGIS и поддерживает обратную совместимость. Примечание:Пакет, который сохраняется в предыдущую версию, может потерять свойства, доступные для более новой версии.
| String |
Включить наборы инструментов (Дополнительный) | Определяет, будут ли наборы инструментов проекта и данные, на которые ссылаются инструменты в наборах инструментов проекта, собраны и включены в выходной пакет. Для всех проектов создается набор инструментов по умолчанию, и этот набор всегда включается в выходной пакет, независимо от значения этого параметра. Набор инструментов, находящийся в подключенной папке, не считается набором инструментов проекта и игнорируется этой установкой.
| Boolean |
Включить элементы истории (Дополнительный) | Определяет, будут ли элементы истории геообработки собраны и включены в выходной пакет. Включенные элементы истории будут также добавлять данные, необходимые для повторного запуска элементов истории.
| String |
Пакет только для чтения (Дополнительный) | Определяет, будет ли проект предназначен только для чтения. Проекты только для чтения нельзя изменить или сохранить.
| Boolean |
Сохранить только те строки, которые связаны с объектами в пределах экстента (Дополнительный) | Указывает, будет ли указанный экстент применен к связанным источникам данных.
| Boolean |
Сохранить мобильную базу геоданных (Дополнительный) | Определяет, будут ли данных входной мобильной базы геоданных сохранены в результатах или записаны в формат файловой базы геоданных Если входные данные представляют собой мобильную базу геоданных, этот параметр имеет приоритет над параметром Конвертировать данные в файловую базу геоданных. Если входные данные представляют собой набор данных мобильной базы геоданных, то результатом всегда будет мобильная база геоданных.
| Boolean |
Краткая информация
Собирает и упаковывает файл проекта (.aprx) связанных карт и данных в файл пакета проекта (.ppkx).
Использование
Все элементы проекта собираются в пакет проекта (.ppkx), включая карты и 3D виды, данные и слои карт, наборы инструментов, историю геообработки, стили, компоновки и папки или подключения к ним (серверам, рабочим процессам и т.п.), в зависимости от того, что используется.
Пакеты проектов по умолчанию создаются для внутреннего применения. Параметр Опубликовать вне организации позволяет управлять тем, будет ли пакет создан для внутреннего использования (внутри сети вашей организации) или для внешнего использования. Если параметр Опубликовать вне организации включен, слои многопользовательской базы геоданных и данные, связанные через UNC-путь, будут включаться в пакет проекта.
Примечание:
Источники данных должны подключаться по ссылке либо из многопользовательской базы геоданных, либо по UNC-пути к файлу, чтобы создать внутренний пакет, в котором остаются ссылки на данные. Пути к локальным данным всегда будут собираться и упаковываться. Если открыть внутренний проект вне среды организации или пользователями, не имеющими доступ к многопользовательской базе геоданных или к данным UNC, то ссылки на данные не будут работать.
Можно создавать шаблоны с помощью параметра Упаковать как шаблон. Для создания проекта вы можете использовать шаблон проекта (файл .aptx), определяя слои, карты и данные, а также необходимые подключения.
Наборы инструментов, являющиеся частью проекта, анализируются при помощи инструмента Анализировать инструменты для 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}, {preserve_sqlite})
Имя | Описание | Тип данных |
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 |
preserve_sqlite (Дополнительный) | Определяет, будут ли данных мобильной базы геоданных сохранены в результатах или записаны в формат файловой базы геоданных Если входные данные представляют собой мобильную базу геоданных, этот параметр имеет приоритет над параметром convert_data. Если входные данные представляют собой набор данных мобильной базы геоданных, то результатом всегда будет мобильная база геоданных.
| Boolean |
Пример кода
В следующем скрипте Python показано применение функции PackageProject в окне Python.
import arcpy
p = arcpy.mp.ArcGISProject("CURRENT")
arcpy.management.PackageProject(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.management.PackageProject(project, outputFile, "EXTERNAL")
Параметры среды
Особые случаи
- Коэффициент параллельной обработки
Если параметр среды не указан, инструмент использует одну вторую доступных ядер.
Информация о лицензиях
- Basic: Да
- Standard: Да
- Advanced: Да