设计器授权问题

打开设计器，选择设计器授权的时候报”无效的logo文件”，无论是重做授权还是更新jar包都不能解决问题。

问题出现原因

当用尽各种方法都未能解决问题时，要关注以下问题的提示信息，如下：

请注意红框内的内容，发现在bonzer.gif后面多了一个空格，这就是产生问题的原因。

解决办法

让销售重新做一份bonzer.gif后面没有空格的授权即可。

这个问题虽然不是什么难题，但也必须注意，除了操作过程中大家要细心以外，在写程序的时候也要考虑周全。

3.5升级至4.0及其以上版本问题

客户方报表升级后，一直有授权不对的问题，指导客户放置对应的位置和一些修改文件的操作后，问题仍然存在。

问题出现原因

如果报授权不匹配的错误，而且是产品升级以后才出现的，那说明在升级过程中，用户并未将旧系统中的相关配置或授权文件完全删除。这样需要检查web.xml文件以及reportConfig.xml文件以及一些缓存文件等。

经检查，客户的web.xml文件确实存有3.5的信息，这会导致授权错误。

解决办法

将web.xml中关于3.5的信息完全删除，并配置reportConfig.xml文件，将正确的授权放到相应位置即可。

这个问题不是什么特别的问题，但是我们在解决过程中明白了一个道理，任何操作都有可能导致最后的结果出现问题，所以在实施过程中，应该尽量做到考虑全面、操作细致。

1.jndi数据源配置（即在dataSource中配置）

此配置适用于在j2ee的服务器中配置了jndi连接池，比如：tomcat服务器下在conf\Catalina\localhost配置了连接池，则可以通过reportConfig.xml的jndi配置连接数据源。

格式如下：

<config>
<name>dataSource</name>
<value>jdbc/test,oracle;exercise,sqlsvr,1,iso8859-1,GBK,0</value>
</config>

关于reportConfig.xml中的jndi数据源的配置详细如下：

数据源的JNDI名称,数据库类型[,取数时是否需要转换编码,数据库字符集编码,显示报表时的字符集编码][,SQL是否需要转码];[重复]……

另外需要注意的是，这里的数据源的jndi名称要与连接池中配置的jndi数据源名称一致。

2、jdbc直连数据源配置：

此配置适用于没有在j2ee服务器上配置jndi连接池。

详细的配置方法如下：

在<reportConfig></reportConfig>加入如下的配置：

<jdbc-ds-configs>
<jdbc-ds-config>
<name>db2</name>
<db-type>db2</db-type>
<connection-url>jdbc:db2://192.168.0.217:50000/sample</connection-url>
<driver-class>com.ibm.db2.jcc.DB2Driver</driver-class>
<user-name>administrator</user-name>
<password>runqian</password>
<db-charset>gbk</db-charset>
<client-charset>gbk</client-charset>
<extend-properties></extend-properties>
</jdbc-ds-config>
</jdbc-ds-configs>

注：读取配置文件的时候，会首先读取dataSource中jndi的配置，如果dataSource没有相关的数据源配置才会读取jdbc直连配置的数据源。

当报表出现横向扩展的时候，导致横向扩展所在列也横向扩展，这样就会影响此扩展格的上方和下方的单元格，这个就是问题产生的原因。

1：嵌入式或者引入式的主子表

此种方法由于子报表放在固定了宽度的单元格中，所以子报表在扩展的时候不会影响到其他单元格，这样，在子报表的横向扩展就对其他区域有什么影响了。

两种报表浏览样式如下（这两种报表的具体设计方法请参照初级设计教程）：

可以看到两个报表都有横向扩展而且展示出来的结果是不一样的。嵌入式主子表的优点是固定了单元格的大小，而由于每个单元格内容都不同，所以有可能出现列无法对其的现象；引入式主子表没有出现这个问题，但是如果横向扩展过多，也会影响美观。

2：横向扩展的强制换行

这种方法使得所有区域的报表都是横向扩展的，这样就可以控制横向扩展了多少单元格，让报表可以只横向扩展固定个数的单元格就进行换行，这样就可以避免上述不美观的情况。

这种横向扩展强制换行方法有以下两种：

（a）：使用to函数进行强制换行，这种方法可以参考强制换行这篇文章，里面有详细介绍。

（b）：使用to函数加valueat函数，实现动态的取数，这样也可以实现报表的强制换行，这种方法可以参考valueat函数的使用方法和相关文章的介绍。

注意：由于使用to函数实现了横向扩展固定的列数，当报表区域过多时，可能会出现有的单元格根本不需要扩展但也随着横向扩展了的情况，这样就需要对报表进行修改了。

