报表过滤参数构件



每张报表的过滤参数是不一样的，本模块是为每张报表设置过滤参数，在报表打印预览模块中预览报表时，报表预览打印模块会根据每张报表的过滤参数设置生成不同的过滤界面，以便用户进行打印预览。如下图：

其字段说明如下：

参数标签名：过滤参数在界面上的汉字标签名。

报表名称：报表的名称，选择一个已做好的报表名称，指示该参数属于该报表。

参数物理名：在生成报表的SQL语句中的参数名称。在没有键字段时参数物理名是传入参数，在有键字段时参数物理名只是用于用户选择后的显示，而键字段则是传入参数。

参数类型:参数类型有字符串型、日期型、日期时间型、数字型、整数型、布尔型、报表模板变量，对于字符串型、日期型、日期时间型系统会自动在参数值上加单引号（‘’）后把参数值替换到SQL中，数字型、整数型、布尔型、报表模板变量的值不会加单引号，对于参数物理名去掉第一个字符后加上单撇（‘）如果与报表模板中定义的变量名相等，则会把该参数取值填入报表模板中该变量定义所处的单元格中。对于报表模板变量，是指在报表模板中定义的变量，对于报表模板变量的参数物理名去掉第一个字符后加上单撇（‘）如果与报表模板中定义的变量名相等，则会把该参数取值填入报表模板中该变量定义所处的单元格中。

输入方式：参数的输入方式，选择一种输入方式，输入方式有：0：输入；1：日历下拉框；2：数据单列下拉框选择；3：数据表格下拉框选择；4：数据树下拉框选择；5：数据下拉树表格选择；6：模块自动传递参数值；在6的情况主要用于把报表挂到操作上时用，当点击报表预览或报表打印操作时，调用该报表。当输入方式是“6：模块自动传递参数值”时，必须选择“取值方式”和填写“取值字段名或隐藏元素名”。

参数顺序号：参数在报表打印预览界面上的位置顺序。

对应键字段：如果输入方式为2、3、4、5时，要指定一个键字段，当选择数据集的一条记录时，会把键值赋给该字段。如果有键字段则必须把键字段名设置为和SQL语句中的参数名称一样，如果没用键字段则必须把参数物理名设置为和SQL语句中的参数名称一样。一般下拉框都有键字段，这时参数物理名只用于对用户的显示。如：选择一个单位，单位名称只是用于显示，而单位ID则是真正的传入参数值。

下拉数据集：当输入方式为2、3、4、5时，选择一个下拉数据集。

下拉数据集取值方式：当输入方式为2、3、4、5时，选择的数据集SQL中有参数，则要选择这些线参数的取值方式。

取值方式：参数的取值方式，当输入方式为6时，必须选择一种取值方式，取值方式有：0：从页面字段中取当前值；1：从页面字段中取原值；2：隐藏元素中取值；3：主界面元中取；4：树结点键值；5：树父节点键值；6：当前页面查询参数中取（从当前页面查询参数所获得的值取，比如用户过滤后相应的查询参数获得了过滤时的设置值，则从与取值字段名相同的查询参数中取值,用于模块的操作上挂接的报表）。

取值字段名或隐藏元素名：如果取值方式为2，则这个字段存的是隐藏元素名，取值方式为为其它时这个字段存的是字段名。

说明：报表中的SQL参数取值都是以字符串替换方式来赋值。

注意事项：由于参数值的传入是通过字符串替换完成的，所以参数物理名之间、对应键字段之间、参数物理名与对应键字段之间的名字字符串不能相同也不能相互包含。如参数物理名为@WarehouseID_，对应键字段为@WarehouseID_，这样会出问题，当在SQL中找@WarehouseID时会把SQL中的@WarehouseID_包含字符替换掉。另外，@DepID_和@EmpID_是预留参数，不需要定义，它们分别是登录人的单位编号和用户编号。注意新参数不要与@DepID_和@EmpID_相同也不能与它们互相包含。不论是参数物理名还是对应键字段，如果在报表中要作为报表变量使用时，前面必须加一个@，该变量去掉@后与报表单元格中的变量去掉`后进行对比，如果一样则将值填入到该报表表格中。