Краткий обзор создания и публикации веб-инструментов

Создание веб-инструмента включает в себя 2 процесса: создание и публикацию. Процесс создания начинается с построения модели или написания скрипта Python в ArcGIS Pro. После создания и успешного запуска инструмента можно опубликовать его на портале ArcGIS Enterprise, как веб-инструмент. Во время создания и публикации необходимо рассмотреть состав данных, параметры инструмента и права доступа. Некоторые аспекты, на которые следует обратить внимание, описаны в следующем примере и соответствующих секциях этого раздела. Следующий рабочий процесс описывает общий процесс:

  1. Построение скрипта или модели с помощью инструментов из набора инструментов, чтобы создать рабочий процесс.
  2. Подбор наборов данных, которые требуются для инструментов, и обеспечение их доступности в базе геоданных или добавление их на карту вашего проекта.
  3. Выполнение инструмента, чтобы после его работы была создана запись в истории геообработки об успешном выполнении.
  4. Настройка символов в выходных наборах данных на вашей карте, если требуется.
  5. Публикация элемента истории как веб-инструмента. При публикации веб-инструмента вы можете настроить свойства для инструмента и для сервиса.

Пример: изучите сколько людей пострадает от прорыва нефтепровода

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

Модель анализа влияния на население разрыва нефтепровода

Построение инструмента

У всех используемых инструментов есть входные и выходные параметры. Эти параметры позволяют изменять различные значения при каждом запуске инструмента, и как следствие инструмент будет выполнять разные аналитические операции. В дополнение ко входным и выходным параметрам инструменты работают с данными проекта и промежуточными данными. Они представляют собой наборы данных, которыми не может управлять пользователь, запускающий инструмент. В модели выходные параметры отмечены символом P. Когда модель запускается как инструмент, любые входные параметры с символом P доступны в диалоговом окне инструмента, и для них можно установить значения, которые будут использоваться во время запуска инструмента. Из модели нефтепровода пользователь может указать путь нефтепровода и расстояние для построения буфера при выполнении трассировки вниз по течению. При использовании этого инструмента местоположение нефтепровода и размер буфера изменяется, чтобы отображалось число людей, затронутых последствиями разрыва трубы. Пересечения нефтепровода и рек, а также линия трассировки – это примеры промежуточных наборов данных, которые создаются во время выполнения инструментов модели. Эти промежуточные наборы данных не нужны пользователю, запускающему инструмент, они не возвращаются в качестве результата. При открытии общего доступа к модели сервис геообработки, обслуживающий модель и запускающий веб-инструмент, выбирает, где записываются промежуточные данные, и стирает их, когда они уже не нужны.

Входные параметры инструмента-модели

Для успешного выполнения инструментов важны входные параметры, но не менее важными являются выходные параметры. Выходной параметр позволяет инструменту вернуть результат именно тому, кто запускает инструмент. В ArcGIS Pro выходные параметры необходимы, так как они определяют наборы данных, которые автоматически добавляются на карту. Инструмент без выходного параметра будет генерировать выходные данные, но они не будут автоматически отображены. Веб-инструменты работают во многом схоже. Для возращения результата конечному пользователю требуется один или несколько параметров. В модели нефтепровода есть два выходных параметра: численность населения в областях в зоне влияния, которая записывается для местоположений буферных полигонов, расположенных вниз по течению, а также суммарная таблица численности населения с рассчитанным значением количества населения, которое может пострадать. Обратите внимание на то, что численность населения в затронутых областях является и промежуточными, и выходными данными. Этот параметр является промежуточным, так как от требуется для инструмента Суммарная статистика, но он определен как параметр модели (P), и его значения будут возвращены как результаты после выполнения инструмента.

Выходные параметры инструмента-модели
Подсказка:

Все те же принципы в отношении ко входным и выходным параметрам, данным проекта и промежуточным данным применяются для создания инструментов-скриптов Скрипт.

Документация инструмента

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

Более подробно о документировании инструментов

Запуск инструмента

После создания инструмента, требуется выполнить его успешный запуск. При запуске инструмента в истории геообработки создаётся запись. Инструмент, который завершился с записью о невыполнении, нельзя опубликовать.

