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使用指南
山东电力集团公司门户项目组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 支持，也支持利用编码来获取其他地方的数据。
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、测试...。
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开发文档
Birt 开发文档目录一．前言 (2)二．开发环境安装 (3)三．报表分类 (3)1．清单表 (4)2．固定格子表 (4)3．交叉表 (4)4．Chart图表 (4)四．报表开发 (5)1．清单表 (6)2．固定格子表 (17)3．交叉表 (18)4．Chart图表 (22)五．报表的参数使用 (26)1．Combo box (26)2．Radio button (27)3．List (27)六．报表的级联参数的使用 (29)七．模板及自定义js (32)1．样式模板 (33)2．自定义js文件 (35)八．报表中script的使用 (38)1．在script中对sql的控制 (38)2．报表中script的控制42(1).隔行换色 (42)(2).鼠标高亮 (44)(3).birt所提供常用的script方法 (46)九．项目开发中整合birt (51)1．Struts2整合问题 (52)2．实现报表的数据权限的控制 (58)十．Birt的扩展 (61)1．Birt的页面样式 (62)(1).修改combobox页面 (63)(2).修改textbox页面 (70)(3).按钮样式的修改 (75)2．Birt国际化 (75)十一．Birt的使用小技巧 (77)1．报表的返回 (79)2．报表的参数默认值 (80)(1).日报返回系统前一天的8位日期 (80)(2).月报返回系统上个月末8位日期 (82)3．报表web.xml的配置 (84)4．报表参数的页面开发............................................................................................85(1).参数的传递方式 (85)(2).birt标签的使用 (87)①.view标签 (87)②.report标签 (89)③.param标签 (90)④.parameterPage标签 (90)⑤.paramDef标签 (92)一．前言BIRT (Business Intelligence and Reporting Tools), 是为Web 应用程序开发的基于Eclipse 的开源报表系统，特别之处在于它是以Java 和J2EE 为基础。
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一一商业智能和报表工具。
MAXIMO平台下birt报表开发环境配置详细步骤
MAXIMO平台下birt报表开发环境配置详细步骤Birt开发环境配置步骤一、环境必备的软件和安装程序：软件/安装程序 Maximo Eclipse Birt Jdk版本 7.5 3.4.2 2.3.2 1.6二、配置详细步骤：1. 在如下路径中新建一个classes文件夹：…\\\\eclipse\\plugins\\org.eclipse.birt.report.viewer_2.3.2.r232_20210212 \\birt\\WEB-INF2. 在如下路径找到已编译的报表脚本类\\com文件：…\\IBM\\SMP\\maximo\\reports\\birt\\scriptlibrary\\classes 3. 把整个\\com 文件夹拷贝到如下目录：…\\\\eclipse\\plugins\\org.eclipse.birt.report.viewer_2.3.2.r232_20210212 \\birt\\WEB-INF\\classes4. 找到mxreportdatasources.properties文件并拷贝到第三步的目录下。
5. 打开mxreportdatasources.properties文件并对它进行编辑1) 把#设置为maximodatasource2) 为当地环境设置url、drive、username、password和schema owner， 3) 示例如下：maximoDataSource.url=jdbc:oracle:thin:@localhost:1521:maximo maximoDataSource.driver=oracle.jdbc.driver.OracleDriverername=maximomaximoDataSource.password=maximo maximoDataSource.schemaowner=maximo6. 从…\\IBM\\SMP\\maximo\\applications\\maximo\\lib把oraclethin.jar拷贝到以下目录：…\\eclipse\\plugins\\org.eclipse.birt.report.viewer_2.3.2.r232_20210212\ \birt\\WEB-INF\\lib（注意：对于oracle数据库，使用oraclethin.jar；对于SQL server数据库，使用opta.jar；对于DB2数据库，使用db2jcc.jar或者db2jcc_license_cu.jar） 7. 然后解压oraclethin.jar文件并把解压得到的oracle文件夹置于…\\eclipse\\plugins\\org.eclipse.birt.report.viewer_2.3.2.r232_20210212\\ birt\\WEB-INF\\classes三、配置报表工程1. 启动eclipse，选择一个工作空间workspace，所有报表将存放在此。
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进行报表设计，可以通过脚本实现自定义的数据处理、表达式计算及样式控制等功能。
开源报表_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 出现脚本编辑器。
birt教程
Birt使用说明目录1.下载相关的软件12.如何创建新的报表及报表模板●创建报表●发布模板3.设置报表的属性1A、设置报表的样式表●设置数据信息●设置数据源。
●设置数据集●设置输出的列●设置计算列●设置数据集的参数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、设置数据信息●设置数据源。
- 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+" andDEPT_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设置表头的样式,包含background color,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位字符串，所以才配置数据集的时候要修改日期格式。