开发前必读
概述
开发者使用指南
开发者使用流程
通信说明
开发者工具
更新日志
基础能力接口
获取token接口
外部系统单点登录
单点登录使用说明
获取单点登录用户信息
通讯录管理
获取部门列表
新增部门
修改部门
删除部门
新增用户
修改用户
删除用户
获取用户列表
通讯录变更同步
获取标签信息
新增标签
修改标签
删除标签
获取标签成员列表
添加标签成员
删除标签成员
按部门查询标签
按用户查询标签
离职用户
获取离职信息
用户复职
获取自定列表信息
第三方消息推送
推送文本消息
推送图文消息
推送消息附录
统一消息推送(回调)
图片附件上传
图片附件下载
图片附件单个下载
图片附件批量下载
应用数据接口
表单流程/七巧
新增表单
获取表单模板信息
推送数据
修改表单数据
删除表单数据
数据源
数据回调
导出表单流程数据
获取填写情况详细数据(新)
通过ID获取填写详细数据(新)
流程干预
获取填写情况详细数据(旧)
通过ID获取填写详细数据(旧)
获取应用填写详细数据(待办、已办等)
发票识别接口
发票验真接口
附录
考勤打卡
获取考勤规则列表
获取考勤详细信息
获取考勤日报信息
注册考勤服务
新增虚拟考勤机
删除虚拟考勤机
考勤机打卡
获取考勤排班明细
获取考勤异常申诉记录
请假出差
获取请假信息列表
获取请假类型列表
假期管理
获取请假详情信息
新闻公告
获取新闻动态类型
新增新闻动态
获取新闻列表
获取新闻详情
获取个人新闻列表
费控报销
获取报销信息列表
获取成本中心信息列表
导入成本中心
获取预算明细
获取发票信息列表
获取借款信息列表
获取用户可见范围内成本中心
获取用户可见范围内科目
获取超额预算
费控预算操作
企业用车
获取车辆申请列表
任务分派
获取任务分派信息列表
获取任务类型信息接口
新建任务接口
移动CRM
获取客户信息列表
获取客户字段
新增客户
更新客户
获取客户详情
获取客户类别
获取所有公海池
获取所有行业信息
获取联系人信息列表
获取联系人字段
新增联系人
更新联系人
获取联系人详情
获取商机信息列表
获取商机字段
新增商机
更新商机
获取商机详情
获取商机阶段或商机类型
修改商机阶段
获取拜访信息列表
获取合同信息列表
获取合同字段
新增合同
更新合同
获取合同详情
获取公海池客户信息列表
获取公海池客户详情
培训考试
获取考试成绩列表
获取考试统计信息列表
获取考试人员明细
获取学习统计信息列表
获取个人学习档案信息列表
获取课程统计信息列表
获取课程人员明细
获取个人学分明细
获取讲师信息列表
获取题库试题明细
新增题库试题
删除题库试题
移动外勤
获取签到信息列表
会议管家
获取会议详情
获取会议纪要详情
获取会议室详情
获取区域列表
获取会议室列表
获取会议详情列表

通过ID获取填写详细数据(新)

开发说明

功能说明:通过work工单明细id,获取明细以下数据
1,获取字段值
2,获取评论
3,获取审批记录
4,获取审批节点信息
5,获取节点当前负责人信息

  • 一次请求work工单明细id支持最多500个。

请求方式:GET(HTTPS)
请求地址:https://qwif.do1.com.cn/qwcgi/api/apiForm/getFormDetail.do?token=token&corpId=corpId&id=id&toSearchCommentAndAudit=true

请求参数说明:

参数名

释义

类型

是否必须

备注

token

用于验证

String

参考获取token接口

corpId

公司唯一标识

String

id

form表单id

String

ids work工单明细id列表

String


toSearchCommentAndAudit
是否查询评论、审批记录、审批节点信息、节点当前负责人信息

Boolean



