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

От параметров, которые вы выберете при публикации инструмента в качестве веб-инструмента, будет зависеть то, как эти параметры будут использоваться клиентскими приложениями. Наиболее общие и часто изменяемые параметры сервиса могут быть заданы при его публикации. Менее общие настройки можно задать в Менеджере ArcGIS Server после публикации инструмента. Несколько расширенных настроек настраиваются только в веб-странице Администратора ArcGIS Server. И только для немногих из этих инструментов (сервисов геообработки) когда-либо потребуется изменять эти расширенные параметры.

Подсказка:

Используйте Менеджер ArcGIS Server для администрирования и изменения настроек опубликованного сервиса.

Настройки

Общее

ПараметрОписание

Имя

Имя веб-инструмента для публикации на вашем портале. Это имя должно быть уникальным на портале и не должно содержать пробелов или специальных символов. Оно перенимается из метаданных инструмента.

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

Краткая информация и теги, которые помогают документировать и делают веб-инструмент доступным для поиска. Это наследуется от метаданных инструмента.

Теги

Данные

Задаёт, будут ли данные копироваться на сервер (становить статичными), или инструмент будет к ним обращаться по ссылке как прежде. Совпадающая запись в хранилище данных должна быть настроена для ваших данных, чтобы использовалась настройка Ссылаться на зарегистрированные данные.

Местоположение

  • Папка – Выберите или создайте папку портала, в которой будет создан элемент веб-инструмента. По умолчанию будет использоваться корневой каталог портала.
  • Сервер и Папка – Для сервера, веб-инструменты должны быть опубликованы на портале с одним или несколькими интегрированными серверами. Если на портале несколько интегрированных серверов, вы можете выбрать, на каком сервере будет опубликован этот веб-инструмент. Что касается папки, вы можете либо выбрать, либо создать новую папку на сайте ArcGIS Server. По умолчанию будет использоваться корневой каталог сайта ArcGIS Server.

Опубликовать для

Укажите, для кого и в каких группах будет опубликован ваш веб-инструмент. Веб-инструмент будет всегда публиковаться в Мои ресурсы. Публикация веб-инструмента Для всех делает этот элемент общедоступным; любой, кто имеет доступ к веб-сайту портала, может найти и использовать этот элемент, а владельцы групп могут добавить его в ресурсы своих групп. При публикации веб-инструмента на ArcGIS Enterprise он станет доступен для всех участников портала, имеющих доступ к элементу. Можно опубликовать его для группы, в которой вы состоите в настоящий момент.

Конфигурация

ПараметрОписание

Загрузить

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

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

Режим выполнения: Синхронный и Асинхронный

Синхронность и асинхронность определяют, как клиент (приложение, использующее веб-инструмент) будет взаимодействовать с веб-инструментом и получать выходные данные. Когда веб-инструмент настроен на синхронность, клиент ждет, пока задача будет завершена. Как правило, синхронный сервис выполняется быстро (за несколько секунд). Асинхронный сервис обычно выполняется медленнее, а клиент должен периодически запрашивать сервер, выполнена ли задача, и если задача выполнена, получить результат. Веб-приложение, использующее асинхронный сервис, должно иметь реализованную логику для проверки статуса и обработки результата, когда выполнение завершено. Клиенты ArcGIS Desktop поддерживают оба типа выполнения.

Просмотреть выходные данные в слое изображения карты

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

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

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

Уровень сообщения

Можно возвращать следующие сообщения различных уровней клиенту, который запустил веб-инструмент:

  • Нет – клиенту не возвращаются сообщения геообработки, только сообщение о том, что выполнение было завершено успешно или со сбоем. Используется по умолчанию.
  • Ошибка – клиенту возвращаются только те сообщения инструмента, которые свидетельствуют об ошибке.
  • Предупреждение – клиенту возвращаются все сообщения об ошибках и предупреждения инструмента.
  • Информация – клиенту возвращаются все сообщения, касающиеся выполнения инструмента.
Внимание:

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

Максимальное число возвращаемых записей

Максимальное количество результатов, которое сервис может вернуть клиенту. Чем большее значение будет задано для этого параметра, тем большее число записей или объектов, направляемых клиенту, сможет обрабатывать ГИС-сервер. Если не нужно возвращать какие-либо объекты, установите для этого параметра значение 0 (нуль). Как правило, это значение равно нулю только при включенном параметре Просмотреть выходные данные в слое изображений карты.

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

