Создание веб-инструмента включает в себя 2 процесса: создание и публикацию. Процесс создания начинается с создания модели или инструмент-скрипта Python в ArcGIS Pro. После создания и успешного запуска инструмента можно опубликовать его на портале ArcGIS Enterprise, как веб-инструмент. Во время создания и публикации необходимо рассмотреть состав данных, параметры инструмента и права доступа. Некоторые аспекты, на которые следует обратить внимание, описаны в следующем примере и соответствующих секциях этого раздела. Следующий рабочий процесс описывает общий процесс:
- Построение скрипта или модели с помощью инструментов из набора инструментов, чтобы создать рабочий процесс.
- Подбор наборов данных, которые требуются для инструментов, и обеспечение их доступности в базе геоданных или добавление их на карту вашего проекта.
- Запустите инструмент, чтобы после его работы была создана запись в истории геообработки об успешном выполнении.
- Настройка символов в выходных наборах данных на вашей карте, если требуется.
- Публикация элемента истории как веб-инструмента. При публикации веб-инструмента вы можете настроить свойства для инструмента и для сервиса.
Пример: изучите сколько людей пострадает от прорыва нефтепровода
Представленная ниже модель инструментов является коллекцией инструментов, которые проверяют, сколько людей может пострадать от возможного прорыва нефтепровода. Рабочий процесс находит точки пересечения нефтепровода и реки и выполняет трассировку вниз по течению, чтобы понять, сколько людей затронет инцидент. Эта модель использует данные проекта и параметры и публикуется как веб-инструмент, чтобы аналитик или сотрудник организации мог изменить предполагаемый маршрут нефтепровода, чтобы увидеть воздействие на население при трассировке вниз по течению. Результаты работы веб-инструмента представляют собой точки, где нефтепровод пересекает реку, и краткую информацию о влиянии на население.
Построение инструмента
У всех используемых инструментов есть входные и выходные параметры. Эти параметры позволяют изменять различные значения при каждом запуске инструмента, и как следствие инструмент будет выполнять разные аналитические операции. В дополнение ко входным и выходным параметрам инструменты работают с данными проекта и промежуточными данными. Они представляют собой наборы данных, которыми не может управлять пользователь, запускающий инструмент. В модели входные параметры помечены символом P. Когда модель запускается как инструмент, любые входные параметры с символом P доступны в диалоговом окне инструмента, и для них можно установить значения, которые будут использоваться во время запуска инструмента. Из модели нефтепровода пользователь может указать путь нефтепровода и расстояние для построения буфера при выполнении трассировки вниз по течению. При использовании этого инструмента местоположение нефтепровода и размер буфера изменяется, чтобы отображалось число людей, затронутых последствиями разрыва трубы. Пересечения нефтепровода и рек, а также линия трассировки – это примеры промежуточных наборов данных, которые создаются во время выполнения инструментов модели. Эти промежуточные наборы данных не нужны пользователю, запускающему инструмент, они не возвращаются в качестве результата. При открытии общего доступа к модели сервис геообработки, обслуживающий модель и запускающий веб-инструмент, выбирает, где записываются промежуточные данные, и стирает их, когда они уже не нужны.
Для успешного выполнения инструментов важны входные параметры, но не менее важными являются выходные параметры. Выходной параметр позволяет инструменту вернуть результат именно тому, кто запускает инструмент. В ArcGIS Pro выходные параметры важны, поскольку эти наборы данных автоматически добавляются на карту. Инструмент без выходного параметра будет генерировать выходные данные, но они не будут автоматически отображены. Веб-инструменты работают во многом схоже. Для возращения результата конечному пользователю требуется один или несколько параметров. В модели нефтепровода есть два выходных параметра: численность населения в областях в зоне влияния, которая записывается для местоположений буферных полигонов, расположенных вниз по течению, а также суммарная таблица численности населения с рассчитанным значением количества населения, которое может пострадать. Обратите внимание на то, что численность населения в затронутых областях является и промежуточными, и выходными данными. Этот параметр является промежуточным, так как от требуется для инструмента Суммарная статистика, но он определен как параметр модели (P), и его значения будут возвращены как результаты после выполнения инструмента.
Подсказка:
Все те же принципы в отношении ко входным и выходным параметрам, данным проекта и промежуточным данным применяются для создания инструментов-скриптов .
Документация инструмента
Очень важно предоставить хорошее описание вашего веб-инструмента, если вы хотите, чтобы пользователи нашли инструмент, разобрались, как он работает, и использовали его. Хорошая документация начинается с самого инструмента. Вы можете предоставить тот же тип метаданных к вашей модели или скрипту, что и у системного инструмента.
Запуск инструмента
После создания инструмента, требуется выполнить его успешный запуск. При запуске инструмента в истории геообработки создаётся запись. Инструмент, который завершился с записью о невыполнении, нельзя опубликовать.
Примечание:
При запуске модели в ModelBuilder не создаётся запись в Истории геообработки. Инструменты-модели должны запускаться как инструмент на панели Геообработка.
Публикация веб-инструмента
Веб-инструмент можно опубликовать, выбрав Анализ > История, чтобы открыть панель История. Чтобы опубликовать, щелкните правой кнопкой элемент и выберите Опубликовать как. Чтобы опубликовать, как новый веб-инструмент, выберите Опубликовать веб-инструмент, чтобы открыть панель Опубликовать как веб-инструмент. Чтобы перезаписать имеющийся инструмент, выберите Перезаписать веб-инструмент, чтобы открыть панель со всеми имеющимися веб-инструментами, опубликованными в Моих ресурсах.
Убедитесь, что вы выбрали корректный инструмент для перезаписи, и щелкните OK, чтобы открыть панель Перезаписать веб-инструмент. Процесс настройки предварительно настроенного веб-инструмента одинаков для вариантов Опубликовать веб-инструмент и Перезаписать веб-инструмент.
Либо выберите Опубликовать > Веб-инструмент, чтобы выбрать Опубликовать веб-инструмент или Перезаписать веб-инструмент. Если вы выберете Опубликовать веб-инструмент, укажите элемент на панели публикации инструментов со всеми успешно запущенными элементами.
Если вы выберете Перезаписать веб-инструмент, укажите перезаписываемый элемент на панели со всеми имеющимися веб-инструментами, опубликованными в разделе Мои ресурсы. Затем выберите элемент на панели со всеми запущенными элементами, которые будут перезаписаны. Шаги перезаписи в этом рабочем процессе меняются местами при выборе из Анализ > История.
Настройка свойств веб-инструмента
Инструмент оценки последствий разлива нефти выводит как результат объекты и таблицу. Объём данных, создаваемых и возвращаемых инструментом, ограничивается в размере, поэтому веб-инструмент будет настроен как асинхронный сервис без результирующего картографического сервиса. Настройки по умолчанию, максимум 1000 записей, будет достаточно. Уровень сообщений ошибка позволит получать только сообщения о невыполнении инструмента. В случае успешного выполнения веб-инструмента конечному пользователю не будет выводиться сообщений о процессе обработки.
Веб-инструмент всегда доступен в вашем разделе Мои ресурсы. Вы можете открыть к нему доступ для организации, для всех или для выбранных групп. Инструмент оценки последствий разлива нефти может пригодиться для сотрудников-акционеров организаций, которым необходимо выполнять анализ нефтепроводов. Выбор правильных групп позволить пользователям быстро найти инструмент и начать с ним работать.
Копирование или ссылка на данные или использование URL данных
Большинство веб-инструментов имеют входные или проектные данные. При публикации модели оценки разлива нефти в виде веб-инструмента необходимо проверить, не являются ли входные данные или проектные данные данными None-URL или данными URL. Вы можете копировать данные None-URL на сервер и создать статичную копию данных для использования сервисом, или пропустить копирование данных, но создать ссылку, по которой сервис будет получать доступ. Данные URL предназначены для ввода данных из URL сервиса.
При публикации модели оценки разлива нефти в виде веб-инструмента проектные данные включают наборы данных рек и численности населения, которые являются статичными и обновляются не часто. Решением проблемы является копирование данных проекта на сервер. Процесс публикации собирает и конвертирует данные (если требуется) в классы объектов файловой базы геоданных, откуда они будут извлечены на сервер и будут использоваться сервисом. В этом случае установите флажок Копировать все данные под заголовком Данные None-URL.
Рассмотрим ситуацию, когда метод анализа был немного изменен, а пользователь не даёт данные о нефтепроводе. Альтернативные данные о предполагаемых местоположениях нефтепроводов пришли из другого процесса, и пользователь предоставил другие входные данные для инструмента. В этом случае предполагаемое местоположение нефтепровода становится данными проекта. Следовательно, рекомендуется поместить этот набор данных в многопользовательскую базу геоданных или папку с универсальными правилами присвоения имен (UNC), к которой сервер может получить доступ и настроить инструмент, чтобы он ссылался на этот набор данных. При публикации установите флажок Ссылаться на зарегистрированные данные под заголовком Данные None-URL и задайте ссылку на данные с помощью хранилища данных ArcGIS Server. В процессе публикации будет сохранена ссылка на базу данных или папку, вместо создания статичной копии. В дальнейшем специалист-аналитик проекта может обновить данные в корпоративной базе геоданных или папке, и веб-инструмент будет выполнять анализ для нового предложенного местоположения нефтепровода.
Другой вариант - предоставить набор классов объектов, который не берется из пользовательского конвейера или не часто обновляется, чтобы обеспечить ввод данных из векторного веб-слоя (сервиса объектов) или слоя изображений карты (картографический сервис) с подслоем объектов. При публикации снимите флажок Конвертировать векторный слой, чтобы сохранить данные URL во время процесса. Если этот флажок установлен, данные будут скопированы на сервер во время публикации, а данные, на которые ссылается инструмент, будут статичными на сервере. Если в качестве входных данных используется набор растровых данных, укажите URL-адрес данных со веб-слоем изображений (сервис изображений). В этом случае не нужно устанавливать флажок Конвертировать векторный слой, так как URL всегда сохраняется при публикации.
Режим ввода
При публикации в качестве веб-инструмента важно решить, как клиент будет предоставлять входные данные для задачи вашего веб-инструмента, что называется режимом ввода параметра. Чтобы настроить свойства инструмента, на вкладке Ресурсы нажмите кнопку Настроить свойства инструмента рядом с его названием.
На панели свойств раскройте каждый параметр и настройте режим ввода для каждого из них. При выборе варианта режима ввода Значение, определяемое пользователем нет характера данных, поскольку они будут предоставлены со стороны клиента при запуске веб-инструмента. При выборе опции Список выбора или Константа данные будут предоставлены из скопированных или ссылочных данных на сервере или данных из URL-адреса сервиса.
При публикации веб-инструмента значение по умолчанию для каждого входного и выходного параметра будет отображаться в конечной точке REST сервера. Если вы не хотите, чтобы значение по умолчанию для какого-либо параметра отображалось, установите для каждого параметра флажок Удалить значение по умолчанию. Чтобы удалить значения по умолчанию для всех параметров, установите флажок Удалить все значения по умолчанию под заголовком Конфигурация параметров.
Анализ
Анализ потенциального веб-инструмента проверяет, можете ли вы успешно опубликовать инструмент на портал. Дополнительно появляются сообщения о данных, и вы можете предпринять соответствующие действия, если они необходимы. Для инструмента оценки разлива нефти уже есть настроенное хранилище данных, инструмент задокументирован и использует поддерживаемые инструменты, которые работают в веб-инструменте. По этим причинам предупреждений или сообщений не должно появиться.
Публикация
После настройки свойств веб-инструмента и исправления всех ошибок анализатора опубликуйте веб-инструмент на портал. В зависимости от того, сколько данных требуется собрать и отправить на сервер, процесс может занять разное количество времени.
Использование веб-инструмента
Веб-инструменты можно найти и открыть в разделе Портал панели Каталог. Помимо запуска инструмента в ArcGIS Pro, соответствующий сервис геообработки можно использовать в скрипте Python или веб-приложении.
Дополнительные сведения о поиске и использовании веб-инструментов в ArcGIS Pro