# 审批决策面板

在易企办审批表单集中显示同意、拒绝和退回修改，并保存处理意见。

## 放置与配置

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

| 参数标识 | 类型 | 标准场景 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| `decisionField` | 变量或表达式 | 需要 | 决定保存目标。用于保存决定代码的可写审批表单字段或变量。 | `ApprovalDecision` |
| `commentField` | 变量或表达式 | 需要 | 意见保存目标。用于保存审批意见或处理理由的可写字段或变量。 | `ApprovalComment` |
| `titleText` | 文本 | 按需 | 标题。显示在审批选项上方的标题。 | `采购申请审核` |
| `subtitleText` | 文本 | 按需 | 副标题。显示在标题下方的操作说明。 | `请选择处理决定` |
| `approveLabel` | 文本 | 按需 | 同意按钮文字。默认显示「同意」。 | `同意` |
| `rejectLabel` | 文本 | 按需 | 拒绝按钮文字。默认显示「拒绝」。 | `拒绝` |
| `reviseLabel` | 文本 | 按需 | 退回修改按钮文字。默认显示「退回修改」。 | `退回修改` |
| `defaultDecision` | 变量或表达式 | 按需 | 默认决定。无已保存决定时显示的默认代码，例如 approve、reject 或 revise。 | 按需留空 |
| `requireCommentOnReject` | 变量或表达式 | 按需 | 拒绝时必填意见。开启后先填写意见，再写入拒绝决定。支持布尔值或表达式。 | `true` |
| `requireCommentOnRevise` | 变量或表达式 | 按需 | 退回时必填意见。开启后先填写意见，再写入退回决定。支持布尔值或表达式。 | `true` |
| `showCommentBox` | 变量或表达式 | 按需 | 显示意见输入框。控制意见输入框显示。支持布尔值或表达式。 | `true` |
| `commentPlaceholder` | 文本 | 按需 | 意见输入提示。意见输入框内的提示文字。 | `请填写审核意见` |
| `panelStyle` | 文本 | 按需 | 面板样式。可用样式为 standard、compact 或 bordered，默认 standard。 | `standard` |
| `showStatusSummary` | 变量或表达式 | 按需 | 显示当前决定摘要。控制当前决定摘要显示。支持布尔值或表达式。 | `true` |
| `readonlyText` | 文本 | 按需 | 只读空状态文字。只读状态下没有已保存决定时的文字。 | `暂无已保存的审批决定。` |
| `decisionOptionsJson` | 变量或表达式 | 按需 | 自定义决定选项。可选 JSON 数组。每项支持代码、显示文字、样式、辅助说明和意见必填开关。 | `[{"code":"hold","label":"暂缓审批","tone":"hold","helper":"请说明需要补充的资料","requireComment":true}]` |
| `validationMessageReject` | 文本 | 按需 | 拒绝校验提示。需要填写拒绝理由时的提示。 | `请填写拒绝理由。` |
| `validationMessageRevise` | 文本 | 按需 | 退回校验提示。需要填写退回理由时的提示。 | `请填写退回修改理由。` |

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

1. 绑定决定和意见字段。
2. 配置选项和必填条件。
3. 核对写回值与流程分支。

## 业务示例与结果

采购审批默认显示同意、拒绝和退回修改。采购报价需补充时，审核人选择退回修改并填写具体要求。若需要「暂缓审批」，可配置带意见要求的自定义决定。

标准选项分别写入 approve、reject、revise。未填写要求的意见时，决定保存目标为空，面板保留当前选项与提示。填写后才写入决定。自定义选项数组会替换默认选项。控件写入字段，提交与下一审批节点由业务流程配置。需要在此面板填写理由时，请保留意见框。明确绑定决定和意见的目标字段。

## 预览验收

验证三种决定、空意见、补填后写回、只读回显和流程分支。选用自定义决定时验证流程识别新增代码。

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

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

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