Files
aibridge/docs/workflow/06-examples/04-form-workflow.md
T
2026-05-18 09:28:15 +08:00

4.1 KiB
Raw Blame History

表单工作流(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