Примечание:

При запуске модели в ModelBuilder не создаётся запись в Истории геообработки. Инструменты-модели должны запускаться как инструмент на панели Геообработка.

Публикация веб-инструмента

Веб-инструмент можно опубликовать, выбрав Анализ > История, чтобы открыть панель История. Чтобы опубликовать, щелкните правой кнопкой элемент и выберите Опубликовать как. Чтобы опубликовать, как новый веб-инструмент, выберите Опубликовать веб-инструмент, чтобы открыть панель Опубликовать как веб-инструмент. Чтобы перезаписать имеющийся инструмент, выберите Перезаписать веб-инструмент, чтобы открыть панель со всеми имеющимися веб-инструментами, опубликованными в Моих ресурсах.

Панель выбора Перезаписать веб-инструмент

Убедитесь, что вы выбрали корректный инструмент для перезаписи, и щелкните OK, чтобы открыть панель Перезаписать веб-инструмент. Процесс настройки предварительно настроенного веб-инструмента одинаков для вариантов Опубликовать веб-инструмент и Перезаписать веб-инструмент.

Либо выберите Опубликовать > Веб-инструмент, чтобы выбрать Опубликовать веб-инструмент или Перезаписать веб-инструмент. Если вы выберете Опубликовать веб-инструмент, укажите элемент на панели публикации инструментов со всеми успешно запущенными элементами.

Панель Выбрать инструмент для публикации

Если вы выберете Перезаписать веб-инструмент, укажите перезаписываемый элемент на панели со всеми имеющимися веб-инструментами, опубликованными в разделе Мои ресурсы. Затем выберите элемент на панели со всеми запущенными элементами, которые будут перезаписаны. Шаги перезаписи в этом рабочем процессе меняются местами при выборе из Анализ > История.

Настройка свойств веб-инструмента

Инструмент оценки последствий разлива нефти выводит как результат объекты и таблицу. Объём данных, создаваемых и возвращаемых инструментом, ограничивается в размере, поэтому веб-инструмент будет настроен как асинхронный сервис без результирующего картографического сервиса. Настройки по умолчанию, максимум 1000 записей, будет достаточно. Уровень сообщений ошибка позволит получать только сообщения о невыполнении инструмента. В случае успешного выполнения веб-инструмента конечному пользователю не будет выводиться сообщений о процессе обработки.

Опции настройки веб-инструмента

Веб-инструмент всегда доступен в вашем разделе Мои ресурсы. Вы можете открыть к нему доступ для организации, для всех или для выбранных групп. Инструмент оценки последствий разлива нефти может пригодиться для сотрудников-акционеров организаций, которым необходимо выполнять анализ нефтепроводов. Выбор правильных групп позволить пользователям быстро найти инструмент и начать с ним работать.

Опции общего доступа для веб-инструмента

Копирование или ссылка на данные

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

Рассмотрим ситуацию, когда метод анализа был немного изменен, а именно пользователь не даёт данные о нефтепроводе. Альтернативные данные о предполагаемых местоположениях нефтепроводов пришли из другого процесса, и пользователь предоставил другие входные данные для инструмента. В этом случае предполагаемое местоположение нефтепровода становится данными проекта. Следовательно, рекомендуется поместить этот набор данных в корпоративную базу геоданных и сделать так, чтобы инструмент ссылался на набор данных. При публикации вы настроите ссылку на данные, используя хранилище данных ArcGIS Server. В процессе публикации будет сохранена ссылка на базу данных, вместо создания статичной копии. В дальнейшем специалист-аналитик проекта может обновить данные в корпоративной базе геоданных, и веб-инструмент будет выполнять анализ для нового предложенного местоположения нефтепровода.

Опции данных веб-инструмента

Анализ

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

Публикация

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

Использование веб-инструмента

Веб-инструменты можно найти и открыть в разделе Портал панели Каталог. Помимо запуска инструмента в ArcGIS Pro, соответствующий сервис геообработки Сервис геообработки можно использовать в скрипте Python или веб-приложении.

Дополнительные сведения о поиске и использовании веб-инструментов в ArcGIS Pro