--- title: "时间轴小部件" slug: "timeline-widget" updated: 2026-10-22T17:18:21Z published: 2026-10-22T17:18:21Z canonical: "support.tulip.co/timeline-widget" --- > ## Documentation Index > Fetch the complete documentation index at: https://support.tulip.co/llms.txt > Use this file to discover all available pages before exploring further. # 时间轴小部件 :::(Info)To download, visit: [Library](https://library.tulip.co/apps/timeline-widget). ::: ## 用途 “时间轴”小部件是一个交互式小部件,用于显示来自 Tulip 表中的已记录事件。它将最新记录置于顶部,确保您随时掌握最新动态。 ![image](https://tulip.widen.net/content/w9asw7xkxy/web/Timelinewidget.gif?animate=true&u=hhrpm9) ## 设置 必填字段:- 聚合 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 中的每条记录都包含元数据(创建日期和更新日期),这些元数据不可修改,但可在查询中使用