# 业务异常提示面板

在经营看板、记录详情或自定义页面汇集超期、资料缺失和其他需要关注的记录。

## 放置与配置

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

| 参数标识 | 类型 | 标准场景 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| `sourceListId` | 变量或表达式 | 需要 | 来源列表 ID。来源数据列表的 ID。 | `203...` |
| `rulesJson` | 变量或表达式 | 按需 | 异常规则 JSON。可选的 JSON 规则数组。 | `[{"field":"Status","operator":"equals","value":"已逾期","title":"处理超期","message":"请核对计划完成时间","severity":"warning"}]` |
| `titleField` | 变量或表达式 | 需要 | 标题字段。保存提示标题的字段标识。 | `Title` |
| `severityField` | 变量或表达式 | 按需 | 严重程度字段。保存严重程度的字段标识。 | `Severity` |
| `descriptionField` | 变量或表达式 | 按需 | 说明字段。保存异常说明的字段标识。 | `Description` |
| `titleText` | 文本 | 按需 | 标题。显示在控件顶部的主标题。 | `业务异常` |
| `subtitleText` | 文本 | 按需 | 副标题。显示在主标题下方的说明。 | `需要跟进的记录` |
| `showSeverity` | 变量或表达式 | 按需 | 显示严重程度样式。按严重程度区分提示样式。 | `true` |
| `maxItems` | 文本 | 按需 | 最大条数。最多显示的提示条数。 | `8` |
| `emptyText` | 文本 | 按需 | 空状态提示。没有可展示数据时的提示文案。 | `未发现异常` |
| `filterExpression` | 变量或表达式 | 按需 | 查询筛选条件。可选的列表查询条件。 | 按需留空 |

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

1. 绑定异常数据列表。
2. 定义规则与提示样式。
3. 验证命中和无异常场景。

## 业务示例与结果

任务状态等于「已逾期」时显示「处理超期」。为资料缺失单独增加一条空值规则，并配置明确的中文提醒。

不填规则时逐条展示来源记录。填写规则后按命中的规则显示提示。规则支持 `equals`、`contains`、`empty`、`notEmpty`，可定义标题、提示及样式。严重程度样式支持 `warning`、`info`、`success`。控件在页面内展示，不发送通知或写回列表。

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

## 预览验收

准备匹配与不匹配记录，验证规则字段已加入查询、命中筛选、数量限制、严重程度开关和无异常提示。

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

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

源模板 CCT726C2。 [Yeeflow 原站控件](https://www.yeeflow.com/templates/custom-code/exception-alert-panel)