5.5 KiB
5.5 KiB
流程设计指南
来源:前端
views/onlineDev/flowEngine/Form.vue、FlowProcess 组件
流程设计器结构
Form.vue 关键代码
// 获取流程设计数据
getFlowInfo(currentVersion.id).then((res) => {
state.dataForm = { ...state.dataForm, ...res.data };
state.flowConfig = JSON.parse(state.dataForm.flowConfig || '{}');
});
// 保存流程设计
saveFlow({
...data,
id: template_id,
flowId: version_id,
flowConfig: JSON.stringify(flowConfig),
}).then((res) => {
if (data.type === 1) {
// 发布
currentVersion.state = 1;
}
});
save_flow 接口
请求参数
client.workflow.save_flow({
"id": template_id, # 模板ID
"flowId": version_id, # 版本ID
"flowXml": flow_xml, # BPMN XML(需URL编码)
"flowNodes": flow_nodes, # 节点配置字典
"flowConfig": flow_config, # JSON字符串
"type": 1, # 0=保存, 1=发布
})
flowXml 格式
简单流程(type=1) - 必须 URL 编码:
<?xml version="1.0" encoding="UTF-8"?>
<bpmn2:definitions ...>
<bpmn2:process id="Process_1">
<bpmn2:startEvent id="Event_0oz4pwh">
<bpmn2:outgoing>Flow_1iadlmn</bpmn2:outgoing>
</bpmn2:startEvent>
<bpmn2:userTask id="Activity_1qf73gq">
<bpmn2:incoming>Flow_1iadlmn</bpmn2:incoming>
<bpmn2:outgoing>Flow_1kz1x8a</bpmn2:outgoing>
</bpmn2:userTask>
...
</bpmn2:process>
</bpmn2:definitions>
flowNodes 结构
{
"global": {
"type": "global",
"nodeId": "global",
"formId": "form_id",
"titleType": 0,
"defaultContent": "{发起用户名}的{流程名称}",
"hasSign": False,
"hasRevoke": False,
"hasComment": True,
"connectList": ["Flow_1", "Flow_2"],
},
"Event_0oz4pwh": { # 发起节点
"type": "start",
"nodeId": "Event_0oz4pwh",
"nodeName": "流程发起",
"formId": "form_id",
},
"Activity_1qf73gq": { # 审批节点
"type": "approver",
"nodeId": "Activity_1qf73gq",
"nodeName": "部门审批",
"formId": "form_id",
"assigneeType": 6,
"approvers": [{"id": "user_id", "type": "user"}],
"counterSign": 0,
"hasOpinion": True,
},
"Event_0zlhfee": { # 结束节点
"type": "end",
"nodeId": "Event_0zlhfee",
},
}
flowConfig 结构
# 简单/标准/任务/自由流程
{"visibleType": 1} # 1=公开, 2=权限设置
# 决策流程
{
"visibleType": 1,
"startParameterList": [], # 自定义入参
"endParameterList": [], # 自定义出参
}
AIBridge 便捷方法
# 一键创建简单流程(推荐)
result = client.workflow.create_simple_flow(
full_name="采购审批",
en_code="purchaseFlow",
form_id="visual_dev_id",
approver_user_ids=["user_id_1", "user_id_2"],
)
# 返回: {"template_id": "...", "version_id": "..."}
# 创建标准流程
result = client.workflow.create_standard_flow(
full_name="请假申请",
en_code="leaveFlow",
form_id="visual_dev_id",
)
# 创建任务流程
result = client.workflow.create_task_flow(
full_name="任务处理",
en_code="taskFlow",
form_id="visual_dev_id",
handler_user_ids=["user_id"],
)
# 创建自由流程
result = client.workflow.create_free_flow(
full_name="自由审批",
en_code="freeFlow",
form_id="visual_dev_id",
approver_user_ids=["user_id"],
)
# 创建决策流程
result = client.workflow.create_decision_flow(
full_name="条件审批",
en_code="decisionFlow",
form_id="visual_dev_id",
branch_a_user_ids=["user_id_1"],
branch_b_user_ids=["user_id_2"],
)
审批节点配置 (assigneeType)
| 值 | 名称 | 配置项 |
|---|---|---|
| 1 | 发起人上级 | managerLevel: 1-10 |
| 2 | 特定岗位 | assignList: 岗位列表 |
| 3 | 发起人自己 | - |
| 4 | 表单变量 | formFieldType, formField |
| 5 | 审批节点 | approverNodeId |
| 6 | 指定成员 | approvers: [{id, type}] |
| 7 | 候选人 | isCandidates: true |
| 9 | 数据接口 | interfaceConfig |
| 10 | 逐级审批 | managerLevel |
会签配置 (counterSign)
{
"counterSign": 1, # 0=或签, 1=会签, 2=依次审批
"counterSignConfig": {
"auditType": 1, # 1=按百分比, 2=按人数
"auditRatio": 100, # 通过比例
"auditNum": 1, # 通过人数
"rejectType": 0, # 拒绝规则
"rejectRatio": 10,
"rejectNum": 1,
}
}
按钮配置
{
"hasAuditBtn": True,
"auditBtnText": "同意",
"hasRejectBtn": True,
"rejectBtnText": "拒绝",
"hasBackBtn": False,
"backBtnText": "退回",
"hasFreeApproverBtn": False,
"freeApproverBtnText": "加签",
"hasReduceApproverBtn": False,
"reduceApproverBtnText": "减签",
"hasTransferBtn": False,
"transferBtnText": "转审",
"hasAssistBtn": False,
"assistBtnText": "协办",
"hasSaveAuditBtn": False,
"saveAuditBtnText": "暂存",
}
超时配置
{
"timeLimitConfig": {
"on": 1, # 0=不启用, 1=启用
"nodeLimit": 0, # 节点时限
"duringDeal": 24, # 办理时长(小时)
},
"overTimeConfig": {
"on": 2, # 0=不启用, 1=自动通过, 2=通知
"firstOver": 24, # 首次超时时间
"overNotice": True,
"overAutoApprove": False,
"overAutoApproveTime": 5,
}
}