Настройки веб-инструмента и сервиса геообработки
При публикации инструмента в качестве веб-инструмента или сервиса геообработки параметры свойств определяют, как они используются клиентскими приложениями. Наиболее общие и часто изменяемые параметры инструмента могут быть заданы при его публикации. Менее общие настройки можно задать в Менеджере ArcGIS Server после публикации инструмента. Некоторые расширенные параметры сервиса можно настроить только через ArcGIS Server Administrator REST API.
Настройки в ArcGIS Pro
Подразделы ниже описывают доступные настройки при совместном использовании веб-инструмента или сервиса геообработки в ArcGIS Pro, включая создание определения связанного или офлайн-сервиса.
Настройки на вкладке Общие
На вкладке Общие, которая является вкладкой по умолчанию при первом запуске панели публикации, доступны следующие настройки. Многие параметры можно изменять в ArcGIS Server Manager после того, как веб-инструмент был опубликован или на странице элементов веб-инструмента в портале.
Имя
Имя веб-инструмента для публикации на вашем портале. Это имя должно быть уникальным на портале и не должно содержать пробелов или специальных символов. Этот параметр наследуется от метаданных инструмента.
Краткая информация и Теги
Краткая информация и теги, представляющие описание, которое делает веб-инструмент доступным для поиска. Эти параметры наследуются из метаданных инструмента.
Вы можете использовать ниспадающее меню Теги, чтобы выбрать существующие теги. Максимальное количество тегов — 128.
Категория
Категория элемента веб-инструмента. Этот параметр недоступен для сервисов геообработки, опубликованных в автономном ArcGIS Server.
Версия
Версия ArcGIS Enterprise или ArcGIS Server, на которую будет распространяться данный инструмент. Этот параметр доступен при сохранении автономного определения сервиса для веб-инструмента.
Данные, Инструменты и Скрипты
Опции настройки поведения консолидации и публикации данных, инструментов и скриптов.
Включать данные, наборы инструментов и скрипты в определение сервиса — определяет, включены ли все связанные данные, наборы инструментов и скрипты в определение сервиса. Когда эта опция отмечена, определённые настройки консолидации автоматически блокируются на состояниях — отмечены или не отмечены. Для большинства рабочих процессов оставьте эту опцию включенной, за исключением случаев, когда у вас есть расширенные сценарии публикации для веб-инструмента или сервиса геообработки. По умолчанию эта опция включена.
Данные не по URL — задает, будут ли данные копироваться на сервер (становиться статичными), или инструмент будет к ним обращаться по ссылке как прежде. Совпадающая запись в серверном хранилище данных должна быть настроена для данных, чтобы использовалась опция Ссылаться на зарегистрированные данные. Если хранилище данных сервера не выполнит соответствующие настройки для данных, они будут скопированы во время публикации. Это применимо только при публикации или перезаписи в качестве веб-инструмента или при сохранении в качестве подключенного определения сервиса. При сохранении результата в качестве автономного определения сервиса, убедитесь, что на все данные параметра можно ссылаться при использовании опции Базовые данные, поскольку альтернативы копированию данных нет, если хранилище данных сервера не выполнит соответствующие настройки для данных. При отключении опции Включить данные, наборы инструментов и скрипты в определении сервиса, копирование любых данных становится невозможным, и эта опция будет заблокирована в статусе Ссылаться на зарегистрированные данные. По умолчанию используется опция Ссылаться на зарегистрированные данные.
Данные URL — контролирует, остаются ли данные, на которые ссылается URL, без изменений при публикации или конвертируются в другой тип данных путём скачивания данных с URL. Эта настройка определяет, публикует ли ArcGIS Pro сервис с использованием исходной URL-ссылки или извлекает и преобразует данные во время публикации. Эта опция доступна в ArcGIS Pro 3.2 и более поздних версиях. Данные URL-адресов относятся к URL-адресам различных типов веб-слоев или сервисов. Можно настраивать только векторные слои, сервисы объектов или подслои объектов веб-слоев изображений. Если отметка Конвертировать векторный слой стоит, векторный слой или сервис из параметра или проекта преобразуются в класс объектов во время публикации. Если отметки нет, URL-адрес векторного слоя сохраняется. Нет возможности преобразовать URL веб-слоев изображений, и URL-адрес веб-слоя изображения всегда будет сохраняться в неизменном виде при публикации. При отключении опции Включить данные, наборы инструментов и скрипты в определении сервиса, конвертация данных URL становится невозможной, и эта опция останется заблокирована в неотмеченном статусе. По умолчанию эта опция включена.
Опции консолидации — узнайте больше об использовании опций консолидации
Местоположение
Определяет, где будет создан элемент веб-инструмента или сервис геообработки.
Для элементов веб-инструментов, опубликованных в ArcGIS Enterprise, возможны следующие опции:
Папка – выберите или создайте папку портала, в которой будет создан элемент веб-инструмента. По умолчанию будет использоваться корневой каталог портала.
Сервер и Папка – Для сервера, веб-инструменты должны быть опубликованы на портале с одним или несколькими интегрированными серверами. Если на портале имеется более одного интегрированного сервера, укажите сервер, на котором будет опубликован веб-инструмент. Для папки либо выберите имеющуюся папку, либо создайте новую на сайте ArcGIS Server. По умолчанию будет использоваться корневой каталог сайта ArcGIS Server.
Для сервисов геообработки, опубликованных на автономных сайтах, возможны следующие опции:
- Папка — выберите или создайте папку на сервере, в которой будет создан элемент сервиса геообработки. По умолчанию это корневой каталог сервера.
Общий доступ с помощью
Доступен только для веб-инструментов, опубликованных в ArcGIS Enterprise, укажите, кому и каким группам будет предоставлен доступ к веб-инструменту. Веб-инструмент будет всегда публиковаться в Моих ресурсах. Публикация веб-инструмента Для всех делает элемент публичным, любой, кто имеет доступ к веб-сайту портала, может найти и использовать его, а владельцы групп могут добавлять его в ресурсы своих групп. При публикации веб-инструмента на ArcGIS Enterprise он станет доступен для всех участников портала, имеющих доступ к элементу. Можно опубликовать его для любой группы, в которой вы состоите.
Настройки вкладке Конфигурация
Загрузка, Валидация, Режим выполнения, Вид выходных данных слоя изображений карты, Уровень сообщения и Максимальное количество возвращаемых записей доступны на подвкладке Настройка возможностей и параметров сервиса.
Количество экземпляров, Тайм-ауты сервиса - максимальное время использования, Тайм-ауты сервиса - максимальное время ожидания и Тайм-ауты сервиса - максимальное время простоя доступны в подвкладке Настройка Слияния сервисов. См. Настройка и конфигурация сервисов для дополнительных сведений по установке этих настроек.
Загрузить
Указывает, может ли клиент загрузить файл на сервер, чтобы использовать его как входные данные для веб-инструмента. Операция загрузки используется, в основном, веб-клиентами, которые нуждаются в способе отправки файлов на сервер для обработки. Операции отправки возвращают уникальный идентификатор для файла после завершения загрузки, который веб-приложение потом может передать веб-инструменту.
По умолчанию не отмечен.
Проверить
Включает операцию проверки для всех задач в веб-инструменте или сервисе геообработки. Операция позволяет клиентам использовать операцию проверки перед запуском инструмента. Независимо от режима выполнения, операция проверки поддерживает только синхронные вызовы. Клиенты, делающие запрос на проверку, должны ждать, пока они не получат ответ от проверки.
По умолчанию не отмечен.
Режим выполнения
Указывает, как клиент (приложение, использующее веб-инструмент) будет взаимодействовать с веб-инструментом и получать выходные данные. Когда для веб-инструмента установлено значение Синхронный, клиент ожидает завершения задачи. Как правило, синхронный сервис выполняется быстро (за несколько секунд). Когда настроен на Асинхронный, сервис обычно выполняется медленнее, а клиент должен периодически запрашивать сервер, чтобы определить, выполнена ли задача, и если задача выполнена, получить результат. Веб-приложение, использующее асинхронный сервис, должно иметь реализованную логику для проверки статуса и обработки результата, когда выполнение будет завершено.
Тип по умолчанию - Асинхронный.
Вид выходных данных слоя изображений карты
При публикации веб-инструмента или сервиса геообработки можно просмотреть выходные данные в качестве изображения карты. Изображение карты создается на сервере и передается обратно клиенту в виде изображения (файл .tiff с информацией о стиле). Символы, надписи, прозрачность и другие свойства изображения карты соответствуют свойствам выходного слоя из сеанса ArcGIS Pro во время исходной публикации. При использовании этого параметра учитывайте следующее:
Если инструмент создает большое количество объектов, для которых клиент должен задавать символы, а затем отображать эти объекты, будет быстрее, если клиент получит изображение карты.
В целях распределения данных нет необходимости отправлять клиенту какие-либо объекты, а только изображение карты.
Результатом работы инструмента является не подлежащий передаче набор данных, такой как сетевой набор данных или топология. Единственный способ передать выходные данные клиенту – это использовать изображение карты.
Примечание:
Выходное изображение карты может использоваться только в том случае, если для параметра веб-инструмента Режим выполнения установлено значение Асинхронный. Этот параметр не поддерживается при публикации веб-инструмента в Kubernetes.
По умолчанию не отмечен.
Уровень сообщения
Возвращает сообщения следующих уровней клиенту, который запустил веб-инструмент:
Нет – клиенту не возвращаются сообщения геообработки, только сообщение о том, что выполнение было завершено успешно или со сбоем. Используется по умолчанию.
Ошибка – клиенту возвращаются только те сообщения инструмента, которые свидетельствуют об ошибке.
Предупреждение – клиенту возвращаются все сообщения об ошибках и предупреждения инструмента.
Информация – клиенту возвращаются все сообщения, касающиеся выполнения инструмента.
Внимание:
Любое сообщение, независимо от уровня, может содержать пути и имена наборов данных, что может представлять угрозу безопасности. Уровень Информация является детализированным и, как правило, содержит ссылки на пути к наборам данным и их имена. Как правило, в среде разработки и тестирования возвращаются сообщения уровня Информация или Предупреждение, а в среде использования продукта это уровни Нет или Ошибка.
Значением по умолчанию является Нет.
Максимальное число возвращаемых записей
Максимальное количество результатов, которое сервис может вернуть клиенту. Чем большее значение будет задано для этого параметра, тем большее число записей или объектов, направляемых клиенту, сможет обрабатывать ГИС-сервер. Чтобы не возвращать никаких объектов, установите это значение на 0 (ноль). Это свойство не сработает, если отмечен параметр Добавить дополнительный выходной параметр класса пространственных объектов.
Значение по умолчанию равно 1000.
Число экземпляров
Минимальное и максимальное количество экземпляров сервиса геообработки, которые могут запускаться на каждой серверной машине для ArcGIS Enterprise или gp-server-sync на поде ArcGIS Enterprise на Kubernetes одновременно.
Тайм-ауты сервиса - максимальное время использования
Максимальное время (в секундах) использования сервиса. Может понадобится увеличить значение по умолчанию, равное 600 секунд (10 мин), чтобы выполнять долгосрочные задачи геообработки. Кроме того, вы можно уменьшить это время, чтобы клиент не использовал сервисы чрезмерно.
Тайм-ауты сервиса - максимальное время ожидания
Максимальное время в секундах, в течение которого клиент будет ждать подключения к экземпляру, прежде чем истечет срок ожидания. Когда все экземпляры заняты обработкой запросов, последующий запросы добавляются в очередь. Если время ожидания истекает до того, как экземпляр станет доступным, задача завершится со сбоем. Значение по умолчанию – 60 секунд (1 минута).
Тайм-ауты сервиса - максимальное время простоя
Максимальное время в секундах, в течение которого экземпляр будет оставаться активным до сжатия пула. Любые экземпляры, которые превышают минимальное количество неиспользованных экземпляров, будут закрыты после истечения максимального времени в состоянии простоя.
Настройки во вкладке Содержание
Параметры, описанные выше, можно изменить только во время публикации веб-инструмента или сервиса геообработки. Чтобы изменить любой из этих параметров для опубликованного инструмента или сервиса геообработки, необходимо либо создать новый, либо перезаписать существующий. Чтобы настроить свойства инструмента для отдельного инструмента, нажмите кнопку редактирования 
рядом с именем инструмента, и свойства выбранного инструмента будут доступны для настройки в виде инструмента. Для первого или единственного инструмента в вашем наборе свойства инструмента будут отображаться по умолчанию без нажатия кнопки редактирования. Чтобы добавить больше инструментов, используйте кнопку Добавить инструмент.
Конфигурация по умолчанию
Параметры Добавить дополнительный параметр выходного сервиса объектов, Добавить дополнительный параметр выходного сервиса изображений и Удалить все значения по умолчанию, настроенные в этом разделе, будут применяться ко всем инструментам. Вы не увидите опции Добавить дополнительный параметр выходного сервиса объектов или Добавить дополнительный параметр выходного сервиса изображений, если ни один из ваших инструментов не имеет выходных параметров объектов или растров. Вы также можете настроить эти две опции для выходных параметров объектов или растров для отдельного инструмента. Чтобы убрать значения по умолчанию для отдельных параметров, настройте Удалить значение по умолчанию параметра.
- Добавить дополнительный параметр выходного сервиса объектов
Дополнительный входной параметр, который указывает, можно ли сохранять все выходные объекты как размещенный сервис объектов при использовании веб-инструмента. Этот параметр поддерживается только при публикации в качестве веб-инструмента с асинхронным режимом выполнения, опубликованном на ArcGIS Enterprise. В противном случае он недоступен для настройки. Параметр отмечен по умолчанию.
[Подробнее об использовании веб-инструментов с выходным сервисом объектов]../../analysis/geoprocessing/share-analysis/use-web-tools-with-output-feature-class.md)
- Добавить дополнительный параметр Выходной сервис изображений
Дополнительный входной параметр, который указывает, можно ли сохранять все выходные данные растра в виде сервисов изображений при использовании веб-инструмента или сервиса геообработки.
- Удалить все значения по умолчанию
Если опция включена, начиная с ArcGIS Pro 3.3, значение по умолчанию, используемое при запуске инструмента, будет удалено, и опция Удалить значение по умолчанию в приведенной выше конфигурации параметров инструмента будет автоматически включена. По умолчанию не отмечен.
Добавить инструмент
Чтобы добавить к существующему веб-инструменту или сервису геообработки дополнительные инструменты из истории геообработки, щелкните кнопку Добавить инструмент 
на вкладке Содержание. Чтобы удалить инструменты, нажмите на имя инструмента и выберите Удалить или нажмите на иконку корзины.
Имя инструмента
Имя инструмента. Значение по умолчанию основано на метаданных инструмента.
Описание инструмента
Описание инструмента. Описание не наследуется из метаданных инструмента. Если поле пустое, предоставьте описание, и оно будет оставаться при каждой публикации из истории.
Имя и Описание параметра
Имя и описание параметра. Оба свойства наследуются от названия параметра и описания в метаданных инструмента. Изменение этих свойства не повлияет на исходные метаданные инструмента.
Тип параметра
Тип параметра определяет, должен ли клиент передавать какое-либо значение для успешной работы инструмента. На вкладке Содержание можно изменить на обязательные только дополнительные параметры. Чтобы изменить обязательный параметр на дополнительный, необходимо выйти из панели публикации, изменить свойства инструмента и повторно запустить его, чтобы получить новый результат.
Сохранять тип данных как Составной
Это свойство доступно только в том случае, если параметр является составным типом данных. Он указывает, будет ли параметр опубликован как составной тип данных (отмечено). По умолчанию не отмечен.
Режим ввода параметра
Указывает, как клиенты будут вводить пространственные объекты в задачу.
Определяемое пользователем значение – значение для параметра предоставляет клиент.
Список вариантов – представлен список строк (список вариантов), и клиент должен выбрать одну или несколько строк из этого списка. В зависимости от типа входных данных, строки могут быть именами слоев или простыми опциями ключевых слов.
Постоянное значение –будет использовано значение, указанное для параметра при создании результата. Поскольку это значение является постоянным, клиент не может его изменить и, следовательно, оно не станет параметром задачи при публикации сервиса.
Смешанный режим: заданный пользователем и список выбора — доступно только для составных параметров или параметров таблицы значений. Настройте режим ввода для каждого типа данных комбинировано или для каждого типа данных в каждом столбце таблицы значений. Если какой-либо тип данных не поддерживает список выбора, для настройки будет доступна только опция Значение, заданное пользователем.
Преобразовать тип данных в строку параметра
Это свойство применимо только к типу данных "единица измерения площади". Оно указывает, будет ли единица измерения площади преобразована в строковый тип данных (отмечено) или опубликована как единица измерения площади (не отмечено). По умолчанию не отмечен.
Удалить значение по умолчанию параметра
Если опция включена, начиная с ArcGIS Pro 3.3, значение по умолчанию, используемое при запуске инструмента, будет удалено в процессе публикации. По умолчанию не отмечен.
Значение по умолчанию параметра
Значение по умолчанию для инструмента определяется значением параметра, указанным во время исполнения инструмента. Чтобы добавить или изменить значение параметра по умолчанию, снова запустите этот инструмент с соответствующим параметром.
Используйте только стандартные слои параметра
Это свойство применимо только к режиму ввода списка вариантов. Указывает, будут ли отмечены только те опции, которые используются при запуске инструмента, в отображении списка под этой отметкой (отмечено). По умолчанию не отмечен.
Тип геометрии параметра
Это свойство применяется только к объектам. Типы геометрии определяется входными и выходными объектами, которые использовались для получения результата. Его нельзя изменить на вкладке Содержание. Перезапустите инструмент, используя объекты с указанным типом геометрии, а затем опубликуйте результат операции.
Схема параметра
Это свойство применяется только к объектам и таблицам. Схема – это список полей (атрибутов), которые должны быть предоставлены клиентом при построении объектов для входных данных для этого инструмента. Этот список полей аналогичен тому слою или набору данных, которые использовались в качестве входных или выходных данных для инструмента, создавшего этот результат.
Настройки ArcGIS Server Manager
Настройки параметров в приведённых ниже подразделах можно изменить в ArcGIS Server Manager после публикации сервиса, за исключением ArcGIS Enterprise Manager для ArcGIS Enterprise на Kubernetes.
Примечание:
При изменении следующих настроек сервис потребуется перезапустить.
Параметры
Доступны следующие настройки параметров:
|
Параметр |
Описание |
|---|---|
|
Кластер |
Кластер, в котором будет выполняться сервис. Эту настройку можно изменить только в том случае, если в кластере принимает участие ArcGIS Server. |
|
Директории |
Каталоги, используемые сервером для записи файлов при выполнении инструмента. |
Функциональные возможности
В настоящее время доступны следующие настройки параметров функциональных возможностей:
|
Параметр |
Описание |
|---|---|
|
WPS |
Включает возможности WPS в сервисах геообработки, позволяя другим клиентам подключаться и использовать инструменты через стандартные протоколы OGC. |
Процессы
В настоящее время доступны следующие настройки параметров процессов:
|
Параметр |
Описание |
|---|---|
|
Повторный запуск |
Задаёт, с какой периодичностью и когда выполнять повторный запуск сервиса. По умолчанию – один раз в 24 часа, начиная с полночи. Сервисы геообработки могут запускаться только при высокой изоляции, в отличие от других типов сервисов, которые могут запускаться при низкой и высокой изоляции. |
Портал для настроек элементов ArcGIS
Начиная с ArcGIS Enterprise 12.0, вы можете управлять множеством настроек на странице элементов вашего веб-инструмента в Портале. Смотрите раздел Управление веб-инструментами, чтобы узнать, какие настройки можно обновить после публикации инструмента.