bjbb_2007的博客

这些控件类型在web页面上的显示模式在皕杰报表里设置了三种模式，只读、显式显示和隐式显示。三种模式可以在报表配置参数中配置全局模式，在url中后跟参数控制单个报表的模式，在报表全局属性里设置单个报表的模式。填报报表是指能够向数据库上传数据的报表，皕杰报表填报单元格支持多种控件类型，包括文本框、文本域、下拉框、下拉树、单选框、复选框、时间、日期、日期时间…表单模式(0-表示只读模式,1-表示可填报模式，控件显式显示,2-表示可填报模式，控件隐式显示)3、 在报表全局属性里设置单个报表的模式。

我们分享了皕杰报表设置序号的三种方法，ds.#0，&cellx和row()，有时用这些方法设置序号并不能满足我们的需求，需要配以显示值的使用，使得序号分类更加清楚。根据上图中，序号全是数字，层次不清晰，地区的序号和城市的序号混为一谈，我们可以在显示值上想办法，比如让地区的序号显示1，2，3，而让城市的序号显示（1），（2），（3）。1、A2单元格写=&B2，A2单元格属性-左主格为B2（这样设计的意思是：跟随B2纵向扩展，取扩展的位置）;我们还可以让序号变成大写的一、二、三，（一）、（二）、（三）。

在皕杰报表如何设置序号系列之一里，我们用ds.#0来实现了序号，用ds.#0得到的数据库中选取的记录的序号。打开皕杰报表设计器，打开我们原来用过的报表：(A2单元格的数据值和显示值还是与上次示例中的一致，即：数据值=mod(ds.#0,20)，显示值=if(@value=0,20,@value))说明：Cellx必须是当前格的主格，这样&Cellx才能够正确运算，其返回值相当于是当前格所属的Cellx主格的位置。返回值：整数，当前格所属的Cellx主格在所有扩展出来的格子中的排序。

由于是对20取模运算，所以第20行的序号就变成0了，我们可以在a2单元格的显示值中进行设置，当值为0的时候，让其显示为20，这样问题就解决，显示值表达式：=if(@value=0,20,@value);皕杰报表软件是一款应用广泛的Java报表工具，使用简单、制表效率高，可以轻松制作出各种各样的报表，是一个不错的Web报表软件。将a2单元格的值设置为ds.#0,并将a2单元格的左主格设置成b2，预览效果如下：（假设每页20条记录的分页方式）我们可以看到，序号已经产生了，并且是第二页的序号是与第一页连续的。

举个例子，1.14638保留2位不四舍五入，我们把第三位小数减去5，即减去0.005，值为1.14138，保留两位并四舍五入就是1.14，后一位大于5也没有进位。保留三位，则减去0.0005，值为1.14588，保留三位并四舍五入就是1.146，相当于把第四位舍去了。皕杰报表里一般在保留小数位时都是按着四舍五入的规则来取舍数据的，比如1.14638保留两位小数是1.15，保留三位小数是1.146。我想应该是可以实现的，可以通过在保留位的后一位数减去5的方法，实现虽说是四舍五入但相当于直接舍去。

同时，在设计器中点击一张报表的行号，则在行属性里有是否行后分页属性，有是否两个选项，要分页就选是，不分页就选否。如果一张报表有很多行，在打印的时候因为收到纸张的限制，所以需要对这张表进行分页。皕杰报表里分页的方式有很多，还能够自定义分页，可以最大程度满足各种页面的需求。基本的分页方式分为按纸张、按数据行、按数据列、自定义以及不分页五个选项，另外在选择按纸张和按数据行分页时还可以同时勾选同时进行自定义行后分页。只要选择不分页就行了，简单的问题设置一下就是，想分页就分，不想分页就不分。

于是老板就让我来接手报表系统的搭建，我们找了一家挺大的国企it公司，让他们给上一套报表系统，但他们开发的报表是一次性的，不能满足我们的长期需求。用皕杰报表工具搭建的报表平台，部署简单，做表容易，不需要开发人员，我们自己就可以制作报表，既方便又快捷，节省了大量外包成本。

