birt报表使用简要说明

1、Birt报表使用指南1 Birt的安装方法把birt整合到了Myeclipse6.5中，(eclipse的官方网站上提供有一个birt-report-designer-all-in-one-2_2_2.zip，你直接解压缩这个就可以了，就免去了birt与Myeclipse6.5的整合)。如果要把birt安装到Myeclipse6.5中，要注意一些事情1.1 eclipse的版本就是说你的eclipse版本要和适当的birt版本配合，当前birt的最新稳定版是birt2.3。如果使用的是eclipse3.3版本，你应该用birt-report-framework-2_2_2.zip，如果使用的是

2、eclipse3.4，你应该用birt-report-framework-2_3_0.zip版本不一致会出一些问题。1.2 在Myeclipse6.5中装birt。MyEclipse6.5自带的是eclipse3.3，所以只能下载birt-report-framework-2_2_2.zip (下载地址：/birt/downloads/index2.2.2.php) 而birt-report-framework-2_3_0.zip是针对eclipse3.4的。把下载下来的birt-report-framework-2_2_2.zip包解压，解

3、压后的features文件夹下的所有文件拷贝到MyEclipse6.5安装目录下的.myeclipseeclipsefeatures下，解压后的plugins文件夹下的所有文件拷贝到.myeclipseeclipseplugins下。重新启动MyEclipse就好了。2 公共方法2.1 公用数据源的方法1.右键单击工程，选择new>Library,起个名字叫ds.rptlibrary2.在Outline窗口下选择Data Sources，选择JDBC Data Source,然后填入连库字符串及用户名密码3.这样数据源就建立好了。4.新建报表后，再Outline窗口下，右键单击Libra

4、ries,选择Use Library，选择刚才新建的ds.rptlibrary5.使用ds我一直没有找到方法，老是找不到怎么把ds引入到Data Sources下，只好修改源代码了，选择报表下面的XML Source 标签，再 </list-property>后面下粘贴下面的语句<data-sources> <oda-data-source extensionID="org.eclipse.birt.report.data.oda.jdbc"name="DataSource" id="1350"

5、extends="ds.Data Source"/></data-sources>注意id=1350不能和报表中其他的id重复。然后就能看到Outline窗口下Data Sources下面多了一个Data Source的链接，说明建立成功2.2 公用样式的方法1.右键单击工程，选择new>Other>Web>CSS，建立一个CSS文件，比如birt.css2.在birt.css里写样式3.点一个报表文件，选择Layout标签，然后再Outline窗口下看到Styles，下面有两个默认的Style，可以先删除。然后右键单击Styles，选择

6、"Use CSS File."，找到刚才建立的birt.css4.然后就OK了，如果修改了birt.css，只需要右键单击Outline窗口下的Styles的birt.css，选择"Use CSS File."。2.3 Birt的分页显示报表，交替颜色功能1、鼠标停在表格上，选择Row Detail一行； 2、选择script标签页，打开birt的脚本编辑窗口； 3、从下拉列表中选择onPrepare，在下面加入Javascript脚本如下：var count = 0;4、从下拉列表中选择OnCreate，在下面加入Javascript脚本如下：coun

7、t+;/分页if(count % 10 = 0) style.pageBreakAfter = "always" /交替颜色if(count%2=0)this.getStyle().backgroundColor = "#EFEFEF"elsethis.getStyle().backgroundColor = "#d4d0c8"5、保存，使用Web Reviewer进行预览，数据可以进行分页显示了。注意不要使用Preview标签页进行浏览，这个标签页的浏览效果是不分页的。发布到web工程上，也可以进行分页显示了。 2.4 如何去掉bi

8、rt报表自动生成的日期2.4.1对已存在报表的解决初次接触birt每次做出来的报表后面都一个时间，比较不合需要，又没找到去掉的地方，索性打开xml，找到下面这段代码：<page-setup><simple-master-page name="SimpleMasterPage" id="2">        <page-footer>          

9、      <text id="3">  <property name="contentType">html</property>                    <text-property name="content"><!C

10、DATA<value-of>newDate()</value-of>></text-property>             </text>            </page-footer>      </simple-ma

