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

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

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

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

  • После запуска инструмента в раздел История геообработки на панели Каталог добавляется элемент истории геообработки. Используйте этот элемент в качестве входных данных для инструмента Упаковать результат.

    Когда инструмент выполняется из Python, возвращается объект Result. Свойство resultID объекта Result можно использовать в качестве входных данных для этого инструмента. Второй пример кода ниже демонстрирует, как использовать свойство resultID объекта Result.

  • Если включена Поддержка ArcGIS Maps SDK, созданный пакет геообработки можно использовать в среде ArcGIS Maps SDKs. Для поддержки среды ArcGIS Maps SDKs выполняются следующие действия:

    • Все источники данных не из баз геоданных будут конвертированы в файловую базу геоданных.
    • Копия инструмента, для которого выполняется упаковка, создается в новом наборе инструментов, настроенном для публикации.

    Примечание:

    Начиная с ArcGIS Pro 2.1, могут быть созданы пакеты геообработки, которые поддерживают ArcGIS Maps SDKs.

  • Если включен параметр Конвертировать данные в файловую базу геоданных, происходит следующее:

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

  • Если включен параметр Конвертировать данные в файловую базу геоданных, происходит следующее:

    • Формат источника данных входных слоев будет по возможности сохранен.
    • Растровые форматы ADRG, CADRG/ECRG и RPF будут преобразованы в растры файловой базы геоданных. ArcGIS не может напрямую считывать эти форматы. Они будут конвертироваться в растры файловой базы геоданных для повышения эффективности.
    • В структуре выходной папки файловые базы геоданных будут объединены в специфичную для версий папку, а все другие форматы будут объединены в папку commonData.
    • Сжатые растровые и векторные форматы не будут обрезаны, даже если в параметре Экстент указан экстент.

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

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

  • Некоторые наборы данных ссылаются на другие наборы данных. Например, у вас может быть набор данных топологи, который ссылается на четыре класса пространственных объектов. Другие примеры наборов данных, которые ссылаются на другие наборы данных, включают Геометрические сети, Сети и Локаторы. При сборе или упаковке слоя на основе этих типов наборов данных, участвующие наборы данных также будут собраны или упакованы.

  • Если выбрано Только схема, то собирается или упаковывается только схема источников входных и выходных данных. Схема – это структура или дизайн класса пространственных объектов или таблицы, состоящей из полей и определений таблицы, свойств системы координат, символов, определяющих запросов и т. д. Сбор и упаковка данных или записей не выполняется.

  • Источники данных, которые не поддерживают только схему, не будут объединены или упакованы. Если отмечен параметр Только схема и инструменту встречается слой, который поддерживается не только схемой, отображается предупреждающее сообщение и этот слой будет пропущен. Если единственный указанный слой не поддерживается только для схемы, инструмент не будет выполнен.

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

    По умолчанию при извлечении пакета в панели Каталог содержимое будет извлечено в профиль пользователя.

Параметры

ПодписьОписаниеТип данных
Результат

Упаковываемый результат.

Входными данными может быть либо результат, взятый из истории вашего текущего проекта, либо, при использовании инструмента в скрипте Python, свойство resultID объекта Result.

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

Имя и расположение выходного файла пакета (.gpkx).

File
Конвертировать данные в файловую базу геоданных
(Дополнительный)

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

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

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

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

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

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

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

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

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

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

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

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

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

  • Не отмечено – выходной пакет не поддерживает ArcGIS Maps SDKs. Это значение по умолчанию
  • Отмечено – выходной пакет поддерживает ArcGIS Maps SDKs.
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

arcpy.management.PackageResult(in_result, output_file, {convert_data}, {convert_arcsde_data}, {extent}, {apply_extent_to_arcsde}, {schema_only}, {arcgisruntime}, {additional_files}, {summary}, {tags}, {version}, {select_related_rows})
ИмяОписаниеТип данных
in_result
[in_result,...]

Упаковываемый результат.

Входными данными может быть либо результат, взятый из истории вашего текущего проекта, либо, при использовании инструмента в скрипте Python, свойство resultID объекта Result.

File; String
output_file

Имя и расположение выходного файла пакета (.gpkx).

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

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

  • CONVERTДанные будут преобразованы в файловую базу геоданных. Параметр не применяется к источникам данных многопользовательской базы геоданных. Чтобы конвертировать данные многопользовательской базы геоданных, задайте параметр convert_arcsde_data как CONVERT_ARCSDE.
  • PRESERVEФорматы данных будут по возможности сохранены. Это значение по умолчанию
Boolean
convert_arcsde_data
(Дополнительный)

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

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

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

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

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

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

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

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

Определяет, будет ли пакет поддерживать ArcGIS Maps SDKs. Для поддержки ArcGIS Maps SDKs все источники данных будут конвертированы в файловую базу геоданных.

  • DESKTOPВыходной пакет поддерживает ArcGIS Maps SDKs. Это значение по умолчанию
  • RUNTIMEВыходной пакет поддерживает ArcGIS Maps SDKs.
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
select_related_rows
(Дополнительный)

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

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

Пример кода

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

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


import arcpy
arcpy.env.workspace = "C:/ResultFiles" 
arcpy.management.PackageResult('Parcel.rlt', 'Parcel.gpk', "PRESERVE", 
                               "CONVERT_ARCSDE", "#", "ALL", "ALL", 
                               "DESKTOP", r"C:\docs\readme.txt", 
                               "Summary text", "Tag1; tag2; tag3")
PackageResult, пример 2 (автономный скрипт)

Следующий скрипт Python показывает, как использовать функцию PackageResult из окна Python или из скрипта с объектом Result пользовательского инструмента.

import arcpy

# Import toolbox with custom model inside
arcpy.ImportToolbox("c:/gisworkflows/ParcelTools.tbx")

# Run the tool and assign to a result variable
parcelUpdate = arcpy.ParcelUpdater_ParcelTools("c:/data/parcels.gdb/ward3", "UPDATE")

arcpy.management.PackageResult(parcelUpdate.resultID, "c:/gpks/parcelgpk.gpkx", 
                               "PRESERVE", "CONVERT_ARCSDE", "#", "ALL", 
                               "ALL", "DESKTOP", "#", "Summary text", "Tag1")

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

Этот инструмент не использует параметры среды геообработки