API开发文档 - 道一云

开发说明

开发说明

功能说明：通过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	否

FormCommentVO类型说明：

参数名	释义	类型	是否必须	描述
content	评论内容	String	否
creator	评论人userId	String	否
createaTime	评论时间	String	否
personName	评论人姓名	String	否
headPic	评论人头像	String	否
picNum	评论图片数量	Integer	否
fileNum	评论附件数量	Integer	否
picList	评论中的图片数组	TbFileMediaVO[]	否
fileList	评论中的附件数组	TbFileMediaVO[]	否
picUrl	评论图片相对路径url	String	否	多个图片英文逗号隔开
fileName	评论附件名	String	否	多个附件英文逗号隔开
wxUserId	评论人账号	String	否

TbFileMediaVO类型说明：

参数名	释义	类型	是否必须	描述
id	附件id	String	否
mediaId	附件媒体id	String	否
type	附件类型	String	否	image:图片;voice:语音;video:视频;file:普通文件
sourceType	上传来源	Integer	否	1:后台；2:手机用户
url	文件相对路径地址	String	否
fileName	文件名	String	否
fileExt	文件扩展名	String	否
fileSizeStr	文件大小，文本表示。如：1.45 M	String	否
fileSize	文件大小	Long	否
createTime	上传时间	String	否
createPerson	上传人userId	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	否

企业微信

通过ID获取填写详细数据（新）

开发说明