3：这种方法是将以上两种方法进行中和，将有横向扩展的子报表进行横向的强制换行，这样在显示的时候就在横向上进行了控制，既取到了想要的数据，又使得页面变得美观。

综合比较上面的几种方法，如果需求比较简单，可以选择方法1和2，设计起来比较简单；如果需求比较复杂而且对美观度要求比较高的话，可以采用方法3。

第一步：新建一张报表，连接demo数据源。

新建一张报表，连接sql数据源，增加一个参数arg1，类型为字符串组；然后增加一个数据集ds1，数据集的sql为：SELECT 类别.类别ID,类别.类别名称,类别.说明 FROM 类别 ，给数据集增加两个参数，如下图所示：

然后增加数据集的检索条件：类别.类别ID in (?) or ? is null，最后数据集的sql样式如下图所示：

第二步：设计报表

设计一张如下图所示的报表，报表的上下两行都为空白行：

第三步：设置行后分页和左主格

设置A3、B3、C3单元格的左主格为A2，然后设置第三行为行后分页，如下图所示：

第四步：制作参数模板

新建一张可以填报的普通报表，连接demo数据源，然后新建一个数据集ds1，数据集的sql为：SELECT 类别.类别ID,类别.类别名称 FROM 类别，如下图所示，设置B1单元格的编辑风格为下拉数据集，具体的样式如下图所示：

然后设置B1的变量名为arg1，设置的方法见下图：

第五步：保存并发布报表

保存主报表名字为fenye.raq，参数模板的名字为fenye_arg.raq，然后在设计器中发布主报表，并选择相应的参数，就能看到下面两幅图的效果：

这样就可以根据类别分页，导出的时候也会跟页面上一样，分多个sheet页展现，实现了上面的需求。

实现思路：
1. 设计单元格表达式根据参数不同而变化，从而实现样式跟随表达式变动。
2．点击一个超链接按钮通过url强制传参给报表中的单元格，从而控制报表的样式。

首先来看这样一张报表（bonzer\webroot\reportFiles\1.基础报表\交叉报表.raq），在页面上的展现效果如下图:

这是一个多维交叉分组报表，上表头是地区/城市，左表头是日期。

如果想动态改变一下报表的样式，左表头变成地区和城市的分组展现，上表头变成年份和月份的分组展现，并且只通过一张报表，这就需要用文章标题中提到的：利用参数实现行列变换的方法了。

本文以此报表为基础，实现可以行列互换的功能（上表头和左表头互换），使得报表在web页面上样式改变。

第一步：设计器中选择配置-参数

给报表增加一个参数，我们把这个参数叫做转换参数，顾名思义，这个参数就是控制行列转换用的。

第二步：修改单元格表达式，让单元格接受参数

我们把C2单元格的表达式修改为：
= if(@arg1==”1″,ds1.group(year(OrderDate),false,OrderDate!=null)+”年”,ds1.group(ShipRegion,false,ShipRegion!=null))
此表达式的意思是：当参数arg1的值为1时，C2单元格的表达式为ds1.group(year(OrderDate),false,OrderDate!=null)+”年”，否则默认为ds1.group(ShipRegion,false,ShipRegion!=null)
关于博计报表中if（）函数的用法请参考博计帮助文档中的相关介绍。
据这个逻辑，依照地区与城市之间的关系，年份和月份之间的关系，把单元格的表达式做如下修改：
C3：= if(@arg1==”1″,ds1.group(month(OrderDate),false)+”月”,ds1.group(ShipCity,false))
A4：= if(@arg1==”1″,ds1.group(ShipRegion,false,ShipRegion!=null),ds1.group(year(OrderDate),false,OrderDate!=null)+”年”)
B4：= if(@arg1==”1″,ds1.group(ShipCity,false),ds1.group(month(OrderDate),false)+”月”)

第三步：修改交叉表头并在其中设置超链接

红色框中的交叉表头区是整张报表的关键，既要在行列转换的时候做到文字跟随变化，又要充当转换控制的按钮。
修改此单元格的表达式为：=if(@arg1==”1″,”分布,运货重,时间”,”时间,运货重,分布”)
然后在此单元格的属性中：

加入超链接属性：

