# 流程设计指南 > 来源:前端 `views/onlineDev/flowEngine/Form.vue`、FlowProcess 组件 ## 流程设计器结构 ### Form.vue 关键代码 ```typescript // 获取流程设计数据 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 接口 ### 请求参数 ```python 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 Flow_1iadlmn Flow_1iadlmn Flow_1kz1x8a ... ``` ### flowNodes 结构 ```python { "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 结构 ```python # 简单/标准/任务/自由流程 {"visibleType": 1} # 1=公开, 2=权限设置 # 决策流程 { "visibleType": 1, "startParameterList": [], # 自定义入参 "endParameterList": [], # 自定义出参 } ``` ## AIBridge 便捷方法 ```python # 一键创建简单流程(推荐) 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) ```python { "counterSign": 1, # 0=或签, 1=会签, 2=依次审批 "counterSignConfig": { "auditType": 1, # 1=按百分比, 2=按人数 "auditRatio": 100, # 通过比例 "auditNum": 1, # 通过人数 "rejectType": 0, # 拒绝规则 "rejectRatio": 10, "rejectNum": 1, } } ``` ## 按钮配置 ```python { "hasAuditBtn": True, "auditBtnText": "同意", "hasRejectBtn": True, "rejectBtnText": "拒绝", "hasBackBtn": False, "backBtnText": "退回", "hasFreeApproverBtn": False, "freeApproverBtnText": "加签", "hasReduceApproverBtn": False, "reduceApproverBtnText": "减签", "hasTransferBtn": False, "transferBtnText": "转审", "hasAssistBtn": False, "assistBtnText": "协办", "hasSaveAuditBtn": False, "saveAuditBtnText": "暂存", } ``` ## 超时配置 ```python { "timeLimitConfig": { "on": 1, # 0=不启用, 1=启用 "nodeLimit": 0, # 节点时限 "duringDeal": 24, # 办理时长(小时) }, "overTimeConfig": { "on": 2, # 0=不启用, 1=自动通过, 2=通知 "firstOver": 24, # 首次超时时间 "overNotice": True, "overAutoApprove": False, "overAutoApproveTime": 5, } } ```