IREPORT使用配置说明书..docx

ireport使用配置说明书1 准备1.1 安装jdk 1.5或1.6版本。1.2 安装ireport软件。安装ireport 3.6.0版本，采用默认安装2 配置2.1 中文配置 工具选项，选择classpath选项卡。 将itext-2.1.0.jar, itextasian.jar, fonts.jar三个jar包复制到ireport的安装路径下（例如：c:program filesjaspersoftireport-nb-3.6.0ireportmodulesext）。 点击classpath选项卡中的【add jar】按钮，将上述路径下刚复制进去的三个jar包导入。 最后点击【add folder】按钮，将系统中fonts文件夹导入。 点击【确定】按钮，完成中文字体的配置。2.2 编译路径配置 。2.3 连接oracle数据库配置添加oracle数据库驱动 工具选项，选择classpath选项卡。 将classes12.jar复制到ireport的安装路径下（例如：c:program filesjaspersoftireport-nb-3.6.0ireportmodulesext）；点击classpath选项卡中的【add jar】按钮，将上述路径下刚复制进去的jar包导入；点击【确定】按钮，完成oracle数据库驱动的导入。配置数据库连接 点击ireport界面的【report datasources】按钮（如下图，如果没有此按钮，选中视图工具栏designer选项，该按钮就会显示） 弹出如下connections / datasources窗口，点击【new】按钮，新建一个oracle数据库连接 弹出如下选择窗口，选择database jdbc connection 选项，点击【next 】，进入下一步连接配置窗口 点击【next 】后，弹出如下配置窗口：在name处填写连接的名字（自定义）；jdbc driver处选择oracle数据库驱动oracle (oracle.jdbc.driver.oracledriver)；jdbc url处填写oracle数据的连接地址jdbc:oracle:thin:server:1521:database（其中server是数据库服务器地址，database是数据库服务id）；username处填写连接数据库的用户名；password处填写用户名对应的连接密码；填写完成后可点击【test】按钮进行连接测试，测试成功后，点击【save】按钮，保存数据库连接。3 相关概念3.1 ireport输出格式以及设置pdf预览previewpdf preview3.2 报表结构说明1. title：放置打印文档的标题，也可删除该band2. page header、page footer：放置文档每页的页头、页脚，也可删除该band3. column header、column footer：放置文档中的列头、列脚，也可删除该band4. detail：正文部分，同一个报表可以存在多个detail5. summary：放置合计信息4 报表创建及设置4.1 新建报表 文件new，弹出创建窗口，选择需要的纸张类型，点击【open this template】按钮 弹出如下窗口，输入report name后，点击【下一步】按钮后继续点击【完成】按钮，完成报表文件的创建。4.2 报表属性设置 创建报表文件后，在report inspector的报表文件上右击，选择“属性”，如下图： 弹出属性设置窗口，将when no date和language两项分别设置为all sections, no detail和java，如下图：4.3 报表的动态对象变量、参数、字段在使用ireport的过程中会碰到很多与变量（variables）、参数（parameters）、字段（fields）这些有关的内容，我们要介绍这些对象的使用和意义：l 字段（fields）：是数据库抽取出来的，希望在报表中出现的数据库内容。比如一个id的所有值。$f filedsname l 参数（parameters）：这是你的应用需要提供给报表的入口，比如你希望在报表被解释的时候提供where语句的条件值，那么就可以使用参数（parameters）。$p parametername l 变量（variables）：这是报表中一些逻辑运算的表现，比如统计值。$v variablesname 每种对象的定义格式如每个对象的后面说明，比如定义一个变量（variables），那么表达式就写成$v variablesname ，报表中出现的就是这个变量的名称。4.4 报表样式style style的设置：在report inspector中的style上右击，选择添加style，在新添加的style上面右击，选择重命名，可以修改style的name选中刚添加的style，在属性窗口设置该style的各项属性，如下图；需要设置的常用属性为：horizontal alignment(左右对齐方式), vertical alignment(垂直对齐方式), font name(字体), size(字号), bold(是否粗体), italic(是否斜体), underline(是否下划线), strike through(是否删除线), pdf font name(pdf字体), pdf embedded, pdf encoding(pdf编码方式)。注意：6. 如果pdf使用宋体，则pdf font name需要选择”stsong-light”，同时pdf embedded必须处于选中状态，pdf encoding选择”unigb-ucs2-h (chinese simplified)”；7. 如果pdf使用外部字体（例如新罗马字体”times.ttf”），必须使用当前工程（位于/sgimsear/earcontent/app-inf/classes路径下）中存在的字体文件，并且必须大写；同时pdf embedded置为非选中状态，pdf encoding选择” identity-h (unicode with horizontal writing)”。 条件样式conditiong style的设置：在创建的style上右击，选择“添加condition style”，双击新添加的condition style，编写判断语句（语句必须返回boolean类型，例如：new boolean($fxm.length() 9)；该condition style代表的意义是，如果xm的长度大于9，则执行该条件样式，否则执行上一级的样式）；选中该condition style，设置各项属性，操作方法同style的设置。4.5 常用报表组件的使用1. static text静态文本将static text从组件面板拖放到工作区相应的band中，双击可进入编辑模式。右击该static text，选择 ”padding and borders”，如下图，可进行padding（边距）和borders（边线，例如如图中的下划线）的设置； 对于static text的字体等属性，可以采用指定style的方式，如下图，将已经创建的style指定给该静态文本区域2. text field文本框text field文本框的使用有两种方式（推荐使用第一种方式） 将需要的parameters、fields或者variables直接拖放到工作区相应的band中 将text field从组件面板拖放到工作区的相应band中，双击进入编辑状态，输入需要的值（例如字段$ffield，字段field必须已经定义）；或者在text field上右击，选择edit expression，打开编辑窗口，双击需要的项（如下图中的variablespage_count），点击【apply】按钮，完成设置。对于text field字体、padding、borders等属性的设置，同static text相同。对于text field组件，需要设置blank when null属性（该属性保证在所传参数为null时，对应的text field显示为空，而不是显示为null），如下图，选中该属性即可。5 报表实例5.1 以sql查询语句做数据源在建立报表时，如下图所示 在connection / data source处选择在2.3小结配置好的数据库，同时在query（sql）处输入要sql语句，可以使用传参$p parametername 来完善sql查询语句。如select * from xj_bk_jbxx where xh=$pxh 点击【下一步】，选择需要在界面上填充的字段，如下图 成功建立后出现如下界面 在左边工作区内右键单击平【parameters】，新建一个xh的参数，注意：参数名统一大写。 修改sql查询语句 点击【edit query】select * from xj_bk_jbxx where xh=$pxh 在jsp页面调用jasper时，先要指定使用哪个jasperreportfile = new file(application.getrealpath(/edu/pku/stu/status/bkxj/jpf/reportbk/文件名.jasper); 给参数xh传值，代码如下：map parameters = new hashmap();parameters.put(xh,”你要传的值”); 生成pdf文件jasperprint jasperprint = jasperfillmanager.fillreport(jasperreport, parameters, conn );/ pdf报表byte bytes= jasperrunmanager.runreporttopdf(reportfile.getpath(),parameters,conn); response.setcontenttype(application/pdf); outputstream output = response.getoutputstream(); output.write(bytes,0,bytes.length); output.flush(); output.close();5.2 以hashmap数组作为数据源 “new”-“blank a4”-【open this template】，新建一个jasper。 然后在“fields”中新建与hashmap数组中每个key对应的字段。 将其拖入detail中 在jsp页面调用jasper时，指定hashmap数组作为数据源，一般将其放在session中hashmap fieldhm=(hashmap)session.getattribute(fieldhm); 然后指定为jdatasourceutil对象，并作为生成pdf文件的参数传入jdatasourceutil jd = new jdatasourceutil(fieldhm);byte bytes = jasperrunmanager.runreporttopdf(reportfile.getpath(), paramhm, jd);6 循环打印需要循环打印的部分，应该放在detail中，并且detail的高度，应该与循环打印的每一行高度相同。如果需要序号的，可以使用variables自动生成。下图为循环打印示例，图中红框中部分为detail循环打印部分，其高度必须与每一循环行的高度相同。7 子报表子报表为subreport，每一个子报表必须单独占有一个detail，不可跨band；使用子报表时，首先创建一个子报表，然后在父报表上添加一个子报表组件subreport（从组件面板拖放到相应的detail中），拖放以后会弹出连接子