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

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

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

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

  • Все элементы проекта собираются и будут сохранены в файле .aprx; включаются карты, данные, связанные со слоями, наборы инструментов, стили, компоновки, а также подключения (если применимо).

  • Параметр Опубликовать вне организации указывает, следует ли помещать данные в папку.

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

    Примечание:

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

  • Можно создавать шаблоны с помощью параметра Собрать как шаблон. При создании проекта вы можете использовать шаблон проекта для определения слоев, карт и данных, а также необходимых подключений.

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

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

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

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

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

Параметры

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

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

File
Выходная папка

Выходная папка, которая будет содержать объединенный проект и данные. Если указанная папка не существует, то она будет создана.

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

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

Примечание:

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

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

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

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

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

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

Boolean
Собрать как шаблон
(Дополнительный)

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

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

Boolean
Сохранить мобильную базу геоданных
(Дополнительный)

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

Примечание:

Этот параметр применяется только к мобильным базам геоданных (.geodatabase), которые, главным образом, используются в автономных рабочих процессах в приложениях ArcGIS Runtime. Базы геоданных SQLite с расширениями .sqlite и .gpkg будут конвертированы в файловые базы геоданных.

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

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

Указывает версию AllSource, в которой будет сохранен собранный проект. Сохранение в предыдущей версии обеспечивает обратную совместимость инструмента. Если вы хотите собрать набор инструментов в предыдущую версию, но имеются функции, доступные только в более новой, произойдет ошибка. Необходимо удалить инструменты, которые не совместимы с предыдущей версией, или выбрать совместимую версию.

  • Текущая версияПапка будет содержать базы геоданных и карты, совместимые с версией текущего выпуска.
  • 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.
String
Сохранить только те строки, которые связаны с объектами в пределах экстента
(Дополнительный)

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

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

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
(Дополнительный)

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

  • INTERNALПроект и его источники данных не будут объедены в выходную папку. Это значение по умолчанию
    Примечание:

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

  • EXTERNALПроект и его источники данных будут объедены (скопированы) в выходной папке, если возможно.
Boolean
extent
(Дополнительный)

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

  • MAXOF - будет использоваться максимальный экстент всех входных данных.
  • MINOF - будет использоваться минимальная область, общая для всех входных данных.
  • DISPLAY– экстент будет равен видимому отображению.
  • Имя слоя - будет использоваться тот же экстент, что и в указанном слое.
  • Объект Extent - будет использоваться тот же экстент, что и в указанном объекте.
  • Строка координат, разделенных пробелами – будет использоваться экстент из заданной строки. Координаты должны быть выражены в таком порядке: x-min, y-min, x-max, y-max.
Extent
apply_extent_to_enterprise_geo
(Дополнительный)

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

  • ALLЭкстент применяется ко всем слоям. Это значение по умолчанию
  • ENTERPRISE_ONLYЭкстент применяется только к слоям многопользовательских баз геоданных.
Boolean
package_as_template
(Дополнительный)

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

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

  • PROJECT_PACKAGEПроект будет собран, как проект, в папку. Это значение по умолчанию
  • PROJECT_TEMPLATEПроект будет собран, как шаблон, в папку
Boolean
preserve_sqlite
(Дополнительный)

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

Примечание:

Этот параметр применяется только к мобильным базам геоданных (.geodatabase), которые, главным образом, используются в автономных рабочих процессах в приложениях ArcGIS Runtime. Базы геоданных SQLite с расширениями .sqlite и .gpkg будут конвертированы в файловые базы геоданных.

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

Указывает версию AllSource, в которой будет сохранен собранный проект. Сохранение в предыдущей версии обеспечивает обратную совместимость инструмента. Если вы хотите собрать набор инструментов в предыдущую версию, но имеются функции, доступные только в более новой, произойдет ошибка. Необходимо удалить инструменты, которые не совместимы с предыдущей версией, или выбрать совместимую версию.

  • 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.
String
select_related_rows
(Дополнительный)

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

  • KEEP_ONLY_RELATED_ROWSБудут объединены только связанные данные, соответствующие записям в указанном экстенте.
  • KEEP_ALL_RELATED_ROWSСвязанные источники данных будут объединены в полном объеме. Это значение по умолчанию
Boolean

Пример кода

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

В следующем скрипте Python показано применение функции ConsolidateProject в окне Python.

import arcpy
arcpy.management.ConsolidateProject('c:\\projects\\SE_Pipelines\\PipeDevelopment.aprx', 
                                    'E:\\gisShare\\projects\\Pipelines\\SE_Pipeline',
                                    'INTERNAL')
ConsolidateProject пример 2 (автономный скрипт)

Следующий скрипт берет входную папку, в которой размещаются файлы проекта (.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.management.ConsolidateProject(project, outputFolder, "INTERNAL")

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

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

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

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