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

Birt数据报表开发手册 创建模板 双击BIRT应用程序以启动Birt报表设计环境，首次启动未加载任何报表开发资源。主界面如下： 根据报表设计的需要，Birt本身提供了一些常规的模板： 当然，也可以根据实际需要，添加一些使用频率比较高的模板。 下面将以两张图形，一张列表，且图形在上横向排列的模板为例，创建新模板。 点击文件菜单中的新建,选择新建模板，根据实际情况修改模板名称和存储路径： 为此模板添加一些附加属性，如该模板的描述信息和模板布局的预览图像等。 点击完成，开始编辑此模板的布局。在组件按钮区域依次选取： 一个标签，用于放置报表的标题，双击输入标题文本。也可根据需要动态的文本。 一个网格：用于放置水平的两张图形，因此网格设置为2列1行。可根据实际情况调整。 一张表：用于放置数据报表，明细数据列设置为8列1行。可根据实际情况调整。 关于组件的使用，将在后面的章节中具体说明。 用鼠标右击网格中的其中一个空白处，依次选择插入，图表。在弹出的对话框中选取需要的图形。同样的方法处理另外网格的另外一个。 有关图形的制作，将在图形报表开发手册中详细说明。 设置每种组件的属性，在OutLine窗口中选中已经拖放的组件，根据需要对其相应的属性进行调整。 如字体大小，颜色，对齐方式，样式等 设置完成后，模板样式如下： 保存模板的配置信息，以便在以后的报表开发中可以直接读取该模板。 新建共享资源库 在Birt的资源管理器中添加一些共享资源，如共享库： 在弹出的对话框中输入Library库文件的保存路径和名称: 确定后，Library库的创建完成。如果操作无误，可以在对应的目录下浏览到新建的库。 新建数据源 在共享库中新建一个制作报表需要的数据库连接，以Oracle9i数据库连接为例，需要先配置数据驱动(数据库的驱动程序配置方法已经在报表设计器的配置手册文档中体现)。然后在新建的库中，用鼠标右击数据源，选择新建数据源： 在弹出的对话框中选择对应数据源类型，并为该数据源命名： 选择正确的数据库驱动和URL后，就可以进行数据库的连接测试： 可以根据报表需要，创建一个或者多个数据源的配置： 数据源创建完成后，可以通过选择选择资源管理器中共享资源，Library库下新建的数据源，右击鼠标选择添加到报表，将新建数据源添加值报表中供使用。 新建数据集 数据源定义完成后，就可以根据报表的具体需求添加数据集： sql查询数据集 在OutLine中选择Library下的数据集，右击鼠标选中新建数据集： 在弹出的对话框中，选择该数据集使用的数据源，以及数据集的类型，并为该数据集命名： 在接下来的查询对话框中，通过选择数据库中的表和字段来组织查询sql，表和字段可以通过列表选取，也可以在筛选器中通过关键字(关键字母全部大写)来查询： 也可以在右边的文本编辑框中直接输入自定义SQL： 点击完成后，对该数据集的属性进行编辑,有下列属性可供编辑: 输出列：主要是针对查询SQL中的Select 字段进行别名和显示名称的关键字进行编辑。 计算列：可以通过添加新字段对现有的数据集进行计算，如Count,Sum,Max,Ave等。 参数：这里是指数据集的参数，数据集的查询SQL中，可以通过’?’来绑定数据集参数，其参数顺序应与查询SQL中的’?’的顺序一致。 数据集参数也可以集成报表的参数，如下图所示，将查询SQL的第一个参数与名称为Date的报表参数进行绑定。 筛选器：只要是针对数据集的查询结果进行数据筛选，可以灵活的定义筛选的条件，并且不与查询SQL冲突。 预览结果：可以对调整后的数据集进行结果的展现，方便确认数据集的正确性。 这里需要注意的是：如果查询SQL中使用到了’?’类的数据集参数，而在数据集的参数栏未设置默认值，或者绑定报表参数，或者绑定的报表参数未传入值，预览结果将会提示错误信息。如果确认设置无误，可以忽略错误提示。 存储过程数据集 Birt提供了存储过程查询的支持，其创建方法如下图所示，选择数据集类型为SQL存储过程查询，并为该数据集命名： 点击Next后在弹出对话框中，通过选择或者编辑存储过程的执行方法，例如，应包括传递至存储过程的所有参数。要输入存储过程，请用花括号将 call 语句括起来。 选择完成以保存数据集。编辑数据集将显示存储过程返回的列，并提供用于编辑数据集的选项。后续的数据集属性设置，与普通SQL查询的数据集设置方法一致。 联接数据集 联接数据集的功能是将多个数据通过关联字段进行连接，输出新的联接数据集。在BI系统中，用于将分析表中的维度ID值转换为对应的维度值的描述信息。 使用鼠标右击数据集，选择新建联接数据集： 在接下来的对话框中，选择需要关联数据集，指定数据集之间的关联关系，连接类型： 完成后可以看到，在数据集中新增了一个关联地市维表的数据