11、ster-page></page-setup>把其中的<page-footer><page-footer>删除即可 2.4.2 对新建的报表2.5 分离部署在JSF界面中嵌入iframe，在javascript里使用超链接的形式调用报表服务器上的报表，展示在JSF的iframe里。javascript代码如：document.frames"show_report".location.replace("37:9090/birt/frameset?_report=abs/new_su

12、m.rptdesign&ParameterDept="+dept);其中show_report为iframe的name，dept为报表参数。有时候中文参数需要编码处理：deptName = encodeURI(deptName);2.6 如何增加序号1. 点击报表的空白处，然后到script页，选择initialize，输入 var num=0 2. 回到报表设计页，在组上加入一个data，在这个data的expression中，输入： num+; num 3. 保存报表即可。2.7 导出工具条1、如果你不想要那个工具条的话，在URL后面加上：& _toolbar=f

13、alse，这样就会把整个的工具条都隐藏了。2、如果想修改工具条中的一个按钮的时候要修改，对应的 2.8 使用脚本可以使用脚本，是BIRT的一大特色。在BIRT中，数据源、数据集和报表项，都可以书写脚本。具体做法：选择数据源、数据集和报表项任意一种对象，然后选择"脚本"页面。如选择数据源user后，对应的脚本输入页面：选择对应的事件，然后在下方的脚本输入框中输入脚本即可。如对于第一个例子，我们需要统计用户地址是"No.5 St."的用户数：1. 选择数据集，然后选择"脚本"，进入数据集的脚本编辑窗口。2. 选择事件"after

14、Open"，在脚本窗口内输入：count=0;3. 选择事件"onFetch"，在脚本窗口内输入：if( row"addr"= "No.5 St.") count+;4. 选择报表，在脚本窗口选择事件"onRender"，输入：this.caption=count;5. 预览，或运行报表后，会在报表的标题输出count的数值。2.9 如何有条件的隐藏元素选择要有条件地隐藏的元素。在“属性编辑器”中，选择“可视性”。将出现“隐藏元素”选项，如图 7-12 所示。“属性编辑器”中的“隐藏元素”选项选择“隐藏元

15、素”以指定将隐藏此元素。如果要始终隐藏元素，您只需要执行此操作。如果要有条件地隐藏元素，请指定条件。选择要应用隐藏条件的报告格式。要对所有报告格式应用隐藏条件，请选择“对于所有输出”。要对某些报告格式应用隐藏条件，请选择“对于特定输出”。如果想要根据报告格式应用不同的条件，也请选择此选项。指定隐藏条件：选择“表达式构建器”。在表达式构建器中，创建指定隐藏条件的表达式。请记住，您必须考虑何时隐藏元素，而不是何时显示它。例如，要在参数不等于等于“所有部门时”显示该行信息，可使用以下表达式有条件地隐藏文本元素：如：if(params"ParameterDept"="所有

16、部门")falseelsetrue当部门名称不等于“所有部门”时，此表达式隐藏该文本消息。选择“确定”。预览报告以测试条件可视性。2.10 编写表达式通过使用直接来自数据源的数据并简单地将数据源字段从“数据资源管理器”拖到报告中，可以创建多个报告。但有时您想要显示不在数据源中的数据，或者您想要以不同于数据源中显示数据的方式来显示数据。您还可能想要使用公式来产生新的数据。在这些情况及许多其他情况下，应使用 JavaScript 来编写表达式。表达式是一个将生成值的语句。表达式可以是文字值， 将字段拖到报告中时，BIRT 报告设计器将创建表达式。该表达式指定报告显示其值的字段的名称。例如

17、，下列表达式分别获取 customerName 字段和 phone 字段中的值：dataSetRow"customerName" dataSetRow"phone" 表达式可以包含文字值、字段、运算符、变量和函数的任意组合，条件是求得的结果为单个值。在下列示例中，第一个表达式将静态文本与字段组合在一起，第二个表达式使用 JavaScript 函数，而第三个表达式将两个字段的值相乘："Order Total: " + row"orderTotal" row"orderDate".getYear()

18、 row"itemQuantity" * row"itemPrice" 2.11 创建参数报表用的参数，在Report Parameters中闯将，界面上传的值的名字和报表上定义的参数的名字要一样。2.12 如何自定义动态查询1. 首先创建参数。2. 在数据集的“查询”页上，定义 SQL 查询，例如：Select name from t_city where year = ？(注：参数用？号表示)3. 在数据集的参数选项卡，如称为“year1”的Integer参数。注解：这里创建的参数，要与？号的位置相对应。3 实际样例3.1 创建简单报表的步骤3.1.

19、1 创建一个报表 选择File->New->Report 。 新建报表（new report ）对话出现。 在Tree View中选择我们之前创建的项目。 接下来在文件名字段输入: new_report_1.rptdesign 点击 next。 选择空白报表。 点击 Finish。3.1.2创建数据源Date Sources打开Data explorer（数据资源管理器）。 选择Data Source（数据源）节点。 用鼠标右键单击打开弹出菜单。 选择新建数据源。 新建数据源对话出现。 选择 相应的数据库 在数据源名称输入框, 如"Data Source" 。

20、点击 next。然后输入相应的数据库的信息，如下图所示：选择“Manage Driver”，导入相应的数据库的驱动包3.1.3创建数据集Data Sets现在我们准备好建立和测试我们的数据集。 打开数据资源管理器 选择数据集节点。 用鼠标右键单击打开弹出菜单。 选择新建数据集。 新建数据集对话将出现。 “在数据集名称”输入框，输入"Date set"。 确保数据源下拉框显示的是我们之前创建的 Data Source 数据源。 确保数据集类型下拉框选中的是"SQL Select Query" 。 点击next然后选择相应的数据表，输入查询语句点击Finis

21、h。3.1.4创建Table首先打开Palette 下（这里提供很多报表的元素，文本，表格，图形等等）拖动 table 到界面上向表格中拖动相应的数据这样一个简单的报表就算完成了3.2 Birt2.2M6的 CorssTab（交叉表）的用法3.2.1什么是交叉表首先你要知道什么是交叉表，又是在什么情况下需要用交叉表。“交叉表”对象是一个网格，用来根据指定的条件返回值。 数据显示在压缩行和列中。这种格式易于比较数据并辨别其趋势。它由三个元素组成：行、列、摘要字段。我找了一副图表，用以说明交叉表3.2.2创建交叉表步骤Birt创建交叉表分为三步：创建Cube、创建CrossTab、把Cube的维度和度量拖到相应的地方。 选择Cube的数据集BIRT的数据立方体（Cube）是基于数据集的。建一个Cube首先就是要选择Cube的数据集，所以先创建自己的数据源和数据集。本例中我们建了一个名为crossTabDataSet 的数据