活动订阅

除了让您在后端执行读写操作外,Integration Connectors 还可以 让您可以订阅在后端应用中发生的事件。例如,假设你 希望在有新的 Jira 票券创建时收到通知。为此,您可以将 适用于事件订阅的 Jira Cloud 连接器。通过使用事件订阅以及 利用 Application Integration,您可以 创建有用的集成来满足您的业务需求。如需了解详情,请参阅 在集成中使用事件订阅

在连接中启用事件订阅

您创建的连接可用于以下任何用途:

  • 仅用于执行连接器操作(实体和操作)
  • 仅适用于事件订阅
  • 用于执行连接器操作和事件订阅

提供启用活动订阅和配置活动相关详细信息的选项 连接创建期间提供给您。但是,如果 您已经有一个现有连接,并想将其改用于事件订阅,可以执行以下操作: 因此,您需要修改和重新配置该连接。

以下连接器支持事件订阅:

在活动通知中丰富数据

您可以配置连接 在事件通知响应中附加其他信息。通过本单元 特定于您配置事件的实体。要获取其他信息 您必须在连接中启用数据丰富化

例如,如果您在 Zendesk 中订阅了门票创建活动, 通知。不过,事件通知有效载荷 只有基本的票券详细信息其他详细信息,例如门票说明 分配对象和状态。要获取这些额外的详细信息, ticket 实体,您必须在 Zendesk 连接中启用数据丰富功能。对于 请参阅 配置事件订阅。通过 以下示例展示了使用数据丰富功能和使用数据丰富功能的响应载荷。

未实现数据丰富化的载荷

以下示例显示了没有数据丰富功能的 Zendesk 的 create Ticket 活动响应载荷。

{
  "account_id": 12345,
  "integration_key": "my_integration_key",
  "subdomain": "my_zendesk_subdomain",
  "input": {
    "ticket_event": {
      "meta": {
        "version": "1.0",
....
....
        "position": 1,
          "total": 9
        }
      },
      "type": "Ticket Created",
      "ticket": {
        "id": 35436,
....
....
        "external_id": "TEST1234",
        "tags": [
          "enterprise"
        ],
        "via": {
          "channel": "web"
        }
      }
    }
  }

具有数据丰富功能的载荷

以下示例展示了 Zendesk 的 create Ticket 活动具有数据丰富功能的响应载荷。

{
    "context-data": {
    "AllowChannelback": false,
    "Assignee": null,
    "AssigneeId": 1.6696812051473E13,
    "Brand": null,
    "BrandId": 1.6696812163985E13,
    "Cc": null,
    "CollaboratorIds": null,
    "Commenter": null,
    "HasAttachment": null,
    "CreatedAt": "2023-07-08 11:37:19.0",
    "CustomFields": null,
    "Description": "Test desc 2",
....
....
    "Status": "open",
    "Subject": "Test Zendesk Ticket Created -2 -DA",
    "Submitter": null,
    "SubmitterId": 1.6696812051473E13,
    "Tags": "tag-changed-after-cache,ticket-created",
....
....
    "ViaChannel": "web",
    "ViaFollowupSourceId": null,
    "ViaSource": "{\r\n  \"from\": null,\r\n  \"to\": null,\r\n  \"rel\": null\r\n}",
    "View_Id": null
  },
   "data":{
  "account_id": 12345,
  "integration_key": "my_integration_key",
  "subdomain": "my_zendesk_subdomain",
  "input": {
    "ticket_event": {
      "meta": {
        "version": "1.0",
....
....
        "position": 1,
          "total": 9
        }
      },
      "type": "Ticket Created",
      "ticket": {
        "id": 35436,
....
....
        "external_id": "TEST1234",
        "tags": [
          "enterprise"
        ],
        "via": {
          "channel": "web"
        }
      }
    }
  }
 }

用于事件订阅的专用连接

为提高安全性,您可以在后端应用和连接之间配置专用连接。 在专用连接中,连接的事件监听器不会直接设为公开。您必须改为 允许入站网络流量通过提供给您的 PSC 服务连接传入事件监听器 Integration Connectors。

在创建连接期间,如果您为事件订阅选择了启用专用连接,则 Integration Connectors 会创建 PSC 服务连接。您必须公开 通过使用任何适合您的方法将 PSC 服务连接到后端应用。一种可能 方法是在负载均衡器中使用 PSC 服务连接,然后配置 来接受来自后端应用的事件。然后,该连接会在负载均衡器的地址上监听后端的事件。 以下简要步骤展示了如何使用负载均衡器来配置专用连接:

  1. 转到新创建的连接的连接详情页面。
  2. 点击修改入站流量端点。系统随即会显示“事件订阅设置”窗格。
  3. 复制 PSC 服务连接名称字段中显示的服务连接名称。
  4. 创建一个 PSC 网络端点组 指向 您在上一步中获得的服务连接。
  5. 创建使用 PSC 网络的外部负载均衡器 作为后端创建的端点组。
  6. 将负载均衡器配置为接受来自事件提供方(后端应用)IP 地址的请求。

    后续 setps(7 到 11)仅适用于后端支持 自动注册事件订阅。例如 Zendesk 和 Jira。

  7. 转到新创建的连接的连接详情页面。
  8. 点击修改入站流量端点。系统随即会显示“事件订阅设置”窗格。
  9. 事件监听器入站流量端点字段中输入负载均衡器的地址。
  10. 点击完成
  11. 点击保存以保存对连接所做的更改。

在集成中使用事件订阅

将事件订阅与集成结合使用后,您可以创建 以解决复杂的业务问题。例如,您可以从 基于 ServiceNow 事件执行整个集成。 Application Integration 提供以下触发器, 监听来自后端应用的事件通知:

如需配置触发器,您必须启用事件订阅 您可以在以下位置启用事件订阅: 现有连接或新连接。如需详细了解 配置这些 Application Integration 触发器,请参阅 触发器文档。

查看已启用的订阅

当您在应用集成中使用事件订阅时,Integration Connectors 会创建 相应连接中订阅的条目。查看所有订阅 对于连接,请执行以下步骤:

  1. 打开 Google Cloud 项目的“所有连接”页面。

    转到“连接”页面

  2. 点击要查看其订阅的连接。

    系统随即会打开连接详情页面。

  3. 点击订阅内容标签页。

    这会显示该连接的所有订阅。此页面上列出了一项订阅 网页可处于以下任一状态:

    • 正在创建 - 订阅正在由集成创建。
    • 有效:订阅有效且运行正常。
    • 已暂停 - 连接处于暂停状态
    • 错误 - 订阅创建失败。例如,身份验证 在订阅创建期间失败。

事件订阅的价格

针对预览触发器中的事件订阅处理的数据(事件载荷)不会产生费用。不过, 您需要为在正式版触发器中处理的事件订阅数据付费。