纵向扩展：当可扩展单元格的扩展方向为纵向时，该单元格进行的扩展称为纵向扩展。此时该单元格会纵向进行复制，复制出的单元格的数据值依次为表达式的结果数据值，表达式返回几个值，单元格就复制几个。横向扩展：当可扩展单元格的扩展方向为横向时，该单元格进行的扩展称为横向扩展。此时该单元格会横向进行复制，复制出的单元格的数据值依次为表达式的结果数据值，表达式返回几个值，单元格就复制几个。可以为扩展单元格设置一个扩展方向，扩展可以有横纵两个方向，即横向扩展和纵向扩展，但一个扩展格同时只能有一个扩展方向。

3、 统计类型为“月”，则表单中年、月参数显示，日参数隐藏。经过这样对查询表单显示/隐藏的设置，参数就按着我们的意愿来显示了。我们通过选择统计类型，年、月、日表单跟随显示或隐藏。统计类型作为年月日显示的依据，可选全部、年、月、日四个值。比如我查年的数据，就只有年这个参数，查月的数据，就有年、月两个参数，查具体日的数据就有年、月、日三个参数。2、 统计类型为“年”，则表单中年参数显示，月和日隐藏。4、 统计类型为“日”，则年月日均显示。1、 统计类型为“全部”，则表单中的年月日参数全都隐藏。

那么为什么要配置jdk环境变量呢？我们把命令放在一个目录下，然后通过给定的路径去找这些命令，这里的路径就是所说的环境变量。在linux系统部署皕杰报表，因皕杰报表是一款纯java报表工具，运行时需要jre环境，所以要在服务器上配置三个jdk环境变量path、classpath、JAVA_HOME。Linux中环境变量是在etc/profile中配置，也就是说要修改profile文件，把上述三条语句放到profile文件里即可。3、 在Linux中通过vi编辑器直接编辑修改，修改后直接保存即可。

于是搜索问题原因，有帖子说大概是端口不对，仔细看下，原来要用22端口连接，将端口号改为22后，再连接又显示连接超时，继续搜索问题原因，说也许是防火墙的问题。安装jdk1.8，安装tomcat9.0.37，配置环境变量，将皕杰报表iface整体复制到webapps下，将数据库jdbc驱动jar放到tomcat/lib里，用报表里的server.xml替换tomcat/conf下的server.xml文件，报表部署工作完成。保存后重新启动tomcat，访问报表，工具条已经变成了中文，见图。

一个完整的URL包括：协议部分、域名部分、端口部分、虚拟目录部分、文件名部分、参数部分、锚部分。皕杰报表工具提供的这个url可以直接访问，可以集成到页面，如果把多个url集成到一个页面，就可以形成大屏和驾驶舱效果，整体效果的美化对于美工和前端工程师来说却是小菜一碟。7、锚：或称片段（fragment），HTTP请求不包括锚部分，从“#”开始到最后，都是锚部分。”开始到“#”（或至结束）为止之间的部分为参数部分，又称搜索部分、查询部分。文件名部分不是一个URL必须的部分，如果省略该部分，则使用默认的文件名。

从两个函数的说明我们可以看出，在皕杰报表中，数据集函数sum是对数据集中满足条件的字段进行求和，其表达式中sum的前面要有数据集的名程”ds.”，sum中要有求和的字段以及条件。而单元格函数是对扩展单元格或几个连续单元格中数值进行求和，直接用sum,求和的对象是单元格集合，单个单元格要用“{}”，多个连续单元格首位中间用“:”。3.例3：sum(A1{},@item>0)，对A1单元格扩展出来的集合中的记录进行求和，并且判断A1集合中的每一个值进行判断是否大于0，如果大于0就计算，否则就不计算。

