数据集参数
模型查询
模型查询中的参数由拖拽字段生成的条件会自动生成参数。
详情请参考 电子表格-模型查询 相关内容。
SQL查询
SQL查询中,在表达式中通过“${ParamName}”来标识参数,其中“ParamName”为参数名;用“{[ ]}”表示该参数可为空。
如:参数表达式 {[id = ${产品编码}]},表示id字段与参数“产品编码”匹配,且参数允许为空用于输出所有编码的产品。
示例:
参数管理
用户创建带参数的电子表格查询、SQL查询完成后,还需要在参数管理中设置参数的映射关系,才能在电子表格中使用参数。
参数管理主要用来设置数据集参数和电子表格参数之间的映射关系。
比如当一个数据集参数包含了A、B、C、D等部分的内容,用户使用数据集1想要参数的A内容、数据集2想要参数的B内容,这时候需要设置参数并进行映射。
功能入口:在工具栏中点击 参数管理 按钮。
打开”参数管理“面板:
在”参数面板“中左下角显示当前电子表格包含的参数个数信息,单击该信息,弹出所有数据集包含的参数列表。列表中清晰的列出各参数的数据来源。
参数映射方法分为以下两种:
批量映射
批量映射是指通过一键操作将所有数据集中的参数自动完成与电子表格参数的映射关系设置。
在”参数面板“中单击 一键映射 按钮,系统自动创建电子表格参数,并建立好与所有数据集的映射:
自动映射的参数,默认沿用数据集参数的名称、数据类型、控件类型等属性,且默认值为静态列表设置,值为数据集参数默认值。
- 当默认值为静态列表设置时,参数继用数据集的数据源,不允许修改,其它属性都可以修改;
- 当默认值改为SQL设置时,支持选择当前登录用户拥有查看权限数据库,且SQL表达式支持参数嵌套。
示例按钮功能:显示SQL表达式,且支持参数嵌套。
单个映射
单个映射是指手工定义电子表格参数,并将其与数据集参数进行映射关系设置。
单击 新建参数 按钮,生成一个电子表格参数设置信息及相关设置项:
定制单个电子表格参数及映射关系时,有以下几个注意点:
- 映射关系:只允许选择带参数的数据集。
- 数据源:默认值为”静态列表“时不允许修改,默认继用关联的数据集参数的数据源;默认值为”SQL“时支持修改,只允许选择当前登录用户拥有查看权限数据库。
- SQL表达式支持参数嵌套。
参数设置按钮
设置参数默认值或备选值表达式时,有如下几个按钮供操作:
按钮 | 说明 |
---|---|
用于在表达式中引用各类对象:参数、函数、用户属性。 | |
用于显示表达式示例以供用户参考。 | |
用于将文本中的表达式格式化。 | |
用于预览表达式数据结果。参数联动时,返回的是引用参数备选值匹配后的结果。 |
关于更多参数的设置方法,详情可参考 数据模型-参数应用 。