Создание вебхуков

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

Предварительные условия, необходимые для создания вебхуков

Прежде чем создавать вебхуки, обратите внимание на следующее:

• Чтобы использовать вебхуки организации, ваша организация должна иметь версию ArcGIS Enterprise 10.7 или новее. Чтобы использовать вебхуки сервиса, ваша организация должна иметь версию ArcGIS Enterprise 11.0 или новее.
• Вы должны быть администратором или вам должны назначить роль администратора по умолчанию, чтобы создавать и управлять вебхуками организации.
• Для создания и управления вебхуками сервисов вам должны быть назначены права администратора Обновить, Удалить, Безопасность и Инфраструктура или Серверы, либо назначена роль администратора по умолчанию.
• Приемники вебхуков должны быть настроены для связи по HTTPS. Существует несколько опций, поддерживаемых для приемников, таких как приемники сторонних веб-сервисов (Microsoft Power Automate, Zapier и IFFT), пользовательские веб-сервисы, ArcGIS Notebook Server и ArcGIS Workflow Manager. Примеры того, как можно создать пользовательские веб-сервисы или начать использовать сторонние приемники, см. в Репозиторий вебхука. Дополнительную информацию о создании вебхуков Notebook Server и Workflow Manager см. в соответствующих разделах Автоматизация рабочих процессов с помощью ArcGIS Notebooks и Создание заданий с помощью вебхуков.
• Чтобы настроить вебхуки для сервисов объектов, сервис должен иметь возможность редактирования и включенное отслеживание изменений без синхронизации.
• Чтобы настроить вебхуки для сервиса геообработки, сервис должен быть асинхронным.

Примечание:

В этой версии вебхуки сервисов являются бета-функцией. Во время бета-тестирования эти функции могут быть не полными, иметь известные проблемы с производительностью или качеством и не будут поддерживаться технической поддержкой Esri. Документация бета-API для вебхуков сервиса доступна в Руководство по API администратора вебхуков сервиса PDF. Дополнительную информацию о функциях ArcGIS Enterprise в стадии бета-тестирования см. в разделе Бета-функции.

Создать вебхук организации

Вебхуки организации позволяют вам подписаться на триггеры событий, связанных с элементами портала, группами и пользователями вашего ArcGIS Enterprise.

Примечание:

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

Выполните следующие шаги, чтобы создать вебхук для организации:

1. Перейдите к ArcGIS Portal Directory и войдите как участник с ролью администратора.

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

   https://machine.domain.com/webadaptor/sharing/rest

   После выполнения вами входа для вашей учетной записи появится страница ресурсов Пользователя.

2. Нажмите на гиперссылку Org ID или выполните запрос в следующей форме для доступа к странице ресурса Portal Self:
   https://machine.domain.com/webadaptor/sharing/rest/portals/self

3. Прокрутите вниз страницу собственных ресурсов и щелкните Вебхук > Создать вебхук, чтобы получить доступ к операции Создать вебхук.
4. Дойдя до конечной точки Создать вебхук, предоставьте следующую информацию:
   1. Введите уникальное имя вебхука в текстовом окне Имя.
   2. Укажите целевой URL-адрес для приемника вебхука в текстовом поле Целевой URL-адрес, который будет запрашиваться в процессе создания вебхука, чтобы обеспечить успешное соединение между вашим приемником и порталом ArcGIS Enterprise.

      Пример целевого URL-адреса показывается ниже:

      https://app.logic.azure.com:443/workflows/b688528a36e246279dc050f936e5ebd4/triggers/manual/paths/invoke?api-version=2016-06-01&sp=%2Ftriggers%2Fmanual%2Frun&sv=1.0&sig=nHP-LBo9x-nSgMi11DSDuwRIUiJr-8yKGCy7OYaT_ow

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

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

   5. В разделе Какие события вы хотите назначить триггерными для этого вебхука выберите Разрешить мне определить вручную или Отправить мне все.
      • Если вы выберете Разрешить мне определить вручную, перечислите события-триггеры, которые будут использоваться для этого вебхука, в текстовом поле Отправить мне изменения для этих событий, разделенных запятыми. Например, если вы хотите подписаться на все события, относящиеся к определенной группе в вашей организации, введите событие-триггер, подобное показанному ниже, где [groupID] представляет собой уникальный идентификатор, связанный с определенной группой:
        /groups/[groupID]/update

        Список всех поддерживаемых триггеров событий для вебхуков организации см. в разделе Триггеры событий.
      • Если вы выберете Отправить мне все, вы будете подписаны на все поддерживающие триггеры события. Вы будете получать уведомления о каждом событии, как только оно произойдет.