既然要联动，参数的取值就应该有一个范围，而不是任意输入一个，所以在做参数联动是第一个参数的控件类型要选择下拉框或单选框，保证我们在一定的范围内取值。这也是从设计之初就保证了联动的父项不是任意取值，只能在一定的范围内选取，以便所有的父项都有对应的子项与之联动。所谓参数联动，是指有两个以上的参数，第二个参数的取值跟随第一参数的取值变化，第三个参数的取值跟随第一个和第二个的取值变化。当我们把第一个参数的控件类型指定为文本框时，在给第二个参数做联动设计的时候就会发现没有跟随联动的参数选项。

检查了客户使用的版本号没有问题，但在linux系统里却只安装了宋体，其它中文字体都没有，而在报表里选择的字体却是微软雅黑，计算的依据没了，系统所以计算出的拉伸高度就是错的了。部署后我们看到单元格已经正常拉伸了，用F12检查一下运行的css，果然是废弃了计算的高度，而采用了我们新增的css格式。我们分析有两种可能，一是所用的皕杰报表版本太老，二是计算高度的依据缺失，而计算拉伸高度的依据是字体和字号。于是要来了这张问题表的html源代码，在浏览器中打开后用F12检查，发现这个单元格的拉伸高度计算不正确。

在皕杰报表中，如果含有斜线的单元格、统计图的报表、或导出pdf时，汉字变成小方框，这往往是服务器端操作系统的中文安装包没有装全，导致报表里用到的字体在服务器端的操作系统里找不到，因此成了小方块。因为斜线单元格里、统计图表里及导出pdf这些都是在后台生成的，调用的是后台操作系统和jre里的字体，缺失就会显示小方块。所以解决这种问题就要从服务器操作系统着手，把所用的中文字体安装到字体文件里。要注意有些商用字体是有版权的，windows里可用不代表在其它操作系统也是免费的，使用中文字体时先确认有权使用。

2、使用第三方的ehcacha缓存（即：设置eh=“true”），这个时候，优先是使用内存缓存，如果内存不足时，可以启用磁盘缓存。启用硬盘缓存，要确保缓存的路径path设置的正确，无需其它设置。当内存的缓存容量不够时，就会自动使用硬盘缓存。设置缓存是提高报表性能的手段之一，皕杰报表在配置文件report_config.xml中对缓存进行设置。develop: 开发模式，不启用报表缓存功能，实时刷新数据和报表模板，方便开发调试。1、使用皕杰内置的缓存（即：设置eh=“false”），这时使用的是内存缓存。

这么低级的错误我们真是没想到的，以后遇到类似的问题一定要先检查数据源配置，尤其是设计器端数据源名称与服务端数据源名称一定要一致。现在回想一下，该用户应该是中间接手的报表，看着人家用得挺好，自己上来就做，根本没有好好看看报表文档，总觉得报表简单，不知其中也有必须掌握的基础知识。原来在设计器中为填报报表配置的数据源名称与展现报表的数据源名称是不同的，而在服务器中只配置了展现报表的数据源，压根就没配填报报表的数据源。后来又得知其系统由皕杰5.2升级到了6.1，于是又怀疑他升级的过程中有漏掉的jar包。

如果url过长，应尽量想法减少url长度，其中把不必要的中文改成英文就会大大降低url的长度。因而我们建议，在使用皕杰报表时，除了必要的参数外，其它都尽量采用英文，尤其是brt文件的名称， 采用英文后，不但减少url长度，还会减少很多由于编码产生的问题。看tomcat控制台也没有错误信息，似乎遇到了一个很难缠的问题，没有错误信息却卡滞了，这个问题怎么解决呢？原来这个get请求的url出奇的长，是不是问题就出在这里呢？这与服务器和浏览器相关，不同的服务器和浏览器对url的要求是不同的。

普通展现报表一次取出所需的全部数据，可以做分组、求和等运算，因此在设计时尽量控制取出数据的数量，只取出必要的数据，在硬件能够承受的条件下运行，避免发生内存溢出。这里所说的报表是由部署在服务器上的报表工具产生并通过浏览器访问的报表，皕杰报表就是这样的报表。行式报表主要用于处理大数量的数据展现，它每次都只从数据库中调取本页的数据，当点击下一页的时候，会重新调取下一页的数据，这样就解决了内存溢出的问题。：所谓展现报表就是将数据库里的数据取出来以一定的样式展现出来，不改变数据库里的数据的报表。

