TIP

# 工作流相关接口

# 查询流程配置

请求方式： POST（HTTPS）
请求地址： https://openapi.qince.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 阶段变更触发 6 按日期触发
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 子流程节点 17并行节点 20抄送节点
nodeConfigs.nextNodeId	VARCHAR(1)	下一节点ID
nodeConfigs.nodeConfig	VARCHAR(1)	节点配置

# 查询流程数据

请求方式： POST（HTTPS）
请求地址： https://openapi.qince.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",
  "flowTags": "1,2"
}

说明：本示例仅供参考，具体以参数说明为准。

参数说明：

参数	类型	必填	说明
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：已删除，不传值时默认查询所有数据
flowTags	VARCHAR(32)	否	非必填，一个都不传默认不过滤，支持按枚举值传入多个值，多个值用英文逗号分隔，传入后过滤流程数据

响应示例：

{
    "msg_id":"X000001",
    "return_code":0,
    "return_msg":"",
    "response_data": "<<DATA>>"
}

数据DATA示例:

[
    {
        "dataLogs": [
            {
                "executorId": "6533427205971799627",
                "executorName": "hujunjie",
                "nodeId": "5601364226199953985",
                "nodeName": "对象数据变更触发",
                "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",
        "flowTags": "1"
    }
]

异常示例：

{
    "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)	流程名称
flowTags	VARCHAR(200)	流程标签:1超时2自动执行失败3处理人异常
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.nodeName	VARCHAR(32)	处理历程.处理节点名称
dataLogs.executorId	VARCHAR(32)	处理历程.处理人员工ID
dataLogs.executorName	VARCHAR(200)	处理历程.处理人姓名
dataLogs.agentId	VARCHAR(32)	处理历程.代理人员工ID
dataLogs.agentName	VARCHAR(200)	处理历程.代理人姓名
dataLogs.executeTime	VARCHAR(32)	处理历程.处理时间
dataLogs.operatorType	VARCHAR(32)	处理历程.处理动作（作废，建议使用dataLogs.operatorShowType字段） 0 触发 1 通过 2 打回 3 转交 4 加签 5 否决 6 重新执行 7 录入 8 自动执行 9 删除 10 自动跳过 11 延时 12 作废 13 重新提交 14 取回 15 更新数据 16 消息通知 17 执行失败 18 否决后字段变更执行失败 19 否决后消息通知执行失败
dataLogs.operatorShowType	VARCHAR(32)	处理历程.处理动作 1：触发 2：同意 3：子流程 4：打回 5：转交 6：加签 7：否决 8：重新执行 9：录入 10：删除 11：新增数据 12：更新数据 13：删除数据 14：获取数据 15：函数 16：运算公式 17：消息通知 18：自动跳过 19：延时 20：作废 21：打回重新提交 22：取回 23：更新数据 24：消息通知 25：执行失败 26：否决后字段变更执行失败 27：否决后消息通知执行失败 28:抄送
dataLogs.opinion	TEXT	处理历程.处理意见文本
dataLogs.opinionFile	TEXT	处理历程.处理意见附件
dataLogs.opinionSignature	TEXT	处理历程.签名

← 合作伙伴 aPaaS数据推送 →