功能说明：获取客户字段
请求方式：POST（HTTPS）
请求地址：https://qwif.do1.com.cn/qwcgi/api/crm/client/getClientFields.do?token=token&corpId=corpId
CrmApi api = QwSdkUtil.getInter(CrmApi.class);
// 调用接口
ApiCrmClientFieldsResultVO result = api.getClientFields(
QwSdkUtil.getCacheToken());
System.out.println(JSONUtil.stringify(result));
{
"code":"0",
"desc":"成功",
"data":{
"multiClientSetting":true,
"basicFields":[
{
"fieldName":"clientName",
"isNecessary":"1",
"label":"客户名称",
"sort":"1",
"type":"TextField"
},
{
"fieldName":"typeIds",
"isNecessary":"0",
"label":"客户类别",
"sort":"2",
"type":"SelectField"
},
{
"fieldName":"poolId",
"isNecessary":"1",
"label":"所属公海",
"sort":"3",
"type":"SelectField"
},
{
"fieldName":"region",
"isNecessary":"0",
"label":"区域",
"sort":"4",
"type":"TextField"
},
{
"fieldName":"address",
"isNecessary":"0",
"label":"地址",
"sort":"5",
"type":"TextField"
},
{
"fieldName":"industryCodes",
"isNecessary":"0",
"label":"行业",
"sort":"6",
"type":"TextField"
},
{
"fieldName":"phone",
"isNecessary":"0",
"label":"联系电话",
"sort":"7",
"type":"PhoneNumber"
},
{
"fieldName":"email",
"isNecessary":"0",
"label":"邮箱",
"sort":"8",
"type":"Email"
},
{
"fieldName":"website",
"isNecessary":"0",
"label":"网站",
"sort":"9",
"type":"Email"
},
{
"fieldName":"remark",
"isNecessary":"0",
"label":"备注",
"sort":"10",
"type":"TextField"
},
{
"fieldName":"chargePersonWxIds",
"isNecessary":"0",
"label":"负责人",
"sort":"11",
"type":"TextField"
},
{
"fieldName":"relativePersonWxIds",
"isNecessary":"0",
"label":"相关人",
"sort":"12",
"type":"TextField"
},
{
"fieldName":"submitType",
"isNecessary":"0",
"label":"通知类型",
"sort":"13",
"type":"TextField"
}
],
"customFields":[
{
"choices":[],
"customFieldId":"ad3383676ae1090cf39bdc9e6fa20676",
"isNecessary":"0",
"label":"单行",
"type":"TextField",
"sort":"1",
"desc":"填写单行内容"
},
{
"choices":[],
"customFieldId":"ca6a5a5d529348259464c7111be9ef2f",
"isNecessary":"0",
"label":"多行",
"type":"TextArea",
"sort":"2",
"desc":"填写多行内容"
},
{
"choices":[
{
"optionId":"3556a5e73566430ab5ef40d0921adac0",
"optionName":"方式1",
"sort":"1",
"value":"1"
},
{
"optionId":"98ec2968791c431ea04b1ad03c0d7d02",
"optionName":"方式2",
"sort":"2",
"value":"2"
},
{
"optionId":"daad6499a8234fe491f93a93ca0fe38a",
"optionName":"方式3",
"sort":"3",
"value":"3"
}
],
"customFieldId":"6cae2f16cd2a67b2b4613b3719527a47Y",
"isNecessary":"0",
"label":"支付方式",
"type":"SelectField",
"sort":"3",
"desc":"填写选择选项"
},
{
"choices":[],
"customFieldId":"442e82087f404c7887bb5ea0c7e091d1",
"isNecessary":"0",
"label":"日期",
"type":"DateTime",
"sort":"4",
"desc":"填写日期"
},
{
"choices":[],
"customFieldId":"fbefd57ca3c84e4494cc8ef5121fe5b4",
"isNecessary":"0",
"label":"整数",
"type":"Number",
"sort":"5",
"desc":"填写整数"
},
{
"choices":[],
"customFieldId":"ae6d11dd437441afbb56f26f7292d0b8",
"isNecessary":"0",
"label":"小数",
"type":"Double",
"sort":"6",
"desc":"填写小数，最多保留两位"
},
{
"choices":[],
"customFieldId":"e247273d18bd49acb41834025f1f6044",
"isNecessary":"0",
"label":"百分比",
"type":"Percent",
"sort":"7",
"desc":"填写百分数，带百分号"
},
{
"choices":[],
"customFieldId":"a2360539f13b4f26a3aa4d2d61d850b4",
"isNecessary":"0",
"label":"联系方式",
"type":"PhoneNumber",
"sort":"8",
"desc":"填写电话号码"
}
],
"seniorFields": [
{
"choices": [],
"fieldId": "fo4acf32007e5742c2ac001dc9a96e2be7",
"fieldName": "（表单）单行文字",
"isNecessary": "true",
"note": "请输入",
"sort": "1",
"type": "TextField"
},
{
"choices": [],
"fieldId": "fo0074c8bb21b943cbb674f75a867e0fac",
"fieldName": "（表单）邮箱",
"isNecessary": "false",
"note": "请输入",
"sort": "2",
"type": "EmailField"
},
{
"choices": [],
"fieldId": "fod3174d0bbc7449c080449c0cbbe6cc86",
"fieldName": "（表单）数字",
"isNecessary": "true",
"note": "请输入",
"sort": "3",
"type": "NumberField"
},
{
"choices": [],
"fieldId": "fo6d502db6136a4a1e821415f383b0ffaa",
"fieldName": "（表单）电话",
"isNecessary": "false",
"note": "分隔请用-或空格，国际电话请加+",
"sort": "4",
"type": "TelephoneField"
},
{
"choices": [],
"fieldId": "foc14e0347f57b40d283324c3b489f5d0f",
"fieldName": "（表单）手机",
"isNecessary": "false",
"note": "请输入",
"sort": "5",
"type": "MobileField"
},
{
"choices": [],
"fieldId": "fof58d5ec766514c53bdb4961110053575",
"fieldName": "（表单）多行文字",
"isNecessary": "false",
"note": "请输入",
"sort": "6",
"type": "TextArea"
},
{
"choices": [],
"fieldId": "fo375dfaeb87b241e681634b7dc8906bee",
"fieldName": "（表单）日期",
"isNecessary": "false",
"note": "请选择",
"sort": "7",
"type": "DateField"
},
{
"choices": [],
"fieldId": "fo855fd02dffc8461d984a12c119730df2",
"fieldName": "（表单）时间",
"isNecessary": "false",
"note": "请选择",
"sort": "8",
"type": "TimeField"
},
{
"choices": [],
"fieldId": "fo9a71a63280374c5b851de2f752d466a9",
"fieldName": "（表单）日期时间",
"isNecessary": "false",
"note": "请选择",
"sort": "9",
"type": "DateTimeField"
},
{
"choices": [
{
"optionId": "foe0cd24dc3f6440ebaf4014cc1506ae3e",
"optionName": "选项1",
"sort": 1
},
{
"optionId": "fobcb78b055b284d47819e249331d9eed2",
"optionName": "选项2",
"sort": 2
},
{
"optionId": "foe58efb490f6e4be28d4fdd63e8dac0e1",
"optionName": "选项3",
"sort": 3
}
],
"fieldId": "fo0dec944e2817445787141a96a9922aa2",
"fieldName": "（表单）单项选择",
"isNecessary": "false",
"note": "",
"sort": "10",
"type": "RadioButton"
},
{
"choices": [
{
"optionId": "fo2a53981b22ec4d298b8f43ed41e99a82",
"optionName": "选项1",
"sort": 1
},
{
"optionId": "foe6b5df849f824a23bc95f48893218192",
"optionName": "选项2",
"sort": 2
},
{
"optionId": "fo30168fb6ce7d432f88e89858316146d5",
"optionName": "选项3",
"sort": 3
}
],
"fieldId": "foe59e667acacc46799d99e12d1af34fa9",
"fieldName": "（表单）多项选择",
"isNecessary": "false",
"note": "",
"sort": "11",
"type": "CheckBox"
},
{
"choices": [
{
"optionId": "fo81a20466198c43fa87b7592e4db09d8c",
"optionName": "选项1",
"sort": 1
},
{
"optionId": "fo3ea9316e9eba49dfa816df1dd8441296",
"optionName": "选项2",
"sort": 2
},
{
"optionId": "fo6735fc627040495088f7de855c0e4020",
"optionName": "选项3",
"sort": 3
}
],
"fieldId": "fobfb40e3e839d441286fce7cb25f30618",
"fieldName": "（表单）下拉框",
"isNecessary": "false",
"note": "",
"sort": "12",
"type": "DropDown"
},
{
"choices": [
{
"optionId": "foe19826c750d042b49eed2edc85f8763f",
"optionName": "选项",
"sort": 1
},
{
"optionId": "foe1652cf16c4b4c9182eb3a1dcc552e03",
"optionName": "选项",
"sort": 2
},
{
"optionId": "fo041f54152075400c825098dcdbfff441",
"optionName": "选项",
"sort": 3
}
],
"fieldId": "foa7b53a4b28a841bb8feffbca2efaae42",
"fieldName": "（表单）评分",
"isNecessary": "false",
"note": "",
"sort": "13",
"type": "RatingField"
},
{
"choices": [],
"fieldId": "fo8cad6f5a58ba46558b9431d5204edb2b",
"fieldName": "（表单）地理位置",
"isNecessary": "false",
"note": "",
"sort": "14",
"type": "GeoField"
},
{
"choices": [],
"fieldId": "fo192681ba68204d908e70f81066512a26",
"fieldName": "（表单）说明项",
"isNecessary": "false",
"note": "请输入",
"sort": "15",
"type": "ImageCheckBox"
},
{
"choices": [],
"fieldId": "fo7d684233347749e9916d69469a5963f1",
"fieldName": "（表单）分节",
"isNecessary": "false",
"note": "",
"sort": "16",
"type": "SectionBreak"
},
{
"choices": [],
"fieldId": "fo03a32cded98b45f0802326e78a3422aa",
"fieldName": "（表单）图片",
"isNecessary": "false",
"note": "",
"sort": "17",
"type": "ImageField"
},
{
"choices": [],
"fieldId": "focac8c53ef9344513adf316dd744fcc88",
"fieldName": "（表单）附件",
"isNecessary": "false",
"note": "",
"sort": "18",
"type": "AccessoryField"
},
{
"choices": [],
"fieldId": "fo50ab5879143647ab903b8e57ecd1db44",
"fieldName": "（表单）省市区",
"isNecessary": "false",
"note": "",
"sort": "19",
"type": "CityField"
},
{
"choices": [],
"fieldId": "fo33f8c688a7ee445a9f7c3c0f5fee89cc",
"fieldName": "（表单）计算式",
"isNecessary": "false",
"note": "（表单）数字",
"sort": "20",
"type": "EquationField"
},
{
"choices": [
{
"optionId": "fo6e892337a7f14bd29dab052e61fe9542",
"optionName": "选项1:二级选项1",
"sort": 1
},
{
"optionId": "fo6e892337a7f14bd29dab052e61fe9542",
"optionName": "选项1:二级选项2",
"sort": 2
},
{
"optionId": "foe7416257061342888ed9361dce544ef0",
"optionName": "选项2:二级选项1",
"sort": 3
},
{
"optionId": "foe7416257061342888ed9361dce544ef0",
"optionName": "选项2:二级选项2",
"sort": 4
}
],
"fieldId": "fo4a614a867c60409f814dbd1981f5f13f",
"fieldName": "（表单）两级下拉框",
"isNecessary": "false",
"note": "",
"sort": "21",
"type": "CascadeDropDown"
},
{
"choices": [],
"fieldId": "fofc48b703309d44fa8c02099cafb50638",
"fieldName": "（表单）微信扫码",
"isNecessary": "false",
"note": "",
"sort": "22",
"type": "ImageRadioButton"
},
{
"choices": [],
"fieldId": "fo21d3476b5a4647e584f85f78acf8f1f8",
"fieldName": "（表单）流水号",
"isNecessary": "false",
"note": "请输入",
"sort": "23",
"type": "SerialNumberField"
},
{
"choices": [],
"fieldId": "foe2d99bcf4fc0470b9326c408016a7295",
"fieldName": "（表单）手写签名",
"isNecessary": "false",
"note": "请输入",
"sort": "24",
"type": "HandWrittenField"
},
{
"choices": [],
"fieldId": "fo468250bcf0bb4a949a786b473349c561",
"fieldName": "（表单）通讯录成员",
"isNecessary": "false",
"note": "",
"sort": "25",
"type": "MEMBERCustomerField"
},
{
"choices": [],
"fieldId": "foa2a9b2d6f631454080cdbe2b002af086",
"fieldName": "（表单）部门",
"isNecessary": "false",
"note": "",
"sort": "26",
"type": "DEPTCustomerField"
}
]
}
}
data
| 参数 | 说明 | 备注 |
|---|---|---|
| multiClientSetting | 允许添加多客户负责人开关 |
true：开启，允许填写多个负责人； false：关闭，只能填一个负责人。 |
|
basicFields |
基础字段数组 |
|
|
customFields |
自定义字段数组 |
|
basicField
|
说明 |
备注 |
|
|---|---|---|
|
fieldName |
字段名 |
|
|
type |
字段类型 |
TextField、TextArea、SelectField、PhoneNumber、Email、DateTime、Integer、Double、Percent |
|
label |
标签 |
|
|
isNecessary |
是否必填 |
1 = 必填，0 = 非必填 |
|
sort |
排序号 |
|
customField
|
参数 |
说明 |
备注 |
|---|---|---|
|
customFieldId |
自定义字段ID |
|
|
type |
字段类型 |
TextField、TextArea、SelectField、PhoneNumber、DateTime、Integer、Double、Percent |
|
label |
标签 |
|
|
isNecessary |
是否必填 |
1=必填，0=非必填 |
|
sort |
排序号 |
|
|
choices |
选项列表 |
只有SelectField才有值，其余为[] |
|
desc |
填写提示 |
|
seniorFields
|
参数 |
说明 |
备注 |
|---|---|---|
|
fieldId |
表单字段ID |
|
|
fieldName |
表单字段名称 |
|
|
type |
字段类型 |
TextField(单行文字)、EmailField(邮箱)、NumberField(数字)、TelephoneField(电话)、MobileField(手机)、 MEMBERCustomerField(通讯录成员)、DEPTCustomerField(部门) |
|
isNecessary |
是否必填 |
true=必填，false=非必填 |
|
sort |
排序号 |
|
|
choices |
选项列表 |
只有 RadioButton(单项选择)、CheckBox(多项选择)、DropDown(下拉框)、RatingField(评分)、CascadeDropDown(两级下拉框) 才有值，其余为[] |
|
note |
填写提示 |
|
choice
|
参数 |
说明 |
备注 |
|---|---|---|
|
optionId |
选项ID |
|
|
optionName |
选项名 |
|
|
sort |
排序号 |
|
|
value |
选项值 |
|