本小节对超链接和填报表超链接的定义、用法和适用场景进行了详细介绍。
单元格的超链接属性,可以是属性“值”,也可以是“表达式”。
如果超链接字符串不需要动态生成,可以直接在属性“值”中写所要链接的路径。
如果超链接字符串需要根据单元格或者参数值动态生成,则需要在超链接“表达式”中写所要连接的路径。
超链接路径可以是绝对路径也可以是相对路径。下面分别举例说明:
1、在超链接中引用单元格的值,例如:
"defaultArg.jsp?report=/exercise/grid&customerid="+urlencode(A6,"UTF-8")
2、在超链接中链接到其他报表页面,例如:
reportJsp/showReport.jsp?rpx=test.rpx
3、绝对路径
绝对路径一定要写完整,包含传输协议。例如:http://www.raqsoft.com.cn,不可只写 www.raqsoft.com.cn。
4、相对路径
相对路径是相对应用路径的,例如:jsp/myreport.jsp,系统运算后会自动给加上应用的路径,相对路径最前面不需要用/开头。
5、dashboard中使用超链接
dashboard中报表的超链接联动采用js函数的方式,可以同时刷新多个面板的内容, 说明如下:
dashboardLink( url1,boardId1,url2,boardId2,urln,boardIdn,......)
urln为要刷新的子报表的url,boardIdn为要显示此url的子报表面板id(即子报表的逻辑名)
超链接如:
="javascript:dashboardLink('board.jsp?board=2.rpx&arg1=A1','item2')"
(1) board.jsp是展现Dashboard中的单个子报表,用于动态关联时的超链接url。
(2) 当超链接使用dashboardLink函数时,给函数传中文参数值时可不用转码,直接传递中文。
6、超链接定义
编辑超链接有两种方式,一种是直接在属性值编辑框中添加超链接url串,另一种添加表达式。
在超链接“表达式”中双击。双击后会弹出超链接定义窗口,选择jsp路径,并配置参数名称与参数值。系统会自动生成超链接表达式,同时也可以直接在表达式tag页中添加或修改超链接表达式,表达式中link函数的用法可参考《程序员参考》link()小节。
当要链接的JSP资源需要传递的参数有多个时,可直接在JSP中添加参数,选择JSP文件时会自动将参数显示到参数列表中。当参数类型为报表名称或JSP名称时可通过动作按钮快速将报表或JSP里所需要的参数添加至参数列表中,效率高于手动逐条添加,使用方法如下:
Jsp中需添加参数注释,注释格式为:
<!--### 参数名=参数标题,参数类型,缺省值;… ###-->
参数类型取值说明:
参数类型 含义
0 缺省(以=开始表示表达式)
1 报表名称
2 JSP名称
3 日期(可界面选择)
4 时间(可界面选择)
5 日期时间(可界面选择)
举例:
tetLink.jsp添加的注释内容如下:
当选择的JSP文件中已添加注释参数时,超链接表达式中选择JSP后会自动解析出JSP中的参数。如上图(1)所示将JSP中rpx和arg1参数显示至参数列表中。
参数列表中的[动作]是根据JSP中参数注释里参数类型判断显示。参数类型是报表名称或者JSP名称时,[动作]会解析为[列出参数],点击[列出参数]按钮,会自动添加报表或者JSP中的需要传递的参数,上图(2)所示点击[列出参数]将test.rpx中的subject参数添加至参数列表中;其他参数类型时[动作]为空。
注意:
1、超链接定义中的参数不需要在当前报表中定义。
2、选择JSP路径之前,需要先在【工具】à【选项】à【JSP】中设置JSP主目录,这样在JSP主目录下的路径中选择jsp文件时,此处会自动变成相对路径,点击超链接时才能正常连接访问。
超链接窗口
超链接跳转方式:
1、属性值为_self时,在当前页面跳转。
2、属性值为_blank时,在新页面打开。
该属性如果不写,缺省为_self。
为填报表单元格增加超链接时,可选中单元格,在右侧单元格属性中增加超链接属性值。
使用超链接时,单元格属性需设置为不可编辑。
使用超链接时,超链接的值必须用引号圈起来。
超链接路径可以是绝对路径也可以是相对路径。下面分别举例说明:
1、在超链接中链接到其他填报表页面,例如:
"showInput.jsp?sht =test.sht"
2、在超链接中引用单元格的值,例如:
"showInput.jsp?sht=yuangong.sht&arg1="+C6
3、绝对路径
绝对路径一定要写完整,包含传输协议。例如:"http://www.raqsoft.com.cn",不可只写 "www.raqsoft.com.cn"。
4、相对路径
相对路径是相对于展现填报表的jsp所在路径,例如,展现填报表的jsp为http://localhost:6868/demo/test/showInput.jsp,超链接值为"jsp/myinput.jsp?sht=mytest.sht",系统运算后的超链接跳转路径为:http://localhost:6868/demo/test/jsp/myinput.jsp?sht=mytest.sht,相对路径最前面不需要用/开头。