让数据成为企业发展的驱动力!

盈帆报表参数使用说明(web设计器)


制作报表时,很多时候会需要其他的参数配合,最终达到报表效果。参数在数据集中使用,可以进行数据筛选;在公式中使用,可以进行条件判断;在报表中使用,可以直接显示。

模板参数

模板参数的名称,必须以字母(大小写)或下划线开头,由字母、数字、下划线组成。不要用全大写字母加数字格式,如:A1,B1,容易与单元格混淆。通常情况下,模板使用参数时,使用@{param}格式在超级链接、区域联动时,参数需要传递的是跳转后的模板参数,需要使用“param=…”格式。

A模板有模板参数paramA,B模板有模板参数paramB,在A模板中数据集或模板用到参数时,写@{paramA},B模板同理

在超级链接时,A模板想跳转到B模板,A模板设置超级链接时,参数需要写成“paramB=…”,跳转到B模板时,B模板接收到的参数就是A模板传递过来的,同理B模板想跳A模板,超级链接参数设置时使用“paramA=…”。如果A模板想将当前的paramA参数传递给B模板,则需要写成paramB=@{paramA};同理B模板想将当前的paramB参数传递给A模板,则写成paramA=@{paramB}

区域联动时,参数设置与超级链接一致。A模板的主页sheet1上有其他子表格,区域联动参数设置时,直接写“paramA=”格式。


默认情况下,设置了模板参数,在报表预览时,会产生模板参数的工具栏。根据实际情况,设置参数,点击查询后将实际的参数使用到报表中,并看到实际效果。

在模板属性中,可以隐藏参数工具栏,预览时,使用的参数实际值就是设置的参数默认值。如设置了隐藏参数工具栏,则无法通过预览的报表再次修改参数。


参数需要设置实际的数据类型,数据类型整体上主要分为三大类:数值(整型、浮点)、字符(字符串、日期、日期时间)、布尔(布尔)。当参数设置成字符时,程序自动将参数添加单引号,将其设置为字符。在SQL语句中没有正确的使用参数类型,查询时很可能会出现查询不到的结果。公式中如使用参数同样需要注意类型的设置。例如:数据库中的“名称”字段是字符串,参数的数据类型设置了“整型”,SQL语句查询时,会认为这条语句是错误的,查询不出来结果。

为了方便操作,可以设置控件名称,与控件类型。在报表显示时,显示相应的设置内容。


模板参数使用的是多选下拉框,或多选下拉树时,实际参数获取的值格式为“A,B,C”,在使用参数值时,需要用JS公式转化成实际的数组,如不转化会认为公式中带有“,”的表达式,最后返回的是最后一个值。


数据链接使用WebService(JSON)时,http请求中可以设置参数。先在所需链接Web数据源的模板设置一下模板参数,再用设置好的模板参数代入web数据源请求地址中。

例如:http://192.168.1.10:8099/thirdSys/getJsonData/total=@{param1}&id=@{param2}