SDK调用示例:

		FormApi api = QwSdkUtil.getInter(FormApi.class);
		// 调用接口
		DetailGetFromsVO formData = api.getFormDetail(QwSdkUtil.getCacheToken(),
				//表单id
				"work工单id",
				// work工单明细id列表
				new String[]{"work工单id1","work工单id2"},
				// 是否查询评论
				true);
		System.out.println(JSONUtil.stringify(formData));
		

返回结果:

{
  "code": "0",
  "desc": "成功",
  "data": {
    "details": [
      {
        "approvers": "当前负责人列表",
        "approversMap": null,
        "auditStatusStr": "",
        "closePerson": "最后处理人userId",
        "closePersonName": "",
        "closeReason": "",
        "closeTime": "2022-06-08 10:25:56",
        "commentNum": 0,
        "content": "",
        "createaTime": "2022-06-08 10:25:52",
        "creator": "提单人userId",
        "currentNode": "节点1",
        "currentNodeId": "当前节点",
        "data": {
          "fo单行文字字段id": "单行文字",
          "fo手机号码字段id": "13000000000",
          "fo电话字段id": "02000000000",
          "fo邮箱字段id": "chenhandong@do1.com.cn",
          "fo单项选择字段id": "其他:其他选项",
          "fo多项选择字段id": [
            "其他:其他选项"
          ],
          "fo两级下拉框字段id": "选项1:二级选项1",
          "fo地理位置字段id": {
            "latitude": 39.916527,
            "longitude": 116.397125,
            "value": "北京市"
          },
          "fo省市区字段id": "北京市:北京市:东城区",
          "fo多行文字id": "多行文本",
          "fo日期字段id": "2022-06-08",
          "fo时间字段id": "10:21",
          "fo日期时间字段id": "2022-06-08 10:21",
          "fo评分字段id": "9",
          "fo图片字段id": [
            "图片相对路径"
          ],
          "fo子表单字段id": [
            {
              "fo子字段计算式字段id": "2.00",
              "fo子字段图片字段id": [
                "图片相对路径"
              ],
              "fo子字段单行文字字段id": "子字段单行文字",
              "fo子字段数字字段id": "1.00",
              "fo子字段数字2字段id": "2"
            }
          ],
          "fo统计字段id": "2.00",
          "fo数字字段id": "6.00",
          "fo计算式字段id": "8.00",
          "fo生成二维码字段id": "二维码详情地址",
          "fo数据源字段id": [
            {
              "name": "北京市",
              "id": 110000,
              "parentid": 100000
            },
            {
              "name": "北京市",
              "id": 110100,
              "parentid": 110000
            },
            {
              "name": "东城区",
              "id": 110101,
              "parentid": 110100
            }
          ],
          "fo通讯录成员字段id": [
            "userId_姓名"
          ],
          "fo部门字段id": [
            "部门id_部门名称"
          ],
          "fo流水号字段id": "0007"
        },
        "definitionId": "defn版本id",
        "departmentName": "",
        "deptFullName": "提单人部门全称",
        "id": "workd工单明细id",
        "instanceTitle": "明细标题",
        "isAlreadyAdd": 0,
        "isAnonymous": 1,
        "isClose": 0,
        "isFree": "",
        "isTask": "",
        "isover": "2",
        "openId": "",
        "orderVersion": 0,
        "orgId": "",
        "personName": "匿名",
        "status": 1,
        "title": "",
        "versions": 0,
        "wxNickname": "",
        "wxUserId": "不可见",
        "comments": [
          {
            "content": "评论内容",
            "createaTime": "2022-06-08 10:26:09",
            "creator": "评论人userId",
            "personName": "匿名",
            "status": 2,
            "time": "刚刚",
            "type": "1",
            "wxUserId": "不可见"
          }
        ],
        "auditSerial": [
          {
            "auditOpinion": "",
            "auditTime": "2022-06-08 10:25:53",
            "buttonCopyWriter": "提单",
            "handleAccounts": "匿名",
            "index": 1,
            "nodeName": "提交",
            "nodeType": ""
          }
        ],
        "flowDetail": {
          "batchApproval": 0,
          "flowTemplates": [
            {
              "flowName": "流程名称",
              "id": "2df7ddad-559c-49c1-9b6d-28049b152f43",
              "creator": "创建人账号",
              "createTime": "2021-05-01 10:41:34",
              "nodes": [
                {
                  "handleAccounts": "9e059abc483f41b4b84dbca8549c285b",
                  "id": "a4fd6eb5-11b9-4020-a36a-0f7648c45cbb",
                  "nodeName": "填写表单",
                  "nodeStatus": "0",
                  "todoInfoList": []
                },
                {
                  "handleAccounts": "9e059abc483f41b4b84dbca8549c285b",
                  "id": "826680c5-af25-4f9f-8391-e4204b6db9cf",
                  "nodeName": "节点1",
                  "nodeStatus": "1",
                  "todoInfoList": [
                    {
                      "createTime": "2021-05-24 10:41:34",
                      "departmentId": "",
                      "departmentName": "",
                      "headPic": "",
                      "personName": "当前负责人姓名",
                      "userId": "当前负责人userId",
                      "wxUserId": ""
                    }
                  ]
                },
                {
                  "handleAccounts": "9e059abc483f41b4b84dbca8549c285b",
                  "id": "ce3632f7-6151-4856-8dae-8ebf5ca70dd1",
                  "nodeName": "结束节点",
                  "nodeStatus": "2",
                  "todoInfoList": []
                }
              ]
            }
          ],
          "isOrderAudit": 0
        }
      }
    ]
  }
}

