# 工作流相关接口

# 查询流程配置

请求方式: POST(HTTPS
请求地址: https://openapi.waiqin365.com/api/apaas/v1/getWorkFlowConfig/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例:

{
    "flowId":"8666295899038660388"
}
说明: 本示例仅供参考,具体以参数说明为准。

参数说明:

参数 类型 必填 说明
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": 0,
  "rows": 0,
  "flowId": 0,
  "triggerObjectKey": "triggerObjectKey_1fb27ed43ce2",
  "triggerDateStart": "2024-09-06 11:01:03",
  "triggerDateEnd": "2024-09-06 11:01:03",
  "serialNumber": "serialNumber_b7e90157348b",
  "instanceStatus": "instanceStatus_f77714464f25",
  "triggerUserId": "triggerUserId_22189789e9f5",
  "triggerDeptId": "triggerDeptId_f038c8ac4a70",
  "currExecutorId": "currExecutorId_82ea02c6d599",
  "lastExecutorId": "lastExecutorId_e9f0f59880ff",
  "lastExecuteDateStart": "2024-09-06 11:01:03",
  "lastExecuteDateEnd": "2024-09-06 11:01:03",
  "status": "status_6c6b5bdf042d"
}
说明: 本示例仅供参考,具体以参数说明为准。

参数说明:

参数 类型 必填 说明
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 审批历程.签名