为托管要素图层创建并管理 Webhook

当某些影响服务的事件发生时,webhook 会发送相关信息。 在 ArcGIS Online 中,可以为填充托管要素图层、托管要素图层视图和托管表格的要素服务创建 webhook,并定义导致调用 webhook 的事件。

必须启用项目的保持对数据更改的追踪(添加、更新、删除要素)编辑设置,然后才能为其创建或管理 Webhook。

创建 webhook

可以为托管要素图层、托管要素图层视图或者托管表格创建 webhook,以便利用触发器和消息功能,实现这些项目的任务通知或自动化操作支持。

用于支持 webhook 的基础设施在 ArcGIS 外部进行配置。 有关在创建 webhook 之前必须配置的内容的信息以及要了解创建 webhook 所需的权限的信息,请参阅 ArcGIS Online 中的 Webhook

要为托管要素图层、托管要素图层视图或托管表格创建 webhook,请完成以下步骤:

  1. 登录组织
  2. 打开托管要素图层、视图或表的项目页面
  3. 单击设置选项卡。
  4. 滚动至 Webhook 部分,然后单击创建 Webhook

    如果创建 Webhook 按钮处于禁用状态,则可能表示该图层未启用保持对数据更改的追踪(添加、更新、删除要素) 选项。

    对于视图,必须在源托管要素图层上启用保持对数据更改的追踪(添加、更新、删除要素) 选项。

  5. 为 webhook 提供名称。
  6. 展开事件菜单,然后选中要触发 webhook 的所有事件复选框。
  7. Webhook 接收器 URL 文本框中,提供 webhook 接收器的 URL。

    webhook 接收器必须已存在,并且它必须配置为通过安全 HTTPS 连接进行通信。

  8. (可选)提供密钥以提高安全性。

    必须在 webhook 接收器上配置密钥,然后向 webhook 提供该密钥。

  9. 为 webhook 提供名称。

该 webhook 将显示在此项目的 webhook 列表中。

管理 webhook

可以在项目页面的设置选项卡中管理 webhook

项目所有者也可以通过我的设置页面访问并管理自己拥有的所有 webhook

提示:

组织管理员可以在组织 > 设置 > Webhook 选项卡中访问并管理组织中的所有 webhook。 有关详细信息,请参阅管理整个组织的 Webhook

与托管要素图层、托管要素图层视图或托管表相关的 webhook 的管理如下所示:

  • 禁用或激活 webhook - 当禁用 webhook 时,它不会在发生为其定义的触发事件时触发。 您可以在执行自动化更新时临时禁用图层上的所有 webhook,以免在收件箱中收到消息。 或者您可以临时禁用针对所有可能事件触发的一个 webhook,保持在单一触发器上触发的另一个 webhook 处于活动状态,以临时将重点放在该单一事件上。
  • 编辑 webhook - 可以更改 webhook 的设置。 例如,可以添加密钥或更改导致 webhook 触发的事件触发器。
  • 删除 webhook - 如果不再需要 webhook,则可以将其删除。
    注:

    将立即删除 webhook。 它们不会移至回收站。

从项目页面管理 Webhook

要从与 webhook 相关联的托管要素图层、托管要素图层视图或托管表格的项目页面中对其进行管理,请完成以下步骤:

  1. 登录组织
  2. 打开托管要素图层、视图或表的项目页面
  3. 单击设置选项卡,然后滚动至 webhook 部分。

    将在此处列出与此项目相关联的所有 webhook。

  4. 执行以下管理任务之一:
    • 要禁用 webhook,禁用 webhook 名称旁的切换按钮。
    • 要启用 webhook,启用 webhook 名称旁的切换按钮。
    • 要编辑 webhook 的设置,单击 webhook 名称旁的选项按钮 选项,然后单击编辑。 更改 webhook 的名称、事件、webhook 接收器 URL 或密钥,然后单击更新 webhook
    • 要删除 webhook,单击 webhook 名称旁的选项按钮 选项,然后单击删除。 当出现确认提示时,请单击删除

在“我的设置”中管理 webhook

要在我的设置中管理 webhook,请完成以下步骤:

  1. 登录组织
  2. 单击站点顶部的成员名称,然后单击我的设置
  3. 单击 Webhook 选项卡。
  4. 将在此处列出您拥有的所有 webhook。
  5. 执行以下管理任务之一:
    • 要禁用 webhook,禁用 webhook 名称旁的切换按钮。
    • 要启用 webhook,启用 webhook 名称旁的切换按钮。
    • 要编辑 webhook 的设置,单击 webhook 名称旁的选项按钮 选项,然后单击编辑。 更改 webhook 的名称、事件、webhook 接收器 URL 或密钥,然后单击更新 webhook
    • 要删除 webhook,单击 webhook 名称旁的选项按钮 选项,然后单击删除。 当出现确认提示时,请单击删除