审批表单详情

接口说明: 获取审批表单详情数据,对应薪人薪事审批详情页面的表单数据。

请求方式: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 日期区间 一般包含三个标签:开始时间、结束时间、申请天数
开始时间
  • startLabName
  • startValue
结束时间
  • endLabName
  • endValue
申请天数
  • longLabName
  • longValue
时间格式为:yyyy-MM-dd HH:mm:ss
其中HH:mm:ss只有两个值,00:00:00表示上半天,12:00:00表示下半天
5 日期 日期格式有两种:
  • yyyy-MM-dd
  • yyyy-MM-dd HH:mm
6 单选框
7 多选框 多个值逗号分隔
8 图片文件 通过files字段获取文件信息,图片类型的文件,不会返回文件名
9 说明文字
10 系统资源字段 系统资源字段指的是,员工的属性信息字段。
11 文件附件 通过files字段获取文件信息
12 地图 外勤打卡使用到了这个字段。value为经纬度坐标值,逗号分隔的。
13 此项无需关心
14 两个时间区间
在时间区间的基础上,增加了开始休息时间和结束休息时间标签
开始休息时间
  • relaxStartLabName
  • relaxStartValue
结束休息时间
  • relaxEndLabName
  • relaxEndValue
时间格式:yyyy-MM-dd HH:mm
此类型的时间都有具体的时间,例如: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=="
              }
            ]
          }
        ]
      }
    ]
  }
}
2024 © 企家有道网络技术(北京)有限公司版权所有@京ICP备15035315号 all right reserved,powered by Gitbookupdate by: 2024-05-08 11:44:51

results matching ""

    No results matching ""