4.1 KiB
4.1 KiB
表单工作流(webType=3)
来源:平台示例 salesOrder、crmOrder 等所有需要审批的表单
特点
- 表单列表工作流(webType=3)
- 关联 VisualDev 表单
- 通过菜单发起和审批
webType 区别
| webType | 名称 | 说明 |
|---|---|---|
| 1 | 纯表单 | 无列表 |
| 2 | 表单+列表 | 无流程 |
| 3 | 表单列表工作流 | 有流程审批 |
| 4 | 扩展字段 | 扩展其他字段 |
创建流程表单
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)
创建菜单
# 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, # 关联工作流
)
绑定流程模板
# 创建流程模板
result = client.workflow.create_simple_flow(
full_name="采购审批流程",
en_code="purchaseFlow",
form_id=func_id, # 关联表单
approver_user_ids=["admin"],
)
# 注意:需要在设计器中绑定到菜单
发起流程
方式1:通过菜单发起
菜单 -> 采购申请 -> 填写表单 -> 提交 -> 发起流程
方式2:通过 API 发起
# 获取版本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": "办公用品采购",
})
审批流程
待办 -> 审批 -> 通过/拒绝 -> 结束
# 获取待办
tasks = client.workflow.get_pending_tasks()
if tasks:
operator_id = tasks[0]["taskOperatorId"]
# 审批
client.workflow.approve(operator_id, "同意")
# 或拒绝
client.workflow.reject(operator_id, "金额过高")
完整示例
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 |