Skip to content

Commit 483981d

Browse files
committed
fix: 合并审批单条详情按记录计算按钮,批量能力仅限制减签
- CustomAction 恢复默认批量能力,避免自定义按钮在合并列表被隐藏 - 补充合并组内每条记录均可展示减签与候选人的回归测试 - 更新接口文档中的合并审批单条查看约定,同步前端子模块指针
1 parent 08760b7 commit 483981d

4 files changed

Lines changed: 33 additions & 11 deletions

File tree

‎docs/Integration/rest-api.md‎

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -192,7 +192,8 @@ resetSubProcess(子流程重置能力标识:当前待办位于开启重置
192192

193193
- `currentNodeOperators`:当前记录所属**节点实例**中仍待审批的人员(`id` / `name`,按人去重,排除当前操作人,含顺序审批尚未激活的隐藏记录)。减签等只能作用于当前节点其他待审批人的动作应以此字段作为候选来源,不要使用宿主的全局用户列表。
194194
- 该字段按单条流程记录计算;合并审批(`mergeable = true`)下多条流程实例的待审批人集合可能不同,不能跨流程合并候选人。
195-
- `actions` / `actionList` 中每个动作额外带有 `batchable` 标记:`true` 表示支持合并批量提交,`false` 表示只能单条记录提交(当前为 `REDUCE_AUDIT`、`CUSTOM`)。该标记只在响应中附加,不写入流程设计持久化数据;旧版本服务端无此字段时前端按 `true` 处理。
195+
- `actions` / `actionList` 中每个动作额外带有 `batchable` 标记:`true` 表示支持合并批量提交,`false` 表示只能单条记录提交(当前为 `REDUCE_AUDIT`)。该标记只在响应中附加,不写入流程设计持久化数据;旧版本服务端无此字段时前端按 `true` 处理。
196+
- 合并审批(`mergeable = true`)时前端不展示 `batchable = false` 的动作;从合并列表进入**单条流程**后,按该条记录自己的 `actions` / `currentNodeOperators` 展示并提交(提交目标固定为该记录)。
196197

197198
### `FlowRecordContent`(列表响应,字段摘要)
198199

‎flow-engine-framework/src/main/java/com/codingapi/flow/action/actions/CustomAction.java‎

Lines changed: 0 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -26,15 +26,6 @@ public class CustomAction extends BaseAction {
2626

2727
public static final String DEFAULT_TITLE = "自定义";
2828

29-
/**
30-
* 自定义动作的行为由脚本决定,可能依赖当前记录的表单/选人数据,
31-
* 无法保证多条流程合并提交语义正确,因此不支持批量。
32-
*/
33-
@Override
34-
public boolean batchable() {
35-
return false;
36-
}
37-
3829
/**
3930
* 后端处理脚本
4031
*/

‎flow-engine-framework/src/test/java/com/codingapi/flow/service/FlowIssue266ReduceAuditTest.java‎

Lines changed: 30 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -274,6 +274,36 @@ void reduceActionShouldBeVisibleOnlyWhenAnotherPendingApproverExists() {
274274
"多人并签节点应展示减签按钮");
275275
}
276276

277+
/**
278+
* 测试目标:合并审批时,合并组内每条流程记录都应单独计算减签按钮与候选人。
279+
* 前置条件:B 为并签节点(b1/b2),开启记录合并,并发起两条流程实例。
280+
* 执行步骤:分别用 b1 在两条流程里的记录查询 detail。
281+
* 期望断言:两条记录都展示减签按钮,候选人均只有 b2;前端进入单条流程时即可据此切换按钮。
282+
*/
283+
@Test
284+
void mergedDetailShouldExposeReduceActionForEachRecord() {
285+
// given
286+
Workflow workflow = saveWorkflow("issue-merge-multi", MultiOperatorAuditStrategy.Type.MERGE,
287+
1f, List.of(2L, 3L), true);
288+
String bNodeId = nodeIdByName(workflow, "B审批");
289+
createAndSubmit(workflow);
290+
createAndSubmit(workflow);
291+
292+
List<FlowRecord> b1Todos = todoRecordsOf(b1, bNodeId);
293+
assertEquals(2, b1Todos.size(), "两条流程的记录应合并到同一个待办分组");
294+
295+
// when/then
296+
for (FlowRecord record : b1Todos) {
297+
FlowContent detail = factory.flowService.detail(new FlowDetailRequest(record.getId(), b1.getUserId()));
298+
assertTrue(detail.isMergeable(), "合并组内的记录应标记为可合并审批");
299+
assertTrue(containsAction(detail.getActions(), ActionType.REDUCE_AUDIT),
300+
"合并组内每条记录都应展示减签按钮");
301+
assertEquals(List.of(b2.getUserId()),
302+
detail.getCurrentNodeOperators().stream().map(FlowOperator::getId).toList(),
303+
"减签候选人应按记录所属流程实例计算");
304+
}
305+
}
306+
277307
/**
278308
* 测试目标:加签不允许把已经在当前节点待办队列中的人员重复加入。
279309
* 前置条件:B 为并签节点,b1、b2 均为待审批人。

0 commit comments

Comments
 (0)