Содержание

Следующие настройки могут быть изменены только в момент публикации веб-инструмента.

Добавить инструмент

Вы можете добавлять к существующему инструменту дополнительные инструменты из истории геообработки; для этого надо щелкнуть кнопку Добавить инструмент Добавить инструмент на вкладке Содержание. Для удаления инструмент необходимо щелкнуть имя удаляемого инструмента и выбрать команду Удалить.

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

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

ПараметрОписание

Имя

Имя инструмента. Имя перенимается от подписи метаданных инструмента.

Описание

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

Для каждого из параметров могут изменяться следующие свойства:

ПараметрОписание

Имя

Имя и описание параметра. Оба (параметра) перенимаются от названия и описания параметра в метаданных инструмента. Здесь вы можете их изменить, не затрагивая исходные метаданные инструмента.

Описание

Тип

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

Режим ввода

Режим ввода определяет, как клиенты будут вводить пространственные объекты в задачу:

  • Определяемое пользователем значение – значение для параметра предоставляет клиент.
  • Список вариантов – клиент получает список строк (список вариантов) и должен выбрать одну или несколько строк из этого списка. В зависимости от типа входных данных, строки в списке вариантов могут быть именами слоев или простыми опциями ключевых слов.
  • Постоянное значение – инструмент будет использовать значение, предоставленное вами для параметра при создании результата. Поскольку это значение является постоянным, клиент не может его изменить и, следовательно, оно не станет параметром задачи при публикации сервиса.

Тип геометрии (применяется только к набору объектов и векторному слою)

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

Схема (применяется к набору объектов, векторному слою, набору записей и табличному виду)

Схема – это список полей (атрибутов), которые должны быть предоставлены клиентом при построении объектов для входных данных для этого инструмента. Этот список полей аналогичен тому слою или набору данных, которые использовались в качестве входных или выходных данных для инструмента, создавшего этот результат.

Значение по умолчанию

Значение по умолчанию для инструмента определяется значением параметра, указанным во время исполнения инструмента. Чтобы добавить или изменить значение параметра по умолчанию, необходимо снова выполнить этот инструмент с соответствующим параметром.

Настройки Веб-менеджера

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

Примечание:

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

Параметры

ПараметрОписание

Кластер

Кластер, в котором будет выполняться сервис. Эту настройку можно изменить только в том случае, если в кластере принимает участие ArcGIS Server.

Директории

Каталоги, используемые сервером для записи файлов при выполнении инструмента.

Функциональные возможности

ПараметрОписание

WPS

Включает возможности WPS в сервисах геообработки, позволяя другим клиентам подключаться и использовать инструменты, используя стандартные протоколы OGC.

Подробнее о протоколе WPS

Слияние сервисов

ПараметрОписание

Число экземпляров

Минимальное и максимальное количество экземпляров сервиса. Значения по умолчанию: 1 (минимум) и 2 (максимум). Установив минимальное значение, равное 0 экземпляров, системные ресурсы будут сокращены; экземпляр будет работать по запросу клиента.

Максимальное время, в течение которого клиент может использовать сервис

Максимальное время (в секундах) использования сервиса. Может понадобится увеличить значение по умолчанию, равное 600 секунд (10 мин), чтобы выполнять долгосрочные задачи геообработки. Кроме того, может понадобиться уменьшить это время, чтобы клиент не использовал сервисы чрезмерно.

Максимальное время ожидания клиентом доступа к сервису

Максимальное время в секундах, в течение которого клиент будет ждать подключения к экземпляру, прежде чем истечет срок ожидания. Когда все экземпляры заняты обработкой запросов, последующий запросы добавляются в очередь. Если срок ожидания истекает до того, как экземпляр станет доступным, задача завершится со сбоем. Значение по умолчанию – 60 секунд (1 минута).

Максимальное время простоя экземпляра, в течении которого он будет запущен

Максимальное время в секундах, в течение которого экземпляр будет оставаться активным до сжатия пула. Любые экземпляры, которые превышают минимальное количество неиспользованных экземпляров, будут закрыты после истечения максимального времени в состоянии простоя.

Процессы

ПараметрОписание

Повторный запуск

Задаёт, с какой периодичностью и когда выполнять повторный запуск сервиса. По умолчанию – раз в 24 часа, начиная с полночи.

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