仅适用于v3.3.4+

前端如何使用APIRequest构造复杂查询？

一、简单查询条件

仅支持所有条件AND或者OR，以第一个参数的relation为准；

• 以下两种参数是所有字段使用AND，”relation”不传默认是”AND”

{
    "parameters": [
        {
            "key": "Q^NAME_^SL",
            "value": "ss",
            "relation": "AND"
        },
        {
            "key": "Q^ACCOUNT_^SL",
            "value": "c"
        }
    ]
}

{
    "parameters": [
        {
            "key": "Q^NAME_^SL",
            "value": "ss"
        },
        {
            "key": "Q^ACCOUNT_^SL",
            "value": "c"
        }
    ]
}

• 以下参数是所有字段使用OR

{
    "parameters": [
        {
            "key": "Q^NAME_^SL",
            "value": "ss",
            "relation": "OR"
        },
        {
            "key": "Q^ACCOUNT_^SL",
            "value": "c"
        }
    ]
}

二、复杂查询条件

支持多层嵌套AND或者OR，第一层parameters为顶层分组，从第二层parameters开始才是条件构造；

• 相同字段的组合查询

  {
    "parameters": [
        {
            "relation": "OR",
            "parameters": [
                {
                    "relation": "AND",
                    "parameters": [
                        {
                            "key": "Q^NAME_^SL",
                            "value": "管",
                            "param": "name"
                        },
                        {
                            "key": "Q^ACCOUNT_^SL",
                            "value": "admin",
                            "param": "account"
                        }
                    ]
                },
                {
                    "relation": "AND",
                    "parameters": [
                        {
                            "key": "Q^NAME_^SL",
                            "value": "cwws1",
                            "param": "name1"
                        },
                        {
                            "key": "Q^ACCOUNT_^SL",
                            "value": "cwws1",
                            "param": "account1"
                        }
                    ]
                }
            ]
        }
    ],
    "requestPage": {
        "pageNo": 1,
        "limit": 20
    },
    "sorts": []
  }

• 不同字段的组合查询

  {
    "parameters": [
        {
            "relation": "OR",
            "parameters": [
                {
                    "relation": "AND",
                    "parameters": [
                        {
                            "key": "Q^NAME_^SL",
                            "value": "管"
                        },
                        {
                            "key": "Q^ACCOUNT_^SL",
                            "value": "admin"
                        }
                    ]
                },
                {
                    "relation": "AND",
                    "parameters": [
                        {
                            "key": "Q^FULL_NAME_^SL",
                            "value": "cwws1"
                        },
                        {
                            "key": "Q^OUT_ACCOUNT_^SL",
                            "value": "cwws1"
                        }
                    ]
                }
            ]
        }
    ],
    "requestPage": {
        "pageNo": 1,
        "limit": 20,
    },
    "sorts": []
  }

三、API说明

3.1、parameters 查询的参数构造

parameters 参数说明

parameters 下的查询参数key说明

1、 参数命名规则
Q^参数名称^参数类型。 eg：Q^name_^SL。以Q开始，采用^进行拆分。
2、 参数名称
注意:这个为数据库表的字段，eg：name_，如果后台多个字段的查询，也可以为别名.字段。
3、 参数类型:
平台封装了下面参数类型

3.2、 requestPage 分页构造

eg:

    "requestPage": {
        "pageNo": 1,
        "limit": 20,
    }

参数说明

3.3、sorts 排序构造

eg:

"sorts":[{
    "field":"CREATE_TIME_",
    "order":"DESC"
}]

参数说明