# 表单工作流(webType=3) > 来源:平台示例 salesOrder、crmOrder 等所有需要审批的表单 ## 特点 - 表单列表工作流(webType=3) - 关联 VisualDev 表单 - 通过菜单发起和审批 ## webType 区别 | webType | 名称 | 说明 | |---------|------|------| | 1 | 纯表单 | 无列表 | | 2 | 表单+列表 | 无流程 | | 3 | 表单列表工作流 | 有流程审批 | | 4 | 扩展字段 | 扩展其他字段 | ## 创建流程表单 ```python from aibridge.builders.full_config import build_full_config, build_create_payload # 1. 构建表单配置 config = build_full_config( full_name="采购申请", en_code="purchaseApply", table_name="base_purchase_apply", table_label="采购申请", description="办公用品采购申请", category="", fields=[ {"field": "f_orderNo", "fieldName": "单号", "jnpfKey": "comInput", "required": True}, {"field": "f_amount", "fieldName": "金额", "jnpfKey": "inputNumber", "required": True}, {"field": "f_reason", "fieldName": "理由", "jnpfKey": "textarea"}, ], web_type=3, # 关键:表单列表工作流 ) # 2. 创建表单 payload = build_create_payload(config) resp = client.visual_dev.create(payload) func_id = resp.id # 3. 发布表单 client.visual_dev.release(func_id) ``` ## 创建菜单 ```python # 1. 创建目录菜单 dir_resp = client.menu.create_directory_menu( name="采购管理", en_code="purchase_mgmt", parent_id="root", ) # 2. 创建功能表单菜单 menu_resp = client.menu.create_form_menu( name="采购申请", en_code="purchaseApply", func_id=func_id, parent_id=dir_resp.id, web_type=3, # 关联工作流 ) ``` ## 绑定流程模板 ```python # 创建流程模板 result = client.workflow.create_simple_flow( full_name="采购审批流程", en_code="purchaseFlow", form_id=func_id, # 关联表单 approver_user_ids=["admin"], ) # 注意:需要在设计器中绑定到菜单 ``` ## 发起流程 ### 方式1:通过菜单发起 ``` 菜单 -> 采购申请 -> 填写表单 -> 提交 -> 发起流程 ``` ### 方式2:通过 API 发起 ```python # 获取版本ID versions = client.workflow.get_version_list(template_id) version_id = versions.data[0]["id"] # 发起流程 task = client.workflow.launch_task(version_id, { "f_orderNo": "PO-2026-001", "f_amount": 5000, "f_reason": "办公用品采购", }) ``` ## 审批流程 ``` 待办 -> 审批 -> 通过/拒绝 -> 结束 ``` ```python # 获取待办 tasks = client.workflow.get_pending_tasks() if tasks: operator_id = tasks[0]["taskOperatorId"] # 审批 client.workflow.approve(operator_id, "同意") # 或拒绝 client.workflow.reject(operator_id, "金额过高") ``` ## 完整示例 ```python from aibridge import JNPFClient, JNPFConfig from aibridge.builders.full_config import build_full_config, build_create_payload config = JNPFConfig() client = JNPFClient.from_config(config) client.login() # 1. 创建表单 fields = [ {"field": "f_title", "fieldName": "标题", "jnpfKey": "comInput", "required": True}, {"field": "f_amount", "fieldName": "金额", "jnpfKey": "inputNumber", "required": True}, ] config = build_full_config("采购申请", "purchase", "base_purchase", "采购申请", "", fields, web_type=3) resp = client.visual_dev.create(build_create_payload(config)) func_id = resp.id client.visual_dev.release(func_id) # 2. 创建目录 dir_resp = client.menu.create_directory_menu("采购管理", "purchase_mgmt", "root") # 3. 创建菜单 client.menu.create_form_menu("采购申请", "purchase", func_id, dir_resp.id, web_type=3) # 4. 创建流程 flow = client.workflow.create_simple_flow( "采购审批", "purchaseFlow", func_id, ["admin"], "采购申请" ) # 5. 发起流程 task = client.workflow.launch_task(flow["version_id"], { "f_title": "办公用品采购", "f_amount": 5000, }) # 6. 审批 tasks = client.workflow.get_pending_tasks() if tasks: client.workflow.approve(tasks[0]["taskOperatorId"], "同意") ``` ## 关键配置项 | 配置 | 说明 | |------|------| | webType=3 | 表单列表工作流 | | flowId | 关联的流程版本ID | | formId | 关联的表单ID |