调试与排错
本章给出动作未按预期执行时的排查顺序与常见配置错误清单。
1. 动作没有生效
按以下顺序检查，该顺序按"最容易忽略、最省时间"排列：
- 动作流是否已保存。设计器中的修改需点击保存才生效。切换事件或关闭对话框前确认已保存；
- 事件是否绑定了正确的按钮或字段。回到触发根节点确认所选时机与绑定对象，与实际测试的操作一致；
- 字段值变化与字段点击是否漏勾字段。这两种时机若未勾选具体字段，编辑器会给出该事件永不触发的警告；
- 条件是否堵死了路径。检查条件是否写反，或两个分支都留空；
- 节点是否被停用。停用的节点整卡变灰并带停用角标，运行时跳过；
- 前面的动作是否先失败了。同步动作失败会使同层级后续节点整体中止。
2. 取数或赋值结果不对
| 检查项 | 说明 |
|---|---|
| 字段选错表 | 最常见的错误是把来源表字段与本报表字段选反 |
| 填充策略 | 查到多条时的处理方式（取第一条、拼接、求和）是否与预期一致 |
| 实际执行一次 | 用表达式编辑器的测试功能跑一遍条件，看返回结果，判断是条件本身有误还是数据没有匹配项 |
3. 使用节点自带的测试
动作节点的配置对话框中带有测试按钮（触发根与条件节点没有）。点击后按当前配置直接执行一次，可查看条件是否匹配、结果是否符合预期。
这比反复保存整条流程再到填报态验证要快得多，且结果直接显示在对话框中，不必离开设计器。
4. 查看执行日志
动作运行时的详细报错不一定完整展示在页面上，需请实例管理员在控制台的日志中心协助查看：
- 记录大致的操作时间、点击的按钮或改动的字段、模板名称，便于检索；
- 管理员在日志中心的系统日志页签按时间范围与关键字查找；
- 日志详情中可看到出错时的原始信息，据此判断是配置问题（表达式写错、目标表选错）还是数据问题（引用的记录已被删除）。
5. 常见配置错误
| 现象 | 原因与处理 |
|---|---|
| 保存被拦截，提示表达式相关错误 | 为"不成立"分支配置了内容。 表达式模式不支持取反，需清空该分支，或改为两个条件节点分别书写正反条件，见分支与子流程 |
| 提示条件两个分支都为空 | 该条件节点没有接任何后续动作，等于未做判断 |
| 提示某个事件不会被触发 | 字段值变化或字段点击选了时机却未勾选字段 |
| 异步开关无法勾选或保存报错 | 该动作不支持异步执行，只能保持同步 |
| 取数或条件结果比预期多 | 某条过滤条件因参数未填被视为未书写，见表达式编辑器 |
| 删除或修改动作执行了但数据没变 | 定位条件未匹配到目标记录，或因版本冲突被自动跳过 |
6. 自查顺序
求助前按此顺序自查一遍，通常可省去大量沟通：
是否已保存 → 事件是否绑对 → 有无未处理的警告 → 条件是否正确 → 前面的步骤是否真的成功
仍无法定位时，带上操作时间与模板名称请管理员查询日志。
7. 相关章节
配置示例：执行成功后仍要核对数据
本例是应用定时任务的数据动作，入口由 Kimpo 本体提供，动作设计器插件配置「新增数据」，宿主执行后写入目标表。执行历史显示两次成功、各完成1/1步后，再按演练关联单号查询库存流水，确认防重后仍只有1条、数量为1。
任务状态与实际业务变化需要分别检查。此例不是模板按钮的节点测试；完整设置见定时任务。
两次手动触发均成功并完成1/1步；需结合实际目标表确认防重后的记录数量
再次执行后重新查询，同一TUTORIAL-JOB-001仍只有1条且数量为1，验证关联单号防重