# 趋势图控件

在易企办仪表盘按日、周或月统计申请、工单等业务记录的变化。

## 放置与配置

在易企办自定义页面或仪表盘添加自定义代码控件，将下载的 TSX 完整粘贴到编辑器。先在测试应用核对字段类型与读写权限，再配置下表。

| 参数标识 | 类型 | 标准场景 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| `dataListId` | 变量或表达式 | 需要 | 数据列表 ID。趋势的数据来源列表，支持表达式获取列表 ID。 | `目标工单列表 ID` |
| `dateField` | 变量或表达式 | 需要 | 日期字段。用于日期分组的字段标识，例如创建时间或完成日期。 | `CreatedTime` |
| `titleText` | 文本 | 按需 | 标题。可选的图表标题。 | `工单提交趋势` |
| `subtitleText` | 文本 | 按需 | 副标题。标题下方的辅助说明。 | `最近 30 天的提交记录` |
| `chartType` | 文本 | 按需 | 图表类型。支持折线 line、面积 area 或 areaLine、柱形 column 或 bar。 | `line` |
| `timeGranularity` | 文本 | 按需 | 时间粒度。按日 day、周 week 或月 month 汇总，默认按日。 | `day` |
| `maxPoints` | 文本 | 按需 | 最多显示的时间段。最多显示多少个时间分组，默认为 12。 | `14` |
| `showPointLabels` | 变量或表达式 | 按需 | 显示数值标签。控制数据点或柱形的数值标签，支持布尔值或表达式。 | `true` |
| `showXAxisLabels` | 变量或表达式 | 按需 | 显示横轴日期。控制横轴的日期显示，支持布尔值或表达式。 | `true` |
| `showYAxis` | 变量或表达式 | 按需 | 显示纵轴。控制纵轴和网格线显示，支持布尔值或表达式。 | `true` |
| `emptyText` | 文本 | 按需 | 空状态提示。没有可汇总的有效日期记录时的提示。 | `暂无可统计工单` |
| `colorMode` | 文本 | 按需 | 配色方案。可选 yeeflow、green、amber、red、violet 或 slate。默认使用易企办配色。 | `yeeflow` |
| `sortMode` | 文本 | 按需 | 排序方式。可用 chronological 按时间正序，或 reverseChronological 按倒序。 | `chronological` |
| `filterExpression` | 变量或表达式 | 按需 | 查询筛选条件。按宿主支持的格式提供查询条件对象、数组或 JSON。留空使用无额外条件的查询。 | 按需留空 |
| `height` | 文本 | 按需 | 图表高度。图表区域的像素高度，默认为 280。 | `280` |
| `pageSize` | 文本 | 按需 | 查询条数。用于本次汇总的查询条数，默认为 500。 | `500` |
| `dateRangeMode` | 文本 | 按需 | 日期范围。可显示全部、近 7、30 或 90 天、本月或近 12 个月。默认 all。 | `last30Days` |
| `cumulativeMode` | 变量或表达式 | 按需 | 显示累计值。启用后显示逐期累计值，支持布尔值或表达式。 | `false` |
| `fillMissingBuckets` | 变量或表达式 | 按需 | 空时间段补零。给时间范围内缺少记录的日期分组补零，支持布尔值或表达式。 | `true` |
| `unknownDateLabel` | 文本 | 按需 | 无效日期标记。无效日期的诊断标记，无效日期不会绘制到图表。 | `无效日期` |

示例字段和列表 ID 请替换为目标应用的实际值。表达式请在编辑器中绑定。

1. 绑定列表及日期字段。
2. 选择统计周期和图形。
3. 核对缺失日期与累计值。

## 业务示例与结果

使用工单创建时间统计最近 30 天。开启补零后，两个有记录日期之间没有工单的日期显示 0。可切换月度汇总或累计曲线。

按有效日期分组，支持折线、面积和柱形图。无效日期不计入图表。启用累计显示后，即使只显示最近若干个时间段，累计数仍包含已选范围内较早的记录。日期按浏览器当地时间归组。

来源列表需授予使用者读取权限。控件处理查询返回的记录。列表量较大时，请按目标租户的 SDK 筛选格式缩小查询范围，并核对查询条数上限。

## 预览验收

验证单日重复记录、缺失日期补零、无效日期提示、月度中文轴标签、累计值及范围筛选。

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

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

源模板 CCT08DC0。 [Yeeflow 原站控件](https://www.yeeflow.com/templates/custom-code/trend-chart-module)