在网上看到一篇关于某品牌报表工具表头锁定问题的文章，在设计器里设定表头行，表头锁定。还是比较简单，只需在皕杰报表设计器里设定表头行即可，在web端不需做任何操作和设置，设定表头行后，无论在设计器里预览还是部署到WEB上，表头都是锁定的。皕杰报表同时支持上表头和左表头的锁定，也就是说在两个方向锁定了表头。在导出excel时皕杰报表也做了设定，就是导出后表头锁定依然生效，就像我们在excel里设置好了表头锁定一样。不仅这样，无论锁定行表头，还是锁定列表头，亦或是同时锁定行和列，都只需把行或列设置成表头即可。

有用户问了一个使用皕杰报表工具时遇到的问题，点击带图表的报表的导出excel按钮没有反应，且页面变成空白，不知从哪里着手解决问题。这种异常单从表面看不出哪里出的问题，需要结合报表日志和tomcat服务器日志看是出了什么问题。从用户发来的tomcat日志看，错误信息是十分清楚的，其中一段截图如下：其中很明确的错误信息是：java.lang.NoClassDefFoundError: org/apache/commons/codec/digest/DigestUtils。其表达的意义是缺少定义类错误，所

从皕杰报表6.0版开始，查询表单改为由servlet直接实现，不再用jsp调出表单，直接用“ReportQuerier?在老版本的皕杰报表中，将报表中的参数通过Tag标签在网页上以表单的方式显示，即为查询表单。可见，查询表单是通过jsp实现的。而在标准配置中没有配进度条 ，点击查询后是一个空等待，需要进度条可在jsp里写代码实现，这对于非专业人士就显得比较困难了。另外，6.0版的查询表单增加了折起功能，一张查询完毕后，为了显示更多的报表内容，可以点击折起按钮把查询表单隐藏起来，点击展开按钮再展现出来。

在皕杰报表工具规划的新版本中，拟将带有查询表单的报表是否根据缺省参数值自动查询的设置放到报表查询表单属性里去设置，原来版本中这个功能点是通过在url中后跟servlet参数autoquery=ture来实现的。通过servlet参数实现的好处就是灵活，同一个brt通过在url中后跟servlet参数可以得到不同的功能效果，缺点就是要记的servlet参数太多，对于非专业人士不够方便。在报表工具中，某一个功能点的实现的方式不是唯一的，可以放在属性中实现，也可以放在servlet参数中实现的。

b、Web端：报表默认是放到WEB-INF/reports（report_config.xml设置报表存放路径的根目录地址）目录下的，如果子表放到WEB-INF/reports/Demo/图表演示/饼状图.brt这个路径下，那么子报表表达式应该是subreport(‘Demo/图表演示/饼状图.brt’)。例如饼状图.brt，它在项目视图中是Demo-图表演示-饼状图.brt,那么子报表表达式应该是subreport(‘Demo/图表演示/饼状图.brt’)那么这样的报表在皕杰报表中是如何实现的呢？

皕杰报表中，css样式文件在资源文件夹report_res/skin下，包含query.css、table.css、toolbar.css、fillin.css、common.css、exception.css，分别是表单格式、报表格式、工具条格式、填报格式、公共区格式以及异常时的格式。另外单元格里也支持从web资源引用属性里添加的css样式，对于具体报表个别单元格里需要的特殊样式，只需在单元格css样式名属性里添加web资源引用属性里添加的css样式名即可。

首先确认需要打包处理的报表，其导出格式有6个选择可选：分别是1、压缩导出EXCEL2003及以下版本；2、压缩导出EXCEL2007及以上版本；3、压缩导出WORD2003及以上版本；4、压缩导出WORD2007及以上版本；5、压缩导出PDF格式的报表文件；6、合并导出PDF格式的报表文件。导出文件名称可以用默认，也可以自行设置。打印则是以pdf方式打印选择的报表。参数使用具体应用参考报表的demo实例，”其它特性\批量操作示例“，其中batchHandler.jsp文件位于iface/report下。

