我该如何使用 Canvas 数据服务来订阅实时事件?

作为管理员,您可以订阅实时事件,并从您的 Canvas 帐户接收实时事件集。您可以在 Canvas 中选择要订阅的事件。您需要维护 Amazon Web 服务队列来接收实时事件数据

注意:要接收实时事件数据,您需要订阅 Amazon Web 服务以维护队列。

打开帐户

打开帐户

点击管理员 (Admin) 链接 [1],然后点击帐户名称 [2]。

打开数据服务

打开数据服务

在帐户导航 (Account Navigation) 中,点击 数据服务 (Data Portal) 链接。

添加数据流

添加数据流

要为您的帐户创建新的数据流,请点击添加流 (Add Stream) 按钮。

配置数据流

配置数据流

名称/标题 (Name/Title) 字段中为您的流输入标题 [1]。

传送方式 (Delivery Method) 下拉菜单中选择 SQS 或 HTTPS 传送方式 [2]。然后在 URL 字段中输入您的 AWS SQS 或 HTTPS 端点 URL [3]。

注意:

  • 每个订阅只允许使用一种传送方式。
  • Canvas 使用 JWT 对事件进行签名。如果服务不可用,并且 Canvas 无法访问该服务,则可能无法传送服务中断期间发生的事件。

配置 Amazon SQS 数据流

配置 Amazon SQS 数据流

如果您想要求对 Amazon SQS URL 进行身份验证,请在身份验证 (Authentication) 字段中选择 AWS 凭证 [1]。如果无需进行身份验证,则可将此字段设置为“无”选项。

如果需要 AWS 凭证,请输入 AWS 密钥 [2]、AWS 机密 [3] 和 AWS 区域 [4]。

消息类型 (Message Type) 字段中选择事件格式 [5]。消息类型可设置为 Canvas 或 Caliper 1.1。

注意:“应用程序类型”字段只能设置为“数据流”选项。

配置 HTTPS 数据流

HTTPS 传送方式包括一个选项,用于在数据流中显示源端点负载数据。要查看有效负载数据,请选中给有效负载签名 (Sign Payload) 复选框 [1]。

消息类型 (Message Type) 字段中选择事件格式 [2]。消息类型可设置为 Canvas 或 Caliper 1.1。

注意:“应用程序类型”字段只能设置为“数据流”选项。

选择订阅

选择订阅

选择要包含在数据流中的订阅。

要搜索特定事件,请在搜索事件 (Search Events) 栏中键入事件名称 [1]。

要在流中包括所有事件,请点击订阅 (Subscriptions) 复选框 [2]。选择此选项包括所有事件类型以及用户和系统生成的操作。

要订阅由最终用户直接执行的操作触发的事件,请点击用户生成 (User Generated) 复选框 [3]。用户生成的事件包括事件元数据中有关 web 请求、浏览器和用户数据的信息,以及受更改影响的对象的详细信息。

要订阅由异步作业触发的事件,请点击系统生成 (System Generated) 复选框 [4]。系统生成的事件包括有关触发事件的进程的数据,以及有关受更改影响的对象的详细信息。

您还可以订阅事件组。要订阅组中的所有项目,请点击该组对应的复选框 [5]。您也可以选择只包括由用户或系统生成的数据 [6]。

要订阅单个事件,请点击订阅组对应的箭头 (Arrow) 图标 [7],然后点击要添加的订阅对应的复选框 [8]。

注意:此步骤中的图像显示 Canvas 消息类型的订阅选项。Caliper 1.1 消息类型的选项不同,但订阅步骤相同。

保存数据流

保存数据流

要保存数据流,请点击保存并退出 (Save & Exit) 按钮。

查看数据流

查看数据流

您可以在“数据流选项”页面上查看和管理数据流