控件实际值和显示值

1.1 版本

1.2 功能入口

1）控件应用中，当原始数据中存储的字段不适宜展现在报表上；或需要根据不同的原始数据在报表中显示不同的值时，部分控件支持通过使用 数据字典 功能将实际值和显示值做巧妙变换。

2）支持数据字典功能，有实际值和显示值区分的控件如下表所示：

控件
单选按钮组控件
复选按钮组控件
下拉框控件
下拉复选框控件
列表控件
下拉树
视图树

3）例如，为下拉框控件设置数据字典，如下图所示：

1）参数控件绑定数据字典，传值的时候传的都是实际值；显示值只是用来显示，传值的时候不会被传递。

例如，设置下拉框控件的实际值为 英文简称 ，显示值为 销售员 ，如下图所示：

当选择显示值销售员时，传递的为实际值英文简称，如下图所示：

2）通常实际值和显示值是一一对应的关系，但也会存在不一一对应的情况，即多个显示值对应一个实际值；多个实际值对应多个显示值。

• 一个实际值对应多个显示值时，控件会列表展示所有的显示值，不会将同样的值合并。如下图所示：

• 一个显示值对应多个实际值时，控件会将所有显示值显示出来。如下图所示：

注：一个显示值对应多个实际值时，传递值时同样传递实际值，按顺序对应，不会合并。

3）控件默认值处可以填写显示值，也可以填写实际值。填写显示值也可以匹配到选项，但传递值时传递的依旧是实际值。

如果实际值和显示值不一一对应：

• 控件值处写入显示值，此显示值对应多个实际值：传值时，将会按顺序传递第一个实际值。

• 控件值处写入实际值，此实际值对应多个显示值：显示时，单选情况下只会选中第一个显示值。

示例完成一个实际值和显示值不一样的查询模板，演示实际值和显示值不一样时，值的传输规则。

3.1 新建模板

新建普通报表，如下图所示：

3.2 新建数据库查询

新建数据库查询 ds1，输入SQL 语句：SELECT * FROM 销量 where 英文简称 = '${sale}'，如下图所示：

3.3 参数绑定控件

进入参数面板编辑界面，将 sale 参数添加到参数面板，绑定下拉框控件。如下图所示：

3.4 设置数据字典

选中下拉框控件，设置数据字典，类型设置为数据库表，数据库为 FRDemo ，数据库表为 销量 ，实际值为 英文简称，显示值为 销售员 ，如下图所示：

3.5 设计报表

设计报表，在 A1 单元格中输入公式 $sale 。如下图所示：

3.6 效果预览

保存模板，点击「分页预览」，控件选项为显示值：销售员，但传递的为实际值：英文简称，如下图所示：

点击下载已完成模板：控件实际值与显示值.cpt

控件实际值与显示值常见问题及解决方案可参考：控件实际值与显示值常见问题