参数控制器
参数控制器是一种支持查看者调整工作表内容的组件，基于一个参数控制器可以创建多个参数 code，一个参数 code 可以在多个工作表中使用，实际查询时会根据参数控制器的值填充对应的参数 code。
每个参数控制器都有自己的名称和默认值，工作表调试的结果会和默认值有关，编辑态无法调整默认值。
参数控制器的类型
目前仪表盘支持两种类型的参数控制器：日期区间控制器和下拉控制器。
日期区间控制器可以设置日期范围，可选范围和看板及分析模型类似，包括静态时间范围、动态时间范围，或者静态开始动态结束的时间范围。
添加参数控制器后，还需要配置参数 code，包括
- 参数 code：名称，用于工作表中使用
- 获取内容：可选开始日期或结束日期
- 日期 format 格式：可根据具体数据情况，选择合适的 format 格式
- 偏移单位 & 偏移量：基于开始日期或结束日期进行偏移，从而得到最终的结果
举例来说，假设日期区间控制器的日期范围是 2026-02-01～2026-02-28，不同参数 code 配置条件下， 最终结果会不同
| 获取内容 | 日期 format 格式 | 偏移单位 | 偏移量 | 最终结果 |
|---|---|---|---|---|
| 开始日期 | yyyy-MM-dd | / | 0 | 2026-02-01 |
| 开始日期 | yyyyMMdd | 天 | -1 | 20260131 |
| 结束日期 | yyyyMM | 周 | 1 | 202603 |
| 结束日期 | yyyy | 年 | -2 | 2024 |
日期区间控制器的参数 code 替换成日期时会自带引号，在工作表中直接写 ${参数 code} 即可，不要再加引号；写成 '${参数 code}' 调试会报错。
下拉控制器可以设置单选项，每一项都有选项名和内容
同样，添加参数控制器后还要配置参数 code，包括
- 参数 code：名称，用于工作表中使用
- 值类型：原生或文本
如果值类型是原生，则系统将直接使用内容进行填充；如果值类型是文本，系统会在外侧以单引号（''）的形式包裹再进行添加
在工作表中使用参数 code
配置完成后，在工作表下方会出现已配置的参数控制器及相关的参数 code，鼠标 hover 时可以预览对应参数 code 将会填充的内容，点击复制按钮可以快速复制参数 code。
在工作表中相应的位置使用${参数 code}，调试和实际查询时会替换成对应的值
如果使用了没有配置过的参数 code，则会提示
在页面上调整参数控制器
在页面上，可以点击添加“参数控制”，再选择一个同类型的参数控制器；配置后，可以在预览和查看仪表盘时进行调整
未被添加到页面上的参数控制器的参数 code，将仅会按照默认值进行查询；被添加到页面上的参数控制器的参数 code 的值，会随查看者调整发生变化