| 应用类型 | 要求 |
|---|---|
参数筛选应用：通过切换参数筛选自助仪表盘及电子表格中的数据。 应用于：自助仪表盘、电子表格 | 数据模型中至少有一个 私有查询资源必须带参数，并且该参数必须在数据模型参数面板中设置好 映射关系。 各私有查询参数详情请参见： 私有查询参数。 参数映射关系详情请参见： 参数映射关系。 |
参数联动应用：切换参数A影响参数B的选项进行数据筛选。 应用于：自助仪表盘、电子表格 | 数据模型中私有查询中参数必须设置好联动效果，并且这两个联动参数必须在数据模型参数面板中设置好映射关系。 各私有查询参数详情请参见： 私有查询参数。 参数映射关系详情请参见： 参数映射关系。 |
动态结果应用：在计算度量、计算成员和命名集中的应用可以实现根据参数取值的不同而动态获取结果。 应用于：计算度量、计算成员、命名集 | 数据模型参数面板中 定义好参数就可以，不要求必须私有查询资源带参数及设置映射关系。 参数面板定义参数详情请参见： 单个映射。 |
数据权限控制：将当前用户的属性与参数关联，或者系统函数获取当前用户信息与参数关联，实现控制当前用户数据权限。 应用于：自助仪表盘、电子表格 | 数据模型中至少有一个私有查询资源必须带参数，并且该参数必须在数据模型参数面板中设置好 映射关系。 各私有查询参数详情请参见： 私有查询参数。 参数映射关系详情请参见： 参数映射关系。 |
私有查询参数
私有查询资源除数据源表和导入文件之外，其它几种类型都支持带参数。
各类私有查询定义参数的详情如下。
SQL查询
SQL查询中，在表达式中通过“${ParamName}”来标识参数，其中“ParamName”为参数名；用“{[ ]}”表示该参数可为空。如：参数表达式 {[id = ${产品编码}]}，表示id字段与参数“产品编码”匹配，且参数允许为空用于输出所有编码的产品。
示例：
即席查询
即席查询中的参数由拖拽字段生成的条件会自动生成参数。
详情请参考 即席查询 相关内容。
脚本查询
脚本查询中的参数在脚本代码的结果集中定义。
示例：
详情请参考 脚本查询 相关内容 。
存储过程查询
存储过程查询中的参数在存储过程中定义，在数据模型中执行存储过程查询结果集，显示参数列表及展现结果。
详情请参考 存储过程查询 相关内容 。
ETL高级查询
ETL高级查询只有”关系数据源“节点才支持参数定义，其参数定义通过参数映射以及数据源节点SQL语句的参数筛选共同实现。
参数表达式中的参数名与参数映射时设置的”参数名“必须一致。
详情请参考 ETL高级查询 相关内容 。
数据模型参数
数据模型参数主要的作用有如下两个方面：
- 实现私有查询参数与数据模型参数的映射关系：它类似于中间件功能，将私有查询参数与数据模型参数进行关联。应用详情请参见： 参数筛选应用、 参数联动应用。
- 应用到计算度量、计算成员和命名集表达式中，实现动态获取结果。应用详情请参见： 动态结果应用。
模型参数必须与私有参数建立好映射关系，才能保证参数应用于自助仪表盘和电子表格的效果。
映射设置入口：单击数据模型定制界面的 设置参数 按钮，打开”参数管理“面板：
在”参数面板“中左下角显示当前数据模型的私有查询参数个数的信息，单击该信息，弹出所有私有参数的列表，列表中列出各参数的归属。
批量映射
批量映射是指通过一键操作将所有私有查询资源中的参数自动完成与数据模型参数的映射关系设置。
在”参数面板“中单击 一键映射 按钮，系统自动创建模型参数，并建立好与所有私有参数的映射：
自动映射的参数，默认沿用私有参数的名称、数据类型、控件类型等属性，且默认值为静态列表设置，值为私有参数默认值。
- 当默认值为静态列表设置时，模型参数继用私有参数的数据源不允许修改，其它属性都可以修改；
- 当默认值改为SQL设置时，支持选择当前登录用户拥有查看权限数据库，且SQL表达式支持参数嵌套：参数嵌套示例请参见： 参数联动应用。
单个映射
单个映射是指手工定义数据模型参数，并将其与私有查询资源中的参数进行映射关系设置。
单击 新建参数 按钮，生成一个模型参数设置信息及相关设置项：
定制单个模型参数及映射关系时，有以下几个注意点：
- 映射关系：只允许选择带参数的私有查询。
- 数据源：默认值为”静态列表“时不允许修改，默认继用关联的私有查询参数的数据源；默认值为”SQL“时支持修改，只允许选择当前登录用户拥有查看权限数据库。
- SQL表达式支持参数嵌套。参数嵌套示例请参见： 参数联动应用。
参数设置按钮
设置参数默认值或备选值表达式时，有如下几个按钮供操作：
| 按钮 | 说明 |
|---|---|
| 用于在表达式中引用各类对象：参数、函数、用户属性。
|
| 用于显示表达式示例以供用户参考。 |
| 用于将文本中的表达式格式化。 |
| 用于预览表达式数据结果。参数联动时，返回的是引用参数备选值匹配后的结果。 |
参数复制
数据模型的参数支持复用其它数据模型的参数：通过参数复制功能，实现将目标参数克隆到当前数据模型。具体操作如下：
在数据模型的“参数管理”面板中，单击 复制参数 按钮，在下拉菜单中勾选需要复制的参数，单击 确定 按钮即在当前数据模型中自动生成参数。
注意事项
1、当参数的数据类型是字符串或日期，参数控件类型选择日期控件下的日期类型时，数据格式如下：
- 日期：默认显示yyyy-MM-dd
- 时间：默认显示HH:mm:ss
- 日期时间：默认显示yyyy-MM-dd HH:mm:ss
- 年：默认显示yyyy
- 年季：默认显示yyyyQ[1|2|3|4]
- 年月：默认显示yyyyMM
- 年周：默认显示yyyyW[1|2|3...]
2、当参数的数据类型是非字符串、非日期时，控件类型不能选择日期。
3、填写参数时，切勿加入空格，正确示范如下：