条带式报表适合制作一些需要详细信息的明细表，看起来内容详实，一目了然。其原理就是通过改变主格的方法来实现的，把区域所有单元格的左主格都设置成一个纵向扩展单元格，简单地说就是让一片区域所有单元格都跟随一个单元格向下扩展。所谓条带式报表，也叫自由式报表，其主要特点是字段不是放在一行里，而是分散在几行里，这几行区域整体扩展，形成表头重复数据不同的信息段，每个信息段格式完全一样。其中：B2单元格扩展方向设置为纵向扩展，左主格设置为“A0”，区域内其它所有单元格的左主格都设为B2单元格，一个条带式报表就设计好了。

首先要知道，设计报表的过程实质上就是把数据集表中的数据按一定格式展现在报表里的过程，因而报表的排序是与数据集中记录顺序有关的，所以在写sql语句取数的时候就应根据需要按照某个字段的顺序进行排序。3.例3：ds1.select（订单ID，false，订单id>=12，数量），将数据集ds1中的“订单ID”字段以列表的形式显示，按“数量”字段顺序排序，并筛选大于等于12号的订单ID。1.例1：ds1.select（订单ID，false），将数据集ds1中的“订单ID”字段以列表的形式显示，并顺序排序。

这个我们要从皕杰报表的打印方式说起，因为采用B/S架构的皕杰报表，用网页浏览器打印，因而用什么打印方式是与浏览器息息相关的。早期的浏览器都支持java控件，所以皕杰报表采用的是applet打印，优点是打印精度很高，缺点是有时控件需要在浏览器中安装一下。为了区分是pdf打印还是applet打印，设置了打印模式参数printMode，参数值等于applet就是applet打印，参数值等于pdf就是pdf打印。问题看似没有头绪，如果我们知道了其中原理，就会轻松找到问题的症结，从而轻松解决问题。

所谓文本数据库就是用文本编写的存成csv格式的数据表，我们要把这个csv格式的数据表当作数据源，在皕杰报表里如何配置呢？首先我们准备一个数据表txt.csv，位置在C:\Users\bijet789\Desktop\csv。单击“下一步”，选择文本数据源的存放路径，输入文本数据源的后缀名称，输入数据分隔符（这里为英文的逗号），如果第一行为列名，第二行为数据类型，则选择相应的复选框，单击“完成”按钮即可。在摘要视图中新建数据集，数据源选择前面建的txt，类型选择SQL语句。二、 设计器中使用文本数据源。

于是对这个问题进行了测试验证，果然是重命名无效，数据集展开显示的还是原来的字段名。于是就上网搜索了一下问题，有人把问题定位到useOldAliasBehavior属性上，这个属性是通过jdbc连接数据库的属性设置，默认值为false，就是使用字段原名，不使用重命名。测试ORACLE，不需设置，应该是mysql数据库的个性问题。有用户使用皕杰报表连接数mysql据库，在sql语句中用as对字段名进行了重命名，反应重命名不起作用，as关键字无效。再展开数据集查看，用as重命名的字段名都显示出来了。

把单元格类型设置成富文本后，这个单元格就像写字板的一个编辑区了，在这个区域里，可以设置多种字体，可以设置多种字号，可以设置多种字色，可以设置多种背景色，可以设置粗体、倾斜、下划线、删除线，还能够设置上标和下标，支持在编辑器里剪切、复制、粘贴以及删除格式。有了富文本单元格后，一个单元格里就有了多种字体，多个字号，多种颜色，且只需在富文本编辑器中编辑即可，大大降低了展示复杂文字的难度，方便了报表设计，做表的效率提高了。1、 单元格右键选择单元格类型——富文本，则该单元格即为富文本类型单元格。

