Skip to main content

创建 webhook

作为组织管理员,您可以为 ArcGIS Enterprise 部署配置 webhook,以在发生特定事件时收到通知。 以下部分概述了如何使用 Notebooks 配置组织和服务 webhook 以及 webhook 接收器。

创建 webhook 的先决条件

创建 webhook 之前,请考虑以下事项:

  • 要使用组织 webhook,您的组织必须使用 ArcGIS Enterprise 10.7 或更高版本。 要使用服务 webhook,您的组织必须使用 ArcGIS Enterprise 11.0 或更高版本。

  • 要创建和管理组织 webhook,您必须已被分配组织 webhook 权限或被分配默认管理员角色。

  • 要创建和管理地理处理服务 webhook,您必须已被分配地理处理权限或被分配默认管理员角色或发布者角色。

  • 要创建和管理要素服务 webhook,您必须已被分配要素图层权限或被分配默认管理员角色或发布者角色。

  • Webhook 接收器必须配置为通过 HTTPS 进行通信。 此处提供多个支持用作接收器的选项:例如第三方 Web 服务接收器(Microsoft Power Automate、Zapier 和 IFFT)、自定义 Web 服务和 ArcGIS Notebooks Services。 有关如何创建自定义 Web 服务的示例或使用第三方接收器的入门指南,请参阅 Webhook 资料档案库。

  • 要为托管要素服务配置 webhook,服务必须包含编辑功能,并且在不使用同步功能的情况下启用了更改追踪。

  • 要为非托管要素服务配置 webhook,该服务所引用的企业级地理数据库数据必须满足更改追踪的要求并遵循以下模式之一:

    • 它是一种已启用存档并且具有全局 ID 的非版本化要素服务。

    • 它是一种未启用版本管理功能的分支版本化要素服务,其中编辑内容直接应用于默认版本的要素。

    • 它是一种已启用版本管理功能的分支版本化要素服务。 启用版本管理功能后,服务可以创建具有 FeaturesPosted 事件触发器的 webhook,每当对服务执行 post 操作时,该事件触发器都会调用 webhook。

    注:

    ArcGIS Enterprise 11.3 添加了对分支版本化要素服务的支持。

  • 要为地理处理服务配置 webhook,服务必须为异步服务。

配置组织 webhook

您可通过组织 webhook 订阅至与项目、群组和用户关联的事件的触发器。

创建组织 webhook

要创建组织 webhook,请按照以下步骤操作:

  1. 确认您以默认管理员身份登录或具有组织 webhook 权限的自定义角色成员身份登录。

  2. 浏览至组织 > 设置 > Webhook。

  3. 在组织 webhook 下,单击创建 webhook。

  4. 在创建 webhook 窗口中,执行以下操作:

    1. 在名称文本框中,为 webhook 提供唯一名称。

    2. 从类型下拉菜单中选择一种 webhook 类型。

      • 选择全部可订阅所有受支持的事件触发器。 在每个事件发生时,您将收到通知。

      • 选择项目、用户、群组或角色允许您手动定义要订阅的事件触发器。

    3. 如果选择全部以外的 webhook 类型,则会出现一个与所选 webhook 类型相关的附加下拉菜单。 例如,如果您为 webhook 类型选择了项目,则会出现项目下拉菜单,允许您选择 webhook 将监控的特定项目。

    4. 从事件下拉菜单中选择事件触发器。 例如,如果您希望在发布特定项目时调用 webhook,请选择 /items/<项目 ID>/publish。

    5. 选择 webhook 接收器类型。

      • 如果选择 Webhook 接收器 URL,请提供 webhook 接收器的负载 URL。 示例负载 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

      • 如果选择笔记本,请选择将在触发 webhook 时运行的笔记本。

        注:

        如果 Notebook 选项不可用,则表示未将 Notebook Services 配置到组织。 如果选项可用但是无法选择此项,则表示您没有任何可用于配置 webhook 的笔记本。 您必须是将用于 webhook 的 notebook 项目的所有者。

    6. 或者,在**密钥(可选)**文本框中为 webhook 设置一个密钥值。 密钥值将用于生成包含在 webhook 有效负载标头中的签名。 Webhook 接收器可以使用此签名来确定是否应信任该消息。

  5. 单击创建 webhook。

为组织 webhook 配置高级参数

应用于组织的 webhook 的高级设置允许您进一步自定义 webhook 的性能,例如指定传送尝试的次数、通知时间和传送尝试之间的间隔。

要为组织 webhook 设置高级属性,请执行以下操作:

  1. 以默认管理员身份登录或具有组织 webhook 权限的自定义角色成员身份登录您的组织。

  2. 浏览至组织 > 设置 > Webhook。

  3. 在组织 webhook 下,单击高级设置。

  4. 在高级设置窗口中,执行以下操作:

    1. 设置传送尝试次数的值。

      此值指定尝试传送 webhook 负载的次数。 默认情况下,ArcGIS Enterprise 将尝试传送负载 3 次。 尝试次数的值必须是 0 到 5 之间的整数。

    2. 设置通知超时的值。

      此值以秒为单位指定时间长度,ArcGIS Enterprise 将在此时间内等待从接收器接收响应。 默认等待时间为 10 秒。 ArcGIS Enterprise 将等待的秒数值必须是 0 到 60 秒之内的整数。

    3. 设置通知历时的值。

      此值指定每次负载传送尝试之间的持续时间(以秒为单位)。 默认情况下,如果上次尝试失败,ArcGIS Enterprise 将在 5 秒后尝试传送另一个负载,直到达到传送尝试次数中指定的尝试次数为止。

  5. 单击保存。

    更新的属性将应用于每个已配置的组织 webhook。

