当某些影响服务的事件发生时,webhook 会发送相关信息。 在 ArcGIS Online 中,可以为填充托管要素图层、托管要素图层视图和托管表格的要素服务创建 webhook,并定义导致调用 webhook 的事件。
必须启用项目的保持对数据更改的追踪(添加、更新、删除要素)编辑设置,然后才能为其创建或管理 Webhook。
创建 webhook
可以为托管要素图层、托管要素图层视图或者托管表格创建 webhook,以便利用触发器和消息功能,实现这些项目的任务通知或自动化操作支持。
用于支持 webhook 的基础设施在 ArcGIS 外部进行配置。 有关在创建 webhook 之前必须配置的内容的信息以及要了解创建 webhook 所需的权限的信息,请参阅 ArcGIS Online 中的 Webhook。
要为托管要素图层、托管要素图层视图或托管表格创建 webhook,请完成以下步骤:
- 登录组织
- 打开托管要素图层、视图或表的项目页面。
- 单击设置选项卡。
- 滚动至 Webhook 部分,然后单击创建 Webhook。
如果创建 Webhook 按钮处于禁用状态,则可能表示该图层未启用保持对数据更改的追踪(添加、更新、删除要素) 选项。
对于视图,必须在源托管要素图层上启用保持对数据更改的追踪(添加、更新、删除要素) 选项。
- 为 webhook 提供名称。
- 展开事件菜单,然后选中要触发 webhook 的所有事件复选框。
- 在 Webhook 接收器 URL 文本框中,提供 webhook 接收器的 URL。
webhook 接收器必须已存在,并且它必须配置为通过安全 HTTPS 连接进行通信。
- (可选)提供密钥以提高安全性。
必须在 webhook 接收器上配置密钥,然后向 webhook 提供该密钥。
- 为 webhook 提供名称。
该 webhook 将显示在此项目的 webhook 列表中。
管理 webhook
项目所有者也可以通过我的设置页面访问并管理自己拥有的所有 webhook。
提示:
组织管理员可以在组织 > 设置 > Webhook 选项卡中访问并管理组织中的所有 webhook。 有关详细信息,请参阅管理整个组织的 Webhook。
与托管要素图层、托管要素图层视图或托管表相关的 webhook 的管理如下所示:
- 禁用或激活 webhook - 当禁用 webhook 时,它不会在发生为其定义的触发事件时触发。 您可以在执行自动化更新时临时禁用图层上的所有 webhook,以免在收件箱中收到消息。 或者您可以临时禁用针对所有可能事件触发的一个 webhook,保持在单一触发器上触发的另一个 webhook 处于活动状态,以临时将重点放在该单一事件上。
- 编辑 webhook - 可以更改 webhook 的设置。 例如,可以添加密钥或更改导致 webhook 触发的事件触发器。
- 删除 webhook - 如果不再需要 webhook,则可以将其删除。
注:
将立即删除 webhook。 它们不会移至回收站。
从项目页面管理 Webhook
要从与 webhook 相关联的托管要素图层、托管要素图层视图或托管表格的项目页面中对其进行管理,请完成以下步骤:
- 登录组织
- 打开托管要素图层、视图或表的项目页面。
- 单击设置选项卡,然后滚动至 webhook 部分。
将在此处列出与此项目相关联的所有 webhook。
- 执行以下管理任务之一:
- 要禁用 webhook,禁用 webhook 名称旁的切换按钮。
- 要启用 webhook,启用 webhook 名称旁的切换按钮。
- 要编辑 webhook 的设置,单击 webhook 名称旁的选项按钮
,然后单击编辑。 更改 webhook 的名称、事件、webhook 接收器 URL 或密钥,然后单击更新 webhook。 - 要删除 webhook,单击 webhook 名称旁的选项按钮
,然后单击删除。 当出现确认提示时,请单击删除。
在“我的设置”中管理 webhook
要在我的设置中管理 webhook,请完成以下步骤:
- 登录组织
- 单击站点顶部的成员名称,然后单击我的设置。
- 单击 Webhook 选项卡。
- 执行以下管理任务之一:
- 要禁用 webhook,禁用 webhook 名称旁的切换按钮。
- 要启用 webhook,启用 webhook 名称旁的切换按钮。
- 要编辑 webhook 的设置,单击 webhook 名称旁的选项按钮
,然后单击编辑。 更改 webhook 的名称、事件、webhook 接收器 URL 或密钥,然后单击更新 webhook。 - 要删除 webhook,单击 webhook 名称旁的选项按钮
,然后单击删除。 当出现确认提示时,请单击删除。