Logo码如云文档中心

码如云官网 进入后台
附件二:控件提交值类型定义

附件二:控件提交值类型定义 #

控件提交值也称为控件答案,表示表单中某个控件的提交数据。

公共字段 #

所有控件提交值均包含以下字段:

{
  "controlId": "c_rDohZC3K7YG7qnjnELHs8W",
  "controlType": "MULTI_LINE_TEXT",
  ......
}

字段含义:

字段解释
controlId控件ID
controlType控件类型

除了公共字段外,每种控件类型所对应的提交值还包含了特定于该控件类型的字段。

单选框 #

{
  "controlId": "c_OB00UJPoQki18LS-e8zauA",
  "controlType": "RADIO",
  "optionId": "Vu6QRsj1SYmBE4iWKWtnyw"
}

字段含义:

字段解释
optionId所选择的选项ID

多选框 #

{
  "controlId": "c_d0Fw9JqNTfKW__IuB-v-Og",
  "controlType": "CHECKBOX",
  "optionIds": [
    "y1R_BRWURgyBVgeSsJpvlA"
  ]
}

字段含义:

字段解释
optionIds所选择的选项ID数组

单行文本 #

{
  "controlId": "c_xptnyZk8QPW4MR2dAdPsdg",
  "controlType": "SINGLE_LINE_TEXT",
  "content": "单行文本输入"
}

字段含义:

字段解释
content填值内容

多行文本 #

{
  "controlId": "c_rDohZC3K7YG7qnjnELHs8W",
  "controlType": "MULTI_LINE_TEXT",
  "content": "多行文本"
}

字段含义:

字段解释
content填值内容

富文本框 #

{
  "controlId": "c_7GFXRV6p6tjA8n4RLFD2ZN",
  "controlType": "RICH_TEXT_INPUT",
  "content": "<p>这是<strong>富文本</strong></p>"
}

字段含义:

字段解释
content填值内容

姓名 #

{
  "controlId": "c_kgJMx73YMvBzYUMgZu5V8B",
  "controlType": "PERSON_NAME",
  "name": "码小云"
}

字段含义:

字段解释
name姓名

手机号 #

{
  "controlId": "c_7g2czyhCdYARNH58emBXBx",
  "controlType": "MOBILE",
  "mobileNumber": "18233445566"
}

字段含义:

字段解释
mobileNumber手机号

邮箱 #

{
  "controlId": "c_jqXvkmBepDsZ3MhnuKJojY",
  "controlType": "EMAIL",
  "email": "anemail@mryqr.com"
}

字段含义:

字段解释
email邮箱

下拉框 #

{
  "controlId": "c_oWQ39FeWhYEK3rjBW74jxX",
  "controlType": "DROPDOWN",
  "optionIds": [
    "2E3WTUPDiAM1WA1aSvSFTD"
  ]
}

字段含义:

字段解释
optionIds所选择的选项ID数组

多级下拉 #

{
  "controlId": "c_24u6njhB92iis3ZZiU1ycz",
  "controlType": "MULTI_LEVEL_SELECTION",
  "selection": {
    "level1": "广东省",
    "level2": "深圳市",
    "level3": "坂田区"
  }
}

字段含义:

字段解释
selection填值信息
selection.level1第一级填值
selection.level2第二级填值
selection.level3第三级填值

文件上传 #

{
  "controlId": "c_jiqbqtohkx2pk3xh9LjNst",
  "controlType": "FILE_UPLOAD",
  "files": [
    {
      "id": "epioNjCVezCqcGqtqWue8N",
      "name": "xuKW567F9xfZmgGpYiRrcz.jpeg",
      "type": "image/jpeg",
      "fileUrl": "https://files.mryqr.com/TNT369363343011480576/APP369363402021143552/QRC371852660661289984/_QR_MANAGE/2023-05-23/xuKW567F9xfZmgGpYiRrcz.jpeg",
      "ossKey": "TNT369363343011480576/APP369363402021143552/QRC371852660661289984/_QR_MANAGE/2023-05-23/xuKW567F9xfZmgGpYiRrcz.jpeg"
    }
  ]
}

字段含义:

字段解释
filesUploadedFile数组

图片上传 #

{
  "controlId": "c_quXp4PQ6iXq8JxfR7so7H7",
  "controlType": "IMAGE_UPLOAD",
  "images": [
    {
      "id": "m75tcV63vrcbbJrav4CaQd",
      "name": "dsgsew.jpeg",
      "type": "image/jpeg",
      "fileUrl": "https://files.mryqr.com/TNT369363343011480576/APP369363402021143552/QRC371852660661289984/_QR_MANAGE/2023-05-23/xuKW567F9xfZmgGpYiRrcz.jpeg",
      "ossKey": "TNT369363343011480576/APP369363402021143552/QRC371852660661289984/_QR_MANAGE/2023-05-23/xuKW567F9xfZmgGpYiRrcz.jpeg"
    }
  ]
}

