176 lines
4.1 KiB
Markdown
176 lines
4.1 KiB
Markdown
# 表单工作流(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 |
|