3.9 KiB
3.9 KiB
高级功能指南
流程监控
监控按钮
// FlowParser.vue - 流程监控
if (btnInfo?.hasCancelBtn) monitorBtnList.push({ id: 'cancel', fullName: '终止' });
if (btnInfo?.hasActivateBtn) monitorBtnList.push({ id: 'resurgence', fullName: '复活' });
if (btnInfo?.hasPauseBtn) monitorBtnList.push({ id: 'pause', fullName: '暂停' });
if (btnInfo?.hasAssignBtn) monitorBtnList.push({ id: 'assign', fullName: '指派' });
API 调用
# 获取监控列表
resp = client.workflow.get_monitor_list({
"currentPage": 1,
"pageSize": 20,
})
# 终止流程
client.workflow.cancel(task_id)
# 暂停流程
client.workflow.pause(task_id)
# 复活流程
client.workflow.resurgence(task_id)
# 指派任务
client.workflow.assign(task_id, {
"assignUserId": "user_id",
})
流程委托
说明
委托用于将审批权临时转交给其他用户,通常在请假或出差时使用。
# 获取委托列表
resp = client.workflow.get_delegate_list({
"currentPage": 1,
"pageSize": 20,
})
Webhook
使用流程
1. get_webhook_url -> 获取 Webhook URL
2. webhook_start -> 开启接收
3. 外部系统 POST 到 Webhook URL
4. JNPF 自动创建并启动流程
API 调用
# 获取 Webhook URL
resp = client.workflow.get_webhook_url({"flowId": flow_id})
webhook_url = resp.data # "http://..."
# 获取 Webhook 字段
resp = client.workflow.get_webhook_params(random_str)
# 开启 Webhook
client.workflow.webhook_start(flow_id, random_str)
流程评论
# 获取评论列表
resp = client.workflow.get_comment_list({"taskId": task_id})
# 添加评论
client.workflow.create_comment({
"taskId": task_id,
"content": "请尽快处理",
"type": 1,
})
# 删除评论
client.workflow.delete_comment(comment_id)
收藏流程
# 获取收藏流程列表
resp = client.workflow.get_collect_flow_list()
# 收藏/取消收藏
client.workflow.set_collect_flow(template_id)
上架/下架
# 上架/下架流程模板
client.workflow.up_down_shelf({
"id": template_id,
"enabledMark": 1, # 1=上架, 0=下架
})
流程选择器
# 获取流程列表(用于发起页面选择)
resp = client.workflow.get_flow_selector({"keyword": "采购"})
# 获取流程树形列表
resp = client.workflow.get_tree_list(form_type="3") # 3=工作流表单
决策参数
# 获取流程决策参数(用于条件分支配置)
resp = client.workflow.get_decision_parameter(template_id)
节点跳转
JumpCmd
// 后端 TaskController
public boolean jump(JumpFo fo) {
BpmnModel bpmnModel = repositoryService.getBpmnModel(instance.getProcessDefinitionId());
JumpCmd jumpCmd = new JumpCmd(fo.getInstanceId(), fo.getSource(), fo.getTarget(), "custom jump", bpmnModel, runtimeService);
managementService.executeCommand(jumpCmd);
}
获取可回退节点
# 获取可回退的节点
resp = client.workflow.get_back_node_list(operator_id)
# 获取后续节点
resp = client.workflow.get_task_next(task_id, node_id)
子流程
# 查看子流程信息
resp = client.workflow.get_sub_flow_info(
node_code="sub_node_code",
flow_id=task_id
)
外部节点重试
# 外部节点重试
client.workflow.retry_outside(node_id)
流程版本管理
# 获取版本列表
versions = client.workflow.get_version_list(template_id)
# 新增版本
new_version = client.workflow.copy_version(version_id)
# 删除版本
client.workflow.delete_version(version_id)
# 切换为标准流程
client.workflow.change_type(template_id) # 简单->标准(不可逆)
导出模板
# 导出流程模板
resp = client.workflow.export_template(template_id)
# 返回文件流
复制模板
# 复制流程模板
resp = client.workflow.copy_template(template_id)
new_template_id = resp.id