Краткий обзор создания пакета геообработки
Чтобы создать пакет геообработки, щелкните правой кнопкой мыши результат работы инструмента в окне Результаты (Results) и выберите Общий доступ как (Share As) > Пакет геообработки (Geoprocessing Package). Результаты создаются при запуске инструмента через его диалоговое окно, а также через окно Python. При запуске модели из ModelBuilder результаты не создаются.
Дополнительные сведения о результатах и окне Результаты
Окно Пакет геообработки.
На приведенной ниже иллюстрации показано окно Пакет геообработки, каким оно отображается при предоставлении общего доступа к результату с именем Оценка рисков (Risk Assessment).
На левой панели содержится таблица содержания. Щелчок каждой записи изменяет содержимое правой панели.
Содержание | Описание |
---|---|
Пакет геообработки | Варианты сохранения пакета. Можно загрузить пакет в ArcGIS Online или сохранить его в файле на жестком диске. Ниже приведены сведения о настройках создания пакета. |
Оценка рисков | В этом примере результат был щелкнут правой кнопкой мыши для открытия окна Пакет геообработки (Geoprocessing Package). В правой панели можно указать новое имя и обновить описание пакета. |
Описание элемента | Это описание создаваемого пакета. Все типы пакетов должны иметь общие сведения и теги. |
Дополнительные файлы | В пакет можно включить дополнительные файлы. Как правило, это файлы документации. Невозможно добавить некоторые типы файлов, например исполняемые файлы (.exe, .py и т. д.). |
В следующей таблице описываются параметры пакета геообработки
Опции | Описание |
---|---|
Паковать только схему | Если этот флажок установлен, в пакет будет включена только схема входных источников данных. Схема — это структура или дизайн класса пространственных объектов или таблицы, состоящей из полей и определений таблицы, свойств системы координат, символов, определяющих запросов и т. д. Данные или записи не будут консолидироваться. Эта опция не применяется к данным проекции. Данные проекции — это входные данные, которые не являются параметром, то есть эти данные не предоставляются пользователем инструмента, а используются внутри самого инструмента. Все данные и записи данных проекции будут включены в пакет. |
Вместо привязки к данным включить данные корпоративной базы геоданных | Если включить эту опцию, любые данные, размещенные в многопользовательской базе геоданных, будут извлечены из базы данных, преобразованы в файловую базу геоданных и включены в пакет. Если не включать эту опцию, наборы данных, хранящиеся в многопользовательской базе геоданных, будут и дальше ссылаться на данные многопользовательской базы геоданных, а получатель пакета должен будет получить доступ к многопользовательской базе геоданных, чтобы воспользоваться этими данными. |
Поддержка ArcGIS Runtime | Эта опция будет доступна, если в пакетах включена поддержка среды выполнения ArcGIS Runtime. Включите эту опцию, если пакет геообработки должен использоваться в приложении среды выполнения ArcGIS Runtime. Чтобы включить эту опцию, щелкните Настроить > Опции ArcMap в главном меню ArcMap. Откроется диалоговое окно Опции ArcMap. Перейдите на вкладку Совместное использование и установите флажок Включить инструменты ArcGIS Runtime, как показано ниже. |
В верхней части окна Пакет геообработки содержится четыре кнопки.
Кнопка | Описание |
---|---|
Добавить результат | Пакет геообработки может содержать несколько результатов. Эта кнопка добавляет в пакет новый результат. |
Анализировать | Анализ всех результатов в пакете на наличие ошибок. |
Общий доступ | Создает файл пакета или загружает его в ArcGIS Online в зависимости от опции, выбранной на панели Пакет геообработки. Пакет будет проанализирован на наличие ошибок, даже если ранее была нажата кнопка Анализировать. |
Свернуть | Это приведет к сворачиванию окна Пакет геообработки до его минимального размера. Это необходимо, к примеру, если следует скрыть окно во время анализа результатов или выполнения каких-либо других задач. Можно восстановить окно до исходного размера, нажав кнопку развертывания. . |
Перед началом упаковки
При создании пакета ArcGIS анализирует результат проблем. В зависимости от этого анализа может понадобиться предоставить дополнительную информацию, а в некоторых случаях повторно обработать результат для создания выходных данных. Чтобы уменьшить вероятность возникновения проблем при создании пакета стоит выполнить три перечисленные ниже задачи.
Документация инструмента
При упаковке результата на основе пользовательской модели или скрипта-инструмента, пользовательский инструмент должен быть документирован (системные инструменты уже документированы, поэтому в документации нуждаются только пользовательские инструменты). При упаковке ArcGIS анализирует инструмент на наличие минимального уровня документации. Инструмент должен иметь, по меньшей мере, общие сведения, один или несколько тегов и описание каждого параметра. Уровень предоставляемой документации выбирается самим пользователем. Если инструмент предоставляется коллеге на рабочем месте, допускается минимальный уровень документации, так как пользователь в любой момент может ответить на вопросы коллеги. Однако при загрузке пакета в ArcGIS Online необходима подробная документация, чтобы использование пакета было понятным и доступным широкой аудитории.
При упаковке результатов ArcGIS проверяет на наличие минимального уровня документации, так что, если она отсутствует, можно приостановить создание пакета и составить документацию. Это не является рекомендацией. Как правило, пользователь спешит завершить работу с пакетом, что отражается на документации. Рекомендуется уделить достаточное время для составления документации, прежде чем создавать окончательный пакет.
Чтобы составить документацию пользовательской модели или скрипта-инструмента, выполните следующие действия.
- В ArcMap перейдите к инструменту, в котором был создан результат, используя для этого окно Каталог или окно ArcToolbox. Щелкните правой кнопкой инструмент и выберите Описание элемента. В ArcMap перейдите к инструменту, который использовался для создания результата, выберите его в дереве каталога и щелкните вкладку Описание.
- В окне Описание элемента щелкните кнопку Редактировать .
- В поле ввода текста Теги укажите теги. Теги используется поисковыми системами.
- В поле ввода Общая информация (Резюме) предоставьте краткую, сжатую сводку о своем инструменте. Обратите внимание, что пакет может содержать дополнительные файлы, такие как документы Word или PDF, в которых можно привести более подробную документацию. Эта общая информация также используется поисковыми системами.
- В разделе Синтаксис разверните каждый параметр и убедитесь, что заполнено поле Пояснение диалога. Если значение не указано, введите приемлемый текст.
- По завершению составления документации, нажмите кнопку Сохранить .
Теги, общая информация и синтаксис — это минимальные требования для упаковки. Конечно, следует выходить за рамки минимальных требований и предоставлять советы по использованию, примеры кода, изображения, признание авторства, ограничения использования и диапазон масштабов инструмента.
Кроме того, для пользовательских инструментов моделей можно добавлять подписи в инструменте ModelBuilder. Для пользовательских скриптов-инструментов понятные комментарии в коде Python будут востребованы теми, кто читает (или отлаживает) этот код.
Составление документации пакета
Помимо документации на инструмент, с помощью которого был сделан результат, необходимо предоставить документацию на пакет. Делать это следует во время упаковки. Рекомендуется составить описание пакета в текстовом редакторе по выбору перед созданием пакета, а затем скопировать и вставить текст в описание пакета.
При упаковке ArcGIS использует общую информацию и теги из инструмента в качестве исходной документации по пакету. Если пакет содержит несколько инструментов, только общая информация и теги из первого инструмента добавляются автоматически. В этом случае следует заменить общую информацию о пакете и теги на сведения, описывающие все инструменты в пакете.
Повторное создание результата
Результаты создаются путем запуска инструмента; следует получить допустимый результат, прежде чем создать пакет. При упаковке ArcGIS анализирует результат и копирует все входные и выходные данные в пакет. Если эти данные невозможно найти, появятся сообщения об ошибках, которые необходимо будет исправить, прежде чем продолжить упаковку.
Самой распространенной проблемой с невозможностью обнаружения данных во время упаковки — это упаковка устаревшего результата. Как правило, устаревший результат — это результат, расположенный в узле Предыдущий сеанс окна Результаты. Между временем создания результата и временем его упаковки данные могли быть удалены, перемещены или переименованы, то есть стали недоступными.
Чтобы повторно выполнить результат, щелкните правой кнопкой мыши результат и выберите Открыть или Запустить повторно. Повторный запуск обеспечивает нахождение всех входных и выходных данных. Затем новый результат можно упаковать.
Использование инструментов Результат пакета и Доступ к пакету
Можно создать пакет геообработки с помощью инструмента Упаковать результат. После создания пакета геообработки можно предоставить к нему доступ через ArcGIS Online с помощью инструмента Доступ к пакету.
Доступ к недействительным результатам
Доступ к недопустимому результату предоставить невозможно, как показано ниже.
Иногда требуется предоставить общий доступ к недопустимому результату своему коллеге в целях устранения неполадок. Это можно сделать с помощью инструмента Собрать результат (Consolidate Result) следующим образом.
- Откройте инструмент Собрать результат.
- Перетащите недопустимый результат из окна Результаты на параметр Результат.
- Предоставьте значение для параметра Выходная папка.
- Измените при необходимости дополнительные параметры или используйте значения по умолчанию.
- Для запуска инструмента нажмите ОК.
- В проводнике Windows откройте местоположение выходной папки.
- Воспользуйтесь служебной программой для создания ZIP-архивов, чтобы сжать папку в ZIP-файл.
- Отправьте этот ZIP-файл по электронной почте своему коллеге. Он сможет распаковать файл и оценить все аспекты вашего инструмента.