配置服务 Webhook

服务 webhook 允许您订阅与组织的要素服务相关联的事件的触发器,或者在完成地理处理服务作业时订阅触发器。

创建服务 webhook

要为地理处理服务或要素服务创建 webhook,请执行以下步骤:

  1. 以默认管理员身份或具有创建和管理服务 webhook 的管理权限的自定义角色成员的身份登录到组织。

    注:

    已分配发布者角色的成员将无法在组织中创建或管理服务 webhook,并且需要使用管理 API 执行这些工作流。

  2. 浏览至组织 > 设置 > Webhook。

  3. 在要素图层和服务 webhook 下,单击创建 webhook。

  4. 在创建 webhook 窗口中,执行以下操作:

    1. 在名称文本框中,为 webhook 提供唯一名称。

    2. 从项目下拉菜单中选择一个服务。

      注:

      如果选择地理处理服务,则事件将设置为服务已完成。 如果选择要素服务,则将显示事件下拉菜单。

    3. 如果选择要素服务 webhook,请从事件下拉菜单中选择事件触发器。 例如,如果您希望在编辑内容包含新附件时调用 webhook,请选择 AttachmentsCreated。

    4. 选择 webhook 接收器类型。

      • 如果选择 Webhook 接收器 URL,请提供 webhook 接收器的负载 URL。 示例负载 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

      • 如果选择 Notebook webhook 接收器,请选择将在触发 webhook 时运行的笔记本。

        注:

        如果 Notebook 选项不可用,则表示未将 Notebook Services 配置到组织。 如果选项可用但是无法选择此项,则表示您没有任何可用于配置 webhook 的笔记本。 您必须是将用于 webhook 的 notebook 项目的所有者。

    5. 或者,在**密钥(可选)**文本框中为 webhook 设置一个密钥值。 密钥值将用于生成包含在 webhook 有效负载标头中的签名。 Webhook 接收器可以使用此签名来确定是否应信任该消息。

  5. 单击创建 webhook。

为服务 webhook 配置高级参数

应用于服务 webhook 的高级设置允许您进一步自定义 webhook 的性能,例如指定传送尝试的次数、通知时间和传送尝试之间的持续时间。

要设置高级属性,请执行以下操作:

  1. 以默认管理员身份或具有创建和管理服务 webhook 的管理权限的自定义角色成员的身份登录到组织。

    注:

    已分配发布者角色的成员将无法在 ArcGIS Enterprise 中创建或管理服务 webhook,并且需要使用管理 API 执行这些工作流。

  2. 浏览至组织 > 设置 > Webhook。

  3. 在要素图层和服务 webhook 下,单击高级设置。

  4. 在高级设置窗口中,执行以下操作:

    1. 设置传送尝试次数的值。

      此值指定尝试传送 webhook 负载的次数。 默认情况下,系统将尝试传送负载三次。 尝试次数的值必须是 0 到 5 之间的整数。

    2. 设置通知超时的值。

      此值以秒为单位指定时间长度,系统将在此时间内等待从接收器接收响应。 默认情况下,系统将等待 10 秒。 该值必须为介于 0 和 60 秒之间的整数。

    3. 设置通知历时的值。

      此值指定每次负载传送尝试之间的持续时间(以秒为单位)。 默认情况下,如果上次尝试失败,则系统将在 5 秒后尝试传送另一个负载,直到达到传送尝试次数中指定的尝试次数为止。

    4. 设置过去天数的值。

      此值用于指定在停用 webhook 之前,可能出现特定失败次数的天数。 默认情况下,系统将接受 5 天内的特定失败次数(在最大失败次数中指定)。 该值必须为介于 1 和 30 之间的整数。

    5. 设置最大失败次数的值。

      此值用于指定在停用 webhook 之前,特定天数内可能发生的失败次数。 默认情况下,系统将接受在停用 Webhook 之前的特定天数内(在过去天数中指定)发生 5 次失败。 该值必须是介于 1 和 10 之间的整数。

  5. 单击保存。

    已更新的属性将应用于每个已配置的服务 webhook。

使用 Notebooks 创建 webhook 和 webhook 接收器

您可以将 webhook 配置为在与您的门户项目、群组或用户关联的事件发生时自动运行您拥有的 notebook。 ArcGIS Notebook Server 将作为 webhook 负载的接收器。 触发 webhook 后,会向 ArcGIS Notebook Server 发出 HTTP 请求以运行所选 notebook,无需任何用户交互。

有关如何使用 Notebooks 创建和管理 webhook 与 webhook 接收器的更多信息,请参阅使用 webhook 事件自动执行笔记本工作流。