Skip to content

查询多条数据接口 ​

简介 ​

通过查询多条数据接口,可以一次查询表单中的多条数据。参数中字段既可以使用原名也可以使用别名。

开发前,请仔细阅读 开发指南。

接口调用 ​

请求地址:POST /Customized/Form/{FormId}/Data/List

请求参数:

参数类型必需说明
FormIdGuid是表单Id
ConditionsJSON否数据过滤条件
OrderByString否按指定字段名称排序
IncludeString否指定为total可返回全部记录数
SkipNumber否跳过记录数
TakeNumber否指定获取记录数
ReturnFieldAliasboolean否返回值使用字段别名

请求示例:

http
POST /Customized/Form/07f16f04-df95-4e96-8f06-875d1fd378ae/Data/List
Headers:
{
  "conditions": "[{\"field\":\"input_1709522214384\",\"type\":\"input\",\"label\":\"单行文本\",\"opt\":\"Equal\",\"val\":\"11\"}]",
  "include": "total",
  "orderby": "-createdTime",
  "skip": 0,
  "take": 20,
  "returnFieldAlias": false
}

返回内容:

参数类型说明
offsetNumber从第0条结果的偏移量
totalNumber符合条件的数据条数
resultsJSON Array表单数据集合

返回示例(字段原名):

json
{
  "offset": 0,
  "total": 1,
  "results": [
    {
      "CreatedByName": "Lily Wang",
      "ModifiedByName": "Lily Wang",
      "SubmittedByName": "Lily Wang",
      "Id": "21881484-8483-45c2-96b8-6fddf2eb06f3",
      "FormId": "07f16f04-df95-4e96-8f06-875d1fd378ae",
      "CreatedBy": "264fcf80-970c-4001-adac-0bf65d7d1954",
      "CreatedTime": "1688544927",
      "ModifiedBy": "264fcf80-970c-4001-adac-0bf65d7d1954",
      "ModifiedTime": "1688544967",
      "SerialNo": "H0150172023070500001",
      "Status": 2,
      "SubmitedBy": "264FCF80-970C-4001-ADAC-0BF65D7D1954",
      "SubmitedTime": "1688544967",
      "select_1680165983154": {
        "value": "91e66e40-ea05-4905-a472-09cc5f497082",
        "label": "已审批"
      },
      "input_1679974929547": "西南_SE",
      "input_1679975307546": "5017",
      "select_1680588945496": {
        "value": "key 1",
        "label": "是",
        "color": {
          "backgroundColor": "#577eff",
          "foreColor": "#ffffff"
        }
      },
      "input_1679975610080": "买赠",
      "input_1679975626936": "01",
      "input_1686031866467": "营销费",
      "input_1679971432166": "E3活动",
      "employeeSelect_1679973163935": {
        "value": "11018838",
        "label": "Lily Wang",
        "code": "11018838",
        "type": "userName"
      }
    }
  ]
}

返回示例(字段别名):

json
{
  "offset": 0,
  "total": 1,
  "results": [
    {
      "CreatedByName": "Lily Wang",
      "ModifiedByName": "Lily Wang",
      "SubmittedByName": "Lily Wang",
      "Id": "21881484-8483-45c2-96b8-6fddf2eb06f3",
      "FormId": "07f16f04-df95-4e96-8f06-875d1fd378ae",
      "CreatedBy": "264fcf80-970c-4001-adac-0bf65d7d1954",
      "CreatedTime": "1688544927",
      "ModifiedBy": "264fcf80-970c-4001-adac-0bf65d7d1954",
      "ModifiedTime": "1688544967",
      "SerialNo": "H0150172023070500001",
      "Status": 2,
      "SubmitedBy": "264FCF80-970C-4001-ADAC-0BF65D7D1954",
      "SubmitedTime": "1688544967",
      "审批状态": {
        "value": "91e66e40-ea05-4905-a472-09cc5f497082",
        "label": "已审批"
      },
      "区域": "西南_SE",
      "区域编码": "5017",
      "是否发起": {
        "value": "key 1",
        "label": "是",
        "color": {
          "backgroundColor": "#577eff",
          "foreColor": "#ffffff"
        }
      },
      "类型": "买赠",
      "input_1679975626936": "01",
      "费用类型": "营销费",
      "活动类型": "E3活动",
      "employeeSelect_1679973163935": {
        "value": "11018838",
        "label": "Lily Wang",
        "code": "11018838",
        "type": "userName"
      }
    }
  ]
}