返回参数说明:

参数名 释义 类型 是否必须 描述
details

字段值

TBFormWorkOrderVO 包含自定义字段

TBFormWorkOrderVO类型说明:

参考获取填写情况详细数据(新)接口的返回参数说明

额外提供以下字段
参数名 释义 类型 是否必须 描述
auditSerial

审批日志

AuditLogVO[]
comments

评论列表

FormCommentVO[]
flowDetail

流程明细

FlowDetailVO

FormComment类型说明:
参数名 释义 类型 是否必须 描述
content 评论内容 String
creator 评论人userId String
createaTime 评论时间 String
type 评论类型,1:正常 String
personName 评论人姓名 String
headPic 评论人头像 String
picUrl 评论图片url String
fileName 评论附件名 String
wxUserId 评论人账号 String
AuditLogVO类型说明:
参数名 释义 类型 是否必须 描述
index 序号 Integer
nodeName 节点名称 String
handleAccounts 处理人 String
auditTime 处理时间 String
auditOpinion 处理意见 String
nodeType 类型 String
buttonCopyWriter 自定义按钮文案 String
FlowDetailVO类型说明:
参数名 释义 类型 是否必须 描述
isOrderAudit 是否启用顺序审批 Integer 0:否,1:是
batchApproval 是否启用批量处理 Integer 0:否,1:是
flowTemplates 流程信息 FlowTemplate[]
FlowTemplate类型说明:
参数名 释义 类型 是否必须 描述
id 流程id String
flowName 流程名称 String
creator 创建人账号 String
createTime 创建时间 Date
nodes 流程节点信息 FlowNode[]
FlowNode类型说明:
参数名 释义 类型 是否必须 描述
id 节点id String
nodeName 节点名称 String
handleAccounts 节点处理人 String 返回节点处理人id,多个用英文"|"隔开
nodeStatus 节点类型 String 0:开始节点,1:普通节点,2:结束节点,3:并行开始节点,4:并行中间节点,5:并行结束节点,6:外部节点
todoInfoList 当前负责人 TodoInfo[]
TodoInfo类型说明:
参数名 释义 类型 是否必须 描述
userId 当前负责人userId String
personName 当前负责人姓名 String
wxUserId 当前负责人账号 String
headPic 当前负责人头像 String
departmentId 当前负责人部门id String
departmentName 当前负责人部门名称 String
createTime 创建时间 String