时间轴小部件

Prev Next

:::(Info)To download, visit: Library.
:::

用途

“时间轴”小部件是一个交互式小部件,用于显示来自 Tulip 表中的已记录事件。它将最新记录置于顶部,确保您随时掌握最新动态。

image

设置

必填字段:- 聚合 ID(Tulip 表聚合)- API 密钥(文本)- 密钥(文本)- 账户 URL(文本)

可选字段:- 白色文本(是/否) - 切换为“是”可将字体颜色更改为白色。默认值为“否”。

要设置此小部件,您需要提供 API 密钥、密钥密文和 URL(格式类似于your-account.tulip.co)。 如果您不清楚什么是 API 密钥,请参阅下一节。此外,您还可以在应用编辑器中(运行应用之前)通过直接在小部件属性中输入信息来设置该小部件。提供必要信息后,请刷新小部件。 此时,如果表格中有任何事件,它们都应显示在小部件中。该小部件使用聚合功能。通过聚合,小部件会填充事件信息。如果没有此聚合,每次向表格插入数据后,都需要刷新小部件以保持其最新状态。

如何创建服务账户

Feature rename

Prior to r383, Service Accounts were called "API Tokens".

要访问事件表,您必须拥有一个具有“表:读取”权限的服务账户。请导航至实例的“设置”部分,然后进入“Tulip API”,以确认您是否拥有该账户。如果已设置工作区,该选项可能位于“工作区设置”下。如果您已有服务账户,它将列在此处。点击“编辑”,并确保在“作用域”下勾选了“表:读取”权限。如果已勾选,则设置完成;若未勾选,请调整作用域或创建新的服务账户。如果没有服务账户,请点击“创建服务账户”按钮进行创建。输入任意名称,然后选择权限范围,确保“表:读取”已勾选,并根据需要勾选其他权限。建议仅授予最低必要的权限,但若不确定,也可勾选所有选项。点击“创建”后,将弹出一个窗口,提示您保存密钥。请务必遵守此提示,因为如果您丢失密钥并需要重新生成,所有使用过旧密钥的地方都将需要更新为新密钥。

工作原理

当表中添加新记录时,该小部件会自动更新。它会将最近的事件显示在最上方。如果您在深色背景上使用该小部件,可以更改字体。

该表格名为“时间线事件”,包含以下列:- ID(文本) - 事件的唯一标识符,应自动生成,虽不打算显示但必不可少- 标题(文本) - 事件标题,由于显示字号较大,应简明扼要- 描述 (文本) - 如果标题不够具体,可以在标题下方添加更多详细信息- 类型 (文本) - 可以是以下类型之一,或留空:success、error、warning、message、andon、pause、start、stop、msteams - 若未指定类型或类型不在上述列表中,则会显示默认图标 - 小部件中处理这些类型时不区分大小写- 创建日期(元数据,隐藏) -Tulip table 中的每条记录都包含元数据(创建日期和更新日期),这些元数据不可修改,但可在查询中使用