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

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

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

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

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

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

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

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

    Примечание:

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

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

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

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

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

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

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

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

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

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

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

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

Параметры

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Добавление краткого описания в свойства пакета.

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

Добавление информации о тегах в свойства пакета. Можно добавить несколько тегов с разделением запятой или точкой с запятой.

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

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

Примечание:

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

  • Все версииПакет будет содержать базы геоданных и карты, совместимые со всеми версиями (ArcGIS Pro 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.
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-min, y-min, x-max, y-max.
Extent
apply_extent_to_arcsde
(Дополнительный)

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

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

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

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

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

  • DESKTOPВыходной пакет поддерживает ArcGIS Runtime. Это значение по умолчанию
  • RUNTIMEВыходной пакет поддерживает ArcGIS Runtime.
Boolean
additional_files
[additional_files,...]
(Дополнительный)

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

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

Добавление краткого описания в свойства пакета.

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

Добавление информации о тегах в свойства пакета. Можно добавить несколько тегов с разделением запятой или точкой с запятой.

String
version
[version,...]
(Дополнительный)

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

Примечание:

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

  • ALLПакет будет содержать базы геоданных и карты, совместимые со всеми версиями (ArcGIS Pro 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.
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")

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

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

Информация о лицензиях

  • Basic: Да
  • Standard: Да
  • Advanced: Да

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