功能说明：集成时用户跳过创建接口，只采用道一云管理后台进行表单管理，需获取字段id与字段名称、流程节点信息等在外部系统进行映射，可以采用此接口。
请求方式：POST（HTTPS）multipart/form-data
请求地址：https://qwif.do1.com.cn/qwcgi/api/apiForm/ajaxGetFormFieldInfoSimple.do?token=token&corpId=corpId&id=id
| 参数名 | 释义 | 类型 | 是否必须 | 描述 |
|---|---|---|---|---|
|
token |
用于验证 |
String |
是 | |
|
corpId |
公司唯一标识 |
String |
是 | |
|
id |
form表单id |
String |
是 | |
|
definitionId |
defn版本id | String | 否 |
|
|
queryFlow | 是否查询流程信息 |
Boolean | 否 |
|
FormApi api = QwSdkUtil.getInter(FormApi.class); // 调用接口 FormFieldInfoSimpleResultVO result = api.ajaxGetFormFieldInfoSimple(QwSdkUtil.getCacheToken(), // 表单id "form表单id", "defn表单版本id", // 查询模版流程信息 true); System.out.println(JSONUtil.stringify(result));
{
"code": "0",
"desc": "成功",
"data": {
"formDetails": {
"batchApproval": 0,
"content": "API创建表单示例，此处支持富文本标签<\/p>",
"creatorDepartmentDisplayOrder": 2,
"creatorDepartmentLevel": 3,
"customIcon": {
"iconColor": "rgba(128,0,0,1)",
"iconName": "baobiao"
},
"customLogo": {
"iconType": 1,
"url": "图片相对路径"
},
"definitionVersionsId": "form表单id",
"departmentFieldDisplayOrder": 1,
"departmentLevel": 3,
"ext": "",
"formName": "API创建表单",
"formStyle": {
"background": "#f7f8fa",
"themeColor": "#fff",
"headerImg": "图片相对路径",
"backgroundRepeat": "no-repeat",
"backgroundType": 0,
"titleStyle": {
"fontFamily": "PingFangSC-Regular,'Microsoft YaHei','宋体', Tahoma, Arial, sans-serif",
"fontWeight": "normal",
"color": "#383838",
"fontSize": "18px",
"textAlign": "left"
},
"fieldStyle": {
"fontFamily": "PingFangSC-Regular,'Microsoft YaHei','宋体', Tahoma, Arial, sans-serif",
"fontWeight": "normal",
"color": "#383838",
"fontSize": "14px",
"space": 0
}
},
"id": "293cfb00-e0ca-429d-88eb-844eb8b45ef1",
"isBuildSerialNumber": 1,
"isCustomRemind": 1,
"isFormPublicInquiry": 1,
"isFormValidators": 1,
"isHavePic": 0,
"isInitPage": 1,
"isOpenPrefill": 0,
"platformType": 0,
"showOrderId": 0,
"style": 1,
"summary": "",
"thumbnail": "图片相对路径",
"title": "API创建表单"
},
"formControl": {
"limitTimeRate": "2",
"isFreeFlow": "3",
"isOpenDraft": "1",
"isScript": "1",
"isShowFlowSerial": null,
"isCanAt": "1",
"password": null,
"endSendMsgTime": "5",
"isBuildTitle": "2",
"isSaveOrbit": "1",
"isBuildSort": "1",
"id": "0c31ee30-8589-4bc5-925b-13238bcbc078",
"formPhotoSet": "0",
"isWriterRemind": "0",
"isWxDownloadMx": "2",
"titleTemplate": "API创建表单{create_user_name}_{yyyyMMdd}",
"isPassword": null,
"isControlOpenField": "0",
"startSendMsgTime": "5",
"isQyWxAuthorize": null,
"isDisableRelevants": "0",
"actorTimeRate": "2",
"isFileMust": null,
"isAnonymous": "1",
"submitTime": "100",
"alreadySubmitNum": "0",
"isRemind": "1",
"typeId": "4f10647a-0694-40e4-bceb-3946c1f4aec2",
"isLimit": "1",
"isSendMsg": "0",
"endSendMsgDate": "2022-12-31 23:54:59",
"isCanDel": "0",
"detailViewLevel": "2",
"relativesMaxNum": "10",
"typeName": "API创建表单分组",
"lockValidTime": "0",
"canSeeDataReport": "2",
"isMatchField": null,
"isOpenSpokesMan": "0",
"actorTime": "1",
"isSearchComment": null,
"isRelatives": "0",
"limitTimes": "07:00-09:00",
"isRelevants": "1",
"startTime": null,
"stopTime": null,
"isUpdaeTitle": "1",
"isSearchForm": null,
"definitionId": "defn表单版本id",
"isWxLogin": null,
"submitTotalNum": null,
"isFile": null,
"isTask": "2",
"isHasPrintTemplate": "0",
"timeRateNum": "0,6",
"isWxAuthorize": null,
"startSendMsg": null,
"isForceAnonymous": "1",
"endSendMsg": null,
"isOpenPrint": "1",
"isIncharges": null,
"daySubmitNum": "2",
"sendRelevantStatus": "3",
"isQyWxLogin": null,
"fieldToMatch": null,
"isOpenComment": null,
"isDisableRelatives": "0",
"isCanUpdate": "0",
"isWithdraw": null,
"isCallback": "0",
"startSendMsgDate": "2021-12-31 23:55:00",
"isPic": null,
"addressBookField": null,
"flowType": null
},
"formField": [
{
"_type": "TextField",
"_id": "fo单行文字字段id",
"label": "单行文字"
},
{
"_type": "MobileField",
"_id": "fo手机号码字段id",
"label": "手机号码"
},
{
"_type": "TelephoneField",
"_id": "fo电话字段id",
"label": "电话"
},
{
"_type": "EmailField",
"_id": "fo邮箱字段id",
"label": "邮箱"
},
{
"_type": "RadioButton",
"_id": "fo单项选择字段id",
"label": "单项选择",
"choices": [
{
"quota": 100,
"_id": "fo选项1id",
"value": "选项1",
"sub_choices": [
{
"value": "二级选项1"
},
{
"value": "二级选项2"
}
]
},
{
"_id": "fo选项2id",
"value": "选项2",
"sub_choices": [
{
"value": "二级选项1"
},
{
"value": "二级选项2"
}
]
},
{
"_id": "fo选项3id",
"value": "其他"
}
]
},
{
"_type": "CheckBox",
"_id": "fo多项选择字段id",
"label": "多项选择",
"choices": [
{
"quota": 100,
"_id": "fo选项1id",
"value": "选项1",
"sub_choices": [
{
"value": "二级选项1"
},
{
"value": "二级选项2"
}
]
},
{
"_id": "fo选项2id",
"value": "选项2",
"sub_choices": [
{
"value": "二级选项1"
},
{
"value": "二级选项2"
}
]
},
{
"_id": "fo选项3id",
"value": "其他"
}
]
},
{
"_type": "DropDown",
"_id": "fo下拉框字段id",
"label": "下拉框",
"choices": [
{
"quota": 100,
"_id": "fo选项1id",
"value": "选项1",
"sub_choices": [
{
"value": "二级选项1"
},
{
"value": "二级选项2"
}
]
},
{
"_id": "fo选项2id",
"value": "选项2",
"sub_choices": [
{
"value": "二级选项1"
},
{
"value": "二级选项2"
}
]
},
{
"_id": "fo选项3id",
"value": "其他"
}
]
},
{
"_type": "CascadeDropDown",
"_id": "fo两级下拉框字段id",
"label": "两级下拉框",
"choices": [
{
"quota": 100,
"_id": "fo选项1id",
"value": "选项1",
"sub_choices": [
{
"value": "二级选项1"
},
{
"value": "二级选项2"
}
]
},
{
"_id": "fo选项2id",
"value": "选项2",
"sub_choices": [
{
"value": "二级选项1"
},
{
"value": "二级选项2"
}
]
}
]
},
{
"_type": "GeoField",
"_id": "fo地理位置字段id",
"label": "地理位置"
},
{
"_type": "CityField",
"_id": "fo省市区字段id",
"label": "省市区"
},
{
"_type": "TextArea",
"_id": "fo多行文字id",
"label": "多行文本"
},
{
"_type": "DateField",
"_id": "fo日期字段id",
"label": "日期"
},
{
"_type": "TimeField",
"_id": "fo时间字段id",
"label": "时间"
},
{
"_type": "DateTimeField",
"_id": "fo日期时间字段id",
"label": "日期时间"
},
{
"_type": "RatingField",
"_id": "fo评分字段id",
"label": "评分"
},
{
"_type": "ImageField",
"_id": "fo图片字段id",
"label": "图片"
},
{
"children": [
{
"_type": "ImageField",
"_id": "fo子字段图片字段id",
"label": "子字段图片"
},
{
"_type": "TextField",
"_id": "fo子字段单行文字字段id",
"label": "子字段单行文字"
},
{
"_type": "NumberField",
"_id": "fo子字段数字字段id",
"label": "子字段数字"
},
{
"_type": "NumberField",
"_id": "fo子字段数字2字段id",
"label": "子字段数字2"
},
{
"_type": "EquationField",
"_id": "fo子字段计算式字段id",
"label": "子字段计算式"
}
],
"_type": "ChildField",
"_id": "fo子表单字段id",
"label": "子表单"
},
{
"_type": "StatisticsField",
"_id": "fo统计字段id",
"label": "统计"
},
{
"_type": "NumberField",
"_id": "fo数字字段id",
"label": "数字"
},
{
"_type": "EquationField",
"_id": "fo计算式字段id",
"label": "计算式"
},
{
"children": [
{
"_type": "TextField",
"_id": "fo表单关联子字段id",
"label": "表单关联子字段"
}
],
"_type": "FORMREFCustomerField",
"_id": "fo表单关联字段id",
"label": "表单关联"
},
{
"_type": "QrCodeField",
"_id": "fo生成二维码字段id",
"label": "生成二维码"
},
{
"_type": "HandWrittenField",
"_id": "fo手写签名字段id",
"label": "手写签名"
},
{
"_type": "Datasource",
"_id": "fo数据源字段id",
"label": "数据源"
},
{
"children": [
{
"_type": "TextField",
"_id": "fo3e39d90e45a34f63871e1f7e7227094d",
"label": "发票id"
},
{
"_type": "AccessoryField",
"_id": "fo5c2b119ca5a541409819e88083a3c14c",
"label": "原件"
},
{
"_type": "RadioButton",
"_id": "fob104157bf73648c68d95d99ebc8952b6",
"label": "发票类型",
"choices": [
{
"_id": "10100",
"value": "增值税专用发票"
},
{
"_id": "10101",
"value": "增值税普通发票"
},
{
"_id": "10102",
"value": "增值税电子普通发票"
},
{
"_id": "10103",
"value": "增值税普通发票（卷票）"
},
{
"_id": "10104",
"value": "机动车销售统一发票"
},
{
"_id": "10105",
"value": "二手车销售统一发票"
},
{
"_id": "10200",
"value": "定额发票"
},
{
"_id": "10400",
"value": "机打发票"
},
{
"_id": "10500",
"value": "出租车发票"
},
{
"_id": "10503",
"value": "火车票"
},
{
"_id": "10505",
"value": "客运汽车"
},
{
"_id": "10505a",
"value": "船票"
},
{
"_id": "10506",
"value": "航空运输电子客票行程单"
},
{
"_id": "10507",
"value": "过路费发票"
},
{
"_id": "10900",
"value": "可报销其他发票"
},
{
"_id": "10902",
"value": "完税证明"
},
{
"_id": "20100",
"value": "国际小票"
},
{
"_id": "20105",
"value": "滴滴出行行程单"
}
]
},
{
"_type": "DateField",
"_id": "fo51c80794e9f44eb3b8a9237a7ae43079",
"label": "日期"
},
{
"_type": "NumberField",
"_id": "fo0c3d3d91a6594da39241c705047aaed4",
"label": "金额"
},
{
"_type": "RadioButton",
"_id": "fo255f4151d3a14d56af476ba1d30e26c2",
"label": "验真状态",
"choices": [
{
"_id": "-1",
"value": "红冲"
},
{
"_id": "0",
"value": "未验真"
},
{
"_id": "1",
"value": "已验真"
},
{
"_id": "2",
"value": "验真失败"
},
{
"_id": "3",
"value": "无需验真"
}
]
}
],
"_type": "OCRInvoiceField",
"_id": "fo智能识别字段id",
"label": "智能识别"
},
{
"_type": "MEMBERCustomerField",
"_id": "fo通讯录成员字段id",
"label": "通讯录成员"
},
{
"_type": "DEPTCustomerField",
"_id": "fo部门字段id",
"label": "部门"
},
{
"_type": "CRMCustomerField",
"_id": "fo费控关联id",
"label": "费控关联"
},
{
"_type": "SerialNumberField",
"_id": "fo流水号字段id",
"label": "流水号"
}
],
"flowDetails": {
"batchApproval": 0,
"flowTemplates": [
{
"flowName": "API创建表单",
"id": "2df7ddad-559c-49c1-9b6d-28049b152f43",
"nodes": [
{
"handleAccounts": "",
"id": "826680c5-af25-4f9f-8391-e4204b6db9cf",
"nodeName": "节点1",
"nodeStatus": "1",
"todoInfoList": []
},
{
"handleAccounts": "",
"id": "8ffb528f-5ce7-4c43-8cc2-cb5227e4e394",
"nodeName": "节点2",
"nodeStatus": "1",
"todoInfoList": []
},
{
"handleAccounts": "",
"id": "a4fd6eb5-11b9-4020-a36a-0f7648c45cbb",
"nodeName": "填写表单",
"nodeStatus": "0",
"todoInfoList": []
},
{
"handleAccounts": "",
"id": "ce3632f7-6151-4856-8dae-8ebf5ca70dd1",
"nodeName": "结束节点",
"nodeStatus": "2",
"todoInfoList": []
}
]
}
],
"isOrderAudit": 0
}
}
}
| 参数名 | 释义 | 类型 | 是否必须 | 描述 |
|---|---|---|---|---|
|
formDetails |
表单详情 |
TbFormDetailsPO |
是 |
|
|
formControl |
表单控制 |
TbFormControlPO |
是 |
|
|
formField |
字段设置 |
Array |
是 |
|
|
flowDetails |
流程信息 |
FlowDetailVO |
否 |
|
| 参数名 | 释义 | 类型 | 是否必须 | 描述 |
|---|---|---|---|---|
| isOrderAudit | 是否启用顺序审批 | Integer | 否 | 0:否,1:是 |
| batchApproval | 是否启用批量处理 | Integer | 否 | 0:否,1:是 |
| flowTemplates | 流程信息 | FlowTemplate[] | 否 |
| 参数名 | 释义 | 类型 | 是否必须 | 描述 |
|---|---|---|---|---|
| id | 流程id | String | 否 | |
| flowName | 流程名称 | String | 否 | |
| nodes | 流程节点信息 | FlowNode[] | 否 |
| 参数名 | 释义 | 类型 | 是否必须 | 描述 |
|---|---|---|---|---|
| id | 节点id | String | 否 | |
| nodeName | 节点名称 | String | 否 | |
| handleAccounts | 节点处理人 | String | 否 | 返回节点处理人id,多个用英文"|"隔开 |
| nodeStatus | 节点类型 | String | 否 | 0:开始节点,1:普通节点,2:结束节点,3:并行开始节点,4:并行中间节点,5:并行结束节点,6:外部节点 |