# 活动时间轴控件

在申请详情、自定义页面或运营看板查看工单进展、状态更新和备注。

## 放置与配置

在易企办测试应用中打开审批表单或支持自定义代码控件的页面，添加自定义代码控件，将同目录 TSX 完整粘贴到编辑器。先核对位置、字段类型与读写权限，再配置下表。

| 参数标识 | 类型 | 标准场景 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| `sourceListId` | 变量或表达式 | 需要 | 来源列表 ID。保存活动记录的数据列表 ID。 | `203...` |
| `recordIdField` | 变量或表达式 | 需要 | 关联记录字段。活动列表中保存业务记录 ID 的字段标识。 | `CaseId` |
| `recordIdValue` | 变量或表达式 | 需要 | 当前记录标识。当前业务记录 ID。 | `{{ListDataID}}` |
| `eventDateField` | 变量或表达式 | 需要 | 事件时间字段。保存事件时间的字段标识。 | `CreatedTime` |
| `actorField` | 变量或表达式 | 按需 | 操作人字段。保存操作人的字段标识。 | `Actor` |
| `titleField` | 变量或表达式 | 需要 | 标题字段。保存事件标题的字段标识。 | `ActivityTitle` |
| `descriptionField` | 变量或表达式 | 按需 | 说明字段。保存事件详情的字段标识。 | `Description` |
| `statusField` | 变量或表达式 | 按需 | 状态字段。保存事件状态或类型的字段标识。 | `ActivityType` |
| `titleText` | 文本 | 按需 | 标题。显示在控件顶部的主标题。 | `活动时间轴` |
| `maxItems` | 文本 | 按需 | 最大条数。最多显示的事件数。 | `10` |
| `emptyText` | 文本 | 按需 | 空状态提示。没有可展示数据时的提示文案。 | `暂无活动记录` |
| `filterExpression` | 变量或表达式 | 按需 | 查询筛选条件。可选的列表查询条件。 | 按需留空 |

示例字段和列表 ID 请替换为目标应用的实际值。表达式请在编辑器中绑定。保存目标使用可写文本字段或环境支持的可写变量。

1. 绑定活动数据列表。
2. 映射当前记录与事件字段。
3. 检查时间排序与可见范围。

## 业务示例与结果

工单详情按工单 ID 匹配活动列表，按新到旧展示「已派单」「已现场核查」「已完成」等活动。

先按当前记录值匹配已读取的数据，再按事件日期降序显示日期、操作人和说明。控件只读来源数据。

来源列表需授予使用者读取权限。控件读取查询返回的首批记录，再按配置筛选、排序或截取。数据量较大时，按目标租户的 SDK 筛选格式缩小查询范围。

## 预览验收

使用两条来自当前工单的事件和一条其他工单事件，核对隔离、时间顺序及空列表提示。

出现空结果时，先核对参数值、来源数据、字段标识和使用者权限。涉及写回时，再检查可写目标类型、当前页面权限及保存后的实际值。

模板已做本地源码与交互检查。发布到业务环境前，请在目标易企办租户验证当前版本的控件编辑器、数据权限和实际读写。

源模板 CCT13731。 [Yeeflow 原站控件](https://www.yeeflow.com/templates/custom-code/activity-timeline)