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

При публикации инструмента в качестве веб-инструмента или сервиса геообработки параметры свойств определяют, как они используются клиентскими приложениями. Наиболее общие и часто изменяемые параметры инструмента могут быть заданы при его публикации. Специальные параметры могут быть изменены в ArcGIS Server Manager после публикации инструмента. Некоторые расширенные настройки можно задать только на ArcGIS Server Administrator REST API.

Настройки

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

Общие

Доступны следующие общие настройки параметров:

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

Имя

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

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

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

Вы можете использовать ниспадающее меню Теги, чтобы выбрать существующие теги. Максимальное ограничение - 128 тегов.

Теги

Категория

Категория элемента веб-инструмента. Этот параметр недоступен для сервисов геообработки, опубликованных в автономном ArcGIS Server.

Версия

Версия ArcGIS Enterprise или ArcGIS Server инструмента будет опубликована. Этот параметр доступен при сохранении автономного определения сервиса для веб-инструмента.

Данные

Определяет, что произойдет с данными.

  • Данные не по URL — задает, будут ли данные копироваться на сервер (становиться статичными), или инструмент будет к ним обращаться по ссылке как прежде. Совпадающая запись в серверном хранилище данных должна быть настроена для данных, чтобы использовалась опция Ссылаться на зарегистрированные данные. Если хранилище данных сервера не выполнит соответствующие настройки для данных, они будут скопированы во время публикации. Это применимо только при публикации в качестве веб-инструмента или при сохранении в качестве подключенного определения сервиса. При сохранении результата в качестве автономного определения сервиса, убедитесь, что на все данные параметра можно ссылаться при использовании опции Базовые данные, поскольку альтернативы копированию данных нет, если хранилище данных сервера не выполнит соответствующие настройки для данных.
  • Данные по URL — задает, будут ли данные оставаться в виде URL или конвертироваться в другой тип данных при публикации. Данная опция доступна в ArcGIS Pro 3.2 10.5 и более поздних версий. Данные URL-адресов относятся к URL-адресам различных типов веб-слоев или сервисов. Можно настраивать только векторные слои, сервисы объектов или подслои объектов веб-слоев изображений. Если отметка Конвертировать векторный слой стоит, векторный слой или сервис из параметра или проекта преобразуются в класс объектов во время публикации. Если отметки нет, URL-адрес векторного слоя сохраняется. Нет возможности преобразовать URL веб-слоев изображений, так как URL всегда будет сохранен при публикации. По умолчанию эта опция включена.

Подробнее о копировании, привязке и использовании данных URL.

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

Определяет, где будет создан элемент веб-инструмента или сервис геообработки.

Для элементов веб-инструментов, опубликованных в ArcGIS Enterprise, возможны следующие опции:

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

Для сервисов геообработки, опубликованных на автономных сайтах ArcGIS Server, возможны следующие опции:

  • Папка – выберите или создайте папку на сервере, в которой будет создан элемент сервиса геообработки. По умолчанию это корневой каталог сервера.

Общий доступ с помощью

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

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

Следующие настройки параметров доступны на вкладке Настроить возможности сервиса и параметры:

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

Загрузка

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

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

Режим выполнения

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

Тип по умолчанию - Асинхронный.

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

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

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

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

Этот параметр не поддерживается при публикации веб-инструмента в Kubernetes.

По умолчанию не отмечен.

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

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

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

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

Значением по умолчанию является Нет.

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

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

Значение по умолчанию равно 1000.

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

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

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

Минимальное и максимальное количество копий сервиса геообработки, которые могут быть одновременно запущены на каждом сервере для ArcGIS Enterprise или модуле gp-server-sync для ArcGIS Enterprise on Kubernetes в любой момент времени.

Тайм-ауты сервиса - максимальное время использования

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

Тайм-ауты сервиса - максимальное время ожидания

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

Тайм-ауты сервиса - максимальное время простоя

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

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

Ресурсы

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

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

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

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

Чтобы настроить свойства инструмента, нажмите кнопку редактирования Настроить свойства инструмента рядом с названием инструмента.

СвойствоОписание

Имя

Имя инструмента. Значение по умолчанию основано на метаданных инструмента.

Описание

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

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

СвойствоОписание

Имя

Имя и описание параметра. Оба свойства наследуются от названия параметра и описания в метаданных инструмента. Изменение этих свойства не повлияет на исходные метаданные инструмента.

Описание

Тип

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

Сохранять тип данных как Составной

Это свойство доступно только в том случае, если параметр является составным типом данных. Он указывает, будет ли параметр опубликован как составной тип данных (отмечено). По умолчанию не отмечен.

Режим ввода

Указывает, как клиенты будут вводить пространственные объекты в задачу. О разработке и использовании графического интерфейса см. Режим ввода.

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

Преобразовать тип данных в Строку

Это свойство применимо только к типу данных "единица измерения площади". Оно указывает, будет ли единица измерения площади преобразована в строковый тип данных (отмечено) или опубликована как единица измерения площади (не отмечено). По умолчанию не отмечен.

Удалить значение по умолчанию

Если отмечено, начиная с ArcGIS Pro 3.3, значение по умолчанию, используемое при запуске инструмента, будет удалено в процессе публикации. По умолчанию не отмечен.

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

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

Использовать только слои по умолчанию

Это свойство применимо только к режиму ввода списка вариантов. Оно указывает, будут ли отмечены только те опции, которые используются при запуске инструмента, в отображении списка под этой отметкой (отмечено). По умолчанию не отмечен.

Тип геометрии

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

Схема

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

Следующие параметры конфигурации применимы ко всему инструменту в целом:

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

Добавить дополнительный параметр выходного сервиса объектов

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

Подробнее об использовании веб-инструментов с выходным сервисом объектов.

Добавить дополнительный параметр Выходной сервис изображений

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

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

Удалить все значения по умолчанию

Если отмечено, начиная с ArcGIS Pro 3.3, значение по умолчанию, используемое при запуске инструмента, будет удалено, и флажок Удалить значение по умолчанию в приведенной выше конфигурации параметров инструмента будет автоматически установлен. По умолчанию не отмечен

Настройки ArcGIS Server Manager

Настройки параметра в подразделах, указанных ниже, могут изменяться только в ArcGIS Server Manager, включая ArcGIS Enterprise Manager для ArcGIS Enterprise on Kubernetes. Большинство описанных выше настроек конфигурации могут быть также изменены в ArcGIS Server Manager после публикации сервиса.

Примечание:

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

Параметры

Доступны следующие настройки параметров:

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

Кластер

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

Директории

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

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

В настоящее время доступны следующие настройки параметров функциональных возможностей:

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

WPS

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

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

Процессы

В настоящее время доступны следующие настройки параметров процессов:

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

Recycling

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

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