5. После настройки вышеуказанных параметров щелкните Создать вебхук, чтобы подтвердить запрос.

   После завершения операции новый вебхук будет добавлен в вашу организацию.

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

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

Примечание:

Пример запроса POST, который настраивает эти дополнительные опции, см. в документации REST API Обновить параметры вебхука.

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

1. Перейдите к ArcGIS Portal Directory и войдите как участник с ролью администратора. Вебхуки могут создаваться и управляться только администраторами или участниками, которым назначена роль администратора по умолчанию.
   https://machine.domain.com/webadaptor/sharing/rest

   После выполнения вами входа для вашей учетной записи появится страница ресурсов Пользователя.

2. Нажмите на гиперссылку Org ID или выполните запрос в следующей форме для доступа к странице ресурса Portal Self:
   https://machine.domain.com/webadaptor/sharing/rest/portals/self

3. Прокрутите вниз страницу собственных ресурсов и щелкните Вебхук > Настройки > Обновить, чтобы получить доступ к операции Обновить параметры вебхука.
4. Дойдя до конечной точки Обновить параметры вебхука, предоставьте следующую информацию:
   1. Установите значение для Количество попыток уведомления.

      Это значение указывает количество попыток доставки полезных данных вебхука. По умолчанию портал ArcGIS Enterprise будет пытаться доставить полезные данные три раза. Значение для попыток должно быть задано целым числом от 0 до 5.

   2. Установите значение для Время ожидания уведомления в секундах.

      Это значение указывает длительность времени в секундах, в течение которого портал ArcGIS Enterprise будет ожидать получение ответа от приемника. По умолчанию портал ArcGIS Enterprise будет ожидать 10 секунд. Значение количества секунд, в течение которых портал ArcGIS Enterprise будет ждать, должно быть целым числом в диапазоне от 0 до 60 секунд.

   3. Установите значение для Время, прошедшее с момента уведомления в секундах.

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

5. После настройки вышеуказанных параметров нажмите Обновить параметры вебхука, чтобы отправить запрос.

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

Создание вебхука сервиса геообработки

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

Примечание:

Чтобы увидеть пример запроса POST, который создает вебхук для сервисов геообработки, обратитесь к документации по бета-версии REST API вебхука в Руководство по API администратора вебхуков сервиса PDF.

Для создания вебхука сервиса геообработки выполните следующие шаги:

1. Перейдите к Директории администратора ArcGIS Server и выполните вход как участник с соответствующими назначенными ему правами администратора.
   Вебхуки могут создаваться и управляться только администраторами, которым назначены права администратора на обновление, удаление, безопасность и инфраструктуру или серверы или которым назначена роль администратора по умолчанию.
   https://machine.domain.com/webadaptor/admin

2. После входа перейдите к ресурсу Вебхуки для сервиса геообработки, щелкнув Сервисы > [ИмяСервиса] > Вебхуки > Создать, где [ServiceName] представляет сервис, для которого будет создан вебхук. Для сервисов, размещенных в определенных папках, щелкните Сервисы > [FolderName] > [ServiceName] > Вебхуки > Создать, где [FolderName] представляет папку, в которой находится сервис.

   Внимание:

   Чтобы настроить вебхуки для сервиса геообработки, сервис геообработки должен быть асинхронным.

3. В точке доступа Создать вебхук измените следующую информацию:
   1. Введите уникальное имя вебхука в текстовом окне Имя. Предоставленное имя может содержать только буквенно-цифровые значения, так как использование специальных символов приведет к ответу с ошибкой.
   2. При необходимости установите секретный ключ для вебхука, который можно использовать для аутентификации сообщений вебхука с приемником. Введите определяемую пользователем буквенно-цифровую строку в текстовое поле Ключ подписи.
   3. Укажите целевой URL-адрес для приемника вебхука в текстовом поле Вебхук URL, который будет запрашиваться во время создания вебхука, чтобы гарантировать успешное соединение между получателем и развертыванием ArcGIS Server. Пример цели показывается ниже:
      https://app.logic.azure.com:443/workflows/b688528a36e246279dc050f936e5ebd4/triggers/manual/paths/invoke?api-version=2016-06-01&sp=%2Ftriggers%2Fmanual%2Frun&sv=1.0&sig=nHP-LBo9x-nSgMi11DSDuwRIUiJr-8yKGCy7OYaT_ow

   4. При необходимости укажите тип медиа. В ниспадающем меню Тип ресурса выберите что-то одно из следующего:
      • application/json (default)
      • application/x-www-form-urlencoded
   5. При необходимости определите формат полезных данных. В ниспадающем меню Формат полезных данных выберите что-то одно из следующего:
      • JSON (по умолчанию)
      • PJSON
   6. При необходимости используйте параметр Активация, чтобы отключить или включить обратные вызовы при инициализации вебхука. Чтобы включить, выберите значение True. Чтобы выключить, выберите значение False.

      По умолчанию обратные вызовы включены.

