润乾报表文件通过 TAG 标签方式发布,导出 EXCEL、word、PDF 的文件名称默认与报表文件名称相同,例如,报表文件名叫 gcxmsyqk.rpx, 那么这张报表导出 excel 时文件名称就是 gcxmsyqk.xlsx。
如果需要用其他规则来命名导出的结果文件名,例如将“gcxmsyqk.rpx”的结果文件导出为“工程项目收益情况统计报表 (每季度由成本分析报告负责人整理提供).xlsx”——润乾报表能实现吗?要怎么实现呢?
润乾报表当然可以实现!利用润乾报表 html 标签中提供的“saveAsName”属性,就可以指定报表另存为 EXCEL、PDF 时的文件名称。如果不指定这个属性,那么默认会使用报表文件名来命名导出的文件。
拿自带的 showReport.jsp 为例,我们看下这个标签的设置:
按上面的设置我们设置好标签后,在页面再导出 EXCEL 文件,可以看到文件名默认就是我们指定的文件名称了。
showReport.jsp 是润乾设计器下自带的一个通用页面,只要通过 url 访问 showReport.jsp 并将报表文件名称通过 rpx 参数传递,就可以展现导出对应报表。在将 saveAsName 设置为固定的字符串后,所有报表文件,在导出结果文件时都会使用那个固定的文件名。这么一来,这个 JSP 似乎就没那么通用了……其实,saveAsName 也可以和报表文件名称一样通过变量传递哦!如果在使用前定义了 saveName 变量,那么就可以像报表文件名称一样通过参数传递导出文件名了哦!
进一步,如果有客户想将每张报表标题行中的内容作为导出的结果文件的名称,那我们是不是可以直接在 JS 脚本中获取单元格内容,然后将这个内容设置到这个变量中呢?抱歉,这样可不行,我们需要用 API 代码读取到报表,从对应格子中取到内容,将内容赋给变量,然后用这个变量给定 saveAsName 的值才可以