审批表单详情
接口说明: 获取审批表单详情数据,对应薪人薪事审批详情页面的表单数据。
请求方式:POST(HTTPS)
请求地址:https://api.xinrenxinshi.com/v5/workflow/detail
请求Header:
key | value |
---|---|
access_token | 获取的access_token的实际值 |
Query参数:
key | value |
---|---|
sign | 签名值 |
Body参数:
参数 | 类型 | 必传(Y/N) | 说明 |
---|---|---|---|
sid | Long | Y | 审批id |
timestamp | Long | Y | 请求时间戳(精确到毫秒) |
返回结果:
特殊说明:表单数据的顺序跟界面展示的顺序是一致的。参数 | 类型 | 必传(Y/N) | 说明 |
---|---|---|---|
errcode | Integer | Y | 0成功,其他失败 |
errmsg | String | Y | 操作结果描述 |
data | ProcessFlowInfo | N | 成功时返回 |
ProcessFlowInfo
参数 | 类型 | 必传(Y/N) | 说明 |
---|---|---|---|
processBasicInfo | ProcessBasicInfo | Y | 审批基础数据,详见获取公司审批列表接口 |
processMetaInfoList | List<ProcessFormGroupInfo> | Y | 审批表单数据 |
ProcessFormGroupInfo
参数 | 类型 | 必传(Y/N) | 说明 |
---|---|---|---|
groupName | String | Y | 分组名称 |
detailInfos | List<ProcessFormDetailInfo> | Y | 分组详情数据 |
ProcessFormDetailInfo
参数 | 类型 | 必传(Y/N) | 说明 |
---|---|---|---|
labName | String | N | 标签名 |
value | String | N | 标签值 |
valueId | String | N | 标签值对应的id |
oldValue | String | N | 数值类型标签调整前的值 |
oldValueId | String | N | 数值类型标签调整前的值对应的id |
type | Integer | Y | 字段类型 |
unit | String | N | 数值类型的单位 |
files | List<FlowFileInfo> | N | 文件信息 |
relatedApproves | List<FlowRelateApprove> | N | 关联审批表单 |
startLabName | String | N | 时间区间开始时间标签名 |
startValue | String | N | 时间区间开始时间的标签值 |
endLabName | String | N | 时间区间结束时间标签名 |
endValue | String | N | 时间区间结束时间的标签值 |
longLabName | String | N | 时间区间申请时长的标签名 |
longValue | String | N | 时间区间申请时长的标签值 |
relaxStartLabName | String | N | 双时间区间开始休息的标签名 |
relaxStartValue | String | N | 双时间区间开始休息的标签值 |
relaxEndLabName | String | N | 双时间区间结束休息的标签名 |
relaxEndValue | String | N | 双时间区间结束休息的标签值 |
textListValue | List<String> | N | 文本列表类型返回 |
processFormGroupInfos | List<ProcessFormGroupInfo> | N | 多分组类型返回 |
FlowFileInfo
参数 | 类型 | 必传(Y/N) | 说明 |
---|---|---|---|
name | String | N | 文件名,仅当类型为文件是返回文件名 |
fileKey | String | Y | 文件key |
FlowRelateApprove
参数 | 类型 | 必传(Y/N) | 说明 |
---|---|---|---|
sid | String | Y | 审批id |
title | String | N | 审批标题 |
flowName | String | N | 审批类型名称 |
flowNumber | String | N | 审批编码 |
关于表单类型,详细说明
无特殊说明的类型,标签名通过字段labName字段获取,标签值通过value获取类型 | 名称 | 说明 |
---|---|---|
1 | 单行文本 | |
2 | 多行文本 | |
3 | 数值 | 数值类型的数据,可以设置单位值。单位值通过unit字段获取。 非自定义的数值类型数据,可能存在调整前的值,通过字段uldValue获取。例如:工资 |
4 | 日期区间 | 一般包含三个标签:开始时间、结束时间、申请天数 开始时间
其中HH:mm:ss只有两个值,00:00:00表示上半天,12:00:00表示下半天 |
5 | 日期 | 日期格式有两种:
|
6 | 单选框 | |
7 | 多选框 | 多个值逗号分隔 |
8 | 图片文件 | 通过files字段获取文件信息,图片类型的文件,不会返回文件名 |
9 | 说明文字 | |
10 | 系统资源字段 | 系统资源字段指的是,员工的属性信息字段。 |
11 | 文件附件 | 通过files字段获取文件信息 |
12 | 地图 | 外勤打卡使用到了这个字段。value为经纬度坐标值,逗号分隔的。 |
13 | 此项无需关心 | |
14 | 两个时间区间 | 在时间区间的基础上,增加了开始休息时间和结束休息时间标签 开始休息时间
此类型的时间都有具体的时间,例如:2019-09-21 09:28 |
15 | 文本列表 | 调店审批用到了这个字段 |
20 | 关联审批表单 | 通过relatedApproves字段获取到关联审批表单的信息 |
21 | 补卡 | 上下班补卡信息 |
22 | 金额 | 金额 |
25 | 多分组类型 | 审批套件里多分组字段 |
26 | 定位 | 文本信息 |
请求示例(HTTPS):
https://api.xinrenxinshi.com/v5/workflow/detail?sign=MvEIky%2Fjxk0x4Sot%2BNEjFXztnV8%3D
请求Body示例:
{
"sid": 687268620463636480,
"timestamp": 1606299018727
}
SDK请求示例(java):
ApprovalDetailRequest request = new ApprovalDetailRequest(access_token);
request.setSid(687268620463636480L);
OpenapiResponse<ProcessFlowInfo> flowDetail = XrxsApprovalService.getFlowDetail(request);
响应示例:
{
"errcode": 0,
"errmsg": "成功",
"data": {
"processBasicInfo": {
"sid": 687268620463636480,
"ownerId": "927251764aa64f9c8f14678bd4b35e1b",
"ownerName": "测试12",
"sponsorId": "927251764aa64f9c8f14678bd4b35e1b",
"sponsorType": 0,
"sponsorName": "测试12",
"sponsorMobile": "19400009090",
"sponsorJobNumber": "03120033",
"sponsorEmployeeId": "927251764aa64f9c8f14678bd4b35e1b",
"departmentId":"0f9ad12e06c34eab83b9a6ca568e88ac",
"departmentName":"开发部门",
"departmentCode": "开发部门",
"jobCode": "12222",
"jobId": "2fb2126317424f04b233efa262d3ee13",
"jobName": "架构师",
"flowTypeId": 16,
"flowTypeName": "出差",
"remark": null,
"status": 0,
"confirmDate": null,
"addtime": 1627531207,
"modtime": 1627531207,
"lastStepModtime": 1627531207,
"flowNumber": "202107291200000007",
"setting": {
"remarkRequired": 0
}
},
"processMetaInfoList": [
{
"groupName": "基本信息",
"detailInfos": [
{
"labName": "发起人",
"value": "测试12",
"valueId": null,
"oldValue": null,
"type": 1,
"unit": "",
"files": null,
"relatedApproves": null,
"startLabName": null,
"startValue": null,
"endLabName": null,
"endValue": null,
"longLabName": null,
"longValue": null,
"relaxStartLabName": null,
"relaxStartValue": null,
"relaxEndLabName": null,
"relaxEndValue": null,
"textListValue": null
},
{
"labName": "性别",
"value": "女",
"valueId": null,
"oldValue": null,
"type": 1,
"unit": "",
"files": null,
"relatedApproves": null,
"startLabName": null,
"startValue": null,
"endLabName": null,
"endValue": null,
"longLabName": null,
"longValue": null,
"relaxStartLabName": null,
"relaxStartValue": null,
"relaxEndLabName": null,
"relaxEndValue": null,
"textListValue": null
},
{
"labName": "部门",
"value": "开发部门",
"valueId": null,
"oldValue": null,
"type": 1,
"unit": null,
"files": null,
"relatedApproves": null,
"startLabName": null,
"startValue": null,
"endLabName": null,
"endValue": null,
"longLabName": null,
"longValue": null,
"relaxStartLabName": null,
"relaxStartValue": null,
"relaxEndLabName": null,
"relaxEndValue": null,
"textListValue": null
},
{
"labName": "岗位",
"value": "",
"valueId": null,
"oldValue": null,
"type": 1,
"unit": null,
"files": null,
"relatedApproves": null,
"startLabName": null,
"startValue": null,
"endLabName": null,
"endValue": null,
"longLabName": null,
"longValue": null,
"relaxStartLabName": null,
"relaxStartValue": null,
"relaxEndLabName": null,
"relaxEndValue": null,
"textListValue": null
},
{
"labName": "入职时间",
"value": "2020-03-01",
"valueId": null,
"oldValue": null,
"type": 1,
"unit": null,
"files": null,
"relatedApproves": null,
"startLabName": null,
"startValue": null,
"endLabName": null,
"endValue": null,
"longLabName": null,
"longValue": null,
"relaxStartLabName": null,
"relaxStartValue": null,
"relaxEndLabName": null,
"relaxEndValue": null,
"textListValue": null
}
]
},
{
"groupName": "申请详情",
"detailInfos": [
{
"labName": "申请类型",
"value": "出差",
"valueId": null,
"oldValue": null,
"type": 1,
"unit": null,
"files": null,
"relatedApproves": null,
"startLabName": null,
"startValue": null,
"endLabName": null,
"endValue": null,
"longLabName": null,
"longValue": null,
"relaxStartLabName": null,
"relaxStartValue": null,
"relaxEndLabName": null,
"relaxEndValue": null,
"textListValue": null
},
{
"labName": null,
"value": null,
"valueId": null,
"oldValue": null,
"type": 4,
"unit": null,
"files": null,
"relatedApproves": null,
"startLabName": "开始时间",
"startValue": "2021-08-01 上半天",
"endLabName": "结束时间",
"endValue": "2021-08-01 上半天",
"longLabName": "申请天数",
"longValue": "0.5天(共计0.0天工作日)",
"relaxStartLabName": null,
"relaxStartValue": null,
"relaxEndLabName": null,
"relaxEndValue": null,
"textListValue": null
},
{
"labName": "申请事由",
"value": "",
"valueId": null,
"oldValue": null,
"type": 2,
"unit": null,
"files": null,
"relatedApproves": null,
"startLabName": null,
"startValue": null,
"endLabName": null,
"endValue": null,
"longLabName": null,
"longValue": null,
"relaxStartLabName": null,
"relaxStartValue": null,
"relaxEndLabName": null,
"relaxEndValue": null,
"textListValue": null
}
]
},
{
"groupName": "出差详情",
"detailInfos": [
{
"labName": "目的地",
"value": "武汉",
"valueId": null,
"oldValue": null,
"type": 1,
"unit": null,
"files": null,
"relatedApproves": null,
"startLabName": null,
"startValue": null,
"endLabName": null,
"endValue": null,
"longLabName": null,
"longValue": null,
"relaxStartLabName": null,
"relaxStartValue": null,
"relaxEndLabName": null,
"relaxEndValue": null,
"textListValue": null
},
{
"labName": "交通工具",
"value": "火车",
"valueId": null,
"oldValue": null,
"type": 6,
"unit": null,
"files": null,
"relatedApproves": null,
"startLabName": null,
"startValue": null,
"endLabName": null,
"endValue": null,
"longLabName": null,
"longValue": null,
"relaxStartLabName": null,
"relaxStartValue": null,
"relaxEndLabName": null,
"relaxEndValue": null,
"textListValue": null
},
{
"labName": "预算",
"value": "2000.00",
"valueId": null,
"oldValue": null,
"type": 3,
"unit": "元",
"files": null,
"relatedApproves": null,
"startLabName": null,
"startValue": null,
"endLabName": null,
"endValue": null,
"longLabName": null,
"longValue": null,
"relaxStartLabName": null,
"relaxStartValue": null,
"relaxEndLabName": null,
"relaxEndValue": null,
"textListValue": null
},
{
"labName": "备注",
"value": "",
"valueId": null,
"oldValue": null,
"type": 1,
"unit": null,
"files": null,
"relatedApproves": null,
"startLabName": null,
"startValue": null,
"endLabName": null,
"endValue": null,
"longLabName": null,
"longValue": null,
"relaxStartLabName": null,
"relaxStartValue": null,
"relaxEndLabName": null,
"relaxEndValue": null,
"textListValue": null
},
{
"labName": "图片",
"value": null,
"valueId": null,
"oldValue": null,
"type": 8,
"unit": null,
"files": [
],
"relatedApproves": null,
"startLabName": null,
"startValue": null,
"endLabName": null,
"endValue": null,
"longLabName": null,
"longValue": null,
"relaxStartLabName": null,
"relaxStartValue": null,
"relaxEndLabName": null,
"relaxEndValue": null,
"textListValue": null
}
]
},
{
"groupName": "新增分组1",
"detailInfos": [
{
"labName": "同行人",
"value": "测试入职延迟",
"valueId": "bf5172bf235c4056b7c6378a1f6bcc29",
"oldValue": null,
"type": 6,
"unit": null,
"files": null,
"relatedApproves": null,
"startLabName": null,
"startValue": null,
"endLabName": null,
"endValue": null,
"longLabName": null,
"longValue": null,
"relaxStartLabName": null,
"relaxStartValue": null,
"relaxEndLabName": null,
"relaxEndValue": null,
"textListValue": null
},
{
"labName": "多选员工",
"value": "测试,测试,测试12",
"valueId": "9825565fc6044b03b6597e45f1e5a78c,9657b238b178407f827b679e4d262e0d,2ed0e4bb433b4b23b39c48ccf4c6acec",
"oldValue": null,
"type": 7,
"unit": null,
"files": null,
"relatedApproves": null,
"startLabName": null,
"startValue": null,
"endLabName": null,
"endValue": null,
"longLabName": null,
"longValue": null,
"relaxStartLabName": null,
"relaxStartValue": null,
"relaxEndLabName": null,
"relaxEndValue": null,
"textListValue": null
},
{
"labName": "自选部门",
"value": "开发部门/开发2/测试创2部门,测试推送部门",
"valueId": "59457fcf651f45db9853b3e8cc92332a,e679cc19d3444f1b953bca5f91371928",
"oldValue": null,
"type": 7,
"unit": null,
"files": null,
"relatedApproves": null,
"startLabName": null,
"startValue": null,
"endLabName": null,
"endValue": null,
"longLabName": null,
"longValue": null,
"relaxStartLabName": null,
"relaxStartValue": null,
"relaxEndLabName": null,
"relaxEndValue": null,
"textListValue": null
},
{
"labName": "关联审批单",
"value": null,
"valueId": null,
"oldValue": null,
"type": 20,
"unit": null,
"files": null,
"relatedApproves": [
{
"sid": "687248528833118208",
"title": "出差0.5天(出差)",
"flowName": "出差",
"flowNumber": "202107291040000015"
},
{
"sid": "687246432918437889",
"title": "出差1.0天(出差)",
"flowName": "出差",
"flowNumber": "202107291031000050"
}
],
"startLabName": null,
"startValue": null,
"endLabName": null,
"endValue": null,
"longLabName": null,
"longValue": null,
"relaxStartLabName": null,
"relaxStartValue": null,
"relaxEndLabName": null,
"relaxEndValue": null,
"textListValue": null
}
]
},
{
"groupName": "新增分组2",
"detailInfos": [
{
"labName": "出发地",
"value": "河北省石家庄",
"valueId": "101",
"oldValue": null,
"type": 6,
"unit": null,
"files": null,
"relatedApproves": null,
"startLabName": null,
"startValue": null,
"endLabName": null,
"endValue": null,
"longLabName": null,
"longValue": null,
"relaxStartLabName": null,
"relaxStartValue": null,
"relaxEndLabName": null,
"relaxEndValue": null,
"textListValue": null
}
]
},
{
"groupName": "新增分组2",
"detailInfos": [
{
"labName": "姓名",
"oldValue": "xxx",
"type": 1,
"value": "xxx"
},
{
"labName": "教育经历明细分组",
"processFormGroupInfos": [
{
"groupName": "教育经历",
"detailInfos": [
{
"labName": "毕业院校",
"oldValue": "",
"type": 1,
"value": "11"
},
{
"labName": "专业",
"oldValue": "",
"type": 1,
"value": "1"
},
{
"labName": "学历",
"oldValue": "",
"type": 6,
"value": "小学",
"valueId": "9"
},
{
"labName": "教学方式",
"oldValue": "",
"type": 6,
"value": "",
"valueId": ""
},
{
"labName": "入学时间",
"oldValue": "",
"type": 5,
"value": ""
},
{
"labName": "毕业时间",
"oldValue": "",
"type": 5,
"value": ""
},
{
"labName": "是否最高学历",
"oldValue": "",
"type": 6,
"value": "否",
"valueId": "0"
}
]
}
]
}
]
},
{
"groupName": "新增分组2",
"detailInfos": [
{
"labName": "新增图片",
"type": 8,
"files": [
{
"fileKey": "https://files.xinrenxinshi.com/site/download?ptoken=0acc0323183425aefea03ebe404e71898fef18b8f8cb32953aef35fb.png"
},
{
"fileKey": "https://files.xinrenxinshi.com/site/download?ptoken=00c4b596853ba59ea79ffeebe4a410049f55325c18540616f5e2fe08.png"
}
]
},
{
"labName": "新增附件",
"type": 11,
"files": [
{
"name": "测试文件.pptx",
"fileKey": "eegm06sOoO7IjRg29dfX4GFjZTA3NzZiMzJjYzM4ZGIyMmE5MTJlODhlZmJiZjE2MTg4NWEyN2MyMDhlZGIwNDdmNzI4ODcyMWI1ODM3NTYOa0IvYoHAvs1NZRYPtyHubkv8kiJcD4LsuOOQiXTB64/2jEwUpc3Olhl2wM4BkSDEflYSgnfMvPmcxxq5FOLnCQSNs6bImf37uvK7PkK4c37UHY6BDPH7kKeuvSye71Jjpfmq44MbxQo/SOgG6uEkw8qUO1iZiFYv6NUnYNyA=="
},
{
"name": "转换器.png",
"fileKey": "rr9F1CAPsnL73lY9ra7p6WM1MTYzMmY1MDViZTY5Zjk2OWVhOTU2MDA1NTg0MjliNWY5ZGEwYzBlODZkODJmZmMzYjA0ODk5OWM4MDZkN2bag3gW5/8vdfc8w6HXyQDogsZzpSRanDOKgbOWLRc6wZw0xsw4f7uKSsuc3LJsYgx7S+WBWHZPlXSVIIzay8BNyyjz8FXYjbrSXtmUyt61b1OZhn0yi3pJoB35r8c/lZmzTME3dWo/YJna3i6bxfReev7HtGLbEmWkg2j14QCQ=="
}
]
}
]
}
]
}
}