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

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

Подсказка:

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

Настройки

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

Общие

Параметр	Описание
Имя	Имя веб-инструмента для публикации на вашем портале. Это имя должно быть уникальным на портале и не должно содержать пробелов или специальных символов. Этот параметр наследуется от метаданных инструмента.
Краткая информация	Краткая информация и теги, представляющие описание, которое делает веб-инструмент доступным для поиска. Каждый параметр наследуется от метаданных инструмента. Этот параметр наследуется от метаданных инструмента. При публикации на ArcGIS Enterprise 10.9 или более ранний портал требуются краткая информации и тэги. Вы можете использовать максимум 128 тегов.
Теги
Версия	Версия сервера ArcGIS Enterprise или ArcGIS Server, который будет доступен для вас. Этот параметр доступен только если вы сохраняете автономное определение сервиса для веб-инструмента или сервиса геообработки.
Данные	Данные не по URL - Задает, будут ли данные копироваться на сервер (становиться статичными), или инструмент будет к ним обращаться по ссылке как прежде. Совпадающая запись в серверном хранилище данных должна быть настроена для ваших данных, чтобы использовалась опция Ссылаться на зарегистрированные данные. Если серверное хранилище данных сервер не выполнит соответствующие настройки для ваших данных, они будут скопированы во время публикации. Это применимо только при публикации в качестве веб-инструмента или при сохранении в качестве подключенного определения сервиса. Если вы сохраните результат как автономное определение сервиса, убедитесь, что на все данные вашего параметра можно ссылаться, выбрав опцию Базовые данные , поскольку альтернативы копированию данных нет, если хранилище данных сервера не выполнит соответствующие настройки для ваших данных. Данные по URL - задает, будут ли данные оставаться в виде URL или конвертироваться в другой тип данных при публикации. Данная опция доступна в ArcGIS Pro 3.2 10.5 и более поздних версий. Данные URL-адресов относятся к URL-адресам различных типов веб-слоев или сервисов. В текущей версии можно настроить только векторный слой или сервис объектов. Если отметка Конвертировать векторный слой стоит, векторный слой или сервис из параметра или проекта преобразуются в класс объектов во время публикации. Если отметки нет, URL-адрес векторного слоя сохраняется.
Местоположение	Папка – выберите или создайте папку портала, в которой будет создан элемент веб-инструмента. По умолчанию будет использоваться корневой каталог портала. Сервер и Папка – Для сервера, веб-инструменты должны быть опубликованы на портале с одним или несколькими интегрированными серверами. Если на портале имеется более одного интегрированного сервера, вы можете назначить сервер, на котором будет опубликован веб-инструмент. Для папки, можно либо выбрать имеющуюся папку, либо создать новую на сайте ArcGIS Server. По умолчанию будет использоваться корневой каталог сайта ArcGIS Server.
Общий доступ с помощью	Укажите, для кого и в каких группах будет опубликован веб-инструмент. Веб-инструмент будет всегда публиковаться в Моих ресурсах. Публикация веб-инструмента Для всех делает элемент публичным, любой, кто имеет доступ к веб-сайту портала, может найти и использовать его, а владельцы групп могут добавлять его в ресурсы своих групп. При публикации веб-инструмента на ArcGIS Enterprise он станет доступен для всех участников портала, имеющих доступ к элементу. Можно опубликовать его для любой группы, в которой вы состоите в настоящий момент.

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

Параметр	Описание
Загрузка	Управляет тем, может ли клиент загрузить файл на ваш сервер, чтобы использовать его как входные данные для веб-инструмента. Операция загрузки используется, в основном, веб-клиентами, которые нуждаются в способе отправки файлов на сервер для обработки. Операции отправки возвращают уникальный идентификатор для файла после завершения загрузки, который веб-приложение потом может передать веб-инструменту. По умолчанию эта опция отключена. Разрешение загрузок на ваш сервис может поставить под удар безопасность. Включайте его только при необходимости.
Режим выполнения: Синхронный и Асинхронный	Синхронность и асинхронность определяют, как клиент (приложение, использующее веб-инструмент) будет взаимодействовать с веб-инструментом и получать выходные данные. Когда веб-инструмент настроен на синхронность, клиент ждет, пока задача будет завершена. Как правило, синхронный сервис выполняется быстро (за несколько секунд). Асинхронный сервис обычно выполняется медленнее, а клиент должен периодически запрашивать сервер, выполнена ли задача, и если задача выполнена, получить результат. Веб-приложение, использующее асинхронный сервис, должно иметь реализованную логику для проверки статуса и обработки результата, когда выполнение будет завершено. Клиенты ArcGIS Desktop поддерживают оба типа.
Просмотреть выходные данные в слое изображений карты	При публикации веб-инструмента вы можете выбрать просмотр выходных данных как изображения карты. Изображение карты создается на сервере с помощью сервиса, а затем отправляется обратно клиенту в виде изображения (файл .tiff с информацией стиля). Символы, надписи, прозрачность и другие свойства изображения карты соответствуют свойствам выходного слоя из сеанса ArcGIS Pro во время исходной публикации. Ниже приведены причины, по которым обычно используется опция Просматривать выходные данные в слое изображений карты: Если инструмент создает большое количество объектов, которым клиент должен присваивать символы, а затем отображать, будет быстрее, если клиент получит изображение карты. В целях распределения данных нет необходимости отправлять клиенту какие-либо объекты, а только изображение карты. Результатом работы инструмента является не подлежащий передаче набор данных, такой как сетевой набор данных или топология. Единственный способ передать выходные данные клиенту – это использовать изображение карты. Примечание: Выходное изображение карты может использоваться только в том случае, если для веб-инструмента установлено значение Асинхронный. Этот параметр не поддерживается при публикации веб-инструмента в Kubernetes.
Уровень сообщения	Можно возвращать следующие сообщения различных уровней клиенту, который запустил веб-инструмент: Нет – клиенту не возвращаются сообщения геообработки, только сообщение о том, что выполнение было завершено успешно или со сбоем. Используется по умолчанию. Ошибка – клиенту возвращаются только те сообщения инструмента, которые свидетельствуют об ошибке. Предупреждение – клиенту возвращаются все сообщения об ошибках и предупреждения инструмента. Информация – клиенту возвращаются все сообщения, касающиеся выполнения инструмента. Внимание: Все сообщения, независимо от уровня, могут содержать пути и имена наборов данных, что может представлять угрозу безопасности. Уровень Информация является самым подробным и, как правило, содержит ссылки на пути к наборам данным и их имена. В общем виде, следует возвращать сообщения во время разработки, но отключать их в производственной среде.
Максимальное число возвращаемых записей	Максимальное количество результатов, которое сервис может вернуть клиенту. Чем большее значение будет задано для этого параметра, тем большее число записей или объектов, направляемых клиенту, сможет обрабатывать ГИС-сервер. Если не нужно возвращать какие-либо объекты, установите для этого параметра значение 0 (нуль). Как правило, это значение равно нулю только при включенном параметре Просмотреть выходные данные в слое изображений карты.

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

