Краткая информация
Упаковывает один или несколько результатов геообработки, включая все инструменты и наборы входных и выходных данных в один сжатый файл (.gpk).
Использование
При запуске инструмента сведения о выполнении записываются как результат в окне Результаты (Results). Результаты можно добавить как входные данные, перетащив их непосредственно из окна Результаты. Или результаты, которые были сохранены как файлы результатов (.rlt), также можно добавить как входные данные.
Если включена Поддержка ArcGIS Runtime (Support ArcGIS Runtime), созданный пакет геообработки можно использовать в среде ArcGIS Runtime. Поддержка среды выполнения
- Все источники данных, не являющиеся базой геоданных, будут преобразованы в файловую базу геоданных.
- Файл определения картографического сервиса (.msd)будет создан и добавлен в пакет.
- Копия инструмента, для которого выполняется упаковка, создается в новом наборе инструментов, настроенном для публикации.
Если установлена отметка Конвертировать данные в файловую базу геоданных (Convert Data to File Geodatabase)
- Каждый уникальный источник данных будет иметь уникальную файловую базу геоданных, созданную в объединенной папке или пакете.
- Сжатые растровые и векторные форматы будут конвертированы в файловую базу геоданных, и сжатие будет утеряно.
- Объединение для многопользовательской базы геоданных не выполняется. В целях преобразования данных многопользовательских баз данных необходимо установить отметку Вместо привязки к данным включить данные корпоративной базы геоданных (Include Enterprise geodatabase data instead of referencing the data).
Если опция Конвертировать данные в файловую базу геоданных (Convert Data to File Geodatabase) отключена.
- Формат источника данных входных слоев будет сохранен. Исключением являются такие форматы как данные персональных баз геоданных (.mdb), данные VPF и таблицы на основе электронных таблиц Excel или подключений OLEDB. Эти форматы не поддерживают среды 64х и, таким образом, они всегда преобразовываются в файловые базы геоданных.
- Растровые форматы ADRG, CADRG/ECRG и RPF преобразовываются в формат файловой базы геоданных. ArcGIS не может напрямую писать из этих форматов. Они всегда будут конвертироваться в растры файловой базы геоданных для повышения эффективности.
- В структуре выходной папки файловые базы геоданных будут объединены в специфичную для версий папку, а все другие форматы будут объединены в папку commonData.
- Сжатые растровые и векторные форматы не будут вырезаться, даже если экстент задан в параметре Экстент (Extent).
Для слоев, которые содержат соединение или участвуют в классах отношений, все соединенные или связанные источники данных будут объединены в выходную папку.
Для векторных слоев, параметр Экстент (Extent) используется для выбора пространственных объектов, которые будут объединены. Для растровых слоев, параметр Экстент используется для вырезания наборов растровых данных.
Некоторые наборы данных ссылаются на другие наборы данных. Например, у вас может быть набор данных топологи, который ссылается на четыре класса пространственных объектов. Другие примеры наборов данных, которые ссылаются на другие наборы данных, включают Геометрические сети (Geometric Networks), Сети (Networks) и Локаторы (Locators). При размещении или пакетировании слоя на основе этих типов наборов данных, участвующие наборы данных также будут размещены или пакетированы.
Если установлена соответствующая отметка, параметр Только схема (Schema Only) будет объединять или запаковывать схему источников входных и выходных данных. Схема – это структура или дизайн класса пространственных объектов или таблицы, состоящей из полей и определений таблицы, свойств системы координат, символов, определяющих запросов и т. д. Объединение или упаковка данных или записей не выполняется.
Источники данных, которые не поддерживают только схему, не будут объединены или упакованы. Если отмечен параметр Только схема (Schema Only) и инструменту встречается слой, который поддерживается не только схемой, отображается предупреждающее сообщение и этот слой будет пропущен. Если единственный указанный слой не поддерживается только для схемы, инструмент не будет выполнен.
Создание пакета из ошибочного результата невозможно. Однако можно использовать инструмент Собрать результат (Consolidate Result) для создания папки, содержащей все данные и инструменты, используемые ошибочным результатом.
Чтобы распаковать пакет геообработки, перетащите файл .gpk в ArcMap или щелкните правой кнопкой на файл .gpk и нажмите Распаковать (Unpack). Или же вы можете воспользоваться инструментом Распаковать (Extract Package) и задать выходную папку.
По умолчанию упаковки будут извлечены в профиль пользователя.
- XP – C:\Documents and Settings\<username>\My Documents\ArcGIS\Packages
- Vista and Windows 7 – C:\Users\<username>\Documents\ArcGIS\Packages
Чтобы изменить папку, в которую по умолчанию распаковывается содержимое пакетов, выберите пункт Опции ArcMap (ArcMap Options) в меню Настройка (Customize). На закладке Общий доступ (Sharing) найдите раздел Упаковка (Packaging) и выберите пункт Использовать определенное пользователем местоположение (Use user specified location), после чего перейдите в новую папку.
Создание пакета из ошибочного результата невозможно. Однако можно использовать инструмент Собрать результат (Consolidate Result) для создания папки, содержащей все данные и инструменты, используемые ошибочным результатом.
Синтаксис
PackageResult_management (in_result, output_file, {convert_data}, {convert_arcsde_data}, {extent}, {apply_extent_to_arcsde}, {schema_only}, {arcgisruntime}, {additional_files}, {summary}, {tags}, {version})| Параметр | Объяснение | Тип данных |
in_result | Упаковываемый результат. Входные данные могут быть либо результатом, добавленным путем перетаскивания непосредственно из окна Результаты (Results) или путем открытия файла результатов (.rlt). | File; String |
output_file | Имя и местоположение выходного файла пакета (.gpk). | File |
convert_data (дополнительно) | Устанавливает, будут ли входные слои конвертированы в файловую базу геоданных или сохранят свои исходные форматы.
| Boolean |
convert_arcsde_data (дополнительно) | Устанавливает, будут ли входные слои многопользовательской базы геоданных преобразованы в файловую базу геоданных или сохранят свои исходные форматы.
| Boolean |
extent (дополнительно) | Задайте экстент, введя вручную координаты в параметре экстента, используя формат X-Min Y-Min X-Max Y-Max. Для использования экстента конкретного слоя укажите имя слоя.
| Extent |
apply_extent_to_arcsde (дополнительно) | Определяет, будет ли указанный экстент ко всем слоям или только к многопользовательские слои базы геоданных.
| Boolean |
schema_only (дополнительно) | Указывает, будет ли объединение и упаковка выполняться только для схемы наборов входных и выходных данных.
| Boolean |
arcgisruntime (дополнительно) | Определяет, будет ли пакет поддерживать ArcGIS Runtime. В целях обеспечения поддержки ArcGIS Runtime все источники данных будут преобразованы в файловую базу геоданных, и в пакете будет создан файл определения картографического сервиса (.msd).
| Boolean |
additional_files (дополнительно) | Добавляет дополнительные файлы в пакет. Дополнительные файлы, например .doc, .txt, .pdf и пр., используются для предоставления дополнительной информации о содержимом и назначении пакета. | File |
summary (дополнительно) | Добавление краткого описания в свойства пакета. | String |
tags (дополнительно) | Добавление информации о тегах в свойства пакета. Можно добавить несколько тегов с разделением запятой или точкой с запятой. | String |
version [version,...] (дополнительно) | Указывает версию базы геоданных, которая будет создана в результирующем пакете. Указание версии позволяет осуществлять общий доступ к пакетам из предыдущих версий ArcGIS и поддерживает обратную совместимость.
| String |
Пример кода
Пример 1. PackageResult (окно Python)
Следующий скрипт Python демонстрирует, как использовать инструмент PackageResult из окна Python:
import arcpy
arcpy.env.workspace = "C:/ResultFiles"
arcpy.PackageResult_management('Parcel.rlt', 'Parcel.gpk', "PRESERVE", "CONVERT_ARCSDE", "#", "ALL", "ALL", "DESKTOP", r"C:\docs\readme.txt", "Summary text", "Tag1; tag2; tag3")
Пример 2. PackageResult (автономный скрипт Python)
Находит и создает отдельные пакеты геообработки для всех файлов результатов, которые находятся в указанной папке.
# Name: PackageResultEx1.py
# Description: Find all the result files that reside in a specified folder and create a geoprocessing package for each result file.
# import system modules
import os
import arcpy
# Set environment settings
arcpy.env.overwriteOutput = True
arcpy.env.workspace = "C:/ResultFiles"
# Loop through the workspace, find all the result files (.rlt) and create a geoprocessing package using the same name as the original result file.
for rlt in arcpy.ListFiles("*.rlt"):
print("Packaging " + rlt)
arcpy.PackageResult_management(rlt, os.path.splitext(lyr)[0] + '.gpk', "PRESERVE", "CONVERT_ARCSDE", "#", "ALL", "ALL", "DESKTOP", r"C:\docs\readme.txt", "Summary text", "Tag1; tag2; tag3")
Пример 3. PackageResult (автономный скрипт Python)
Находит и создает один пакет геообработки для всех файлов результатов, которые находятся в указанной папке.
# Name: PackageResultEx2.py
# Description: Find all the result files that reside in a specified folder and create a single geoprocessing package.
# import system modules
import os
import arcpy
# Set environment settings
arcpy.env.overwriteOutput = True
arcpy.env.workspace = "C:/ResultFiles"
# Find all the result files (.rlt) in a workspace and create a single geoprocessing package.
rlts = arcpy.ListFiles("*.rlt")
arcpy.PackageResult_management(rlts, 'all_layers.gpk', "PRESERVE", "CONVERT_ARCSDE", "#", "ALL", "ALL", "DESKTOP", r"C:\docs\readme.txt", "Summary text", "Tag1; tag2; tag3")
Параметры среды
Этот инструмент не использует параметры среды геообработки