LDAP单点登录认证主要是改变原有的认证策略，使得需要的软件都通过LDAP服务器进行认证，在统一身份认证后，用户的所有信息都存储在AD Server中，终端用户在需要使用公司内部服务的时候，都需要通过AD服务器进行认证。2、OAuth是一个关于授权的开放网络协议，它允许用户让第三方网站访问该用户在某一网站上存储的信息和资源，如账户信息，照片，联系人等，而不需要给第三方网站提供某一网站上的账户和密码。总结：上面说的三种登录方式都是单点登录系统，其安全性都很高，都能较好地满足单点登录系统的需求。

在皕杰填报报表中，除了要设计表样、设置控件类型外，还要做填报操作设置。所谓填报操作，实质上是建立了报表填报单元格与数据库表字段之间的映射关系，也就是明确了单元格里数据上传到数据库里哪张表的哪个字段里，至于是新增记录还是修改已有记录，报表则会根据主键自动判断。按钮，弹出填报处理设置对话框，点击【新建填报操作集】按钮，新建填报操作，填报操作名称为“tijiao”，选择数据源为内置数据源，选择数据库表----“订单明细”表，进入“设置填报字段”，根据自己设置的“填报单元格”，将其对应的填到表格中。

可见，如果想在LINUX上部署皕杰报表，你首先在windows上部署并调试好，然后移植到LINUX上就好了。在BIOS SEVER文件夹下，wbbapps下的iface文件才是皕杰报表的程序和文件，所以移植最主要的就是移植这部分，把iface文件夹及其所有文件都复制到LINUX系统的tomcat中的webapps下即可。另外要注意两个地方，一个是在conf文件下的server.xml文件要复制到相应的文件夹下，另一个就是要把数据库的JDBC驱动jar放到tomcat的lib文件夹下。...

皕杰报表作为项目部署时，需在web.xml中进行相关配置，具体要配置那些信息呢？基本上包含报表系统提供的web.xml文件中的节点下的所有内容。其中主要是配置servlet信息和一些必要的过滤器。Servlet是运行在服务器上的一个小程序，用来处理服务器接收到的请求。另外，可将编码转换过滤器和XSS防注入过滤器配置在平台的主过滤器之后。当皕杰报表用皕杰平台做门户时，还需要将平台的相关配置放进来。...

一个Engine组件可以处理Service中的所有请求，一个Host组件可以处理发向一个特定虚拟主机的所有请求，一个Context组件可以处理一个特定Web应用的所有请求。reloadable：设置为true，Tomcat会自动监控Web项目的/WEB-INF/classes/和/WEB-INF/lib变化，当检测到变化时，会重新部署Web项目。GlobalNamingResources元素定义了全局资源，通过配置可以看出，该配置是通过读取tomcat/ conf/tomcat-users.xml实现的。.

4、客户端资源存放路径，节点值为相对应用根目录的路径。3、应用资源的存放路径，节点值为相对应用根目录的路径。1、报表文件存放目录，节点值为相对web应用根目录的路径。表单模式(0-表示只读模式,1-表示可填报模式，控件显式显示,2-表示可填报模式，控件隐式显示)develop: 开发模式，不启用报表缓存功能，实时刷新数据和报表模板，方便开发调试。15、URL前缀，通过域名地址访问报表，或报表服务器地址存在跳转、分发时，请设置该参数。导出的word文件版本，docx表示2007格式，doc表示2003格式。.

我们可以通过参数给报表传递有用的信息，来控制sql语句查询的数据，或者在报表页面显示一些信息，也可以往报表属性里传递有用的信息。所谓参数就是报表里的信息输入的一种方式，是对报表中已知数据类型的信息的一种赋值。皕杰报表参数支持多种数据类型，有整数、实数、字符串、日期、时间、日期时间、布尔、整数组、实数组、字符串组等。其中参数名称要用英文符号，数据类型要选定，中文描述可以在表单上显示，缺省值即为查询时的默认值，缺省值支持公式表达式计算，但不支持含有数据集函数的表达式计算。那么参数在皕杰报表中具体如何使用呢？..