При использовании веб-инструмента с выходными данными обычных объектов выходные данные генерируются на сервере и отправляются обратно клиенту в виде объекта. Выходной сервис объектов попадает в ArcGIS Data Store обслуживающего сервера и позволяет передавать выходные данные об объектах и непространственные таблицы через интернет, вместо того, чтобы сохранять их на локальном носителе. Это также экономит расходы на передачу получившихся данных обратно клиенту, повышая эффективность веб-инструмента, если размер полученного выходного объекта будет слишком большим. Благодаря им ваши данные могут быть доступными для различных клиентов, в том числе веб-клиентов, настольных приложений и полевых приложений.
Создание
Чтобы использовать эту функцию, выходные данные должны быть классом объектов или таблицей.
При создании этого веб-инструмента вам не потребуется что-либо изменять как в случае обязательных выходных данных, так и в случае факультативных.
Публикация
Для публикации веб-инструмента с выходным сервисом объектов необходимо выполнение следующих программных требований:
- ArcGIS Pro версии 2.3 или более поздняя
- ArcGIS Server и Portal for ArcGIS версии 10.7 или выше
- ArcGIS Server должен быть интегрирован с Portal for ArcGIS
- Наличие размещающего сервера для Portal for ArcGIS
После выполнения этого инструмента выполните следующие настройки в диалоговом окне Опубликовать как веб-инструмент:
- Этот веб-инструмент может публиковаться только в группах портала или в ArcGIS Enterprise. Не публикуйте этот инструмент Для всех, так как это приведет к проблемам с правами доступа при его использовании.
- Установите Режим выполнения на Асинхронный.
- Оставьте не отмеченной опцию Просматривать выходные данные в слое изображений карты.
- Опция Максимальное количество записей, возвращаемых сервером не оказывает влияния на выходной сервис объектов.
Примечание:
При использовании функции Python arcpy.CreateGPSDDraft для публикации веб-инструмент, server_type должен быть указан как MY_HOSTED_SERVICES.
Использование
При использовании веб-инструментов с выходными объектами или таблицами в конце списка параметров доступен дополнительный входной параметр, который называется Имя выходного сервиса объектов. Этот параметр генерируется автоматически во время процесса публикации. Он не может быть переименован, и его нельзя удалить. Чтобы успешно использовать веб-инструмент с этим параметром, укажите имя сервиса, которое отвечало бы следующим требованиям:
- Имя выходного сервиса объектов должно быть уникальным среди всех размещенных сервисов портала, поскольку все выходные сервисы объектов будут находиться в папке Hosted портала.
- Это имя может содержать только буквы, цифры, пробелы или нижние подчеркивания, максимальная длина - 120 символов.
- У пользователя портала должны быть права доступа на создание выходного сервиса объектов. Такие права доступа есть только у ролей Издатель и Администратор. Для пользователей портала с пользовательскими ролями требуется наличие размещенных слоев объектов Участники/Просмотр, Ресурсы/Публикация, а также права доступа Ресурсы и Анализ/Анализ стандартных объектов.
Когда этот инструмент используется с выходным сервисом объектов, все выходные объекты копируются в хранилище данных хост-сервера независимо от того, где находится на сервере исходный результат.
Примечание:
При публикации веб-инструмента на сайт ArcGIS Server, интегрированный с порталом, команда allowconnection должна быть выполнена на хост-сервере. В противном случае результаты не смогут быть скопированы на ваш хост-сервер.
После выполнения веб-инструмента сервер предоставляет полученному сервису объектов URL-адрес. Если этот веб-инструмент используется в ArcGIS Pro, результат добавляется как слой URL-сервиса в таблицу содержания. При использовании этого инструмента из конечной точки REST, URL-адрес будет представлен в формате JSON.
Примечание:
Параметр Имя выходного сервиса объектов является факультативным. Если использовать веб-инструмент, оставив поле Имя выходного сервиса объектов пустым, будет создан обычный выходной объект или таблица.
Свойства исходного выходного параметра влияют на способ отображения сервиса объектов. Ниже приведены возможные варианты:
- Несколько разных параметров выходных данных – Когда имеется несколько параметров выходных объектов, в выходной сервис объектов в виде слоев добавляются все выходные результаты, но при запуске веб-инструмента существует только один выходной сервис объектов.
- Пустые выходные данные – Если при запуске веб-инструмента результат выходного параметра пустой, генерируется слой с пустыми объектами, который добавляется в сервис.
- Необязательные и производные выходные данные – Если тип выходного параметра является необязательным или производным, существует вероятность, что при запуске веб-инструмента выходные данные не будут генерироваться. В этом случае никакой слой в сервис добавлен не будет.
- Выходные данные с несколькими значениями – При запуске веб-инструмента с несколькими значениями выходной сервис объектов не поддерживается.
- Символы – Если для выходных данных инструмента заданы символы, они будут поддерживаться выходным сервисом объектов. Если при создании инструмента символы не заданы, то будут использоваться символы по умолчанию.