润乾报表V4技术资料

CSV逗号分隔值文件（Comma Separated value），是一种用来存储数据的纯文本文件格式，通常用于电子表格或数据库软件。

在报表中，我们提供了一组标签，用来处理导出和导入CSV文件。

1、报表导出为csv格式文件，标签名称为saveCsv，用法如下：
在展现报表jsp页面引入tld:
<%@ taglib uri=”/WEB-INF/csvReport.tld” prefix=”csv” %>
使用保存标签：
<csv:saveCsv reportTagName=”report1″ needSaveAsCsv=”true” csvLabel=”保存为csv文件”></csv:saveCsv>
该标签有三个属性：
第一个属性：
reportTagName是report:html标签的name的值，必须属性
第二个属性：
needSaveAsCsv表示是否显示保存csv文件按钮，默认值是”false”,可选属性
第三个属性：
csvLabel：是为保存csv文件按钮设置的显示值，默认是”导出CSV”，可选属性

如果不显示导出csv按钮，也可以跟报表标签一样通过调用标签内的js方法导出，js方法名为
report1_saveAsCsv()；其中report1是报表展示标签name的值。

标准的页面用法：

<%@ page contentType=”text/html;charset=GBK” %>
<%@ taglib uri=”/WEB-INF/csvReport.tld” prefix=”csv” %>
<%@ taglib uri=”/WEB-INF/runqianReport4.tld” prefix=”report” %>
<a href=”#” onClick=”report1_saveAsCsv();return false;”>csv</a>

<csv:saveCsv reportTagName=”report1″ needSaveAsCsv=”true”></csv:saveCsv>
<table align=center>
<tr><td>
<!–展现报表的标签是一定要有的! –>
<report:html name=”report1″ reportFileName=”aaa.raq”
needPrint=”yes”
funcBarLocation=”top”
/>
</td></tr>
</table>

页面效果：

2、将scv文件的数据导入到填报表报表中(直接入库)，标签名称为importCsvData，
注意：该导入csv数据功能只能把数据导入到行式填报表中
用法如下：
在展现报表jsp页面引入tld:
<%@ taglib uri=”/WEB-INF/csvReport.tld” prefix=”csv” %>
使用保存标签：
<csv:importCsvData name=”report1″ reportFileName=”<%=report %>” needImportDataFromCsv=”true” csvImportLabel=”CSV导入数据”></csv:importCsvData>
该标签有四个属性：
第一个属性：
name是report:html标签的name的值，必须属性
第二个属性：
reportFileName是展现报表的报表名称，必须属性
第三个属性：
needImportDataFromCsv表示是否显示从csv文件导入数据按钮，默认值是”false”,可选属性
第四个属性：
csvImportLabel：是为从csv导入数据按钮设置的显示值，默认是”从csv导入数据”，可选属性

如果不显示csv导入数据按钮，也可以跟报表标签一样通过调用标签内的js方法导入，js方法名为
report1_importDataFromCsv()；其中report1是报表展示标签name的值

页面效果：

在使用以上两组标签的同事，还需要在web.xml文件需加如servlet配置：
<servlet>
<servlet-name>CsvFileServlet</servlet-name>
<servlet-class>com.runqianapp.csvReport.CsvFileServlet</servlet-class>
</servlet>

<servlet-mapping>
<servlet-name>CsvFileServlet</servlet-name>
<url-pattern>/servlet/CsvFileServlet</url-pattern>
</servlet-mapping>