# 工作流相关接口
# 查询流程配置
请求方式: POST(HTTPS)
请求地址: https://openapi.waiqin365.com/api/apaas/v1/getWorkFlowConfig/{ openid }/{ timestamp }/{ digest }/{ msg_id }
在线调试
请求示例:
参数说明:
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
flowId | BIGINT | 是 | 流程ID |
响应示例:
{
"return_code": "0",
"return_msg": "success",
"msg_id": "90b4b267dd3d49aeace879038b1e7291",
"response_data": "<<DATA>>"
}
数据DATA示例:
{
"againApprovalStrategy": "1",
"batchApprovalStrategy": "1",
"createTime": "2024-08-15 17:39:20",
"creatorId": "6533427205971799627",
"creatorName": "hujunjie",
"enableStatus": "0",
"flowId": "8666295899038660388",
"flowName": "工作流14",
"modifyTime": "2024-08-15 17:39:19",
"modifyierId": "6533427205971799627",
"modifyierName": "hujunjie",
"nodeConfigs": [
{
"nextNodeId": "6350787240417207215",
"nodeConfig": "{\"displayText\":[{\"valueStyle\":{\"color\":\"#151515\"},\"labelStyle\":{\"color\":\"#808080\"},\"label\":\"触发对象\",\"value\":\"测试对象0730\"},{\"valueStyle\":{\"color\":\"#151515\"},\"labelStyle\":{\"color\":\"#808080\"},\"label\":\"触发动作\",\"value\":\"新增或编辑\"}],\"positionIds\":[],\"triggerCondition\":\"[]\",\"triggerField\":\"[]\",\"typeKey\":\"trigger_data_change\",\"color\":\"#2C93FF\",\"disCondition\":[],\"assignType\":\"0\",\"nodeType\":\"TRIGGER\",\"scheduleTrigger\":false,\"conditionEntity\":[],\"roleIds\":[],\"disObjectName\":\"测试对象0730\",\"objectKey\":\"object_y4hxw__cqadaye\",\"userIds\":[],\"assigned\":false,\"deptIds\":[],\"nextKey\":\"f045701463b94176859dd0cbf6622781\",\"triggerType\":\"1\",\"triggerMode\":\"3\",\"key\":\"64aecf6cdd5249af9183f8aaca6afce2\",\"objectId\":\"7066449500185692296\"}",
"nodeId": "6335323743124701108",
"nodeName": "对象数据变更触发",
"nodeType": "0"
}
],
"releaseStatus": "0",
"remarks": "",
"repeatApprovalStrategy": "2",
"status": "0",
"timeoutRemind": "0",
"timeoutRemindHour": "1",
"timeoutRemindType": "",
"triggerObjectId": 7066449500185692296,
"triggerObjectKey": "object_Y4HxW__c",
"triggerObjectName": "测试对象0730",
"triggerType": "1",
"urgeType": "1",
"withdrawStrategy": "0"
}
异常示例:
{
"return_code": "108",
"return_msg": "流程ID必填",
"msg_id": "90b4b267dd3d49aeace879038b1e7291",
"response_data": null
}
参数说明:
参数 | 类型 | 说明 |
---|---|---|
flowId | VARCHAR(32) | 流程ID |
flowName | VARCHAR(200) | 流程名称 |
manageScope | VARCHAR(32) | 管理范围 |
remarks | VARCHAR(200) | 备注 |
repeatApprovalStrategy | VARCHAR(1) | 重复审批策略 0:未选中 1:相邻审批节点为同一审批人时,仅需审批一次,其余自动通过 2:同一流程内的同一审批人出现多次,仅首次需审批,其余自动通过 |
againApprovalStrategy | VARCHAR(1) | 被打回重新提交策略 0: 被打回节点再次提交时重新处理 1: 被打回节点再次提交时直接回到打回节点 2: 处理人选择被打回重新提交策略 |
triggerType | VARCHAR(1) | 触发类型 1 数据变更触发 2 自定义按钮触发 3 定时触发 4 子流程触发 5 阶段变更触发 |
batchApprovalStrategy | VARCHAR(1) | 批量审批策略 0:未选中 1:禁止批量审批 |
withdrawStrategy | VARCHAR(1) | 发起人撤回策略 0:未选中 1:允许撤回(仅第一个处理节点为人工节点的流程,且在第一个节点处理前可以撤回) |
timeoutRemind | VARCHAR(1) | 超时提醒,0:未选中 1:开启 |
timeoutRemindType | VARCHAR(1) | 超时提醒类型,0:只提醒一次,1:重复提醒 |
timeoutRemindHour | VARCHAR(2) | 超时时间 |
timeoutRemindInterval | VARCHAR(3) | 提醒间隔,重复提醒类型下每次提醒间隔 |
timeoutType | VARCHAR(1) | 超时提醒方式 1 系统消息 2 邮件 |
urgeType | VARCHAR(1) | 催办提醒方式 1 系统消息 2 邮件 |
remindEmail | VARCHAR(32) | 发件邮箱 |
triggerObjectId | VARCHAR(32) | 发起对象id |
triggerObjectKey | VARCHAR(100) | 发起对象key |
triggerObjectName | VARCHAR(100) | 发起对象名称 |
enableStatus | VARCHAR(1) | 启用状态,0:停用,1:启用 |
releaseStatus | VARCHAR(1) | 发布状态,0:未发布,1:已发布 |
status | VARCHAR(1) | 状态 |
nodeConfigs.nodeId | VARCHAR(32) | 节点ID |
nodeConfigs.nodeName | VARCHAR(200) | 节点名称 |
nodeConfigs.nodeType | VARCHAR(1) | 节点类型: 0 触发节点 1 审批节点 2 录入节点 3 新增节点 4 更新节点 5 删除节点 6 获取节点 7 wrap节点 8 条件节点 9 结束节点 10 加签节点 11 函数节点 12 延迟节点 13 运算节点 14 通知节点 15 子流程节点 |
nodeConfigs.nextNodeId | VARCHAR(1) | 下一节点ID |
nodeConfigs.nodeConfig | VARCHAR(1) | 节点配置 |
# 查询流程数据
请求方式: POST(HTTPS)
请求地址: https://openapi.waiqin365.com/api/apaas/v1/queryWorkFlowDatas/{ openid }/{ timestamp }/{ digest }/{ msg_id }
在线调试
请求示例:
参数说明:
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
page | INT | 是 | 页数,默认值为1 |
rows | INT | 是 | 条数,默认值为100 |
flowId | VARCHAR(32) | 否 | 流程ID |
triggerObjectKey | VARCHAR(32) | 否 | 发起对象key |
triggerDateStart | VARCHAR(32) | 否 | 发起时间起,格式:yyyy-MM-dd HH:mm:ss |
triggerDateEnd | VARCHAR(32) | 否 | 发起时间止,格式:yyyy-MM-dd HH:mm:ss |
serialNumber | VARCHAR(32) | 否 | 流水号 |
instanceStatus | VARCHAR(32) | 否 | 流程状态 0 未处理 1 处理中 2 已通过 3 已打回 4 已撤回 5 已否决 6 已作废 7 已删除 |
triggerUserId | TEXT | 否 | 发起人ID,多个值之间用英文逗号分隔 |
triggerDeptId | TEXT | 否 | 发起人部门,多个值之间用英文逗号分隔 |
currExecutorId | TEXT | 否 | 当前处理人ID,多个值之间用英文逗号分隔 |
lastExecutorId | TEXT | 否 | 最近处理人ID,多个值之间用英文逗号分隔 |
lastExecuteDateStart | VARCHAR(32) | 否 | 最近处理时间起,格式:yyyy-MM-dd HH:mm:ss |
lastExecuteDateEnd | VARCHAR(32) | 否 | 最近处理时间止,格式:yyyy-MM-dd HH:mm:ss |
status | VARCHAR(32) | 否 | 删除状态:1:未删除,0:已删除,不传值时默认查询所有数据 |
响应示例:
{
"msg_id":"X000001",
"return_code":0,
"return_msg":"",
"response_data": "<<DATA>>"
}
数据DATA示例:
[
{
"dataLogs": [
{
"executorId": "6533427205971799627",
"executorName": "hujunjie",
"nodeId": "5601364226199953985",
"operatorType": "2",
"opinion": ""
}
],
"flowId": "8262100149438923538",
"flowName": "工作流5",
"flowVersion": "1",
"instanceId": "5511106241304314383",
"lastExecutorId": "6533427205971799627",
"lastExecutorName": "hujunjie",
"serialNumber": "20240830000014",
"status": "1",
"triggerDataId": "8008578630468748927",
"triggerId": "6533427205971799627",
"triggerName": "hujunjie",
"triggerObjectId": "7674206752433877876",
"triggerObjectKey": "bas_cm_customer",
"triggerTime": "2024-08-30 18:45:46"
}
]
异常示例:
{
"msg_id":"X000001",
"return_code":1,
"return_msg":"查询失败!"
}
参数说明:
参数 | 类型 | 说明 |
---|---|---|
instanceId | VARCHAR(32) | 流程数据ID |
status | VARCHAR(32) | 删除状态:1:未删除,0:已删除,不传值时默认查询所有数据 |
triggerObjectKey | VARCHAR(32) | 发起对象key |
triggerObjectId | VARCHAR(32) | 发起对象ID |
triggerObjectName | VARCHAR(200) | 发起对象名称 |
triggerDataId | VARCHAR(32) | 发起对象数据ID |
flowId | VARCHAR(32) | 流程ID |
flowName | VARCHAR(200) | 流程名称 |
flowVersion | VARCHAR(32) | 流程版本 |
serialNumber | VARCHAR(32) | 流水号 |
triggerTime | VARCHAR(32) | 发起时间, 格式: yyyy-MM-dd HH:mm:ss |
triggerId | VARCHAR(32) | 发起人员工ID |
triggerName | VARCHAR(32) | 发起人姓名 |
instanceStatus | VARCHAR(32) | 流程状态: 0 未处理 1 处理中 2 已通过 3 已打回 4 已撤回 5 已否决 6 已作废 7 已删除 |
lastExecuteTime | VARCHAR(32) | 最近处理时间, 格式: yyyy-MM-dd HH:mm:ss |
lastExecutorId | VARCHAR(32) | 最近处理人员工ID |
lastExecutorName | VARCHAR(32) | 最近处理人姓名 |
currNodeId | VARCHAR(32) | 当前步骤节点ID |
currNodeName | VARCHAR(200) | 当前步骤节点名称 |
currExecutorIds | TEXT | 当前处理人员工ID,多个值之间用英文逗号分隔 |
currExecutorNames | TEXT | 当前处理人姓名,多个值之间用英文逗号分隔 |
currData | JSON | 发起对象在工作流的流程数据内的最新数据 |
dataLogs.nodeId | VARCHAR(32) | 审批历程.处理节点ID |
dataLogs.executorId | VARCHAR(32) | 审批历程.处理人员工ID |
dataLogs.executorName | VARCHAR(200) | 审批历程.处理人姓名 |
dataLogs.executeTime | VARCHAR(32) | 审批历程.处理时间 |
dataLogs.operatorType | VARCHAR(32) | 审批历程.处理动作 0 触发 1 通过 2 打回 3 转交 4 加签 5 否决 6 重新执行 7 录入 8 自动执行 9 删除 10 自动跳过 11 延时 12 作废 13 重新提交 14 取回 |
dataLogs.opinion | TEXT | 审批历程.处理意见文本 |
dataLogs.opinionFile | TEXT | 审批历程.处理意见附件 |
dataLogs.opinionSignature | TEXT | 审批历程.签名 |