跳到主要内容
版本：Next

筛选器

应用场景​

筛选器的应用场景更广更灵活，相当于超级控制器，支持选择查询关键字段+判断条件+值一体的自由控制，直接可添加多个筛选条件。普通控制组件在配置工程时已限定查询关键字段及配置，而超级控制器将开放，在工程运行时亦可更新，更自主可控。

操作使用​

1）前提：图表关联

首先需将图表关联筛选器，完成控制关系的绑定。绑定后，图表查询时将以筛选器所设置的条件进行。

image-20230628191229253

2）使用：条件设置

点击筛选按钮，弹出条件面板，再次点击收起面板；

弹出条件面板后，点击image-20230628192035473，新增1行条件，下面将说明条件配置使用；

  • 查询关键字段：下拉选择字段，为所控制图表其源数据字段；

  • 查询判断条件：下拉选择，支持=、!=、>、<、>=、<=、包含、不包含、为空、不为空；

  • 查询条件值：

    • 文本&数值：支持输入及下拉两种设置值方式，点击条件右侧的image-20230629100747484进行切换。

      image-20230629110016627

    • 时间值：

      • 支持绝对时间，支持年、年月、年月日（日期）、年月日时分秒（日期时间）多种粒度选择，点击下拉选择对应粒度，点击时间面板即可选择

        （若筛选一段时间，可设置>=开始时间，<=结束时间）

      • 支持相对时间，从当前时刻往前推或往后推，如近30分钟/后7天，点击下拉选择相对，输入相对时间及单位；

      • 支持快捷时间，如本小时、今天、昨天、本周、上周、本月、上月、本季度、本年度，点击下拉直接选择对应的快捷项；

        image-20230629110557149

点击确认，即可触发图表查询

组件配置​

外观文本：设置筛选器外观文本样式

权限控制：勾选，该组件的控制操作需验证当前登录用户是否有权限进行操作。详见运行模块-权限管理

特别说明​

tip1：在开发环境设置的筛选条件，为工程运行时图表查询的初始条件，若运行时无须修改历史查询条件，可将筛选器隐藏

tip2：点击确认手动触发图表的查询，若需设置定时自动更新，如实时近5分钟，在配置条件后，对应勾选自动刷新数据功能，频率可自定义

image-20231013095127259

tip3：支持通过事件脚本获取和设置筛选条件，满足

  • 获取筛选条件：获取控件值至变量，如将当前筛选器的筛选条件"字段A >= 100 && 字段B = 日期 '2023-06-05' "输出至变量

image-20230629113237607

  • 设置筛选条件：设置控件值，如设置筛选器的筛选条件为"字段A >= 100 && 字段B = 日期 '2023-06-05' "，设置后将自动触发查询更新

image-20230629113250431

# 筛选条件格式说明
1条筛选条件的组装规则为，字段+比较符+标识（一般日期字段才有标识，非必填）+值，在实际语句中，+替换为空格号，即4个元素直接需有空格号隔开，每个元素解析如下：

- 示例:
  - "A > 1 && B <= 2"
  - "A 大于 1 且 B 包含 'abc' 且 C 为空"
  - "D 等于 日期 '2023-06-05'"
  - "D 等于 近 7 天"
  - "D 等于 去年"

- 格式: "字段 比较符 值"
- 连接: and, &&, 且, 并且
- 多条件: "条件 连接 条件"
- 比较符:
  - =, ==, 等于
  - !=, <>, 不等于
  - >, 大于
  - < ,小于
  - >=, 大于等于
  - <=, 小于等于
  - 包含
  - 不包含
  - 为空
  - 不为空
- 值：
  - 数字: 123
  - 文本: 'abc'
  - 日期:
    - 绝对日期：标识 值
      - 标识：日期, 时间, 日期时间
      - 值: yyyy, yyyy-MM, yyyy-MM-dd, yyyy-MM-dd hh:mm:ss
    - 相对日期：
      - 近 N 单位
        - 单位: 天, 时, 分, 秒
      - 后 N 单位
        - 单位: 同上
      - 今天
      - 昨天
      - 本周
      - 上周
      - 本月
      - 上月
      - 本季度
      - 上季度
      - 今年
      - 去年

若仍对筛选器-设置筛选条件的格式模糊，您可配置一个基础输入框，当筛选器输入变化（变化筛选条件）时，设置基础输入框控件值为当前筛选器的控件值（筛选条件），此后在筛选器上设定您期望设置的条件，基础输入框显示所设定的筛选条件，可复制该条件作为设置筛选条件的值，无需自己按格式拼凑。

image-20231013141508700