- 开发指南
- 字段类型对照表
- 筛选器使用指南
- 错误码
- API 使用指南
- 应用
- 对话机器人
- 工作表
- 工作表行记录
- 自定义页面
- 选项集
- 公共查询
- 知识库
- 视图
- 统计图
- 工作流
- 角色
- 数据模型
- Schemas
- options
- relation
- obj_base_response
- obj_field
- obj_filter
- obj_record_row
- obj_record_log
- obj_record_discussion
- obj_pivot_meta
- obj_pivot_dimensions
- obj_pivot_data
- obj_process
- obj_process_detail
- obj_input
- obj_output
- obj_role
- obj_role_permission
- obj_user
- obj_user_desensitized
- obj_department
- obj_custom_page
- obj_optionset
- obj_filter_children
- obj_app
- 鉴权信息
- 人员对象
- 自定义页面
- 应用角色
- 人员信息
- 统计图数值字段参数
- FilterField
- FilterTarget
- ApiError
- BatchCreateViewsRequest
- DataScope
- ViewItem
- Aggregation
- BatchCreateViewsResponse
- TimeRange
- ChartType
- DynamicRangePoint
- DimensionItem
- MetricItem
- SortItem
- CreateChartData
- InlineChartConfig
- ViewConfig
- TextConfig
- HtmlConfig
- CarouselConfig
- ButtonActionItem
- ButtonConfig
- TabConfig
- ContainerConfig
- ChartComponent
- SectionComponent
- TextComponent
- HtmlComponent
- ViewComponent
- CarouselComponent
- ButtonComponent
- TabComponent
- ContainerComponent
- SaveCustomPageComponent
- SaveCustomPageData
- ComponentConfig
- SaveCustomPageRequest
- app
- CreateChartRequest
- SaveCustomPageResponseData
- CreateChartResponseData
- ButtonItem
- 基础返回对象
- DimensionField
- memberInfo
- ValueField
- department_with_path
- SortField
- departmentInfo
- TimePointDynamic
- regionInfo
- process
- process_detail
- CustomDynamicRange
- input
- CustomRange
- output
- role
- role_permission
- optionset
- field
- CreateChartResponse
- PageComponent
- Position
- filter_children
- ErrorResponse
- discussion
- TabItem
- SaveCustomPageResponse
- User
- WorkflowInputParameter
- WorkflowOutputParameter
- WorkflowNode
- WorkflowValidationError
- create_process_NodeRef
- create_process_ValueRef
- create_process_FieldValueRef
- create_process_Filter
- create_process_Condition
- create_process_WorksheetEventTriggerConfig
- create_process_ScheduleTriggerConfig
- create_process_DateFieldTriggerConfig
- create_process_WebhookTriggerConfig
- create_process_TriggerSpec
- batch_create_process_nodes_NodeRef
- batch_create_process_nodes_ValueRef
- batch_create_process_nodes_FieldValueRef
- batch_create_process_nodes_RecordValueRef
- batch_create_process_nodes_FieldPatch
- batch_create_process_nodes_Filter
- batch_create_process_nodes_Condition
- batch_create_process_nodes_PersonRef
- batch_create_process_nodes_AttachmentSpec
- batch_create_process_nodes_FormProperty
- batch_create_process_nodes_NodeSpec
- batch_create_process_nodes_SortSpec
- ApiResponseBase
- WorkflowListType
- WorkflowInstanceStatus
- FlowNodeType
- InstanceLogStatus
- WorkItemOperationType
- WorkItemLogAction
- ApprovalAuthType
- BatchRuleType
- CallbackType
- TriggerType
- AppType
- ApprovalResultBranchType
- FailureCause
- SignatureType
- AppBrief
- UserBrief
- ControlValue
- FlowNodeAuth
- SelectNodeObject
- FlowNode
- InstanceLog
- ProcessBrief
- FileInfo
- Signature
- WorkItem
- WorkItemLog
- ChangedField
- WorkflowInstance
- BatchApprovalRequest
- BatchApprovalInstance
- BatchApprovalResult
- OpinionRequest
- ReturnRequest
- bundled_2af3dc97c2fe
- bundled_da9b1112b2d5
- bundled_66310009f584
- custom_page
- worksheet
- filter
- record_row
- Schemas
批量添加工作流节点
正式环境
https://api.mingdao.com
正式环境
https://api.mingdao.com
POST
/v3/app/workflows/{workflow_id}/nodes/batch
• processId 必填，节点全部追加到该流程内。
• 节点用 prevNode/parentNode 表达顺序/容器；数据引用写在具体字段里：ValueRef.node、target/input。rollup / approval_block / sub_process 统一用 config.target。引用历史节点推荐用 nodeId（避免 alias 冲突），同批新建节点之间用 nodeAlias。
• 筛选条件只用 Filter={logic, items} 和 Condition={left, op, right?}；left 必须是字段引用 {kind:'field', node, fieldId}，其它值类型只能放 right。
• get_single/get_multiple 的 config.filter 中，left.node 必须引用当前查询节点自身，用来筛选被查询工作表字段；trigger/其它上游字段只能作为 right 动态值。
• 不允许在本接口新建触发器；触发器只能在创建工作流时一次创建。
• 块节点（approval_block / sub_process）内部节点不通过 parentNode 挂，而是写在块节点 config.process.nodes 里。
• 返回 createdNodes 中如果包含 approval_block 或 sub_process，该节点项会带内部审批流程/子流程的 processId。
⚠️ rollup 输出字段固定为 number_fx_id；compute(number/dateDiff) 输出字段固定为 number_fx_id，compute(dateOffset) 输出字段固定为 date_fx_id。下游引 用应使用 等。
⚠️ 分支路径下的第一个节点，prevNode 和 parentNode 都必须显式指向该路径的 alias。绝对不能把路径 alias 用作数据源 target。
⚠️ 审批内部节点引用记录使用 approval_start；子流程内部节点引用记录使用 sub_trigger。
⚠️ 查询多条记录 (get_multiple) 结果分支判断是否为空，必须先创建 rollup (COUNT) 节点，再在 branch 中判断汇总值 > 0。
请求参数
Authorization
Path 参数
Header 参数
Body 参数application/json必填
示例
{
"nodes": [
{
"nodeAlias": "string",
"nodeId": "string",
"nodeType": "get_single",
"name": "string",
"description": "string",
"prevNode": {
"nodeAlias": "string",
"nodeId": "string"
},
"parentNode": {
"nodeAlias": "string",
"nodeId": "string"
},
"config": {
"worksheetId": "string",
"filter": {
"logic": "and",
"items": [
{}
]
},
"sort": [
{}
],
"ifEmpty": "continue",
"limit": 0,
"fields": [
{
"fieldId": "string",
"op": "set",
"value": {
"kind": "literal",
"value": null,
"node": {
"nodeAlias": "string",
"nodeId": "string"
},
"fieldId": "string"
},
"type": 0,
"require": true,
"hide": true,
"subFields": [
{}
],
"enumDefault": 0,
"allowAddOptions": true,
"richText": true,
"dataSource": "string"
}
],
"target": {
"kind": "record",
"node": {
"nodeAlias": "string",
"nodeId": "string"
}
},
"permanent": true,
"branchType": "condition",
"mode": "firstMatch",
"paths": [
{
"alias": "string",
"name": "string",
"filter": {
"logic": "and",
"items": [
{}
]
},
"result": "pass"
},
{
"alias": "string",
"name": "string",
"filter": {
"logic": "and",
"items": [
{}
]
},
"result": "pass"
}
],
"method": "count",
"fieldId": "string",
"expression": "string",
"precision": 0,
"nullZero": true,
"computeType": "number",
"startTime": {
"kind": "literal",
"value": null,
"node": {
"nodeAlias": "string",
"nodeId": "string"
},
"fieldId": "string"
},
"endTime": {
"kind": "literal",
"value": null,
"node": {
"nodeAlias": "string",
"nodeId": "string"
},
"fieldId": "string"
},
"outputUnit": "Y",
"inputTime": {
"kind": "literal",
"value": null,
"node": {
"nodeAlias": "string",
"nodeId": "string"
},
"fieldId": "string"
},
"offsetExpression": "string",
"duration": {
"value": 0,
"unit": "minute"
},
"time": {
"kind": "literal",
"value": null,
"node": {
"nodeAlias": "string",
"nodeId": "string"
},
"fieldId": "string"
},
"recipients": [
{
"kind": "user",
"userId": "string",
"roleId": "string",
"departmentId": "string",
"includeChildren": true,
"jobId": "string",
"orgRoleId": "string",
"node": {
"nodeAlias": "string",
"nodeId": "string"
},
"fieldId": "string"
}
],
"title": "string",
"content": {
"kind": "literal",
"value": null,
"node": {
"nodeAlias": "string",
"nodeId": "string"
},
"fieldId": "string"
},
"viewId": "string",
"showRecordTitle": true,
"cc": [
{
"kind": "user",
"userId": "string",
"roleId": "string",
"departmentId": "string",
"includeChildren": true,
"jobId": "string",
"orgRoleId": "string",
"node": {
"nodeAlias": "string",
"nodeId": "string"
},
"fieldId": "string"
}
],
"subject": {
"kind": "literal",
"value": null,
"node": {
"nodeAlias": "string",
"nodeId": "string"
},
"fieldId": "string"
},
"body": {
"kind": "literal",
"value": null,
"node": {
"nodeAlias": "string",
"nodeId": "string"
},
"fieldId": "string"
},
"bodyType": "plain",
"attachments": [
{
"name": "string",
"url": "string",
"value": {
"kind": "literal",
"value": null,
"node": {
"nodeAlias": "string",
"nodeId": "string"
},
"fieldId": "string"
}
}
],
"process": {
"mode": "create",
"processId": "string",
"templateProcessId": "string",
"name": "string",
"start": {
"worksheetId": "string",
"processConfig": {},
"updateData": [
{
"fieldId": "string",
"op": "set",
"value": {
"kind": "literal",
"value": null,
"node": {
"nodeAlias": "string",
"nodeId": "string"
},
"fieldId": "string"
},
"type": 0,
"require": true,
"hide": true,
"subFields": [
{}
],
"enumDefault": 0,
"allowAddOptions": true,
"richText": true,
"dataSource": "string"
}
],
"property1": "string",
"property2": "string"
},
"nodes": [
{}
],
"property1": "string",
"property2": "string"
},
"initiators": [
{
"kind": "user",
"userId": "string",
"roleId": "string",
"departmentId": "string",
"includeChildren": true,
"jobId": "string",
"orgRoleId": "string",
"node": {
"nodeAlias": "string",
"nodeId": "string"
},
"fieldId": "string"
}
],
"formProperties": [
{
"fieldId": "string",
"permission": "readonly",
"property": 1,
"type": 0,
"showInCard": true,
"showCard": 0,
"workflow": true,
"allowAdd": "1",
"allowCancel": "1",
"allowEdit": "1",
"allowExport": "1",
"isdecrypt": "1",
"subFormProperties": [
{}
]
}
],
"addNotAllowView": true,
"processConfig": {},
"updateData": [
{
"fieldId": "string",
"op": "set",
"value": {
"kind": "literal",
"value": null,
"node": {
"nodeAlias": "string",
"nodeId": "string"
},
"fieldId": "string"
},
"type": 0,
"require": true,
"hide": true,
"subFields": [
{}
],
"enumDefault": 0,
"allowAddOptions": true,
"richText": true,
"dataSource": "string"
}
],
"approvers": [
{
"kind": "user",
"userId": "string",
"roleId": "string",
"departmentId": "string",
"includeChildren": true,
"jobId": "string",
"orgRoleId": "string",
"node": {
"nodeAlias": "string",
"nodeId": "string"
},
"fieldId": "string"
}
],
"instruction": "string",
"allowReject": true,
"allowTransfer": true,
"allowAddApprover": true,
"returnTo": "string",
"assignee": {
"kind": "user",
"userId": "string",
"roleId": "string",
"departmentId": "string",
"includeChildren": true,
"jobId": "string",
"orgRoleId": "string",
"node": {
"nodeAlias": "string",
"nodeId": "string"
},
"fieldId": "string"
},
"submitText": "string",
"execution": {
"mode": "once",
"continueAfterComplete": true,
"executeAll": true,
"executeAllCount": 0,
"fromTrigger": true
},
"language": "javascript",
"inputs": [
{
"key": "string",
"value": {
"kind": "literal",
"value": null,
"node": {
"nodeAlias": "string",
"nodeId": "string"
},
"fieldId": "string"
}
}
],
"code": "string",
"auto_retry": true,
"outputs": [
{
"name": "string",
"type": "string",
"reference_value": null
}
],
"property1": "string",
"property2": "string"
}
}
]
}请求示例代码
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location 'https://api.mingdao.com/v3/app/workflows//nodes/batch' \
--header 'HAP-Appkey: {{appkey}}' \
--header 'HAP-Sign: {{sign}}' \
--header 'Content-Type: application/json' \
--data '{
"nodes": [
{
"nodeAlias": "string",
"nodeId": "string",
"nodeType": "get_single",
"name": "string",
"description": "string",
"prevNode": {
"nodeAlias": "string",
"nodeId": "string"
},
"parentNode": {
"nodeAlias": "string",
"nodeId": "string"
},
"config": {
"worksheetId": "string",
"filter": {
"logic": "and",
"items": [
{}
]
},
"sort": [
{}
],
"ifEmpty": "continue",
"limit": 0,
"fields": [
{
"fieldId": "string",
"op": "set",
"value": {
"kind": "literal",
"value": null,
"node": {
"nodeAlias": "string",
"nodeId": "string"
},
"fieldId": "string"
},
"type": 0,
"require": true,
"hide": true,
"subFields": [
{}
],
"enumDefault": 0,
"allowAddOptions": true,
"richText": true,
"dataSource": "string"
}
],
"target": {
"kind": "record",
"node": {
"nodeAlias": "string",
"nodeId": "string"
}
},
"permanent": true,
"branchType": "condition",
"mode": "firstMatch",
"paths": [
{
"alias": "string",
"name": "string",
"filter": {
"logic": "and",
"items": [
{}
]
},
"result": "pass"
},
{
"alias": "string",
"name": "string",
"filter": {
"logic": "and",
"items": [
{}
]
},
"result": "pass"
}
],
"method": "count",
"fieldId": "string",
"expression": "string",
"precision": 0,
"nullZero": true,
"computeType": "number",
"startTime": {
"kind": "literal",
"value": null,
"node": {
"nodeAlias": "string",
"nodeId": "string"
},
"fieldId": "string"
},
"endTime": {
"kind": "literal",
"value": null,
"node": {
"nodeAlias": "string",
"nodeId": "string"
},
"fieldId": "string"
},
"outputUnit": "Y",
"inputTime": {
"kind": "literal",
"value": null,
"node": {
"nodeAlias": "string",
"nodeId": "string"
},
"fieldId": "string"
},
"offsetExpression": "string",
"duration": {
"value": 0,
"unit": "minute"
},
"time": {
"kind": "literal",
"value": null,
"node": {
"nodeAlias": "string",
"nodeId": "string"
},
"fieldId": "string"
},
"recipients": [
{
"kind": "user",
"userId": "string",
"roleId": "string",
"departmentId": "string",
"includeChildren": true,
"jobId": "string",
"orgRoleId": "string",
"node": {
"nodeAlias": "string",
"nodeId": "string"
},
"fieldId": "string"
}
],
"title": "string",
"content": {
"kind": "literal",
"value": null,
"node": {
"nodeAlias": "string",
"nodeId": "string"
},
"fieldId": "string"
},
"viewId": "string",
"showRecordTitle": true,
"cc": [
{
"kind": "user",
"userId": "string",
"roleId": "string",
"departmentId": "string",
"includeChildren": true,
"jobId": "string",
"orgRoleId": "string",
"node": {
"nodeAlias": "string",
"nodeId": "string"
},
"fieldId": "string"
}
],
"subject": {
"kind": "literal",
"value": null,
"node": {
"nodeAlias": "string",
"nodeId": "string"
},
"fieldId": "string"
},
"body": {
"kind": "literal",
"value": null,
"node": {
"nodeAlias": "string",
"nodeId": "string"
},
"fieldId": "string"
},
"bodyType": "plain",
"attachments": [
{
"name": "string",
"url": "string",
"value": {
"kind": "literal",
"value": null,
"node": {
"nodeAlias": "string",
"nodeId": "string"
},
"fieldId": "string"
}
}
],
"process": {
"mode": "create",
"processId": "string",
"templateProcessId": "string",
"name": "string",
"start": {
"worksheetId": "string",
"processConfig": {},
"updateData": [
{
"fieldId": "string",
"op": "set",
"value": {
"kind": "literal",
"value": null,
"node": {
"nodeAlias": "string",
"nodeId": "string"
},
"fieldId": "string"
},
"type": 0,
"require": true,
"hide": true,
"subFields": [
{}
],
"enumDefault": 0,
"allowAddOptions": true,
"richText": true,
"dataSource": "string"
}
],
"property1": "string",
"property2": "string"
},
"nodes": [
{}
],
"property1": "string",
"property2": "string"
},
"initiators": [
{
"kind": "user",
"userId": "string",
"roleId": "string",
"departmentId": "string",
"includeChildren": true,
"jobId": "string",
"orgRoleId": "string",
"node": {
"nodeAlias": "string",
"nodeId": "string"
},
"fieldId": "string"
}
],
"formProperties": [
{
"fieldId": "string",
"permission": "readonly",
"property": 1,
"type": 0,
"showInCard": true,
"showCard": 0,
"workflow": true,
"allowAdd": "1",
"allowCancel": "1",
"allowEdit": "1",
"allowExport": "1",
"isdecrypt": "1",
"subFormProperties": [
{}
]
}
],
"addNotAllowView": true,
"processConfig": {},
"updateData": [
{
"fieldId": "string",
"op": "set",
"value": {
"kind": "literal",
"value": null,
"node": {
"nodeAlias": "string",
"nodeId": "string"
},
"fieldId": "string"
},
"type": 0,
"require": true,
"hide": true,
"subFields": [
{}
],
"enumDefault": 0,
"allowAddOptions": true,
"richText": true,
"dataSource": "string"
}
],
"approvers": [
{
"kind": "user",
"userId": "string",
"roleId": "string",
"departmentId": "string",
"includeChildren": true,
"jobId": "string",
"orgRoleId": "string",
"node": {
"nodeAlias": "string",
"nodeId": "string"
},
"fieldId": "string"
}
],
"instruction": "string",
"allowReject": true,
"allowTransfer": true,
"allowAddApprover": true,
"returnTo": "string",
"assignee": {
"kind": "user",
"userId": "string",
"roleId": "string",
"departmentId": "string",
"includeChildren": true,
"jobId": "string",
"orgRoleId": "string",
"node": {
"nodeAlias": "string",
"nodeId": "string"
},
"fieldId": "string"
},
"submitText": "string",
"execution": {
"mode": "once",
"continueAfterComplete": true,
"executeAll": true,
"executeAllCount": 0,
"fromTrigger": true
},
"language": "javascript",
"inputs": [
{
"key": "string",
"value": {
"kind": "literal",
"value": null,
"node": {
"nodeAlias": "string",
"nodeId": "string"
},
"fieldId": "string"
}
}
],
"code": "string",
"auto_retry": true,
"outputs": [
{
"name": "string",
"type": "string",
"reference_value": null
}
],
"property1": "string",
"property2": "string"
}
}
]
}'返回响应
🟢200成功
application/json
Bodyapplication/json
示例
{
"success": true,
"data": {
"createdNodes": [
{
"nodeAlias": "string",
"nodeId": "string",
"nodeType": "string",
"name": "string",
"prevNode": {
"property1": "string",
"property2": "string"
},
"parentNode": {
"property1": "string",
"property2": "string"
},
"config": {
"property1": "string",
"property2": "string"
},
"property1": "string",
"property2": "string"
}
],
"updatedNodes": [
{
"nodeAlias": "string",
"nodeId": "string",
"nodeType": "string",
"name": "string",
"prevNode": {
"property1": "string",
"property2": "string"
},
"parentNode": {
"property1": "string",
"property2": "string"
},
"config": {
"property1": "string",
"property2": "string"
},
"property1": "string",
"property2": "string"
}
],
"property1": "string",
"property2": "string"
},
"error_code": 0,
"error_msg": "string"
}修改于 2026-06-25 10:21:03