1. 概述

参数也叫做变量，使用起来非常灵活，可以在计算字段中使用，实现单个计算字段甚至整个图表的动态逻辑方案。当参数取不同的值，字段表达式会对应不同的计算逻辑。

2. 快速入门

2.1 常用使用场景

（1）作为随时变化的动态目标值：当您设置月或季度目标时，利用这个目标值参与计算“目标完成度”，同时中途频繁修改目标值。

（2）作为一个固定值，同时限定多个维度/度量范围，达到筛选效果。

（3）在 topN 中，N作为参数，通过实时改动即可查看前n项的数据。

2.2 使用过程示例

第一步 创建一个报告参数

（1）创建一个参数，选择“新建报告参数”；

（2）在新建参数的面板，输入参数名称，选择参数的类型、数据格式和可选范围，设置默认值；指定参数接受值的方式，可从以下选项中选择：

• 任意：参数控件是字段中的简单类型
• 区间：参数控件可用于选择指定范围中的值
• 列表：参数控件提供可供选择的可能值的列表

这些选项的可用性由数据类型确定。例如，字符串参数只能接受列表，若选择“列表”，则必须指定值列表。在列表中可输入值。

如果选择“区间”，则必须指定最小值、最大值和步长。例如，可以定义介于1至10的整数范围，并将步长设置为2。

对于整数、小数、字符串类型的报告参数，当可选范围为“列表”时，支持选择“动态值”或“静态值”，选择“动态值”时，可以设置绑定字段；

默认值支持设置为表达式，满足更灵活的场景，比如默认选中昨日销售额最高的门店

（3）编辑完成后，单击“添加”，完成参数的创建。您可在管理参数界面中可以看到创建完的参数，如下图：

第二步 在计算字段中使用参数

您可通过参数来动态修改计算中的值。在需要更改值时，可打开参数控件并更改值，之后使用该参数的所有计算都会更新。

若要在计算字段中使用参数，在计算字段的编辑框中能够插入参数，放在公式中的一个新位置，或替换当前公式的一个部分：

出于演示需要，这里新建一个“新销售额”字段，通过参数来调整销售额预计增幅。

第三步 使用包含参数的字段

将新建的“新销售额”度量字段拖入表格中，即得到一个包含参数的图表。可以在参数管理界面调节参数值，默认值为10，放在图表中意为在原销售额基础上增幅10%后的数字。

3 功能介绍

3.1 参数控制器

如果您不确定要在报表中展示哪些字段或筛选条件来“适配”您的读者，那么您可以使用参数控制器，以便让读者自行选择他们想要查看数据。

参数控制器分为“单值参数控制器”和“起止时间参数控制器”两种，“单值参数控制器”较为常用，下面将展开介绍：

创建步骤

（1）在顶部工具栏中选择添加一个参数控制器；

（2）在参数控制器的数据面板中，默认选择“单值参数控制器”，这里会列出当前报告中您所创建的所有参数，可以进行选择；

（3）完成参数选择后，您可在样式选择参数控件的样式，样式分为滑块和输入框（需参数可选范围为“区间”），可以修改标题、选项和背景边框等；

使用示例

（1）创建参数：创建一个名为“动态维度”的字符串类型的参数；

（2）使用参数：在计算维度中插入参数，如下图一个简单的case语句，对参数进行了判断；

（3）新建一个图表，把刚才创建的计算维度拖入到X轴，销售额拖入y轴；

（4）新建一个参数控制器，选择参数“动态维度”；

（5）在阅览模式下，读者可以通过切换参数来实现对图表字段的切换。

起止时间参数控制器

“起止时间参数控制器”可同时控制日期字段的起止时间，更为灵活，用法与“单值参数控制器”一致。需要注意的是，起止时间参数的参数类型需要都是日期和时间类型。

报告级关联

跨页面传递值：在一个报告内的不同页面之间，同类型的参数控制器可以互相传递值。

设置报告级关联后，当前组件可以与本报告内其他页面符合关联条件的组件互相之间传递筛选值。当组件的下述条件改变时 ，关联将自动失效。

• 参数控制器：相同参数控制器类型、相同参数类型、相同可选范围、相同样式中选择方式、参数

3.2 全局参数

本产品提供全局参数来设定一些变量，在配置报表时，可以通过引用全局变量的方式支持一些需要参数变化的场景。全局参数可支持跨报告使用，对报告进行批量处理，提升处理效率。

创建全局参数

在[项目中心-资源管理-全局参数]，您可以查看已有的全局参数并对其进行编辑与删除的操作。您可在全局参数管理页面完成创建，如下图所示：

与报告参数一致，全局参数目前支持类型包括整数、小数、字符串、日期、日期和时间；数据格式可选自动、数值和百分比；可选范围包括任意、区间和列表。

对于整数、小数、字符串类型的全局参数，当可选范围为“列表”时，默认值支持多选或全选；

全局参数设置动态值时，支持通过关键词搜索数据模型、字段；

引用全局参数

（1）与报告参数用法一致，您可在计算字段中使用参数，也支持参数控制器；

（2）数据源为Restful API时，参数配置中的value值支持引用全局参数，输入#可引用全局参数，下拉中展示当前用户拥有查看权限的参数列表，点击参数右侧icon可查看对应参数设置详情；

（3）数据模型设置页面，选择添加【自定义视图】时，SQL语句中使用#唤起全局参数的下拉框，若设置全局参数后不建议抽取。

4. 其他

（1）报告参数跟全局参数重名时，计算字段的引用逻辑优化；

• 计算字段插入报告参数时，参数名默认为“[报告参数].[参数名]”。插入全局参数时，参数名默认为“[全局参数].[参数名]”。通过此策略区分同名的报告参数、全局参数；
• 直接输入[参数].[参数名]，依旧可以生效，报告参数、全局参数重名时优先选择报告参数。

（2）支持自定义参数的标题文字。