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

При использовании веб-инструмента с выходными данными обычных объектов выходные данные генерируются на сервере и отправляются обратно клиенту в виде объекта. Выходной сервис объектов попадает в ArcGIS Data Store обслуживающего сервера и позволяет передавать выходные данные об объектах и непространственные таблицы через интернет, вместо того, чтобы сохранять их на локальном носителе. Это также экономит расходы на передачу получившихся данных обратно клиенту, повышая эффективность веб-инструмента, если размер полученного выходного объекта будет слишком большим. Благодаря им ваши данные могут быть доступными для различных клиентов, в том числе веб-клиентов, настольных приложений и полевых приложений.

Создание

Чтобы использовать эту функцию, выходные данные должны быть представлены классом объектов или таблицей

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

Публикация

Для публикации веб-инструмента с выходным сервисом объектов необходимо выполнение следующих программных требований:

  • ArcGIS Pro 2.3 или более поздняя версия.
  • ArcGIS Server и Portal for ArcGIS версии 10.7 или выше.
  • ArcGIS Server должен быть интегрирован с Portal for ArcGIS.
  • Portal for ArcGIS должен иметь хост-сервер.

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

  • Публикуйте веб-инструмент только в группах на вашем портале или в ArcGIS Enterprise. Не устанавливайте отметку Для всех, чтобы избежать проблем с разрешениями при использовании инструмента.
  • Установите опцию Режим выполнения на Асинхронный.
  • Оставьте не отмеченной опцию Просматривать выходные данные в слое изображений карты.
  • Настройка Максимальное количество записей, возвращаемых сервером не оказывает влияния на выходной сервис объектов.
  • Чтобы отключить параметр выходного сервиса объектов в опубликованных выходных данных, щелкните кнопку Настроить свойства инструмента Настроить свойства инструмента и снимите отметку с опции Добавить дополнительный параметр выходного сервиса объектов.
Примечание:

При использовании функции CreateGPSDDraft для публикации веб-инструмента укажите server_type в качестве аргумента MY_HOSTED_SERVICES.

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

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

  • Имя выходного сервиса объектов должно быть уникальным среди всех размещенных сервисов портала, поскольку все выходные сервисы объектов будут находиться в папке Hosted портала.
  • Имя может содержать только буквенно-цифровые символы или знаки подчеркивания и не должно содержать более 120 символов.
  • У пользователя портала должны быть права доступа на создание выходного сервиса объектов. Такие права доступа есть только у ролей Издатель и Администратор. Для пользователей портала с пользовательскими ролями требуется наличие размещенных слоев объектов Участники/Просмотр, Ресурсы/Публикация, а также права доступа Ресурсы и Анализ/Анализ стандартных объектов.

Когда этот инструмент используется с выходным сервисом объектов, все выходные объекты копируются в хранилище данных хост-сервера независимо от того, где находится на сервере исходный результат.

Примечание:

Когда вы публикуете веб-инструмент на сайте ArcGIS Server, интегрированным с вашим порталом, на хост-сервере должна быть запущена команда allowconnection. В противном случае результаты не могут быть скопированы на хост-сервер.

При запуске веб-инструмента сервер предоставляет URL-адрес полученному сервису объектов. Если этот веб-инструмент используется в ArcGIS Pro, результат добавляется как слой URL-сервиса в таблицу содержания. При использовании этого инструмента из конечной точки REST, URL-адрес будет представлен в формате JSON.

Примечание:

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

Свойства исходного выходного параметра влияют на способ отображения сервиса объектов. Ниже приведены возможные варианты:

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

Перезапись существующего размещенного сервиса объектов

Вы можете перезаписать существующий выходной сервис объектов из версии ArcGIS Pro 3.0 и ArcGIS Enterprise 11 и выше. Примите во внимание приведенные ниже требования и права, прежде чем перезаписывать выходной сервис объектов.

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

  • Если пространственная привязка выходных данных текущего анализа и слоя существующего выходного сервиса объектов отличаются, вы не можете перезаписать сервис.
  • Вы можете перезаписывать только из ArcGIS Pro 3.0 и конечной точки REST. Перезапись из Python, Map Viewer Classic и Web AppBuilder не поддерживается.

Права на перезапись существующего выходного сервиса объектов связаны с ролью учетной записи ArcGIS Enterprise.

  • Роль должна иметь права на создание выходного сервиса объектов - Издатель или Администратор. Для пользовательской роли необходимо включить Участники/Просмотр; Ресурсы/Публикация размещенных векторных слоев; Ресурсы/Создание, обновление и удаление; и права Ресурсы и Анализ/Анализ стандартных объектов.
  • Роль администратора может перезаписывать любые размещенные сервисы объектов.
  • Издатель может перезаписывать только собственные размещенные сервисы объектов.

Сделайте следующее, чтобы перезаписать из ArcGIS Pro 3.0:

  • Откройте задачу веб-инструмента и отметьте Имя выходного сервиса объектов. Под параметром отсутствует отметка Перезаписать существующий размещенный сервис объектов и нет отметки Создать новый размещенный сервис объектов, если перезапись не удалась.
  • Используйте текстовое окно, чтобы указать существующее имя сервиса или Выражение JSON в качестве входных данных, или щелкните кнопку Обзор, чтобы выбрать сервис для перезаписи.
  • Отметьте Создать новый размещенный сервис объектов, если перезапись не удалась и активируйте Создать новый размещенный сервис объектов, если перезапись не удалась. Оставьте активированную отметку не отмеченной или отметьте и щелкните Запустить для перезаписи.
  • В случае неудачной перезаписи со снятой отметкой Создать новый размещенный сервис объектов, если перезапись не удалась, возвращается сообщение об ошибке. Если эта отметка установлена, при неудачной перезаписи создается новый выходной размещенный сервис пространственных объектов с примечанием _1 после первоначальной неудачной попытки. Дальнейшие попытки увеличат примечание до _2, _3, и так далее.