Files
2026-05-18 09:28:15 +08:00

176 lines
4.1 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 表单工作流(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 |