4. После настройки вышеуказанных параметров щелкните Создать, чтобы отправить запрос.

   После завершения операции к конкретному сервису геообработки применяется новый вебхук.

Примечание:

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

Создание вебхука сервиса объектов

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

Примечание:

Чтобы увидеть пример запроса POST, который создает вебхук для сервисов пространственных объектов, обратитесь к документации по бета-версии REST API вебхука в Руководство по API администратора вебхуков сервиса PDF.

Чтобы создать вебхук для сервиса объектов, выполните следующие шаги:

1. Перейдите к Директории администратора ArcGIS Server и выполните вход как участник с соответствующими назначенными ему правами администратора.

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

   https://machine.domain.com/webadaptor/admin

2. После выполнения входа перейдите к ресурсу Вебхуки для сервиса объектов, нажав Сервисы > [ServiceName] > Вебхуки > Создать, где [ServiceName] представляет сервис, для которого создается вебхук. Для сервисов, размещенных в определенных папках, щелкните Сервисы > [FolderName] > [ServiceName] > Вебхуки > Создать, где [FolderName] представляет папку, в которой находится сервис.

   Внимание:

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

3. В точке доступа Создать вебхук измените следующую информацию:
   1. Введите уникальное имя вебхука в текстовом окне Имя. Предоставленное имя может содержать только буквенно-цифровые значения, так как использование специальных символов приведет к ответу с ошибкой.
   2. Перечислите триггеры событий, которые будут использоваться для этого вебхука, в текстовом поле Изменить тип. Например, чтобы инициировать вебхук при создании сервиса объектов, используйте следующий триггер события:

      Пример

      FeaturesCreated

      Список все триггеров событий, поддерживаемых для вебхуков сервиса объектов, см. в статье Триггеры событий.
   3. При необходимости установите секретный ключ для вебхука, который можно использовать для аутентификации сообщений вебхука с приемником. Введите определяемую пользователем буквенно-цифровую строку в текстовое поле Ключ подписи.
   4. Укажите целевой URL-адрес для приемника вебхука в текстовом поле Вебхук URL, который будет запрашиваться во время создания вебхука, чтобы гарантировать успешное соединение между получателем и развертыванием ArcGIS Server. Пример цели показывается ниже:
      https://app.logic.azure.com:443/workflows/b688528a36e246279dc050f936e5ebd4/triggers/manual/paths/invoke?api-version=2016-06-01&sp=%2Ftriggers%2Fmanual%2Frun&sv=1.0&sig=nHP-LBo9x-nSgMi11DSDuwRIUiJr-8yKGCy7OYaT_ow

   5. При необходимости укажите тип медиа. В ниспадающем меню Тип ресурса выберите что-то одно из следующего:
      • application/json (default)
      • application/x-www-form-urlencoded
   6. При необходимости определите формат полезных данных. В ниспадающем меню Формат полезных данных выберите что-то одно из следующего:
      • JSON (по умолчанию)
      • PJSON
   7. При необходимости используйте параметр Активация, чтобы отключить или включить обратные вызовы при инициализации вебхука. Чтобы включить, выберите значение True. Чтобы выключить, выберите значение False.

      По умолчанию обратные вызовы включены.

   8. Настройте расписание вебхуков, изменив информацию Секунды, в текстовом окне Расписание. Для сервисов объектов, которые часто редактируются, уменьшите значение Секунд, чтобы получать более частые вебхуки с меньшим количеством информации о событиях в полезных данных. Для сервисов объектов, которые редактируются редко, увеличьте значение Секунд, чтобы получать менее частые вебхуки с большим количеством информации о событиях в полезных данных.

      Минимальное значение и по умолчанию для расписания составляет 20 секунд.

4. После настройки вышеуказанных параметров щелкните Создать, чтобы отправить запрос.

   После завершения операции к конкретному сервису объектов применяется новый вебхук.