参数功能

1.1 版本

1.2 功能简介

在组件设置内可以新增参数并进行绑定，在仪表板中过滤组件也绑定参数，可以实现对目标组件传值的功能。

目前可以绑定参数进行传值的过滤组件有：时间过滤组件、文本组件、数值下拉组件。

2.1 计算字段中使用参数

在计算字段中使用参数参与计算，在过滤组件中绑定参数实现动态控制计算字段结果值。详情参见：计算字段中使用参数动态控制计算字段结果值。

例如：用户可以用过滤组件绑定参数进行传值，动态更改大订单和小订单的衡量标准，当数值下拉组件的值为 2000000 时，2000000 被传参到组件内部实现计算比较，合同金额大于 2000000 的订单为大订单，数量为 41 。如下图所示：

2.2 字段过滤绑定参数

在组件编辑界面对字段进行过滤过程中绑定参数，过滤组件也绑定参数，即可实现对字段过滤进行传参。详情可见：字段过滤绑定参数实现动态过滤数据。

例如，在数值下拉中输入数值 5 ，过滤出销售额前 5 名的店名；输入数值 9 ，过滤出销售额前 9 名的店名，如下图所示：

2.3 明细过滤绑定参数

在指标明细过滤中绑定参数并设置过滤条件，过滤组件绑定参数，可以实现动态过滤。详情可见：动态计算某时间段内的新增数、动态展示过滤组件值前后一段时间的数据、动态展示天/周/月/年数据

例如：默认显示距离当前时间前 15 天的数据，对日期过滤组件设置过滤条件后，数据也显示过滤条件前 15天的数据。

选择过滤条件为「2020-12-01」，则显示「2020-12-01」之前 15 天的数据，如下图所示：

在组件设置内新增创建参数，可对参数名称进行修改，参数类型包括日期、文本、数值，创建对应类型后不支持修改类型，新增参数有两种方式，如下图所示：

• 新增组件参数，如下图所示：
  

• 新增组件参数后出现参数模块，此时可以在参数模块新增参数，如下图所示：
  

• 参数暂时不支持单独作为字段拖入组件中使用

• 字段明细过滤、字段过滤绑定参数需要具备匹配关系：对应设置内容属于文本值的只能绑定文本参数，属于数值值的只能绑定数值参数，属于日期值的只能绑定日期参数，如果文本字段的过滤设置前N项，则绑定参数字段为数值参数

• 一个过滤组件支持绑定多个参数字段；同一个仪表板同一个组件参数只能被一个过滤组件绑定一次，绑定过后显示灰化

• 在仪表板中过滤组件绑定参数，根据对应过滤组件类型，对应显示相应类型的组件参数，如数值过滤组件，仅展示数值类型参数，如下图所示：

在过滤组件编辑界面中，可以绑定 SQL 参数。

• 支持绑定 SQL 参数的过滤组件有，数值下拉过滤组件，文本过滤组件以及时间过滤组件。

• 关于 SQL 参数的使用，可参见：SQL 数据集参数。

• 日期区间、年月区间仅支持按开始区间、结束区间绑定参数，按照年月区间绑定会提示：不支持绑定 SQL 参数，如下图所示：