if(@arg1==null, “/reportBase/reportAspx/showContent.aspx?report=/交叉报表.raq&arg1=1″,”/reportBase/reportAspx/showContent.aspx?report=/交叉报表.raq”）

这个超链接的作用就是点击这个单元格，赋予arg1参数值，然后通过超链接中的url把参数传递到asp中的报表里，通过对参数值的判断，来确定超链接中的url，这样就可以来回转换，防止只能转换一次的情况出现。（超链接也可以设置在其他单元格中，本文中这样做是为了美观且容易理解）
接下来，我们把报表发布到页面上去看效果：

点击设置了超链接的表头单元格后，url自动转换为/reportBase/reportAspx/showContent.aspx?report=/交叉报表.raq&arg1=1，强制把参数arg1=1传给报表的各个单元格，单元格表达式发生变化，报表样式也随之变化，于是实现了行列互换的效果：

此时，如果想转换到前一种样式，只需再点击一次表头单元格即可。
在这个报表中，我们运用了很多颇具技巧性的方法，例如参数结合超链接的运用，if（）函数的运用，往往一些看似很复杂的报表，通过一些技巧性的做法都是可以迎刃而解的。

客户在使用博计打印功能的时候，在打印预览页面选择”按高”或”按宽”缩放。

当前报表行数比较少（如本例中是一行），当点击”按高缩放”的时候会出现下面的提示，

点击确定以后，打印内容会有所变化，有的客户比较费解。

现象说明：

打印缩放是根据当前内容进行宽高同比例缩放，当报表内容超过一页纸时，整个报表会按比例缩小到一张纸的范围；当报表内容不足一页纸时，报表会按比例填充到整张纸范围。

如本例中的A1单元格，设置其宽高都为8.0，然后选择按高缩放。此时报表的内容会填充满整张纸，即报表行高会变成纸张高度，同时，报表宽度也会同比例增加到纸张高度大小，这时问题出现了。因为A4纸张的宽度要远小于其高度，此时A1单元格的宽度为纸张高度，那么它将远远超过纸张宽度，就是说，报表中的某一列宽度比给定（A4纸）的纸张宽，这种情况是报表工具不允许的。

同理，按宽缩放也一样。

那如何避免这种情况的发生呢？我们还需要从报表设计入手：

首先，我们制作的报表如果行数比较少，但还想使用按高缩放的功能，这时对于我们列宽的要求就比较高了，当选择按高缩放的时候，一定不能让其中的某列宽度大于纸张宽度；

其次，行高的问题可以通过将该单元格设置成合并格，并勾选”单元格”拆分选项来解决；

最后，要遵循报表设计的规则，尽量避免一些极端情况的发生。

首先，需要知道报表是如何在页面上展现的。设计器安装目录：

\webroot\reportBase\reportAspx\showReport.aspx就是一个典型的展现博计报表的aspx例子：

从上图可以看到整个报表标签< rq:HtmlTag>包含在一个< table>标签中，在报表扩展的时候，就是在这个table中去扩展。
想通过点击鼠标去获得单元格的值，就要定位单元格。如何去定位一个单元格呢，就要通过< rq:HtmlTag>中的name属性，然后加上单元格的位置来定位。这里我们举例的报表来自博计设计器的安装目下的：

\webroot\reportFiles\1.基础报表\交叉报表

例如：(”report1″).rows[1].cells[1]就代表的是报表的B2单元格。(表头为rows[0],第一列为cells[0])

接下来，在页面中增加一段JavaScript函数，用这个函数去获得单元格的值。

< script language=”javascript”>
function _getDispValueByName(){
var cell = document.getElementById(”report1″).rows[1].cells[1].innerText; //通过ID去定位单元格位置
alert(cell); //用alert()函数弹出这个单元格的值
}
< /script>

最后，可以做一下效果展示，在页面上增加一个按钮，来触发这个JavaScript函数。

< input type=”button” onclick=_getDispValueByName() value=”check”>

通过这个例子,不仅知道怎样去定位单元格获取单元格的值，还可以看出博计报表中是可以使用强大的JavaScript函数来实现很多特殊功能的。

例如客户想画一个柱状图，下面讲一下实现过程。新建一个jsp。

jsp需要引入的相关包，因为本例比较简单所以引用的包也较少。

<%@ page import=”com.runqian.report4.usermodel.*”%>
<%@ page import=”com.runqian.report4.model.*”%>
<%@ page import=”com.runqian.report4.util.*”%>
<%@ page import=”com.runqian.report4.usermodel.graph.*”%>

第一步新建一个默认的空报表，代码如下

ReportDefine rd = new ReportDefine2(1, 1);//一行一列的报表
IRowCell rowCell = rd.getRowCell(1);
IColCell colCell = rd.getColCell((short)1);
rowCell.setRowHeight((float)150);
colCell.setColWidth((float)150);

第二步构造一个空的统计图：

// 构造一个空统计图
GraphProperty gp = new GraphProperty();

// 设置统计图类型–柱状图
gp.setType(GraphTypes.GT_COL);

// 设置坐标轴颜色
gp.setAxisColor(238130238);

// 设置柱形图间距
gp.setBarDistance(”20″);

// 设置统计图标题
gp.setGraphTitle(”统计图例子”);

// 设置标题与图形之间的距离
gp.setTitleMargin(”10″);

// 设置横轴标题
gp.setXTitle(”横坐标轴”);

// 设置纵轴标题
gp.setYTitle(”纵坐标轴”);

第三步，构造分类轴和系列值的定义，并把他们赋给统计图，

GraphCategory[] graphCat = new GraphCategory[1];
GraphSery[] sery=new GraphSery[1];
for(int i = 0; i<graphCat.length;i ++){//由于本例比较简单，所以这个循环看起来是多余的，但是在实际的应用中，这个循环 在赋值过程中很有用处
GraphCategory category = new GraphCategory();
category.setCategory(”销量”);
graphCat[i] = category;

//根据分类设置它对应的系列对象

for(int j = 0; j<sery.length; j ++ ){
GraphSery gSery = new GraphSery();
gSery.setName(”name”);
gSery.setExp(”=200″);
sery[j]=gSery; }
graphCat[i].setSeries(sery);
}
gp.setCategories(graphCat);

最后设置单元格，并设置该单元格的图表

INormalCell iGraphCell = rd.getCell(1,(short) 1);
iGraphCell.setCellType(iGraphCell.TYPE_GRAPH);

iGraphCell.setGraphProperty(gp);

rd.setCell(3, (short)1, iGraphCell);
IByteMap exp3 = new ByteMap();
exp3.put(INormalCell.VALUE, “graph()”);
iGraphCell.setExpMap(exp3);

这样统计图就画完了，在后面加上标签进行解析

//设置request中报表定义对象
String rptName = “RPT_”+Double.toString(Math.random());
request.setAttribute(rptName,rd);

<report:html name=”report1″
srcType=”defineBean”
beanName=”<%=rptName%>”
/>

这样就可以浏览这个jsp，在页面上可以看到一个有关于销量的统计。如图：

这样就完成了api的统计图设计。有需要的朋友可以用这个作为参考。

有两种办法可以实现上面的需求，分别为：

1．展现时候展现一张不分页的，导出的时候导出另外一张报表，在导出的时候调用API导出那个分页的报表。

2．在jsp中设置width=”-1″ ,excelUsePaperSize=”yes”然后把报表设置成按纸分页的，也可以正常导出excel。

下面分别介绍一下这两种方法的实现过程：

第一种：调用API的方法。

第一步：制作一张超过255列的报表，报表的样式如下图所示(这里直接用to(1,300)函数实现了)

保存这个报表为300col.raq。

第二步：设置分页。

点击属性-报表属性-分页，设置分页方式为按纸分页，然后另存这个报表为300col1.raq

第三步：编写导出的API

导出excel的API内容如下：

<%@ page language=”java” contentType=”text/html; charset=gbk”
pageEncoding=”gbk”%>
<%@page
import=”com.runqian.report4.usermodel.*,com.runqian.report4.util.*,com.runqian.report4.model.ReportDefine”%>
<%@ page import=”java.io.*,com.runqian.report4.usermodel.DataSetConfig
“%>
<%
Context cxt = new Context();
String reporthome = Context.getInitCtx().getMainDir();
String path = application.getRealPath(reporthome);
String raq = path+File.separator+”300col1.raq”;
ReportDefine rd = (ReportDefine) ReportUtils.read(raq);
Engine engine = new Engine(rd,cxt);
IReport ir = engine.calc();
ReportUtils.exportToExcel(path+File.separator+”300col.xls”,ir,true);
%>

在发布不分页的报表(也就是300col.raq)的jsp中调用上面的jsp，将300col1.raq导出，就可以实现导出超过255列excel的需求了。

第二种：使用标签实现。

在展现报表jsp的博计标签中加入如下两个内容： width=”-1″ , excelUsePaperSize=”yes”，width=”-1″的含义是页面展现的时候纸张宽度无线大，这样展现的时候就不分页了，而excelUsePaperSize=”yes”的含义是导出excel的时候按照设置的纸张大小来分页，jsp的内容如下：

<%@ page contentType=”text/html;charset=GBK” %>
<%@ taglib uri=”/WEB-INF/runqianReport4.tld” prefix=”report” %>

<% //这里为两种方法准备图片连接的公共部分
String appmap = request.getContextPath();
String printImage = “<img alt=打印 src=’” + appmap + “/images/print.gif’ border=no style=’vertical-align:middle’>”;
String wordImage = “<img alt=导出Word src=’” + appmap + “/images/doc.gif’ border=no style=’vertical-align:middle’>”;
String excelImage = “<img alt=导出excel src=’” + appmap + “/images/excel.gif’ border=no style=’vertical-align:middle’>”;
String pdfImage = “<img alt=导出PDF文件 src=’” + appmap + “/images/pdf.gif’ border=no style=’vertical-align:middle’>”;
String firstPageImage = “<img src=’” + appmap + “/images/firstpage.gif’ border=no style=’vertical-align:middle’>”;
String lastPageImage = “<img src=’” + appmap + “/images/lastpage.gif’ border=no style=’vertical-align:middle’>”;
String nextPageImage = “<img src=’” + appmap + “/images/nextpage.gif’ border=no style=’vertical-align:middle’>”;
String prevPageImage = “<img src=’” + appmap + “/images/prevpage.gif’ border=no style=’vertical-align:middle’>”;
String submitImage = “<img alt=保存到数据库 src=’” + appmap + “/images/savedata.gif’ border=no style=’vertical-align:middle’>”;
String importExcelImage = “<img alt=导入Excel文件 src=’” + appmap + “/images/importExcel.gif’ border=no style=’vertical-align:middle’>”;
%>
<form id=”form1″ action=”excel.jsp”>
<table align=center>
<tr><td>
<input type=”button” onclick=”form1.action” value=”导出excel”>
<report:html name=”report1″ reportFileName=”300col.raq”
needSaveAsWord=”yes”
needSaveAsPdf=”yes”
needSaveAsExcel=”yes”
width=”-1″
excelUsePaperSize=”yes”
wordLabel=”<%=wordImage%>”
pdfLabel=”<%=pdfImage%>”
submit=”<%=submitImage%>”

/>
</td></tr>
</table>
</form>

使用上面的jsp发布第一种方法制作的300col1.raq，点击导出excel的按钮，选择分页方式导出，具体样式如下图所示：

点击确定，就会导出按纸分页的excel了，这样在页面上导出超过255列不分页报表的excel就实现了。

准备报表：

实现用报表使用设计器自带应用中的 参数报表.raq 和 参数报表_arg.raq。

具体实现：

新建frame.html文件，文件内容如下：

<frameset rows=”100,*” framespacing=”2″ frameborder=”yes” border=”2″
bordercolor=”#993300″>
<frame src=”params.aspx” name=”topFrame” scrolling=”NO” noresize >
<frame src=”” name=”reportFrame”>
</frameset>

新建param.aspx文件，文件内容如下：

<%@ Page Language=”C#” AutoEventWireup=”true” %>
<%@ Register Assembly=”report35net” Namespace=”com.runqian.report.tag” TagPrefix=”rq” %>
<%@ Import Namespace=”System.IO” %>

<html>
<body topmargin=0 leftmargin=0 rightmargin=0 bottomMargin=0>
<table id=param_tbl align=center>
<rq:ParamTag
ID=”ParamTag_1″
Name=”param1″
ParamFileName=”参数报表_arg.raq”
NeedSubmit=”no”
runat=”server”
resultPage=”reportBase/testAspx/report.aspx”
target=”reportFrame” />
<td><a href=”javascript:_submit( param1 );”><img src=”img/query.jpg” border=no style=”vertical-align:middle”></a></td>
</table>
</body>
</html>

其中resultPage=”reportBase/testAspx/report.aspx”，resultPage是博计的发布参数报表标签中的属性，属性含义：提交参数后，显示报表的结果页面；属性取值：相对于应用根目录的页面URL。

新建report.aspx文件，内容如下：

<%@ Page Language=”C#” AutoEventWireup=”true” %>
<%@ Register Assembly=”report35net” Namespace=”com.runqian.report.tag” TagPrefix=”rq” %>
<%@ Import Namespace=”System.IO” %>
<html>
<head>
<title></title>

</head>
<body>
<table align=center>
<tr><td>
<rq:HtmlTag
ID=”HtmlTag_1″
Name=”report1″
ReportFileName=”参数报表.raq”
funcBarLocation = “”
needSaveAsExcel=”yes”
needSaveAsPdf=”yes”
needSaveAsWord=”yes”
needSaveAsText=”yes”
needPrint=”yes”
funcBarFontSize=”12px”
funcBarFontColor=”red”
functionBarColor=”yellow”
runat=”server”
/>
</td></tr>

</table>

</body>
</html>

在页面上访问frame.html后，发现初始只有一个参数报表，当点击查询后，出现了结果报表,并显示出了正确的结果。

至此该需求已满足。