字段含义:

字段解释
imagesUploadedFile数组

省市地址 #

{
  "controlId": "c_sh91czN3g9TMwHEoh36Phk",
  "controlType": "ADDRESS",
  "address": {
    "province": "安徽省",
    "city": "淮北市",
    "district": "杜集区",
    "address": "街道地址"
  }
}

字段含义:

字段解释
addressAddress类型

定位 #

{
  "controlId": "c_38PoiH98b9Xtx3HE9SxrMx",
  "controlType": "GEOLOCATION",
  "geolocation": {
    "point": {
      "longitude": 104.10577,
      "latitude": 30.48093
    },
    "address": {
      "province": "四川省",
      "city": "成都市",
      "district": "双流区",
      "address": "麓山大道二段麓山大道南干渠"
    },
    "note": null
  }
}

字段含义:

字段解释
geolocationGeolocation类型

数字 #

{
  "controlId": "c_mZhY5gRNAZRShkhFYrP2pj",
  "controlType": "NUMBER_INPUT",
  "number": 123.0
}

字段含义:

字段解释
number所填数字

五星打分 #

{
  "controlId": "c_eL8dWknyfQiaXYWfuterHq",
  "controlType": "NUMBER_RANKING",
  "rank": 8
}

字段含义:

字段解释
rank所填打分值

日期 #

{
  "controlId": "c_38PoiHxPb9Xtx3HE9SxrMx",
  "controlType": "DATE",
  "date": "2023-04-13"
}

字段含义:

字段解释
date所填日期值

时间 #

{
  "controlId": "c_raJStLKgjdM2QzkyAS2LxW",
  "controlType": "TIME",
  "time": "17:04"
}

字段含义:

字段解释
time所填时间值

编号标识 #

{
  "controlId": "c_jByjhipoom3hmggGkyhtFq",
  "controlType": "IDENTIFIER",
  "content": "ABCD1234"
}

字段含义:

字段解释
content所填内容

物品明细 #

{
  "controlId": "c_uUgtvY9Zcsv84cWrSjkdmr",
  "controlType": "ITEM_COUNT",
  "items": [
    {
      "id": "hohrG1GhgaAFgKhpQxdjzq",
      "optionId": "xsApfbD9cqdThsWEaMfFGk",
      "number": 1
    }
  ]
}

字段含义:

字段解释
items所选物品的数组
items[].id物品ID
items[].optionId物品选项ID
items[].number物品对应数量

状态选择 #

{
  "controlId": "c_5GFc1aA6SMsHdKo1wkRx2s",
  "controlType": "ITEM_STATUS",
  "optionId": "odu2j4BGs3QHFkAZnvHQmG"
}

字段含义:

字段解释
optionId所填选项ID

点检 #

{
  "controlId": "c_cMBM24MmDhE9sYCoU7NwtT",
  "controlType": "POINT_CHECK",
  "checks": {
    "uGQgwd9TrhhcciqGVs5Scz": "YES",
    "t2opEvH49pVevNk1E5JKNq": "YES"
  }
}

字段含义:

字段解释
checks每个选项ID对应的点检结果(结果值有YESNONONE)

电子签名 #

{
  "controlId": "c_o9xqaJUQ4P5nf4gUSBPKM6",
  "controlType": "SIGNATURE",
  "signature": {
    "id": "49fa7zY6CGAMspnDin8nwg",
    "name": "c_o9xqaJUQ4P5nf4gUSBPKM6-signature.png",
    "type": "image/png",
    "fileUrl": "https://files.mryqr.com/TNT369363343011480576/APP376266854085166080/QRC377366957122388992/p_YZ-DKjaVQp2bgr0pUp2pRQ/_SUBMISSION/2023-05-07/49fa7zY698AMspnDin8nwg-c_o9xqaJUQ395nf4gUSBPKM6-signature.png",
    "ossKey": "TNT369363343011480576/APP376266854085166080/QRC377366957122388992/p_YZ-DKjaVQp2bgr0pUp2pRQ/_SUBMISSION/2023-05-07/49fa7zY698AMspnDin8nwg-c_o9xqaJUQ395nf4gUSBPKM6-signature.png"
  }
}

字段含义:

字段解释
signatureUploadedFile类型的签名图片文件

成员选择 #

{
  "controlId": "c_kw5ELVnos5x3PLZhHWhWff",
  "controlType": "MEMBER_SELECT",
  "memberIds": [
    "MBR370526634266067968"
  ]
}

字段含义:

字段解释
memberIds成员ID的数组