为了满足复杂的数据查询需求，伙伴云对查询数据的条件做了一次抽象，提炼出 筛选器 对象的概念。在伙伴云的接口中，筛选器 对象被广泛地使用，包括数据查询，表格行权限，关联数据条件等等场景。

筛选器示例

以下是一个标准的筛选器的数据结构：

{
    "and": [
        {
            "field": 7256086,
            "query": {
                "eq": "测试"
            }
        },
        {
            "or": [
                {
                    "field": 7256086,
                    "query": {
                        "in": [1, 2, 3]
                    }
                },
                {
                    "field": "7256086",
                    "query": {
                        "em": true
                    }
                }
            ]
        }
    ]
}

数据结构

筛选项

筛选器的最小单位是 筛选项 对象，一个标准的 筛选项 对象如下所示：

{
    "field": 7256086,
    "query": {
        "eq": "匹配的字符"
    }
}

字段说明

筛选逻辑

筛选器可以通过 筛选逻辑 对象组合出满足各种场景的查询条件。一个简单的带 筛选逻辑 的筛选器如下所示：

{
    "and": [
        {
            "field": 7256086,
            "query": {
                "eq": "匹配的字符"
            }
        },
        {
            "field": 7256087,
            "query": {
                "in": [1, 2, 3]
            }
        }
    ]
}

目前 筛选逻辑 支持的逻辑关键字包括：and 和 or，关键字是由 筛选项 或 筛选逻辑 组成的集合，每个集合组合出的条件逻辑遵循关键字表达逻辑。

假设我们有以下的查询条件：

A AND (B OR C)

转换为筛选器后的数据结构如下：

{
    "and": [
        A,
        {
            "or": [
                B,
                C
            ]
        }
    ]
}

应用场景

伙伴云的表格中不同的字段所能使用的 筛选项 中的查询条件（query）是不同的。

数据唯一标识字段

创建人/用户字段

用户字段支持的变量：

• myself 当前登录用户

创建时间/时间字段

时间字段支持的变量：

• today 当前日期
• yesterday 当前日期的前一天
• tomorrow 当前日期的后一天
• last_week 过去的7天
• last_month 过去的30天
• next_week 未来的7天
• next_month 未来的30天
• this_whole_month 当前月
• last_whole_month 上月
• next_whole_month 下月
• this_quarter 当前季度
• last_quarter 上一季度
• next_quarter 下一季度

文本字段

数字字段/计算字段

选项字段

关联字段

图片字段/附件字段