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.1简介BIRT 是一个Eclipse-based 开放源代码报表系统。
它主要是用在基于Java 与J2EE的Web 应用程序上。
BIRT 主要由两部分组成：一个是基于Eclipse 的报表设计和一个可以加到你应用服务的运行期组件。
BIRT 同时也提供一个图形报表制作引擎。
BIRT 拥有和Dreamweaver 一般的操作界面，可以像画table 一样画报表，也可以生成图片、导出Excel、html 分页，样式比script 设置简单，另外BIRT 还有OLAP 导航功能。
1.2基本概念数据源：数据的来源，或提供者。
如xml 数据源、jdbc 数据源等。
数据集：数据集合，它必须与数据源关联，可以理解为查询的结果。
报表以及报表项，报表可视为是针对一组数据集的表现形式，而报表项这是这个表现形式的某个具体的单元。
它们之间的关系，与窗体和控件的关系非常类似。
报表、数据集、数据源三者间的关系：数据源 --- 数据集 --- 报表。
报表参数：查询参数的表现形式，使用它可以构建更灵活的报表。
模板和库：主要用于复用报表设计，提高报表开发的效率。
1.3Birt报表设计器的安装与配置BIRT 的下载地址是：/birt/downloads/ 有两种下载方式：1) All-in-One 版本（birt-report-designer-all-in-one-2.2.2.zip），它包含了运行BIRT系统所需的组件，可直接应用。
2) Framework 插件版本（birt-report-framework-2.2.2.zip），安装的必要环境为Java1.4.2/1.5 JDK/JRE; Eclipse SDK 3.2, GEF 3.2 and EMF 3.2。
安装步骤如下：打开eclipse 文件夹，在文件夹中再新建一文件夹（如：birt）,然后打开birt-report-framework-2.2.2.zip 把其中的eclipse 文件夹放入新建的birt文件夹中。
BIRT_中文指南
BIRT 中文指南BIRT -简介BIRT是一个Eclipse-based开放源代码报表系统。
它主要是用在基于Java与J2EE的Web应用程序上。
BIRT主要由两部分组成：一个是基于Eclipse的报表设计和一个可以加到你应用服务的运行期组件。
BIRT同时也提供一个图形报表制作引擎。
URL: /birt/URL: BIRT报表中文指南BIRT.rar前言这个指南将引导你设计一个简单的报表，令你对BIRT报表系统有个感性的认识，如果想进一步了解BIRT的使用可以参考BIRT在Eclipse中自带的帮助，Select Help→Help Contents from the Eclipse menu and then click on the BIRT Developer Guide.个人体验•操作界面友好大方，各种提示信息直观清晰，界面，图标都很漂亮：），尤其是对报表的开发布局划分的很科学，一般的报表工具只有设计和预览两个界面，BIRT有正常，主页，XML源，布局，预览，脚本多个设计布局；•功能并不逊色与商业报表工具；•CSS提供了强大的样式定义，对于属性CSS的设计人员来说，应该可以设计出相当出色的报表样式；•灵活的条件格式定义(formatting rule)，可以方便的根据业务逻辑来动态格式话报表元素；•集成在Eclipse中，不用再开启别的报表开发工具窗口；•BIRE的本地化做的很好，安装以后操作界面就是中文的；•开源的报表产品，降低开发成本，一些报表开发工具除了价格昂贵以外，还有用户限制；•不足之处，毕竟是国外的报表工具，与中国的报表在理念上还是有很多不同，国外更注重报表设计时数据和样式的分离设计，以获得清晰真实的统计数据，国内的报表可能主要是作为个人业绩的的一种炫耀吧，更注重报表的样子而不是样式。
所以早期的Html设计都喜欢采用table来作为元素定位的工具，而table的初衷可能只是作为数据显示的容器吧。
06-Birt工具关于使用外部数据源的配置手册
关于使用外部数据源的报表的配置问题--2010-8-27根据前期报表的设计讨论，使用外部数据源的情景如下：用户配置了一个报表，主SQL已经确定，即需要查询的数据集已经确定，但是参数的数据来源在后期需要重新变化，如ad-hoc生成的临时表。
为了不用再去重新设计一张报表，特别设计了该功能。
由于时间仓促，有些地方没有考虑全面，需要在脚本中进行一些调整，还请见谅。
外部数据源报表的配置如下：1、配置一张报表，数据集主SQL如下：图1当然，也可以添加一些其他条件。
2、设计报表参数图2对于报表参数，暂时只对字符串类型的参数进行了处理，所以，请使用字符串数据类型。
3、数据库配置图3数据库配置时，请注意图3画红色框框的地方。
表：t_birt_table_sql字段：QRY_ID 报表名称字段：QRY_FILED_NAME 即图2中参数名称字段：QRY_SQL 参数的数据来源，如果只提供一个字段，数据显示的名称和数据值将显示一样。
字段：STAFF_ID 员工编号，即用户登录系统后，系统使用的员工编号4、修改脚本在数据集的beforeOpen脚本中添加如下脚本代码//获取参数信息var userIds=params["user_id"].value;var querySQL=this.queryTextvar whereClause=" 1=1 ";//判断参数是否为空或者没有数据输入if(userIds!=null&&userIds!=''){//拼SQLwhereClause += " and user_id in ('";//如果是外部数据源数据，一般会获得一个如下格式的字符串//[a,b,c]或[a]或[]//将其按照逗号拆分var userIdArray=userIds.split(",");//如果拆分的结果为空或者没有数据，跳出if(null != userIdArray && userIdArray.length > 0){//将拆分的结果拼接起来，这里利用了js的一些自带函数//拆分结果格式 "[a","b","c]"//预期拼接结果"[a','b','c]"var str = userIdArray.join("','");//去掉数组转换时的中括号//如果首尾为一对中括号，一般是外部数据源if("["== str.substring(0,1) && "]"== str.substr(str.length-1)){//掐头去尾str = str.substring(q,str.length-1);}//补充完SQLwhereClause += str + "')"; }else{whereClause += "')"}}//拼接SQLif(whereClause!=null&&whereClause!=''){this.queryText += " where "+ whereClause; }5、测试...。
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/ 下载。
01-Birt工具数据报表开发手册
Birt数据报表开发手册1. 创建模板双击BIRT应用程序以启动Birt报表设计环境，首次启动未加载任何报表开发资源。
主界面如下：根据报表设计的需要，Birt本身提供了一些常规的模板：当然，也可以根据实际需要，添加一些使用频率比较高的模板。
下面将以两张图形，一张列表，且图形在上横向排列的模板为例，创建新模板。
点击文件菜单中的新建,选择新建模板，根据实际情况修改模板名称和存储路径：为此模板添加一些附加属性，如该模板的描述信息和模板布局的预览图像等。
点击完成，开始编辑此模板的布局。
在组件按钮区域依次选取：一个标签，用于放置报表的标题，双击输入标题文本。
也可根据需要动态的文本。
一个网格：用于放置水平的两张图形，因此网格设置为2列1行。
可根据实际情况调整。
一张表：用于放置数据报表，明细数据列设置为8列1行。
可根据实际情况调整。
关于组件的使用，将在后面的章节中具体说明。
用鼠标右击网格中的其中一个空白处，依次选择插入，图表。
在弹出的对话框中选取需要的图形。
同样的方法处理另外网格的另外一个。
有关图形的制作，将在图形报表开发手册中详细说明。
设置每种组件的属性，在OutLine窗口中选中已经拖放的组件，根据需要对其相应的属性进行调整。
如字体大小，颜色，对齐方式，样式等设置完成后，模板样式如下：保存模板的配置信息，以便在以后的报表开发中可以直接读取该模板。
2. 新建共享资源库在Birt的资源管理器中添加一些共享资源，如共享库：在弹出的对话框中输入Library库文件的保存路径和名称:确定后，Library库的创建完成。
如果操作无误，可以在对应的目录下浏览到新建的库。
3. 新建数据源在共享库中新建一个制作报表需要的数据库连接，以Oracle9i数据库连接为例，需要先配置数据驱动(数据库的驱动程序配置方法已经在报表设计器的配置手册文档中体现)。
然后在新建的库中，用鼠标右击数据源，选择新建数据源：在弹出的对话框中选择对应数据源类型，并为该数据源命名：选择正确的数据库驱动和URL后，就可以进行数据库的连接测试：可以根据报表需要，创建一个或者多个数据源的配置：数据源创建完成后，可以通过选择选择资源管理器中共享资源，Library库下新建的数据源，右击鼠标选择添加到报表，将新建数据源添加值报表中供使用。
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进行预览，数据可以进行分页显示了。
03-Birt工具设计器配置手册
Birt报表设计器配置手册Birt是安讯公司开发的一个优秀的报表插件, 是一个Eclipse-based开放源代码的报表系统，它主要是用在基于Java和J2ee的web应用程序上。
使用Birt报表工具拥有和Dreamweaver相似的操作界面，可以通过简单的拖拽和属性设置来制作各种式样和类型的报表；且很方便的在一个报表中混合展现概要数据和详细数据；同时提供了灵活的CSS样式支持，可以设计出相当漂亮美观的报表；生成的报表完全是XML格式，扩展性好；也可以生成多种类型图片、导出Excel、html、PDF、PPT、XLS 等多种类型文档；提供了本地化的语言包，更新后操作界面为中文。
1. Birt设计工具获取与安装Birt的官方下载地址是：/birt/downloads/，目前的最新版本为2.5.2。
官方提供了两种下载方式：1)All-in-One 版本，它包含了运行Birt系统所需的组件，可直接应用。
2)Framework插件版本，安装的必要环境为Java 1.4.2/1.5 JDK/JRE; Eclipse SDK 3.2,GEF 3.2 and EMF 3.2。
安装步骤如下：打开Eclipse文件夹，在文件夹中再新建一文件夹（如：Birt）,然后打开birt-report-framework-2.5.2.zip把其中的eclipse文件夹放入新建的Birt文件夹中。
然后在同文件夹的links文件夹中，新建一个.link文件（如：birt.link），且修改.link文件路径（如：path=D:\Eclipse\Birt）;或者把Framework包解压，然后和其它plugin一样放到Eclipse的plugins和features目录下即可，完成后目录结构如下：注意：Birt的运行依赖于GEF和EMF，所以你的Eclipse平台要正确安装GEF和EMF。
2. 插件的获取与安装如果需要输出PDF格式显示报表结果，需要下载itext.jar支持包和prototype.js：itext-1.3.jar: /itext/itext-1.5.4.jarprototype.js: /repos/prototype/dist/prototype.js下载完成后将itext-1.3.jar拷贝到plugins\com.lowagie.itext_version\lib\目录下;将prototype.js拷贝到如下目录：plugins\org.eclipse.birt.report.viewer_version\birt\webcontent\birt\ajax\lib\如果输出PDF要显示亚洲语言，需要下载iTextAsian.jar支持包：/itext/itextasian-1.5.2.jar下载完成后将itext-1.3.jar拷贝到plugins\com.lowagie.itext_version\lib\目录下。
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一步步开发教程
ContentsBirt一步步开发教程................................... 错误!未定义书签。
1 安装部署Birt ....................................... 错误!未定义书签。
下载安装birt .................................. 错误!未定义书签。
安装网页运行时软件包 .......................... 错误!未定义书签。
2 报表的开发制作 .................................. 错误!未定义书签。
新建一张报表 .................................. 错误!未定义书签。
连接数据源......................................... 错误!未定义书签。
图表的制作......................................... 错误!未定义书签。
新建数据集...................................... 错误!未定义书签。
创建表.......................................... 错误!未定义书签。
3 报表的发布.......................................... 错误!未定义书签。
使用tomcat发布报表................................ 错误!未定义书签。
4 其他功能的应用...................................... 错误!未定义书签。
目录的创建......................................... 错误!未定义书签。
报表参数的创建..................................... 错误!未定义书签。
birt初级教程
Birt使用说明目录1.下载相关的软件2.如何创建新的报表及报表模板●创建报表●发布模板3.设置报表的属性A、设置报表的样式表●设置数据信息●设置数据源。
●设置数据集●设置输出的列●设置计算列●设置数据集的参数B、设置报表的布局●几种控件的介绍C、设置报表的样式表●倒入样式表单●设置的控件样式4.报表的相关处理A、报表参数●新加参数●参数邦定B、数据排序分组过滤高亮显示●排序●分组●过滤●格式化指定的列显示C、预览打印报表●在开发环境下点击preview即可。
●在tomcat的环境下●集成的自己的运用程序中5. 相关的网站及帮助的使用一、下载相关的软件下载地址：选择下面的连接开发环境/birt/downloads/build.php?build=R-R1-2_1_0-200606281351 Availability Platform DownloadWindows birt-report-designer-all-in-one-2_1_0.zip(md5)下面的连接运行环境Availability Platform DownloadAll birt-runtime-2_1_0.zip(md5)一、在项目中如下图新建一个报表创建报表在下面图中输入报表名称，点击下一步选择报表的类型，最后创建一个新报表。
这里面有不birt系统自带的几种类型也有自己做的模板其中testTemplate是我做的一个简单模板，这里选择特testTemplate模板，将带一些基本的属性给新的报表如下图：包括数据源,数据集,页面的样式css,分页机制等.如果选择其他的样式类型这些属性将需要自己设置。
发布模板将做好的报表可以以模板的形式发布在以后的开发中使用建好的模板。
在outline页面右击做好的报表选择publish to template 如下图进入模板发布页面进行发布二、设置报表的属性。
创建一个空白报表1、设置数据信息●设置数据源。
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报表开发
图1-1 BIRT设计器图1-2 BIRT运行时环境说明图1-3 BIRT报表引擎图1-4 BIRT运行时环境BIRT 设计器和设计引擎可以设计以下的报表：列表－列表是最简单的报表。
当列表变长时，你可以把相关数据增加到同一分组（基于客户的订单分组，基于供应商的产品分组），如果数据是数字类型的，你可以轻松的添加到“总数”、“平均”、或其他汇总中。
列表的产生和显示都可以定制，进行过滤，突出显示，排序，分组同样可以过滤，突出显示和排序。
图表－图表能够帮助数字型的表格形象化的理解。
BIRT 提供饼状、线状以及柱状图标等。
交叉表－交叉表（也叫做十字表格或矩阵）用两种维度展示数据：sales per quarter or hits per web page。
信函和文档－通知、信件、以及其他文本文档都很容易通过BIRT 方便建立。
文档包括正文、格式、列表、图表等。
混合报表－很多报表需要联合以上所有的报表构成单一文档。
例如，一份客户声明会列出客户所需要的信息，为当前促销(promotions)提供文本，以及提供并行的出帐和入帐列表。
一份财务报表将包括声明、图表、表格，所有这些都可以进行全方位的格式化，来匹配共有的配色方案。
Birt有以下几点优点：1、开发方便，BIRT是Eclipse的一个插件可以很好的集成在Eclipse中，图形编辑框架下可以在几分钟之内做出一个报表，操作界面友好大方，MyEclipse近期的版本（8.0以上）本身包含BIRT特性。
2、可以很方便地在一个报表中混合展现概要数据和详细数据。
3、提供了强大灵活的样式定义，对于熟悉CSS的设计人员来说，应该可以设计出相当出色的报表样式。
4、Birt提供很好的国际化支持，支持中文本地化。
图1-5 birt-report-designer-all-in-one下载官网安装方式二：单独下载birt-report-designer所需要的eclipse平台和插件。
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_开发_手册_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详细开发手册目录1BIRT开发环境 (3)1.1新建Project (3)1.2新建Report (4)1.3调整工作窗口 (5)2BIRT报表开发 (6)2.1新建数据源(Data Sources) (6)2.2新建数据集(Data Set) (7)2.3BIRT报表条件 (10)2.3.1一般条件 (10)2.3.2日期条件 (11)2.3.3条件脚本 (11)2.4BIRT表格 (13)2.4.1Insert table (13)2.4.2设置报表表头 (14)2.4.3表头样式 (14)2.4.4表格网络线 (15)2.5绑定数据集 (15)2.6表格数据添加分组(分组可以不用设根据需求添加) (16)2.7报表标题(Master Page) (19)2.8固定布局与自由布局 (20)2.9报表预览 (21)2.10数据操作 (23)2.10.1列求和 (23)2.10.2数据格式 (26)3图表制作 (26)3.1饼状图 (26)3.2折线图 (32)3.3柱状图 (38)3.4图表效果展示 (42)此文档为本人结合网上资料与本人BIRT开发经验整理的BIRT详细的开发手册，适用于初学者快速掌握BIRT开发。
1BIRT开发环境BIRT开发环境是带有BIRT插件的eclipse1.1新建Project菜单栏file→new→other选择report project→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窗口调出这两个窗口方便报表开发。
拖动显示的窗口，调整如下的布局，方便报表开发2BIRT报表开发2.1新建数据源(Data Sources)在Data Explorer中的 Data Sources 右键New Data Source数据源类型选择 JDBC Data Source, Data Source Name为数据源名称Next之后如图3-1Driver Class在下拉框中选择数据库驱动com.ibm.db2.jcc.DB2Driver(v3.50)Driver URL 配置数据库连接地址User Name 与 Password 数据库连接的用户名密码,设置完成后点击Test connection 测试连接显示connect successful则数据源配置完成图3-1在Driver Class中找不到对应数据库驱动则可以手动添加驱动点击Manage Drivers可以添加其他数据库驱动如oracle，点击add添加oracle数据驱动包即可2.2新建数据集(Data Set)在Data Explorer中的Data Set右键New Data Set设置好Data Set Name后Netx报表sql,如果报表需要添加条件则在sql后加入 where 1=1,在条件处理是script脚本要用到。
Sql完成后在完成data set前预览sql(Preview Results),数据查看sql是否有问题,然后OK,Data Set 设置完成.2.3BIRT报表条件在Data Explorer中的Report Parameters new Parameter2.3.1一般条件Name:条件名字(英文字母)，Prompt text:条件提示名字Is Required:条件是否必填，Hidden:隐藏条件，Default vale:默认值2.3.2日期条件日期条件设置时在Prompt text中对日期条件进行设置^^^^yyyyMMdd日期格式为8位字符串型(如:20151012),^^^^yyyy-MM-dd为10位字符串型(如:2015-10-12)2.3.3条件脚本点击Data Set下的数据集,然后选中Script页面Script选中beforeOpen在此区域中编写脚本if( params["DEPT_NAME"] && !params["DEPT_NAME"].value.equals("")){this.queryText = this.queryText+" and DEPT_NAME='"+params["DEPT_NAME"].value+"'"; }if ( params["DATA_DT"] && !params["DATA_DT"].value.equals("")){this.queryText = this.queryText.replace("1=1","1=1AND DATA_DT='"+params["DATA_DT"].value+"'");}两种脚本的不同:第一种为在where 1=1后没有其他sql语句的可直接在1=1后拼接and DEPT_NAME=‘值’SELECT DEPT_NO,DEOT_NAME,SIGN_ACCT_CNT,SIGN_CUST_CNT,DATA_DT FROMS120_BSD_GDM.FACT_INDIV_TA_SIGN_NUM WHERE1=1 AND DEPT_NAME=‘值’第二种在where 1=1 后有其他sql时就要用第二种脚本将1=1进行替换1=1 ANDDATA_DT=‘值’(可以多次对1=1替换)SELECT DEPT_NO,DEOT_NAME,SIGN_ACCT_CNT,SIGN_CUST_CNT,DATA_DT FROMS120_BSD_GDM.FACT_INDIV_TA_SIGN_NUM WHERE1=1 AND DATA_DT=‘值’ORDER BY DATA_DT2.4BIRT表格2.4.1Insert table插入table在Layout空白处右键Insert TableInsert Table 设置table的列(Number of columans),Number of details一般不用设置,然后OK,在Layout中即可显示插入的table.Table中Header Row为表头,Detail Row为对应表头的数据集,Footer Row未用到2.4.2设置报表表头在table第一行个表格中点击后右键Insert Label插入文本框输入表头报表表头设置也可以才3.2添加数据集sql时将sql字段取一个中文别名，如下形式select er_code as 登录名,er_name as 用户名,er_no as 用户编号,er_type as用户类别,er_email as ,er_tel as手机号,er_role as角色,a.job_name as在岗,a.status as状态from portal.portal_sys_user a按这种方式写sql在配置表格数据时直接拖拽置Detail Row2.4.3表头样式选中表头在Property Editor中General设置表头的样式,包含backgroundcolor,font,size,color等2.4.4表格网络线点击table的左上角区域选中整个table然后在Property Editor中的Border中设置网格线(点击table的左上角区设置网格线为整个表格都设置,选中Table设置网格线则只设置外边框)。
2.5绑定数据集在Data Set中的数据集将对应表头的字段直接拖拽到Detail Row的对应位置2.6表格数据添加分组(分组可以不用设根据需求添加) 选中要分组的 Detail Row 然后右键 insert Group删除多余行删除完多余行后合并分组2.7报表标题(Master Page)Master Page为报表的标题,Border中网格线的方法与table中类似可参考table中网格线的设置,General中设置报表标题颜色、大小、布局方式等2.8固定布局与自由布局在Layout的General中的Layout Preference中有两种布局方式:Auto Layout为自由布局选中自由布局报表会根据窗口大小自动调整,Fixed Layout为固定布局,布局固定不会根据窗口大小变动一般将报表设置为自由布局的格式当报表所需列较多时一般将报表都设置成自由布局，在设置自由布局时要指定列宽否则列宽会自由调整，报表数据会出现挤在一起的情况。
选中表格的列然后在Property Editor下的General中设置Width注：在列较多时在设置列宽时预览不明显或者没变化时，可以将报表布局设置为固定布局，一列一列调整列宽，调整完毕后将布局调整为自由布局，调整后将表格稍微拉宽一点即可。
有时由于列较多，在调为固定布局后设置列宽到后边的列会挤在一起，无法调整，可以暂时将布局调整为自由布局，进行设置列宽。
调整后仍需将表格稍微拉宽一点。
将鼠标放置表格边缘区域即可进行拖动(一般情况下不进行拖动只有在调整布局设置列宽后进行拖动)2.9报表预览点击View Report in web Viewer预览完成的报表报表预览时有时会出现空白页面不出现结果，产生原因一般是电脑自身环境原因，暂无解决办法，View Report in web Viewer不能预览时可以用其他的预览方式，如 View Report as HTML，或者换一个开发环境试试。
点击运行报表可以输入报表条件2.10数据操作2.10.1列求和选中第一行即表头然后右键Insert→Row→Below 即可在表头的下边重新插入一行Header Row(如果选中的二行进行插入怎会生成一行Detail Row)在刚插入的Header Row中进行求和计算，选中相应的表格右键Insert→Aggregation在Aggregation Builder中进行编辑，Display Name 为创建Aggregation Builder的名字，data Type为数据类型可根据需求在下拉框中选择，Function 为函数选择需要的求和函数，Expression为求和的列注：Function中有多种函数可根据报表需求进行选择是求和还是做其他操作Expression:点击2.10.2数据格式在有金额列时保留小数点操作选中要控制小数的数据集在Property Editor Format Number中进行设置Format at中选择所要的数据格式：Unformatted 无格式 General Number 常规 Currency 货币Fixed 固定 Scientific 科学计数Decimal places 保留小数的位数在货币格式下Currency 中有 symbol 可以根据需要选择币种符号3图表制作注：BIRT图形加日期条件时注意日期格式，饼状图只支持date类型的日期格式不支持8位字符串，所以才配置数据集的时候要修改日期格式。