Содержание

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

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

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

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

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

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

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

Параметр	Описание
Имя	Имя и описание параметра. Оба наследуются от названия параметра и описания в метаданных инструмента. Здесь вы можете их изменить, не затрагивая исходные метаданные инструмента.
Описание
Тип	Тип параметра определяет, должен ли клиент передавать какое-либо значение для успешной работы инструмента. На вкладке Содержание можно только заменять необязательные параметры на обязательные. Чтобы изменить обязательный параметр на дополнительный, необходимо выйти из панели публикации, изменить свойства инструмента и повторно запустить его, чтобы получить новый результат.
Режим ввода	Режим ввода определяет, как клиенты будут вводить пространственные объекты в задачу: Определяемое пользователем значение – значение для параметра предоставляет клиент. Список вариантов – клиент получает список строк (список вариантов) и должен выбрать одну или несколько строк из этого списка. В зависимости от типа входных данных, строки могут быть именами слоев или простыми опциями ключевых слов. Постоянное значение – инструмент использует значение, предоставленное вами для параметра при создании результата. Поскольку это значение является постоянным, клиент не может его изменить и, следовательно, оно не станет параметром задачи при публикации сервиса.
Тип геометрии (применяется только к набору объектов и векторному слою)	Типы геометрии определяется входными и выходными объектами, которые использовались для получения результата. Его нельзя изменить на вкладке Содержание. Необходимо перезапустить инструмент, используя объекты с указанным типом геометрии, а затем опубликовать полученный результат.
Схема (применяется к набору объектов, векторному слою, набору записей и табличному виду)	Схема – это список полей (атрибутов), которые должны быть предоставлены клиентом при построении объектов для входных данных для этого инструмента. Этот список полей аналогичен тому слою или набору данных, которые использовались в качестве входных или выходных данных для инструмента, создавшего этот результат.
Значение по умолчанию	Значение по умолчанию для инструмента определяется значением параметра, указанным во время исполнения инструмента. Чтобы добавить или изменить значение параметра по умолчанию, снова запустите этот инструмент с соответствующим параметром.

Следующий параметр применяется только для выходных данных векторного типа.

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

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

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

Примечание:

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

Параметры

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

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

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

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

Параметр	Описание
Число экземпляров	Минимальное и максимальное количество экземпляров сервиса. Значения по умолчанию: 1 (минимум) и 2 (максимум). Установка минимального значения, равного 0, сокращает системные ресурсы; экземпляр будет стартовать по запросу клиента.
Максимальное время использования сервиса клиентом	Максимальное время (в секундах) использования сервиса. Может понадобится увеличить значение по умолчанию, равное 600 секунд (10 мин), чтобы выполнять долгосрочные задачи геообработки. Кроме того, может понадобиться уменьшить это время, чтобы клиент не использовал сервисы чрезмерно.
Максимальное время ожидания клиентом доступа к сервису	Максимальное время, в секундах, в течение которого клиент будет ждать подключения к экземпляру, прежде чем истечет срок ожидания. Когда все экземпляры заняты обработкой запросов, последующий запросы добавляются в очередь. Если срок ожидания истекает до того, как экземпляр станет доступным, задача завершится со сбоем. Значение по умолчанию – 60 секунд (1 минута).
Максимальное время работы простаивающего экземпляра	Максимальное время в секундах, в течение которого экземпляр будет оставаться активным до сжатия пула. Любые экземпляры, которые превышают минимальное количество неиспользованных экземпляров, будут закрыты после истечения максимального времени в состоянии простоя.

Процессы

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