Birt开发入门教程
BIRT3.72汉化版开发使用说明
1简介1.1BIRT (Business Intelligence and Reporting Tools), 是为Web 应用程序开发的基于Eclipse 的开源报表系统，以Java 和J2EE 为基础。
1.2BIRT功能支持：列表－列表是最简单的报表。
图表－当需要图表表现时，数字型数据比较好理解。
BIRT 也提供饼状、线状以及柱状图标等。
交叉表－交叉表（也叫做十字表格或矩阵），分组分类统计。
导出和打印支持。
1.3BIRT 有两个主要组件：基于Eclipse 的报表设计器，以及部署到应用服务器上的运行时组件（ReportEngine报表引擎和WebViewer网页浏览器）。
2birt报表设计器eclipse-reporting-indigo-SR2-win32用于开发和制作rptlibrary库文件和rptdesign报表文件，设计器制作完成的文件，不能用其他工具如记事本、UE去修改（可以查看），一旦修改则原文件作废。
3birt运行器3.1birt运行器有两种，一种是最基本的ReportEngine报表引擎，可以直接用java编程配置和调用，导出多种格式；一种是WebViewer网页浏览器，内置了ReportEngine，只需要提供报表文件和参数，即可直接网页iframe的方式展示报表内容。
3.2基本部署：birt-runtime-3_7_2整个放入tomcat下的webapps中，如果不需要web展示，可以只保留ReportEngine和report文件夹。
如果需要web展示，可以删除ReportEngine文件夹。
如果都需要，删除ReportEngine文件夹，并将java调用API时的birtHome路径配置为birt-runtime-3_7_2下的WEB-INF文件夹即可。
可以变更birt-runtime-3_7_2文件夹的名称。
3.3在birt报表中,中文参数值是乱码的解决办法：1.页面打开url使用window.open(encodeURI(url));2.修改tomcat--->conf---->server.xml，添加<Connector port="8080" protocol="HTTP/1.1" connectionTimeout="20000"URIEncoding="UTF-8" useBodyEncodingForURI="true"redirectPort="8443" />4birt 库文件开发制作4.1运行birt报表设计器，初次使用时，新建一个报表项目，以进入报表设计模式。
birt入门文档(自己整理)
Birt 入门文档目录1 BIRT -前言 (1)2 BIRT -简介 (1)3 BIRT -配置安装 (2)3.1 下载 (2)3.2 安装以及汉化 (2)4 BIRT -简例 (2)4.1 创建一张报表 (3)4.2 创建报表数据源和数据集 (5)4.3 构建Table (9)4.3.1 构建明细表 (9)4.3.2设置边框，样式 (10)4.3.3创建报表参数 (11)4.3.4设定颜色标识 (13)4.3.4过滤器使用 (15)5 BIRT -小结和回顾 (16)1 BIRT -前言本文档在简介BIRT这个开源免费的报表开发工具后将引导你设计出简单的报表，如想进一步了解BIRT的使用可参考BIRT在Eclipse中自带的帮助，Help→Help Contents。
2 BIRT -简介BIRT是一个Eclipse-based开放源代码报表系统。
BIRT是Business Intelligence and Reporting Tool的简写,即商业智能与报表工具。
它主要是用在基于Java与J2EE 的Web应用程序上。
BIRT主要由两部分组成：一个是基于Eclipse的报表设计器，另一个是可以加到你应用服务的运行期组件。
BIRT同时也提供一个图形报表制作引擎。
URL: /birt/ 这个网址可以找到BIRT，可以去看看。
使用BIRT可以开发出多样化的报表应用，包含：列表（最简单的报表就是列出数据）、图标（饼图，折线图，柱状图等）、交叉表（通过二维显示数据）、字符和文档、复合报表（多个报表组成）等。
有人总结了许多它的优点。
看一下：•操作界面友好大方；•功能并不逊色与商业报表工具；•CSS提供了强大灵活的样式定义，对于属性CSS的设计人员来说，应该可以设计出相当出色的报表样式；•集成在Eclipse中，不用再开启别的报表开发工具窗口；•BIRE的本地化做的很好，安装以后，可以汉化；•开源免费的报表产品，降低开发成本，一些报表开发工具除了价格昂贵以外，还有用户限制；3 BIRT -配置安装3.1 下载在BIRT官方网站/birt/ 下载。
birt报表入门教程之报表设计器学习
birt报表入门教程之报表设计器学习报表设计器数据浏览器－把你的数据源（连接）以及数据集（查询）组织起来。
数据集编辑器允许你测试数据集，以确保报表接收数据的正确性。
布局视图（Layout）－所见即所得编辑器为你的报表提供以拽方式来创建表现内容。
包含一个标准报表条目调色板。
属性编辑器（Property Editor）－以便利的格局表现大多数通用的用户属性使编辑更快速和容易。
BIRT也集成了标准Eclipse属性视图，为每个条目提供详细的属性列表。
报表预览（Preview）－你可以在任何时间采用真实数据测试你的报表。
预览窗口直接内嵌在Eclipse中。
代码编辑器(Script)－在访问数据以及报表生成或浏览时，脚本把业务逻辑添加给报表。
在编辑脚本时代码编辑器提供标准的Eclipse特性：语法加色、自动完成等等。
BIRT用很简单的脚本来表达，expression builder能更容易的创建这些表达。
略图（OutLine）－BIRT报表被组织为一个树型结构作为整体报表的根，并且为样式、报表内容、数据源、数据集、报表参数等分类。
略图视图提供你整个报表结构紧凑的预览。
Cheat Sheets－学习新工具永远是种挑战，但是Eclipse提供一种创新方案：cheat sheets。
它们是一些帮助你完成新任务的文档。
同为常用的报表工具，与BIRT对比，FineReport的设计器是什么样的呢？具体如下：设计器概览下图是FineReport报表软件设计器的整体示例图：1.1模板管理面板所有通过FineReport设计器设计出来的模板全部保存在reportlets文件夹下，并显示在模板面板中。
1.2数据集面板数据集面板中展示的是数据集，数据集是指通过SQL语句，将数据库中的数据获取出来，作为模板数据的直接来源，数据集包括模板数据集和服务器数据集。
1.3模板预览方式预览方式是指查看模板时以哪种方式查看，在设计器预览方式按钮处，有三种预览方式，分页预览，填报预览，数据分析，如下图：默认预览方式为分页预览。
Birt报表的开发使用手册
Birt 使用说明合适版本：2.1.3目录一、前言 1二、相关软件 11.1、BIRT 21.2、EMF和GEF 3三、Birt的安装和配置 3四、使用说明 54.1、创建项目 54.2、创建第一个报表 74.2.1、创建一个空白报表 74.2.2、设置数据集参数 94.2.3、设计报表 144.3、报表中的参数 264.3.1、静态标量参数 274.3.2、动态标量参数 294.3.3、动态组合参数 31五、应用系统的结合 31六、BIRT的学习资料和缺点 456.1、学习资料 456.2、缺点 45一、前言公司的一个Java语言的B/S架构项目中需要实现大量的文字报表和图像报表的功能，以前使用CSS、JS和JfreeChart等技术，只能实现简单的报表，很难达到现在需求，于是我研究了几个开源免费的报表工具，通过网上的评价，发现了Birt有以下几点优点：1、开发方便，Birt是Eclipse的一个插件可以很好的集成在Eclipse中，图形编辑框架下可以在几分钟之内做出一个报表。
2、可以很方便地在一个报表中混合展现概要数据和详细数据。
3、操作界面友好大方。
4、提供了强大灵活的样式定义，对于熟悉CSS的设计人员来说，应该可以设计出相当出色的报表样式。
5、集成在Eclipse中，不用再开启别报表开发工具窗口，对于习惯于Eclipse开发的程序员来说这点非常重要。
6、Birt的本地化做的很好，安装以后操作界面就是中文的（这点我在使用过程中没有充分体现，我使用了Birt的中文语言包）。
7、开源的报表产品，有源代码，可以进行深层的定制开发。
8、生成的报表完全是XML格式，扩展性好。
9、容易和应用系统结合。
10、最重要一点是开源免费的（我穷啊）。
根据这几个优点，我决定研究Birt，通过几天查找资料和自己的摸索，心中总算有些小的体会。
由于习惯与Eclipse3.2版本，所以我使用了2.1.3版本的Birt，现在最新版本已经是2.3以上版本了，就是这个原因网上很多资料都不是很适合这个版本，所以我走了很多弯路，希望看到此文档的人能比我少走弯路，这也是我写这个文档的原因之一。
BIRT学习
对象数据源不能进行动态SQL拼写方法一：设置表格内容隔行变色(变的是每行背景的颜色)1.选中整表,在script的onprepare里写:count=0;2.选中表格数据明细行,在script的oncreate里写:count++;if( count % 2 == 0 ){this.getStyle().backgroundColor="#ECF3FE";}else{this.getStyle().backgroundColor="#FCFFFE";}方法二：设置表格内容隔行变色(变的是每行内容的颜色)选中表格数据明细行，在属性编辑器的突出显示中添加"行数%2等于0" 颜色选择背景色自动。
设置柱形图与表关联的代码片段：var viewer = actuate.getViewer(evt.srcElement || evt.target);var table = viewer.getTable();table.setFilters(new actuate.data.Filter("Country", "eq", categoryData));table.submit();生成图形(柱形图和折线图混合图形时)乱码问题：一般把字体改为宋体(好像中文名称的就可以了如：幼圆、仿宋等)就可以了修改右侧在图表格式>图例>条目中修改修改标题：图表格式>标题中修改隐藏：This.getStyle().display=”none”;显示：this.getStyle().display=”hidden”打开ＢＩ报表交互（在整个BI的脚本clientScripts中的事件onContentUpdate添加）if(!this.getViewer().isInteractive())this.getViewer().enableIV();reportContext 是一个全局的上下文对象，利用这个上下文对象，可以在不同的事件响应处理类中传递信息。
05-Birt工具图表组合型报表开发手册
图表组合型报表开发指南-----伊朗演示1、新建报表运行Birt报表开发工具后命名，选择保存的目录，然后Finish。
2、新建数据源开发工具的菜单栏，打开Outline窗口：如下：右击数据源，选择新建：如上图选择，数据源名称自定，Next：从“驱动程序类”的下拉列表中选择对应数据库的的驱动，若没有需要的，则选择“Manage Drivers”按钮：将对应数据库的驱动程序添加进来，回到上一步选择驱动程序类：输入数据库连接信息:URL:：jdbc:oracle:thin:@10.40.200.69:1521:osstestUser：bi71Password：smart可测试：右击“数据集”，选择“新建数据集”上面选择前面新建的数据源Next：主数据集sql：select B.PROVINCE_NAME PROVINCE,C.PACKAGE_TYPE_NAME PACK,COUNT(1) TOTAL_SUBS,SUM(CASEWHEN A.STATE = 0 THEN1ELSEEND) AS CHRUN_SUBS,SUM(CASEWHEN A.STATE = 1 THEN1ELSEEND) AS NEW_SUBS,SUM(CASEWHEN A.STATE = 1 THEN1ELSEEND) - SUM(CASEWHEN A.STATE = 0 THEN 1ELSEEND) AS INCREASE_SUBS, SUM(CASEWHEN A.IN_STATE = 1 THEN1ELSEEND) AS SILENCE_SUBS,SUM(CASEWHEN A.IN_STATE = 2 THEN1ELSEEND) AS USAGE_SUBS,SUM(D.TARGET_VALUE) AS TARGET_SUBS, (SUM(CASEWHEN A.STATE = 1 THEN1ELSEEND) - SUM(CASEWHEN A.STATE = 0 THEN1ELSEEND)) / COUNT(1) AS INCREASE_RATEfrom f_width_call A, D_PROVINCE B, D_PACKAGE_TYPE C, TMP_SUBS_TARGET DWHERE A.Province = B.PROVINCE_IDAND A.Package_Type = C.PACKAGE_TYPE_IDAND A.PROVINCE = D.PROVINCE_IDAND A.PACKAGE_TYPE = D.PACK_TYPE_IDAND (substr(A.PRD_ID,1,6)=? or ? is null )AND (A.Province = ? or ? is null )GROUP BY B.PROVINCE_NAME, C.PACKAGE_TYPE_NAME3.2、从数据集(对应Month的查询条件)同样新建数据集：Next：Month条件的sql：select distinctto_char(to_date(D_TIME_PERIOD.PRD_ID,'yyyy-MM-dd'),'yyyyMM') AS Y_M from D_TIME_PERIOD3.2、从数据集(对应Province的查询条件)同样新建数据集：Next：Province条件的sql：select prov.PROVINCE_ID ,prov.PROVINCE_NAMEfrom D_PROVINCE prov4、创建报表参数报表参数，即为查询条件的输入参数。
birt报表初级教程之数据源配置
birt报表初级教程之数据源配置数据源配置在布局编辑器中开始设计报表之前，构建BIRT数据源以将报表连接至数据库或其他类型的数据源。
构建数据源时，要指定驱动程序类、数据源名称和其他连接信息（例如，用户名和密码）。
Birt自带一个已经配置为与BIRT报表设计器配合使用的样本数据库Classic Models，对于本教程使用的是Derby数据库。
1.选择数据资源管理器(Data Explorer)。
如果使用缺省报表设计透视图，则数据资源管理器位于布局编辑器的左边，在选用板（Palette）的旁边，如图所示。
如果它尚未打开，则选择窗口->显示视图->数据资源管理器。
2.右键单击Data Sources然后从上下文菜单中选择新建数据源。
新建数据源显示可以创建的数据源的类型，如图所示。
●Classic Models Inc.Sample DataBase———上面说过是BIRT样本数据库。
●Flat File Data Source———从CSV、SSV、TSV、PSV四种格式的文件获取数据源。
●JDBC Data Source———通过配置jdbc连接数据库。
●Script Data Source———通过编写脚本获取数据源。
●Web Services Data Source———通过web service方式获取数据源。
●XML Data Source———从xml文件获取数据源。
3.这里我们介绍通过JDBC Data Source配置数据源。
选择JDBC Data Source，输入数据源名称，点击Next,配置Jdbc信息。
如下图：●首先，单击Manage Drivers添加驱动包。
如下图：单击add，选择derby数据库的derbyclient.jar驱动包。
点击ok，驱动完成添加。
●配置信息：Driver Class:org.apache.derby.jdbc.ClientDriver(v10.1)(通过下拉菜单可以找到)Database URL:jdbc:derby://【host】:1527/【database】User Name：用户名Password：密码4.测试连接，测试前查看derby数据库是否启动；点击Test Connection。
Birt一步步开发教程
ContentsBirt一步步开发教程................................... 错误!未定义书签。
1 安装部署Birt ....................................... 错误!未定义书签。
下载安装birt .................................. 错误!未定义书签。
安装网页运行时软件包 .......................... 错误!未定义书签。
2 报表的开发制作 .................................. 错误!未定义书签。
新建一张报表 .................................. 错误!未定义书签。
连接数据源......................................... 错误!未定义书签。
图表的制作......................................... 错误!未定义书签。
新建数据集...................................... 错误!未定义书签。
创建表.......................................... 错误!未定义书签。
3 报表的发布.......................................... 错误!未定义书签。
使用tomcat发布报表................................ 错误!未定义书签。
4 其他功能的应用...................................... 错误!未定义书签。
目录的创建......................................... 错误!未定义书签。
报表参数的创建..................................... 错误!未定义书签。
- 1、下载文档前请自行甄别文档内容的完整性，平台不提供额外的编辑、内容补充、找答案等附加服务。
- 2、"仅部分预览"的文档,不可在线预览部分如存在完整性等问题,可反馈申请退款(可完整预览的文档不适用该条件!)。
- 3、如文档侵犯您的权益，请联系客服反馈,我们会尽快为您处理(人工客服工作时间：9:00-18:30)。
回到原先的报表，选中数据行中的JOBTITLE项， 在下方的Property Editor页中选择Hyperlink标签 点击…进行编辑 弹出的框中选择Drill-through项
34
2016-10-12 |
Step 1中选择刚才建立的报表 Report Parameters框中添加目标报表所具有的查询 参数
Birt使用入门详解
2016-10-12
目录
1. 2. 3. 4.
1. 2.
安装 一个简单的报表 参数查询 使用脚本
给报表行添加序号 添加自定义分页
5. 使用超链接 6. Data Cubes
1.
2.
制作汇总表 制作多表头报表
7. 图表
2
2016-10-12 |
安装
3
2016-10-12 |
一个简单的报表
使用Data Cubes制作多表头报表
多表头需要有对应的数据表结构。以下是对示例表 设计的介绍：
表：head1（第一级表头） 字段：id(INTEGER)（编号）name(VARCHAR)（名称） 表：head2（第二级表头） 字段：id(INTEGER)（编号）name(VARCHAR)（名称） parent_id(INTEGER)（上级表头id） 表：data（数据） 字段：id(INTEGER)（编号）value(INTEGER)（数据值）head_id (INTEGER)（从属表头id）row_id(INTEGER)（行编号，用于判定是 否为同一条记录）
新建项目，选择 Business Intelligence and Reporting Tools下 的Report Project
4
2016-10-12 |
输入名称，点击 Finish
5
2016-10-12 |
在新建的项目中添加一个report文件
6
2016-10-12 |
输入名称，点击 Finish
添加了”?”之后，会自动在Parameters页中添加一个 新的参数
16
2016-10-12 |
为参数修改名称、类型、默认值
接下来添加一个外部参数
17
2016-10-12 |
为参数设置必要的属性
18
2016-10-12 |
回到刚才的查询参数，将其与外部参数对应起来
接下来可以预览
58
2016-10-12 |
在编辑区将图表调整成合适的大小，预览
59
2016-10-12 |
谢谢！
25
2016-10-12 |
选中Table，点击Script标签，为其onPrepare事件 添加一个计数器定义
26
2016-10-12 |
选中Data所在的行，点击Script标签，为其 onCreate事件增加计数
27
2016-10-12 |
编辑刚才添加的Data组件，填写名字、种类，在表 达式一栏中填上计数器count
51
2016-10-12 |
添加Cross Tab，head1、head2组拖放至按列分组 区，data组的row_id拖放至按行分组区，Summary 拖至Summary区
52
2016-10-12 |
将不必要的id项和value标题在Property Editor下的 Visibility页中选择隐藏
2016-10-12 |
45
建好表后，添加一些数据 使用JDBC链接至数据库
46
2016-10-12 |
选择驱动，填写信息；Manage Drivers按钮可以添 加驱动
47
2016-10-12 |
将三张表的数据分别建立数据集 建立total数据集，用inner join语句将三张表连接起 来
预览结果
28
2016-10-12 |
29
2016-10-12 |
使用脚本添加自定义分页
Birt的表格设置中有固定分页的功能（Page break ），通过脚本，可以为表格传入参数进行自定义分 页 在数据行的Script标签中，为onCreate事件添加脚 本：
30
2016-10-12 |
10
2016-10-12 |
点击Finish后会弹出 编辑页面，可以添加 参数或预览查询结果 等
11
2016-10-12 |
Palette标签中有一系列布局用组件，它们和Data Explorer中的数据一样都可以直接拖放到编辑区中 使用
12
2016-10-12 |
从Palette中将Table组件拖至编辑区，选择8列1行
22 2016-10-12 |
23
2016-10-12 |
选中某个元素后点击下方的Scripts标签，可以为元 素的事件添加脚本
24
2016-10-12 |
使用脚本给报表行添加序号
添加一个Table，为其增加一些数据； 在Details Row的第一格中，增加一个Data组件； 在Header Row的第一格中，增加一个Label组件为 Data作标注；
Report Parameters中添加脚本中用到的pagecount 参数
31
2016-10-12 |
可以在序号 的Data表达 式中修改脚 本，将其改 为基于当前 页的序号
32
2016-10-12 |
使用超链接
简单地制作 一个带有查 询的报表， 为其添加参 数等
33
2016-10-12 |
48
2016-10-12 |
建立新Data Cube，选择数据集为total
49
2016-10-12 |
在Available Fields下，使用Other下三个数据集进行 分组，使用total集下的value值作为Summary
50
2016-10-12 |
在Link Groups页中，分别为三个组中的字段与total 集中相应字段建立连接
35
2016-10-12 |
参数的Value 项可以使用表 达式编辑器添 加脚本、报表 内容，或者简 单地使用固定 值/字符串。这 里使用报表的 JOBTITLE字 段值
36
2016-10-12 |
Step 2-6按需求设定，预览结果
37
2016-10-12 |
点击“头衔”下的任一链接，会跳转到对应头衔的 目标报表
53
2016-10-12 |
预览效果
54
2016-10-12 |
使用图表
从Palette区域将Charts组件拖入编辑区
55
2016-10-12 |
选择图表类 型和显示选 项
56
2016-10-12 |
按需要将分组 和值拖入相应 的选择框中
57
2016-10-12 |
设置显示效 果，名称， 格式等
19
2016-10-12 |
预览时会弹出窗口，输入参数
20
2016-10-12 |
只有符合要求的条目会显示
21
2016-10-12 |
使用脚本
拖放进编辑区的字段内容使用Data组件。拖放一个 Data组件进入编辑区，弹出编辑Data窗口，点击fx 进入表达式设置
表达式设置下方有可以使用的函数、运算符等，如 果绑定了数据集也可以添加数据进入表达式。编辑 框中可以使用JavaScript语法
然后将刚才建立的Data Set中的字段拖进table组件 的Detail Row组件中
13
2016-10-12 |
得到如下样式：
点击工具栏按钮预览
14
2016-10-12 |
得到了一个最简单的报表
15
2016-10-12 |
参数查询
Birt可以使用一些外部的参数对报表进行查询 首先要对sql语句进行修改：
7
2016-10-12 |
为报表添加数 据源
数据源可以有 多种来源，此 处选择第一个 自带数据库
8
2016-10-12 |
为报表添加数 据集，数据源 选择刚才所建 的数据源
9
2016-10-12 |
输入查询语句 。可以通过双 击左侧的 available items将表名 或字段名加入 语句
41
2016-10-12 |
对CHECKNUMBER作出修改以计算交易数
Function中有求和、计数、最值等多种计算方式
42
2016-10-12 |
为页面添加一个Cross Tab，将Group和Summary 拖放至相应格中
43
2016-10-12 |
预览结果
44
2016-10-12 |
38
2016-10-12 |
使用Data Cubes做汇总表
先建立一个 可以做汇总 的数据集
39
2016-10-12 |
建立一个新的Data Cube，数据集选择刚才建立的 数据集
40
2016-10-12 |
在Groups and Summaries项中，按需求将分组拖放 至Groups和Summary Fields下