01-Birt工具数据报表开发手册.doc

Birt数据报表开发手册1. 创建模板双击BIRT应用程序以启动Birt报表设计环境，首次启动未加载任何报表开发资源。主界面如下：根据报表设计的需要，Birt本身提供了一些常规的模板：当然，也可以根据实际需要，添加一些使用频率比较高的模板。下面将以两张图形，一张列表，且图形在上横向排列的模板为例，创建新模板。点击文件菜单中的新建,选择新建模板，根据实际情况修改模板名称和存储路径：为此模板添加一些附加属性，如该模板的描述信息和模板布局的预览图像等。点击完成，开始编辑此模板的布局。在组件按钮区域依次选取：一个标签，用于放置报表的标题，双击输入标题文本。也可根据需要动态的文本。一个网格：用于放置水平的两张图形，因此网格设置为2列1行。可根据实际情况调整。一张表：用于放置数据报表，明细数据列设置为8列1行。可根据实际情况调整。关于组件的使用，将在后面的章节中具体说明。用鼠标右击网格中的其中一个空白处，依次选择插入，图表。在弹出的对话框中选取需要的图形。同样的方法处理另外网格的另外一个。有关图形的制作，将在图形报表开发手册中详细说明。设置每种组件的属性，在OutLine窗口中选中已经拖放的组件，根据需要对其相应的属性进行调整。如字体大小，颜色，对齐方式，样式等设置完成后，模板样式如下：保存模板的配置信息，以便在以后的报表开发中可以直接读取该模板。2. 新建共享资源库在Birt的资源管理器中添加一些共享资源，如共享库：在弹出的对话框中输入Library库文件的保存路径和名称:确定后，Library库的创建完成。如果操作无误，可以在对应的目录下浏览到新建的库。3. 新建数据源在共享库中新建一个制作报表需要的数据库连接，以Oracle9i数据库连接为例，需要先配置数据驱动(数据库的驱动程序配置方法已经在报表设计器的配置手册文档中体现)。然后在新建的库中，用鼠标右击数据源，选择新建数据源：在弹出的对话框中选择对应数据源类型，并为该数据源命名：选择正确的数据库驱动和URL后，就可以进行数据库的连接测试：可以根据报表需要，创建一个或者多个数据源的配置：数据源创建完成后，可以通过选择选择资源管理器中共享资源，Library库下新建的数据源，右击鼠标选择添加到报表，将新建数据源添加值报表中供使用。4. 新建数据集数据源定义完成后，就可以根据报表的具体需求添加数据集：a) sql查询数据集在OutLine中选择Library下的数据集，右击鼠标选中新建数据集：在弹出的对话框中，选择该数据集使用的数据源，以及数据集的类型，并为该数据集命名：在接下来的查询对话框中，通过选择数据库中的表和字段来组织查询sql，表和字段可以通过列表选取，也可以在筛选器中通过关键字(关键字母全部大写)来查询：也可以在右边的文本编辑框中直接输入自定义SQL：点击完成后，对该数据集的属性进行编辑,有下列属性可供编辑:输出列：主要是针对查询SQL中的Select 字段进行别名和显示名称的关键字进行编辑。计算列：可以通过添加新字段对现有的数据集进行计算，如Count,Sum,Max,Ave等。参数：这里是指数据集的参数，数据集的查询SQL中，可以通过?来绑定数据集参数，其参数顺序应与查询SQL中的?的顺序一致。数据集参数也可以集成报表的参数，如下图所示，将查询SQL的第一个参数与名称为Date的报表参数进行绑定。筛选器：只要是针对数据集的查询结果进行数据筛选，可以灵活的定义筛选的条件，并且不与查询SQL冲突。预览结果：可以对调整后的数据集进行结果的展现，方便确认数据集的正确性。这里需要注意的是：如果查询SQL中使用到了?类的数据集参数，而在数据集的参数栏未设置默认值，或者绑定报表参数，或者绑定的报表参数未传入值，预览结果将会提示错误信息。如果确认设置无误，可以忽略错误提示。b) 存储过程数据集Birt提供了存储过程查询的支持，其创建方法如下图所示，选择数据集类型为SQL存储过程查询，并为该数据集命名：点击Next后在弹出对话框中，通过选择或者编辑存储过程的执行方法，例如，应包括传递至存储过程的所有参数。要输入存储过程，请用花括号将 call 语句括起来。选择完成以保存数据集。编辑数据集将显示存储过程返回的列，并提供用于编辑数据集的选项。后续的数据集属性设置，与普通SQL查询的数据集设置方法一致。c) 联接数据集联接数据集的功能是将多个数据通过关联字段进行连接，输出新的联接数据集。在BI系统中，用于将分析表中的维度ID值转换为对应的维度值的描述信息。使用鼠标右击数据集，选择新建联接数据集：在接下来的对话框中，选择需要关联数据集，指定数据集之间的关联关系，连接类型：完成后可以看到，在数据集中新增了一个关联地市维表的数据集，该数据集包含了被关联的两个数据集的所有字段：值得注意的是：由于关联数据集每次只能指定两个数据集之间的关联关系，在BI系统中，如果需求有多个维度需要关联维表，就必须关联多次。d) 多维数据集多维数据集是为交叉表提供多维分析数据的数据集合，使用鼠标右击多维数据集，选择新建数据和多维数据集：在弹出的生成器窗口中，选择多维数据集依赖的主数据集，并命名新的多维数据集：在组和摘要选项中，选择需要展现的维度和指标。将维度字段拖放至组中，指标字段拖放至摘要栏。根据维度的分类和指标指标计算方式分别对组和摘要进行编辑：确定多维数据集设置并保存，在资源管理器的多维数据集类别中，可以浏览到该数据集：在制作交叉的多维报表时，就可以选取该多维数据集的数据。5. 新建报表当共享的模板和数据集创建完成后，就可以使用模板和数据集进行报表的制作。打开文件菜单的新建子菜单，选中新建报表：为报表命名并选择报表配置文件的存放路径：选择之前定义好的模板来制作报表：选择完成后，按照报表的需求进行内容的填充。数据报表部分可直接选取数据集中的字段拖放至对应的表格中：根据报表需求对内容进行编辑和调整,如第一行的显示字段名称，指标的计算等：报表内容填充完成后，可以在工具和Web中对报表进行预览。在工具中预览，点击报表编辑环境中的预览标签如果配置无误，在Birt中的预览结果会正常显示，如下图：选择运行菜单的查看报表子菜单，选择在Web中查看器中预览：Birt弹出新的Web页面展现报表：6. 建立数据绑定简单的报表制作完成后，可以根据报表需求修改编辑明细数据项的表达式，选中需要编辑的单元，鼠标右击选择”编辑值/表达式”,或者直接双击该单元格：在弹出的编辑数据绑定中修改表达式的基本属性，如显示名称，类型等：通过手工输入或者选择的方式，使用数据集，列，Java函数，Birt内部的函数的组合来生成数据表达式：7. 设计报表外观与属性报表展现内容确定后，就可以根据内容来调整美化报表格式。如下图：在左边的OutLine窗口选择需要调整元素，右边的布局标签下属性选项卡里编辑其属性。常规的属性可以根据报表需求调整元素名称，字体大小，字形，对齐方式，背景颜色，样式等：边框属性主要是设置元素所在列或行的单元格的样式，颜色，边框的粗细。对于显示内容的格式，则可根据不同的数据类型来调整数据格式，如数字型，字符型，日期时间型的数据，Birt本身提供了支持的格式，并可对格式进行预览。8. CSS样式使用选择想要对其应用样式的报告元素。如果想要创建样式但不对任何元素应用它，则单击报告页上的空白区域。选择“元素”-“新建样式”。将出现“新建样式”，如图所示。属性类别显示在左边,所选类别的属性显示在右边。要对特定类型的元素应用样式属性，请选择“预定义样式”并从下拉列表中选择一种样式。要创建用户命名的样式，请对“定制样式”指定唯一描述性名称。确保该名称不会与任何预定义样式名称相同。如果指定的名称与预定义样式名称相同，则定制样式优先，并且无法再使用该预定义样式来应用级联表。通过选择在左边选择属性类别并指定属性值来设置期望的样式属性设置完样式属性时，请选择“确定”以保存样式。在OutLine窗口选择“样式”-“导入 CSS 样式”在“导入 CSS 样式”上的“文件名”中，指定想要导入其样式的 CSS 文件的名称可选择“浏览”来查找文件。“导入 CSS 样式”将显示在 CSS 文件中定义的样式。如图显示 CSS 文件 Birt.css 中的样式的示例选择想要导入的样式。要导入所有样式，请选择“全部选中”。完成选择之后，请选择“完成”。BIRT 报告设计器会将这些样式复制到报告中。上图视图中的样式列表的示例。编辑报表元素属性时，则可以选择导入的新样式。9. 参数的定义与使用a) 普通参数配置在“数据资源管理器”中，右键单击“报表参数”并选择“新建参数”。将出现“新建参数”，如图所示：对于“名称”，输入参数的名称。如果不对“提示文本”指定值，则报告用户会将“名称”值看作提示。最好为“提示文本”中的参数提供一个友好名称。对于“类型”，请选择参数的数据类型。选择“确定”，参数将出现在“数据资源管理器”的“报表参数”中。在数据集中添加带有一个或多个参数的 WHERE 子句，如：在数据集的参数选项中，选择数据集参数并设置绑定到报表参数:配置正确后，之前配置数据集时预览报错的问题将不会出现。数据集参数会继承报表参数的值，按顺序替换数据集的SQL的?号。b) 动态参数使用动态参数的配置与使用与普通参数基本一致，不同的是在选择显示类型时，选择为组合框，其他配置方法与列表框一样：配置完成在参数页面，该参数将会出现一个下拉框和文本框的组合，用户可选择或输入参数值：c) 级联参数配置在“数据资源管理器”中，右键单击“报表参数”并选择“新建级联参数组”。将出现“新建级联参数组”，如图所示：根据需要选择数据集个数和级联参数个数，并编辑参数与数据集之间的关系：在数据集的参数选项中，可选择设置绑定到级联参数组：10. 变量定义与使用Birt提供了两种变量的使用：报表变量和页面变量。报表变量在一张报表完成时解析，而页面变量在单页被写入时解析。他们都可以被置于Master页。在“数据资源管理器”中，右键单击“变量”并选择“新变量”。将出现“新变量”，如图所示：页面级事件(OnPageStart和OnPageEnd)可以作用于报表或主页。 在某一页的全部报表元素实例被创建，作用于报表上的OnPageStart事件将被触发，紧接着是作用于master页上的OnPageStart事件。之后是展现在页面上的每一个报表元素实例的OnPageBreak事件。 最後是作用于主页和报表上的OnPageEnd事件。至此，单个页面创建完毕。 这个过程将在报表的每个子页面中重复。Birt为页面变量提供了2个方法getPageVariable和setPageVariable可以在事件的脚本中通过方法来获取和使用变量。11. 表达式使用通过使用直接来自数据源的数据并简单地将数据源字段从“数据资源管理器”拖到报表中，可以创建报表。但有时要显示不在数据源中的数据，或者要以不同于数据源中显示数据的方式来显示数据。还可能想要使用公式对数据进行排序，而不是根据现有字段排序。在这些情况及许多其他情况下，应使用 JavaScript 来编写表达式。表达式是一个将生成值的语句。表达式可以是文字值，也可以是数据字段或计算结果。将字段拖到报表中时，BIRT 报告设计器将创建表达式。该表达式指定报表显示其值的字段的名称。例如，上图表达式获取BUS_REVENUE_FACT的值：表达式可以包含文字值、字段、运算符、变量和函数的任意组合，条件是求得的结果为单个值。在下列示例中，第一个表达式将静态文本与字段组合在一起，第二个表达式使用 JavaScript 函数，而第三个表达式将两个字段的值相乘：在表达式构建器的“类别”中选择“BIRT 函数”。“子类别”将显示 BIRT 定义的函数类。选择“总计”以显示聚集函数。双击想要使用的聚集函数。该函数将出现在表达式构建器的表达式区域中。在函数的圆括号 ( ) 中指定想要聚集其值的数据集字段（或引用数据集字段的列绑定）：在“类别”中，选择“可用的数据集”或“可用的列绑定”。在“子类别”中，选择包含该字段的数据集或包含列绑定的元素。双击数据集字段或列绑定以在聚集函数的圆括号中插入它。选择“确定”以保存表达式。12. 脚本编辑在使用Birt制作报表时，可以使用 Java 或 JavaScript 编写定制事件处理程序。在布局页面中，选择要为其编写事件处理程序的报告元素、数据源或数据集。选择“脚本”选项卡,从方法下拉列表中选择事件处理程序。在脚本编辑器中输入事件处理程序代码。以下代码是对onPageStart事件输入的代码过程，表示页面开始前先执行此代码：也可以选中报表元素，在属性编辑器中选择高级，在对应的事件属性中输入脚本：13. 复杂报表的开发除了最基本的列表式报表，Birt还支持多种类型的报表格式.接下来介绍一些我们常用报表的制作方法。a) 分组报表先开发好基础的列表类报表，以下图为例：以下是列表的展示结果：在报表正文的表元素中，选择分组,鼠标右击选择插入分组：编辑分组的依据，分组名称等，设置其他附加属性：对分组的页眉页脚信息进行表达式的编辑，设置样式，和单元格的合并等：预览结果如下：展现结果以设置的COUNTRY字段进行分组，分组的页脚信息按单元格的表达式配置信息，显示该COUNTRY的客户数。b) 交叉报表交叉和报表的制作依赖于多维数据集，也就是说制作报表之前必须先定义展现数据的多维数据集。多维数据集的定义方法在前面部分已经说明。首先新建一张报表，并设置报表的布局：使用文本组件用于设置报表标题使用交叉表展现多维数据集的数据设置完成后，将多维数据集中的维度和指标拖入对应的交叉表元素中，并设置其样式：设置交叉表的小计与总计：设置小计和总计的聚合条件和显示方式，及要计算的指标:设置应用式样小计和总计部分的样式：交叉表的预览结果：c) 子报表主从报表的制作需要使用到两个数据集，且子报表需继承主报表的结果的值作为筛选条件，这样就需要定义两个或以上的数据集，如下图为按正常的数据集定义方法定义的主报表的数据集定义：下面是子报表的数据集，需要集成主报表的Prd_Id和Area_Name两个参数:子报表中先定义两个数据集参数，暂不关联主报表的字段：先按正常的列表报表制作主报表，设置布局，样式，属性等：在主报表的明细数据最后一列插入一个表，将子表的数据集中的需要展示的字段放置在新建的表中：在子报表的属性编辑窗口，选择绑定，选择数据集为子报表：设置子报表对应的参数与主报表中的对应关系：设置完成后，调整布局，应用样式和其他附加属性：下图即为以上设置的主从报表的最终显示结果：d) 链接式报表链接式报表是根据第一个报表中的展现结果中的值，链接到另一张报表，以显示主报表中某项数据的具体内容，因此需要有两张报表，两个数据集，以上一章的两个数据集为例，先定义好两张报表：设置好两张报表的布局，样式及附加属性：选择第一张报表的需要链接显示的明细数据列，如DATA,选择属性编辑中的超级链接选项，指定该字段的链接属性：按需求设置链接属性，指定链接报表的参数与主报表的数据对应关系：设置完成后，主报表预览结果如下：链接页面的预览结果如下：e) 平行报表平行报表需要使用到两个不同的数据集，这两个数据源的需要使用共同的参数，将展示结果平行放置，为保证数据集展示结果的平行，需要使用到网格，布局如下图所示：在正文中放置一个2行的网格，上一格用于放置报表标题，下一个则放置平行数据，在下一个中放置一个2列的网格，两个子网格中分别放置平行的表以放置数据集修改布局，应用样式，设置属性等常规设置:在工具中预览结果如下,所设置展现的两个数据集的数据平行展示在报表中：f) 告警报表(高亮显示设置)要制作告警类型的报表，需要用到Birt工具的突出显示功能。该工具可能编辑根据不同的条件突出显示报表中的某部分数据，先以隔行高亮显示为例,按普通的列表方式制作一张报表，在列表的第一列插入一列，在页眉行为此列取名为”行数”，明细数据行中编辑其表达式为” row0+1”：预览刚才行数的设置结果，报表的第一列将记录的行数显示：选中明细数据行,在属性编辑器中选择突出显示选项卡：添加一个突出显示条件：在工具中的预览结果如下, 记录行数为单数的都以设置的显示方式来显示：也可以根据实际的告警需要来设置突出显示条件，如实际收入在5000到10000的黄色底显示预警，小于50000的红底显示告警，设置方法如下,添加一个预警条件和颜色设置：再添加一个告警显示条件与颜色配置:预览结果如下：14. 组件的使用Birt报表工具提供了一些制作报表时用到的组件，有如下几种，下面说明一下各组件的功能与用法：标签：标签元素用于显示静态文本，标签元素的外观可以通过本地进行设置，如设置标签元素的超级连接、字体大小等属性；文本：文本元素与标签元素相似，只是文本元素可以显示多行数据，更加易于格式输出。可以在文本元素中使用脚本表达式，然后在客户端使用标签进行解析；动态文本：动态文本元素通常用于显示数据值。数据可以通过使用Birt的表达式得到数据；数据：数据元素用于显示数据源的数据，通过使用表达式来操作或改变数据值。例如，数据集有包含姓列以及名列，那么可以使用表达式来将姓列与名列进行合并，从而形成包含姓名的一列；图像：图片元素用于在报表模板中显示图片。Birt支持通过URL获得图片，或是从数据库的取得图片，或是从本地硬盘上获得图片；网格：网格元素用于布局报表中的报表元素，并进行统一的管理。例如，想在报表中显示产品销售数据表格，同时又想在右边显示一张图表，此时则需要使用Grid来进行网格划分，将报表分成一行两列；下图是一个3行3列的网格样式:列表：列表元素也相当于一个容器，它不同于其它容器的地方在于列表元素可以绑定到数据集上。列表元素包含头、脚及数据部分。当渲染列表元素时，头与脚部分一次性渲染完成，而中间的数据部分需要显示数据集的每一行数据。数据格式可以是文本元素，也可以是表格、列表等元素；下图是放置在报表中的列表样式：表：表格元素与列表元素相似，都可以用于显示数据集中的数据。表格元素与HTML中的表格元素风格相似；交叉表：交叉报表元素用于显示BIRT数据立方体中的数据。在BIRT以前的版本中，表格中列数据需要在设计时就确定，而使用交叉报表元素，则列数据与行数可以动态生成，无需在报表设计时确定；交叉表可放置横向和纵向两种维度，报表自动根据这两种维度进行交叉：图表：图表元素用于在报表中添加图表。当在报表中添加了图表元素时，Chart自动进行渲染并显示。Chart用于设计图形，并提供了三大设置区域，分别是：设置图表类型、设置数据、设置图表格式。BIRT提供了大量的图表类型，同时，图表格式可以是PNG、JPG、BMP、SVG等输出格式；下图是图标在报表中的默认样式，具体的图形制作方法，请参阅Birt图形报表开发手册聚合：聚合元素是新增的元素，使用聚合元素向报表添加汇总功能。聚合元素提供的汇总功能大概有25项，常见的如：SUM、MIN、MAX、AVERAGE等；15. 报表分页功能大数据量普通表格报表SQL分页，设计报表需要注意的几点如下：1、更改页面类型为自定义，并设置页面高度，高度宽度自定义，如下图：2、设置分页符间隔，如果每页记录数越大设置的值就要越大，一般设置6