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报表设计器，初次使用时，新建一个报表项目，以进入报表设计模式。
Eclipse Birt报表指南
-简介BIRT是一个Eclipse-based开放源代码报表系统。
它主要是用在基于Java与J2EE的Web 应用程序上。
BIRT主要由两部分组成：一个是基于Eclipse的报表设计和一个可以加到你应用服务的运行期组件。
BIRT同时也提供一个图形报表制作引擎。
URL: /birt/前言这个指南将引导你设计一个简单的报表，令你对BIRT报表系统有个感性的认识，如果想进一步了解BIRT的使用可以参考 BIRT在Eclipse中自带的帮助，Select Help→Help Contents from the Eclipse menu and then click on the BIRT Developer Guide.如图个人体验操作界面友好大方，小图标都很漂亮：）；功能并不逊色与商业报表工具；∙CSS提供了强大灵活的样式定义，对于属性CSS的设计人员来说，应该可以设计出相当出色的报表样式；∙集成在Eclipse中，不用再开启别报表开发工具窗口；∙BIRE的本地化做的很好，安装以后操作界面就是中文的；∙开源的报表产品，降低开发成本，一些报表开发工具除了价格昂贵以外，还有用户限制；BIRT 安装指南安装方式一下载一个BIRT All-in-one版本的 Eclipse，包含了运行BIRT系统所需的组件，最方便了（如果是将报表工具培训一下让非开发人员参与定制话可以这样做：））URL:birt-report-designer-all-in-one-2_1_1.zip安装方式二假设你已经知道如何安装Eclispe插件(建议采用Link的方式安装插件，不至于全部一股脑的将各种插件都解压到Eclipse的目录中去)运行BIRT报表系统需要以下软件或插件∙Java 1.4.2/1.5 JDK/JRE∙Eclipse-SDK-3.1.2-win32及以上版本∙Graphics Editor Framework (GEF) runtime∙Eclipse Modeling Framework (EMF) runtime∙BIRT∙iText 1.3 - 复制 itext-1.3.jar 文件到plugins/org.eclipse.birt.report.engine.emitter.pdf_version/lib 目录.∙prototype.js v1.4.0 - 复制prototype.js 文件到plugins/org.eclipse.birt.report.viewer_version/birt/ajax/lib 目录其他∙BIRT提供的一个Flash格式的安装演示，也可以照着这个演示来安装：）∙BIRT 网站提供的安装指南∙运行报表（tomcat/weblogic/jboss）使用入门1.环境●报表设计器：可以到/birt/downloads/下载最新版本，当前的最新版是birt-rcp-report-designer-2_1_1。
birt使用指南
山东电力集团公司门户项目组2007年1月修订页目录1.简介 (4)2.功能介绍 (4)2.1支持的报表 (4)2.2体系组成 (4)2.3J2EE应用中的BIRT (5)3.软件下载 (5)4.报表制作 (6)4.1简单的例子 (6)4.2设计细节 (19)4.3子报表设计 (23)4.4图表设计 (25)4.5图表细节 (27)4.6项目应用 (35)5.应用部署 (39)Birt 使用文档1.简介BIRT是一个Eclipse-based开放源代码报表系统。
是基于J2EE的Web应用程序上。
BIRT 主要由两部分组成：一个是基于Eclipse的报表设计和一个可以加到你应用服务的运行期组件。
BIRT同时也提供一个图形报表制作引擎。
目前正式版本是2.1.1，2.2版已经在发布中已经有2.2M4版可以下载，中文版暂时还没有，项目中使用2.1.1的中文版本。
2.功能介绍2.1支持的报表1)列表列表是最简单的报表。
当列表变长时，你可以把相关数据增加到同一分组（基于客户的订单分组，基于供应商的产品分组）。
如果数据是数字类型的，你可以轻松的添加到“总数”、“平均”、或其他汇总中。
2)图表当需要图表表现时，数字型数据比较好理解。
BIRT 也提供饼状、线状以及柱状图标等。
3)信函和文档通知、信件、以及其他文本文档都很容易通过BIRT 方便建立。
文档包括正文、格式、列表、图表等。
4)混合报表很多报表需要联合以上所有的报表构成单一文档。
例如，一份客户声明会列出客户所需要的信息，为当前促进(promotions)提供文本，以及提供并行的出帐和入帐列表。
一份财政报表将包括声明、图表、表格，所有这些都将进行全方位的格式化，来匹配共有的配色方案。
2.2体系组成BIRT 报表包含四个部分：数据、数据转换、业务逻辑、陈述。
1)数据Web 服务、Java 对象，这些都可以作为BIRT 报表源。
2.1 版本提供JDBC 支持，也支持利用编码来获取其他地方的数据。
Eclipse BIRT 简单报表开发
Eclipse BIRT 简单报表开发帮助文档：/documentation/BIRT_231/wwhelp/wwhimpl/js/html/wwhelp.htm1新建报表：1.1运行向导建立工程,如下图：1.2选择新建的工程，如下图：1.3建立报表文件,如下图这里选中Report templates：Blank Report已经完成建立报表文件。
2连接数据库2.1建立Data Source这里我们会连接SQL Server 2005的示例数据库：AdventureWorks●请确认已经安装这个示例数据库●请确认Sql server 2005已经打开TCP/IP连接,如下图：打开建立Data Source向导，如下图：这里要注意如果刚安装的Eclipse BIRT是没有（如下图）：Com.microsoft.sqlserver.jdbc.SQLServerDriver (v1.2)下载地址：/download/8/B/D/8BDABAE2-B6EA-41D4-B903-7916EF36 90EF/sqljdbc_1.2.2323.101_enu.exe安装方法：●把文件解压●Manage Drivers●Add-> 选中解压出来的文件：sqljdbc.jar●添加成功连接串：jdbc:sqlserver://localhost:1433;databasename=AdventureWorksTest Connection…,如下图：成功添加Data Source2.2建立Data Sets如下图：在这里可以输入简单的SQL语句：select * from HumanResources.Employee成功添加Data Set2.3添加Report ParameterPS:这个是用于报表传参数的,建立参数后Birt自动提供一个页面给我们填写参数，不用再另做页面设计的。
建立Parameter后要在DataSet进行绑定才可以用，如下图：3设计报表显示区域3.1在Palet面板中把Table拖入报表编辑区，并填写行数和列数，如下图：3.2在Data面板中的DataSet中把相关字段拖放入Detail Row区域中,如下图：3.3运行报表，在工具栏点击View Report ，输入EmployeeID之后就可以运行，如下图：3.4简单的统计补充有时在设计报表时会用到如Count和Sum这类的小统计，我们可以把Data控件插入Footer Row里面，再输入统计信息，如下图：常用方法：Total.sum()Total.count()4建立图表4.1在Palet面板中把Chart拖入报表编辑区,运行图表向导，如下图：这里可以分别填写x和y系列所用的字段。
BIRT 报表使用说明
BIRT 报告传统报告允许允许企业以图形形式显示其他人可读的数据。
BIRT 有助于自动化在部署好的J2EE 应用程序中创建报告的过程。
在本教程中，将学习如何创建一个将使用您的应用程序部署的报告。
示例应用程序当客户来到银行进行取款或汇款时，该事务通常由银行职员执行。
本教程的示例应用程序是一个用户界面(UI)，该界面将接收事务细节信息，并将它们存储到一个Derby 数据库中。
记录的事务细节信息包括事务日期、事务标题、职员编号、事务类型、取款或汇款数量，等等。
分析数据当示例应用程序获取信息并将它们存储到数据库中时，数据处于其最原始的形式，没有能以某种有意义的方式进行查看的可靠组织形式。
您开发的BIRT 将用于分析此数据。
所介绍的每种类型的报告都允许您查看并随后分析数据库中包含的数据。
将BIRT 对象嵌如应用程序一旦已经完成BIRT 报告和示例应用程序，就可以将BIRT 对象嵌入应用程序中。
这将使您——银行管理人员——乐于查看发生在银行中的事务的趋势。
您将获得一些知识，这些知识使您作出向更好趋势更改的决定，并提高银行的生产效率和性能。
Derby：设置在这一节中，将创建并初始化具有BIRT 中要使用的测试数据的Derby 数据库。
您将通过Geronimo 的网络服务器使用Geronimo 中的内置Derby 数据库。
在Geronimo 上部署应用程序时，将使用此数据库，因此使用内置数据库是有一定道理的。
设置用于Derby 的Geronimo因为将在用于BIRT 的Geronimo 中使用内置Derby 数据库，所以需要正确的驱动程序。
有一些 .jars 需要添加到Geronimo 中：IBM DB2 JDBC Universal Drivers。
现在您应该已拥有这两个文件（请参阅前提条件）。
解压缩从IBM 获得的 .zip 文件。
从lib 目录中获得两个 .jar 文件：db2jcc.jar 和db2jar_license_c.jar，并将它们放置在Geronimo 安装的<geronimo-install-dir>/repository/org.apache.derby/jars 目录中。
01-Birt工具数据报表开发手册
Birt数据报表开发手册1. 创建模板双击BIRT应用程序以启动Birt报表设计环境，首次启动未加载任何报表开发资源。
主界面如下：根据报表设计的需要，Birt本身提供了一些常规的模板：当然，也可以根据实际需要，添加一些使用频率比较高的模板。
下面将以两张图形，一张列表，且图形在上横向排列的模板为例，创建新模板。
点击文件菜单中的新建,选择新建模板，根据实际情况修改模板名称和存储路径：为此模板添加一些附加属性，如该模板的描述信息和模板布局的预览图像等。
点击完成，开始编辑此模板的布局。
在组件按钮区域依次选取：一个标签，用于放置报表的标题，双击输入标题文本。
也可根据需要动态的文本。
一个网格：用于放置水平的两张图形，因此网格设置为2列1行。
可根据实际情况调整。
一张表：用于放置数据报表，明细数据列设置为8列1行。
可根据实际情况调整。
关于组件的使用，将在后面的章节中具体说明。
用鼠标右击网格中的其中一个空白处，依次选择插入，图表。
在弹出的对话框中选取需要的图形。
同样的方法处理另外网格的另外一个。
有关图形的制作，将在图形报表开发手册中详细说明。
设置每种组件的属性，在OutLine窗口中选中已经拖放的组件，根据需要对其相应的属性进行调整。
如字体大小，颜色，对齐方式，样式等设置完成后，模板样式如下：保存模板的配置信息，以便在以后的报表开发中可以直接读取该模板。
2. 新建共享资源库在Birt的资源管理器中添加一些共享资源，如共享库：在弹出的对话框中输入Library库文件的保存路径和名称:确定后，Library库的创建完成。
如果操作无误，可以在对应的目录下浏览到新建的库。
3. 新建数据源在共享库中新建一个制作报表需要的数据库连接，以Oracle9i数据库连接为例，需要先配置数据驱动(数据库的驱动程序配置方法已经在报表设计器的配置手册文档中体现)。
然后在新建的库中，用鼠标右击数据源，选择新建数据源：在弹出的对话框中选择对应数据源类型，并为该数据源命名：选择正确的数据库驱动和URL后，就可以进行数据库的连接测试：可以根据报表需要，创建一个或者多个数据源的配置：数据源创建完成后，可以通过选择选择资源管理器中共享资源，Library库下新建的数据源，右击鼠标选择添加到报表，将新建数据源添加值报表中供使用。
BIRT详细开发手册
BIRT详细开发手册BIRT详细开发手册目录1BIRT开发环境 (6)1.1..................... 新建Project71.2..................... 新建Report81.3..................... 调整工作窗口92BIRT报表开发 (11)2.1...... 新建数据源(Data Sources) 112.2............ 新建数据集(Data Set) 132.3................... BIRT报表条件162.3.1.................. 一般条件162.3.2.................. 日期条件172.3.3.................. 条件脚本192.4....................... BIRT表格202.4.1............. Insert table202.4.2.............. 设置报表表头222.4.3.................. 表头样式232.4.4................ 表格网络线233.4..................... 图表效果展示58此文档为本人结合网上资料与本人BIRT开发经验整理的BIRT详细的开发手册，适用于初学者快速掌握BIRT开发。
1BIRT开发环境BIRT开发环境是带有BIRT插件的eclipse1.1新建Project菜单栏file→new→other选择reportproject→nex，然后给project取名，完成后点击finish即可完成新建project新建完成后的project1.2新建Report在新建的项目上右键new→orher ,Report→next, file name为报表名称是以”. rptdesign”为结尾的文件，点击finsh即可完成新建Report.1.3调整工作窗口菜单Window→Show View→other→Report Design 调出Data Explorer窗口菜单Window→Show View→other→Report Design 调出Property Editor窗口调出这两个窗口方便报表开发。
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报表使用指南1Birt的安装方法把birt整合到了M yeclips e6.5中，(ec lips e的官方网站上提供有一个bi rt-rep ort-design er-all-in-o ne-2_2_2.zip，你直接解压缩这个就可以了，就免去了birt与My ec lipse6.5的整合)。
如果要把bi rt安装到Myecl ipse6.5中，要注意一些事情1.1ecl ip se的版本就是说你的eclipse版本要和适当的bir t版本配合，当前bi rt的最新稳定版是b irt2.3。
如果使用的是ec lips e3.3版本，你应该用bir t-repo rt-framewo rk-2_2_2.zi p，如果使用的是eclipse3.4，你应该用birt-report-f ra mework-2_3_0.zip版本不一致会出一些问题。
1.2在Myec lipse6.5中装birt。
My Eclipse6.5自带的是ecli pse3.3，所以只能下载birt-re port-fra me work-2_2_2.zip (下载地址：http://do wnlo ad.ecl ips /b ir t/downloa ds/index2.2.2.php)而birt-repo rt-frame wo rk-2_3_0.z ip是针对e clip se3.4的。
把下载下来的birt-r epo rt-fram ew ork-2_2_2.zip包解压，解压后的feature s文件夹下的所有文件拷贝到MyEcl ip se6.5安装目录下的..\my ecli pse\e clips e\fe atures 下，解压后的plug in s文件夹下的所有文件拷贝到..\my eclipse\ec lipse\plug ins下。
birt的简单使用
最近项目用上了birt，一款开源的报表制作工具，当然开源的东西总是免不了简单方便等溢美之词。
我只用到了birt的脚本化数据源和脚本化数据集，所以这里也只说下这两者的简单使用。
1.报表的集成就不说了，网上一搜一大把，我用的是3.7.2版本的birt。
2.新建一个报表项目：首先新建一个普通的java工程test，在该工程下建立一个存放报表文件的文件夹birt，如下图所示：添加所依赖的jar包：3.环境搭建好了之后，下面创建一张效果如下所示的报表：其中行和列都是可以动态变化的。
4.新建报表：右击新建报表，我的是中文版的，报表后缀名为rptdesign：5.新建数据源：双击新建的报表，进入报表设计视图，在左上角?数据源节点右击新建数据源：选择脚本化数据源，填写名称即可。
6.新建数据集，在数据集节点右击新建数据集：选择第6步建立的数据源，填写数据集名称即可。
7.将数据集拖到可视化布局面板中，修改表头名称：此时系统生成了一个一行（ps：这里的行不包括页眉和页脚）一列的表格，双击name列，可以看到基本的一个列绑定：其中dataSetRow[“name”]表明了这个name的值来自数据集。
8.创建报表资源，方便起见，直接写死：9.报表事件处理程序的添加：为了支持报表的动态渲染，我选择了实现IReportEventHandler:然后在属性编辑器选择报表：为它添加刚才编写的事件处理程序：点击浏览有类选择：10.表格动态添加列：这里的列就是Resources.properties的数目加上名字这一列。
1).获取表格：我选择了根据表格名来获取：在属性编辑器-表中的常规里可以看到名称，如果没有，自己指定一个。
获取表格代码：2).表格插入行：调用th.insertColumn(int columnNumber,int optionFlag)即可插入行，optionFlag应该控制的是左右方向。
3).设置表头文本：下面红色的就是表头文件(来自于报表文件xml源)，其实，如果不去看它的xml而直接调用java代码的话会无从下手，而看了xml文件后就非常清晰了，下面是设置表头文本的实现：4).动态添加数据集。
Birt使用详细说明
引言：初次使用Birt，感觉这个开源的报表工具实在是太好了，因为我也用过国内某收费报表工具，感觉某些地方没有Birt功能强大，如果花钱买过来，实在不划算。
一.下载及安装Birt :：/birt/downloads/，最简单的就是下载其中的birt-report-designer-all-in-one-XXX.zip 版本，直接运行就可。
二.Birt的参考资料：/posts/list三.新建一个报表的步骤：1.新建报表工程。
打开eclipse后,new->other->Business intelligence and reporting tools –>report project 如下图输入project name：birt即可。
2.新建报表。
new->other->Business intelligence and reporting tools–>report输入文件名，选择blank report 最后点击finish 3.设计报表之一构建数据源。
打开”data explorer ”将出现如下图，右击“data source”点击“manage dirver….”加上数据库的驱动.点击“Test Connection 。
”测试连接是否成功。
4.新建数据集右击“data sets”–> new data set从左边drag 相应的字段，构成查询sql语句5．报表布局显示出”paletee”选择“Report items”将table 拖到中间。
将数据集中的字段拖放到表的detail row中的单元格内最后点击“preview”，就可在报表中显示数据这样一个简单的报表就完成了。
6．定义动态参数查询新建报表参数点击数据集,选择”parameters”将其绑定到定义的报表参数中去同时修改Query，加上where条件先选择某一，如table, 等，再切换到script直接在里面写就可以了8.在web server下运行New ->other->web project将XXX. new_report.rptdesign copy到webContent目录下。
Birt模板设计操作手册范文
文件版次：业务需求说明书_综合查询Birt模板设计操作手册目录1 BIRT模板设计器................................................................................................................. 错误！未定义书签。
1.1环境准备 ....................................................................................................................... 错误！未定义书签。
1.2启动B IRT报表编辑器.................................................................................................. 错误！未定义书签。
2BIRT模板制作..................................................................................................................... 错误！未定义书签。
2.1将E XCEL格式模板转换为B IRT模板 ......................................................................... 错误！未定义书签。
2.2调整转换后生成的B IRT模板...................................................................................... 错误！未定义书签。
3模板数据绑定 ....................................................................................................................... 错误！未定义书签。
BIRT报表开发手册详解
开源报表BlRT开发手册北京宇信易诚科技有限公司2007-08-23目录1Birt 介绍 (5)U 报表介绍 (5)1.2基本概念 (5)1・3 丰富的报表 (5)1.4BIRT报表由四部分组成 (6)1.5报表设计器 (6)2Birt插件安装 (8)2.1插件版本说明 (8)12插件安装 (9)2.2.1完全安装 (9)2.2.2更新安装： (9)2.2.3分步安装 (9)3Birt报表开发实战 (13)3.1创建报表 (13)3.1.1创建报表工程 (13)3.1.2创建报表 (14)3.2数据源配置 (16)3.3创建数据集 (19)3.4网格报表 (20)3.4.1创建数据源 (21)3.4.2创建数据集 (21)343 对报表进行布局 (21)3.4.4格式化与预览 (23)3.5分组报表 (24)3.5.1创建数据源 (25)3.5.2构建数据集 (25)3.5.3对报表进行布局 (25)3.5.4设定分组数据 (25)3.5.5格式化报表 (27)3.6交叉报表 (28)3.6.1构建数据源 (28)362构建数据集 (28)363在报表中加入交叉报表 (28)3.6.4数据准备 (29)3.6.5向交叉表插入数据 (32)3.6.6加入汇总 (33)3.6.7格式化报表 (34)3.7嵌套报表 (35)3.7.1构建数据源 (36)3.7.2构建数据集 (36)3.7.3布局嵌套报表 (38)3.7.4将Table绑左数据集 (39)3.7.5设定主表数据 (39)3.7.6设定子表数据 (40)3.8交互报表 (42)3.83 加入响应参数 (45)384 布局扌艮表 (47)3.8.5插入报表数据 (48)3.8.6格式化与预览 (49)3.9报表钻取 (51)3.9.1设泄响应参数 (51)3.9.2预览结果 (54)3.10图表报表 (55)3」0」为报表插入图表 (55)3」0.2 设定图表属性 (55)3」0.3 图表预览 (60)3.11多层交叉报表 (61)3」1」构建数据源 (61)3.11.2构建数据集 (61)3.11.3在报表中加入交叉报表 (62)3.11.4数据准备 (63)3」1.5 向交叉表插入数据 (63)3」1.6 格式化与预览 (64)3.12多层交叉汇总报表 (65)3」2」加入汇总 (65)3.12.2格式化与预览 (66)3.13 其他 (67)3.61 格式化报表 (67)表头与标题 (67)3.13J.2 设泄单元格格式 (68)3.13J.3 样式套用 (68)3.61.4数据元素格式化 (69)3.13.2分页、页眉与页脚 (70)3.13.2」设置分页显示 (70)3」3.2.2 设置分页打印 (70)3.13.2.3 设冒页眉页脚 (71)3.13.3隔行高亮度显示 (73)3.13.4对报告进行布局 (76)3.13.4」添加删除行或列 (76)3」3.4.2 指定行髙或列宽 (76)3」3.4.3 添加图像 (77)3.13.5数据绑泄 (79)4Birt 报表script (82)4・1 avascript 脚本编写 (82)4.1.1隔行髙亮度显示 (82)4.2java脚本编写 (88)421 创建java 类 (88)4.2.2java类与报表交互 (92)4.3BIRT脚本参考 (98)5Birt报表部署 (99)5・ 1 直接使用运行birt-nmtime-2_2_0 包中的WebViewerExamplc (99)5.2集成到已有web应用 (100)5.3数据库驱动位置 (107)5.4报表url说明 (107)5. 5 web, xml 配置 (113)5. 6 viewer・ properties 说明 (115)5.7BIRT 在jsp 中tag 使用 (116)5.8关于BIRT编码 (123)1Birt介绍1.1报表介绍BIRT一一商业智能和报表工具。
Birt_报表参数的使用配置说明
Birt 报表参数的使用Birt 是一款非常流行的开源报表开发工具。
本文总结了 Birt 报表中参数机制，并结合实例详细地阐述了参数的各种使用方法，最后介绍了 Birt 报表的源代码级使用。
以期为 Birt 报表使用者提供一个有益的参考。
序言参数是 birt 提供的一种很重要的机制，在 birt 中，参数具有变量的作用，它为 birt 报表的生成提供了一种灵活强大的机制。
本文基于 Birt 2.1.2 讲述 Birt 报表中一些重要的用法以及 birt 源码级的参数使用机理，为报表开发者以及报表应用程序开发者提供一个参考。
本文的示例是基于 Birt RCP designer 2.1.2 开发的，在阅读本文前，最好有 eclipse 相关经验，并且已经能够使用 Birt 插件制作一些简单报表，并了解 Birt 报表的一些基本概念，比如 Data Source（数据源），Data Set（数据集）等。
基本报表制作过程可见 developerworks 相关文章"BIRT：基于 Eclipse 的报表"。
本文示例使用 Birt 自带的 Sample 数据源，用到的数据基于图 1 所示的实体关系模型。
从这个模型中可以看出，文中示例用到三张数据库表分别为 customers，orders 和 orderdetails。
其中 customers 表的customernumber 字段作为外键出现在 orders 表中，而 orders 表的 ordernumber 字段做为外键出现在orderdetails 表中。
图 1. 实体关系模型1 标量参数(Scalar parameter)在使用 BIRT 参数的时候，首先要了解 BIRT 分为报表参数和数据集参数。
报表参数定义于整个报表内，而数据集参数定义于某个数据集（Data Set）中。
数据集参数使用的时候通常需要链接到某个报表参数或者利用绑定表（binding tab）和一个嵌套表中的某个数据元素绑定。
birt使用指南
birt使用指南BIRT使用指南BIRT（Business Intelligence and Reporting Tools）是一套基于开放标准的商业智能和报表工具，由Eclipse开发。
本文档将详细介绍BIRT的使用指南，包括安装、数据源、报表设计和等内容。
1、安装1.1 BIRT1.2 安装Java开发工具（JDK）1.3 安装Eclipse1.4 安装BIRT插件2、数据源2.1 连接数据库2.2 导入数据源2.3 创建数据集2.4 数据集参数设置3、报表设计3.1 新建报表3.2 报表元素添加3.3 数据绑定3.4 样式设置3.5 图表设计3.6 嵌套表设计3.7 参数设置3.8查询过滤器3.9脚本设计4、报表4.1 导出报表4.2 配置报表方式4.3 调度报表任务4.4 报表API调用附注：1、本文档涉及附件：本文档所述示例代码和演示数据已打包为附件，可以通过以下：[附件]。
2、本文所涉及的法律名词及注释：2.1 商业智能（Business Intelligence）：利用数据分析技术和工具，将企业内外部的海量数据加工分析，得出对业务决策有价值的信息。
2.2 报表（Report）：根据特定的数据和要求，结合数据分析和可视化技术，将数据以表格、图表等形式呈现，用于信息展示和决策支持。
2.3 数据源（Data Source）：报表所需的数据的来源，可以是数据库、文件、Web服务等。
2.4 数据集（Data Set）：报表中用于展示数据的集合，通常与数据源相关联。
2.5 参数（Parameter）：报表运行时可以输入的变量，用于动态筛选数据或配置报表行为。
2.6 查询过滤器（Query Filter）：用于对数据集进行过滤，筛选出满足条件的数据。
2.7 脚本（Script）：BIRT支持使用JavaScript进行报表设计，可以通过脚本实现自定义的数据处理、表达式计算及样式控制等功能。
02-Birt工具图形报表开发手册-13页word资料
Birt图形报表开发手册1. 图表制作总体步骤Birt提供了丰富的图表元素，图表是数据或数据集之间关系的图形表示法。
图表采用易于理解的格式显示复杂数据。
完全可以将图表作为报告使用，也可以将报告与其他报告元素组合以增强或突出显示相关信息。
图表的配置一般包含如下步骤：a)准备数据源与数据报表的数据源集数据集准备一样，大部分多维的图表的制作也需要依赖于多维数据集。
如需要使用数据集，请参考《Birt数据报表开发手册》的数据源和数据集的创建与使用部分。
b)选择图表类型选择组件板，然后将该组件板中的图表元素拖到报告中，或者在报表正文的放置图表位置右击鼠标，选择插入图表：弹出图表配置对话框，首先根据报表需求选择图表类型和子类：设置图表的指标维度个数，已经图表的输出类型格式等，从而确定图表的大体样式。
c)关联展示数据集类型选择完成后，针对图表的特点和属性进行数据的绑定关联：首先选择图表展现的数据来源，也就是报表中已经存在的数据集。
根据图表的需要设置系列，维度指标，是否分组等。
可以使用不同的方法来提供图表中的数据表达式：指定要使用的数据的最简单方法是将“数据预览”中的列拖拽至图表的元素中，或通过选中数据集的字段右击鼠标，选择相应的元素加入也可以输入表达式或使用表达式构建器来创建表达式。
在设计图表时，预览窗口将向您指示您的进度。
例如，如果更改线图的X，Y轴的显示信息，分组信息等，则预览窗口将反映您所作的更改。
d)设置图表格式数据绑定后，就可以根据需求和图表本身的属性，对图表的展现格式进行设置，设置完成后，就可在工具和页面中预览。
柱线图预览结果:图表数据的方式通常与在 Birt 中的其他数据展现的方式不同。
一个重要的差别是为图表创建的数据集，图表不会聚集数据。
要在图表中使用总计，必须创建返回总计信息的数据集。
下面我们将按照不同的图表来全量了解图表的制作。
2. 柱状图系列在Birt的图表设置中，柱状图，折线图，面积图，散点图，气泡图，股票图，管，锥，棱形图，差异图等趋势展现类图表，只是展现图表的形状和元素，样式有差异。
BIRT报表中文学习手册
一、去掉Birt表格下自动生成的日期时间在报表下点击Xml Source标签，打开xml，找到<page-setup><simple-master-page name="Simple MasterPage" id="2"><page-footer><text id="3"><property name="contentType">html</property><text-property name="content"><![CDATA[<value-of>new Date()</value-of>]]></text-property></text></page-footer></simple-master-page></page-setup>把<text id="3"><property name="contentType">html</property><text-property name="content"><![CDATA[<value-of>new Date()</value-of>]]></text-property></text>这几行去掉即可。
二、Birt表格隔行换颜色1、鼠标旋停在表格上，选择Row Detail一行；2、选择script标签页，打开birt的脚本编辑窗口；3、从下拉列表中选择OnCreate，在下面加入Javascript脚本如下：if(row.__rownum % 2 == 0){this.getStyle().backgroundColor = "#E9EAEB";}else{this.getStyle().backgroundColor = "#FFFFFF";}4、保存三、Birt表格分页下面是我从网上找的方法，我试了一下不行，后来我在table里设置了Page break interval 就可以了，但是预览的时候不能看到分页1、鼠标旋停在表格上，选择Row Detail一行；2、选择script标签页，打开birt的脚本编辑窗口；3、从下拉列表中选择onPrepare，在下面加入Javascript脚本如下：var count = 0;4、从下拉列表中选择OnCreate，在下面加入Javascript脚本如下：count++;if(count % 10 == 0){style.pageBreakAfter = "always";}5、保存，使用Web Reviewer进行预览，数据可以进行分页显示了。
开源报表_BIRT_开发_手册_2
4 Birt 报表script在使用 Eclipse 工作台开发 BIRT 报表时，您可以使用 Java 或 JavaScript 编写定 制事件处理程序。
在使用 Eclipse ECP（Eclipse CORBA Plugin (ECP)提供一个可针 对 CORBA IDL 文件语法进行着色的编辑器） 开发 BIRT 报表时，只能编写 JavaScript 事件处理程序。
无论是使用 Java 还是 JavaScript，可以编写的事件处理程序集合是相同 的。
可以使用 Java 来编写一些事件处理程序并使用 JavaScript 来编写另一些事件处理 程序。
如果同一个事件同时有 Java 和 JavaScript 事件处理程序，则 BIRT 将使用 JavaScript 处理程序。
4.1 avascript 脚本编写4.1.1 隔行高亮度显示1. 在布局（Layout）中,选择 Table－Detail 的行。
如下图：2. 然后选择 Script，打开脚本窗口顶部的方法列表并选择 onPrepare，如图所示。
var count=0;3. 最后打开脚本窗口顶部的方法列表并选择 onCreate，如图所示： count++;if (count % 2 != 0) {style.setBackgroundColor(silver);}4. 保存，点击 Preview预览结果如下图。
4.1.2 多参数查询在多参数查询时，根据输入的参数不同，查询出不同的结果集，这就需要对查询 sql语言进行拼凑。
在 birt 环境下这种拼凑可以在 data set 的 script 编辑框中完成。
前端包 含在标签中的查询参数提交上来后，通过 params[parameterName]即可引用。
1. 首先，按照 3.3 创建数据集的步骤创建数据集。
Sql2. 创建报表参数，sql需要的条件参数。
如下图：3. 点击 Data Set（创建的数据集），然后点击编辑区的Script 出现脚本编辑器。
- 1、下载文档前请自行甄别文档内容的完整性，平台不提供额外的编辑、内容补充、找答案等附加服务。
- 2、"仅部分预览"的文档,不可在线预览部分如存在完整性等问题,可反馈申请退款(可完整预览的文档不适用该条件!)。
- 3、如文档侵犯您的权益，请联系客服反馈,我们会尽快为您处理(人工客服工作时间：9:00-18:30)。
Birt 使用说明
合适版本：2.1.3
目录
一、前言 1
二、相关软件 1
1.1、BIRT 2
1.2、EMF和GEF 3
三、Birt的安装和配置 3
四、使用说明 5
4.1、创建项目 5
4.2、创建第一个报表 7
4.2.1、创建一个空白报表 7
4.2.2、设置数据集参数 9
4.2.3、设计报表 14
4.3、报表中的参数 26
4.3.1、静态标量参数 27
4.3.2、动态标量参数 29
4.3.3、动态组合参数 31
五、应用系统的结合 31
六、BIRT的学习资料和缺点 45
6.1、学习资料 45
6.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以上版本了，就是这个原因网上很多资料都不是很适合这个版本，所以我走了很多弯路，希望看到此文档的人能比我少走弯路，这也是我写这个文档的原因之一。
二、相关软件
相关的软件分别为：
Java 1.4.2/1.5 JDK/JRE
Eclipse-SDK-3.2.0
Graphics Editor Framework (GEF 3.2) runtime
Eclipse Modeling Framework (EMF 2.2.3) runtime
Birt 2.1.3
Birt-runtime-2.1.3（发布时使用）
NLpack1-birt-report-designer-all-in-one-2_1_3.zip（Birt的中文插件）
下载地址为：
由于在使用过程中对Birt、GEF和EMF不是很理解其用处，所以我也找了一些资料（汗颜，我想大家都知道），下面我就分别简单的介绍一下，如果大家都知道那就跳过去吧。
2.1、BIRT
Birt（Business Intelligence Reporting Tools）是一个Eclipse-based开放源代码报表系统。
，是为 Web 应用程序开发的基于 Eclipse 的开源报表系统，特别之处在于它是以 Java 和 J2EE 为基础。
BIRT 有两个主要组件：基于Eclipse 的报表设计器，以及部署到应用服务器上的运行时组件。
Birt可以实现的报表格式有一下几种，列表、图表、混合报表、交叉表和信件文档，在测试过程中，我只实现了列表、图表和混合报表。
听说也可以实现交叉表和信件文档，我没有验证这里就不介绍了。
列表：列表是最简单的报表。
当列表变长时，你可以把相关数据增加到同一分组。
如果数据是数字类型的，你可以轻松的添加到“总数”、“平均”、或其他汇总中。
图表：当需要图表表现时，数字型数据比较好理解。
BIRT 也提供饼状、线状以及柱状图标等。
混合报表：很多报表需要联合以上所有的报表构成单一文档。
例如，一份客户声明会列出客户所需要的信息，为当前促进(promotions)提供文本，以及提供并行的出帐和入帐列表。
一份财政报表将包括声明、图表、表格，所有这些都将进行全方位的格式化，来匹配共有的配色方案。
一份报表包括BIRT包含四个部分：数据、数据转换、业务逻辑和表现形式。
数据：数据库、Web 服务、Java 对象，这些都可以作为 BIRT 报表源（Web 服务、Java 对象，我没有验证，不知道是否可行，大家都这样说，我也照搬了）。
BIRT 的 ODA(Open Data Access) 框架允许任何人构建新的 UI 以及运行时支持任何类型的表格式数据，单一报表可包含从任意多个数据源获取数据。
数据转换：报表通过对数据的分类、统计、过滤以及分组来适应用户需求。
当然，数据库能实现这些功能，当遇到普通文件和 Java 对象时 BIRT 必须以"simple" 数据源方式处理。
BIRT 允许复杂的操作，比如总合分组、整体共计的百分比，等等。
业务逻辑：真实世界的数据很少提供你理想的结构良好的报表。
许多报表要求用具体逻辑把原始数据转换成用户的有用信息。
如果该逻辑仅仅用于该报表，你可以用 BIRT 的 JavaScript 脚本支持。
如果你的程序中已包含这些逻辑，你可以调用已有的 Java 代码。
表现形式：一旦数据准备好了，你可以在很大的范围内选择表现形式。
表格、图表、文字等等都可以。
单一数据集可以有多种方式表现，而单一报表可以表现多个数据集。
2.2、EMF和GEF
Emf（Eclipse Modeling Framework）和Gef(Graphical Editor Framework)都是Eclipse的tools项目，在Eclipse中使用Emf对系统建模，如数据库模型、网络连接模型，甚至包括界面显示模型（JAVA的事件模型）。
Gef它是一套图像编辑框架，用于开发图形应用，如果你在Eclipse中使用过基于图形设计的应用，例如UML建模，可视化软件界面设计(VE)等，它们基本上都是基于GEF而开发出来的。
至于Emf和Gef的具体使用方法和实现效果，这里就不做重点介绍了，毕竟我们研究的主要对象是Birt。
Birt是基于Emf和Gef来实现的。
三、Birt的安装和配置
3.1、插件安装
Birt的安装和Eclipse的其他插件的安装一样，但是我建议使用Link的方式，这样结构上比较清晰，如果都放在Eclipse的plugins下，一是结构不清晰，二是如果以后不用拆分也很麻烦。
虽然大家都知道怎么安装Eclipse插件，但是我这里还要啰嗦一下，保持文档的完整性。
Eclipse的安装大家想必都会把，直接解压就可以了。
在Eclipse根目录下新建一个文件夹，我创建的为myplugins，把下载的GEF-runtime-3.2.zip、emf-sdo-runtime-2.2.3.zip、Birt-2.1.3.zip和NLpack1-birt-report-designer-all-in-one-2_1_3.zip解压在此文件夹下并重命名，每个文件下的下层目录都为eclipse，如图：
分别在Eclipse根目录下的links目录下创建对应的映射文件，文件格式为.link，我创建文件如图：
内容如图：
创建完成，重启Eclipse，重启前在Eclipse快捷方式的目标中加上-clean 强制加载插件，如图：
在下次使用Eclipse时记得去掉-clean，因为要检查插件，所有速度会很慢。
至此Brit就安装完成了，简单吧？安装成功后在视图中多了一块报表设计的视图，如图
3.2、all in one 方式
官网选择对应的版本，下载集成开发环境。
安装一键搞定。
万事俱备只欠东风，下一步我们就开始激动人心的使用之旅，期待了吧？
四、使用说明
这里用一个简单的例子来说明列表和图形报表的实现过程。
4.1、创建项目
创建一名为TestReports的Web项目，如图所示，文件==》新建==》项目
选择【Web Porject】双击
输入项目名称，点击【完成】
4.2、创建第一个报表
4.2.1、创建一个空白报表
Eclipse切换到【表报设计】窗口，在WebRoot下创建一个文件夹reports，选中reports右键==》新建==》报表
输入testReport.rptdesign的报表名称
点击【下一步】
选择空白报表模板，点击【完成】，一个空白的报表已经完成了。
4.2.2、设置数据集参数
1、创建数据源
选中新创建的空白报表，进入【数据资源管理器】
选中【数据源】右键==》新建数据源，进入新建数据源窗口
有很多类型的数据源，选择第二个JDBC数据源，输入数据源名称“OracleJDBC”点击【下一步】
由于数据源为oralce数据源，首先要选择oracle的驱动，点击【管理驱动程序】
点击【添加】，选择oralce数据库的驱动程序，添加后JAR文件一栏中现实了刚刚添加的驱动程序，添加后点击【确定】，返回【新建数据源】窗口，选择驱
动程序类、数据数据库URL、用户名和密码（JNDI URL为数据源），点击【测试链接】，如果输入的项全部正确会提示，链接成功。