大数据集导出

ps:1.报表模式应该为 数据分析 模式

2.设置列名 columns 时候，不应该有空格存在，逗号后边也不能有，MySQL复制所有列名时，会自带空格；

 

3.实例：

//获取参数控件值
var Data_Source = this.options.form.getWidgetByName("var_Data_Source").getValue(); 
//alert(Data_Source);

//获取参数控件值

var end_Estimate_Year_Month = this.options.form.getWidgetByName("var_end_Estimate_Year_Month").getValue(); 
//alert(end_Estimate_Year_Month);

//获取参数控件值

var start_Estimate_Year_Month = this.options.form.getWidgetByName("var_start_Estimate_Year_Month").getValue(); 
//alert(start_Estimate_Year_Month);

//获取参数控件值

var month = this.options.form.getWidgetByName("var_month").getValue(); 
//alert(month);

//获取参数控件值

var year = this.options.form.getWidgetByName("var_year").getValue(); 
//alert(year);

//接口为directExportToExcel: function (dsName, fileName, params, colNames)
//注意参数中的特殊字符需要进行url编码，比如大括号，冒号等。

//将变量值赋值到URL中

var paramStr = encodeURIComponent("{var_Data_Source:"+Data_Source+",var_end_Estimate_Year_Month:"+end_Estimate_Year_Month+", var_start_Estimate_Year_Month:"+start_Estimate_Year_Month+", var_month:"+month+", var_year:"+year+"}")
//alert(paramStr)

//数据集传参,//指定导出的数据列，导出字段按此顺序排列，为空默认导出所有,最好不要为空；并且列名之间不能有空格
var colNames = encodeURIComponent("id,Data_Source,Sequence,Year,Month,Estimate_Year,Estimate_Month,Estimate_Year_Month,AR_Source,Operating_Unit,Trx_Number,Order_Number,Delivery,Sales_BU,Salesrep_Number,Salesperson,Order_Type,Customer_Number,Customer,Customer_Short_Name,Account_Type_1,Distributor,Bill_to,Tier1_end_customer,GL_Date,Departure_Date,Ordered_Item,Description,Size,Currency,Quantity,Unit_Price,Amount,Exchange_Rate,Local_Currency,Total_Amount_Local_Currency,Exchange_Rate_TM,Total_Amount_CNY,Total_Amount_USD,Total_Amount_EUR,Total_Amount_JPY,Tax_Classification_Code,Warehouse,Shipping_Org_Area,Customer_PO,Incoterms,Payment_Terms,Included_in_Revenue,Account_Type,Cutting,Granule_Quantity,Market_Segments,Organization,Opp_No,Ship_To_Location,Item_Category,Tokyo_Flag,Sales_Rounting_Num,Outship_Flag,Inship_Flag,Legal_Entity,BD_FD_Flag,Group1,Group2,Group3,Business_Area,MP_Region,Technique_Type,Type,NL_TM,Global_Account_Region,Parent_Account,Oper_Sign,Record_Date");

_g().directExportToExcel("ds1",Data_Source+"-"+start_Estimate_Year_Month+"~"+end_Estimate_Year_Month+"明细",paramStr,colNames);

 

 

 

大数据集导出

 

1. 版本

报表服务器版本	JAR 包
10.0	2018-12-27

2. 概述

2.1 应用场景

目前 FineReport 对于大数据量的模板导出时，可能存在时间过长或内存占用过大的情况。

为了防止这样造成宕机的风险，FineReport 10.0 新增了「大数据集导出」的功能，可直接根据数据集结果进行导出。

2.2 功能描述

此功能主要是针对明细表，它可以实现跳过报表计算直接取数导出。

3. 思路

通过自定义 JS 调用接口，实现原理如下：

1）使用 SXSSFWorkbook 流式行导出，速度快；

2）使用生产者消费者模式，一个线程用于取数，把数据行存在队列中，另一线程读取行导出；

4. 接口

注：此功能只支持关系型数据库，且 SQL Server 数据库需要把游标设置为服务器游标。

Key	Value	举例
sessionID	具体sessionID
dsName	数据集名称	ds1
params	数据集参数 JSON，参数名:参数值	{ id: '9527', name:'Stephen' }
columns	列名称用逗号分割，不指定使用数据集所有字段	col1,col2,...
fileName	导出文件名称，不指定使用默认的“模板名-数据集名称.xlsx”

接口示例如下：

//接口为directExportToExcel: function (dsName, fileName, params, colNames)
//注意参数中的特殊字符需要进行url编码，比如大括号，冒号等。
var paramStr = encodeURIComponent("{param1:1,param2:\"21','22\",param3:\"text\",...}")
//数据集传参，字符串参数建议写成格式\"text\"
var colNames = encodeURIComponent("col1, col2, col3,...")//指定导出的数据列，导出字段按此顺序排列，为空默认导出所有；另外列名逗号之间不能有空格
_g().directExportToExcel("数据集名称", "导出文件名称", paramStr, colNames)

5. 示例一：导出数据集参数为单个值

5.1 模板设置

打开模板 %FR_HOME%\webapps\webroot\WEB-INF\reportlets\doc\Parameter\使用常用参数组合.cpt

5.2 控件设置

在参数面板中添加导出按钮，并新增点击事件，如下图所示：

JS 代码如下：

//接口为directExportToExcel: function (dsName, fileName, params, colNames)
//注意参数中的特殊字符需要进行url编码，比如大括号，冒号等。
var paramStr = encodeURIComponent("{area:华北,province:河北}")
//数据集传参
var colNames = encodeURIComponent("订单ID,货主名称,货主地区,货主省份,货主城市,货主地址")
//指定导出的数据列，导出字段按此顺序排列，为空默认导出所有；另外列名逗号之间不能有空格
_g().directExportToExcel("ds1","订单",paramStr,colNames)

注：这里的参数名是指模板参数名，而不是数据集中的数据列名。

5.3 实现效果

点击导出按钮，可以将 ds1 数据集导出来，如下所示：

6. 示例二：导出数据集参数为多个值

6.1 模板设置

打开模板%FR_HOME%\webapps\webroot\WEB-INF\reportlets\doc\Parameter\使用常用参数组合.cpt

6.2 控件设置

在参数面板中添加导出按钮，并新增点击事件，如下图所示：

JS 代码如下：

//接口为directExportToExcel: function (dsName, fileName, params, colNames)
//注意参数中的特殊字符需要进行url编码，比如大括号，冒号等。
var paramStr = encodeURIComponent("{area:\"华北','华东\",province:\"北京','山东\"}")
//数据集传参
var colNames = encodeURIComponent("订单ID,货主名称,货主地区,货主省份,货主城市,货主地址")
//指定导出的数据列，导出字段按此顺序排列，为空默认导出所有；另外列名逗号之间不能有空格
_g().directExportToExcel("ds1","订单",paramStr,colNames)

注：在sql参数值的前后需要加上 \ ，防止被解析。

注：这里的参数名是指模板参数名，而不是数据集中的数据列名。

6.3 实现效果

点击导出按钮，可以将 ds1 数据集导出来，如下所示：

7. 已完成模板

7.1 示例一模板

已完成模板，可参见：%FR_HOME%\webapps\webroot\WEB-INF\reportlets\doc\Parameter\大数据集导出-单数据.cpt

模板下载请点击：大数据集导出-单数据.cpt

7.2 示例二模板

已完成模板，可参见：%FR_HOME%\webapps\webroot\WEB-INF\reportlets\doc\Parameter\大数据集导出-多数据.cpt

模板下载请点击：大数据集导出-多数据.cpt