myeclipse报表开发教程基础篇

1、Myeclipse 报表开发教程基础篇1、 介绍在我们的日常生活或商业领域中，经常会用到报表。数据以很好的方式（比如以商业报表的形式）组织起来，会极大的改善关键的决策制定。报表开发工作流程和 Myeclipse 报表开发工具可以帮助我们开发各种 Web 报表。本教程将根据基本的流程在 Myeclipse 中开发、部署和测试一个简单的客户的 Web 报表。图 1-1 是整个客户报表的一个截图，可以用 Examples On-Demand 浏览器按照按照本教程开发的客户报表。图 1-1 本教程开发的客户报表在 Web 浏览器中的截图面向的读者本教程假设读者熟悉 Myeclipse Web 开发、部

2、署以及相关工具和 MyEclipse Database Explorer 特性。如果在练习时遇到问题或想获取更详细的信息，请参考 Resources 部分获得更多的资源。为了更好的体会 Myeclipse 请参考产品文档。系统需求本系统是用 Myeclipse6.0.1 专业版创建的。如果您使用的是更新的版本，本教程中的大部分图片和说明是向后兼容的。Myeclipse Reports 需要 Myeclipse6.0.1 或更高的版本。是专业级的特性并且只能注册获取。2、 报表开发流程开发流程是创建一个表所要做的工作的概要：（1） 创建一个 Report Web Project（2）（3）（4）

3、（5）（6）（7）创建一个 report创建一个 Myeclipse JDBC DataSource创建一个 DataSet规划、定制和风格化报表部署 Report Web Project浏览测试 Web Report每项都将在下面依此展开讨论。2.1 Myeclipse 报表向导Myeclipse 为每种报表提供有开发向导，开发向导一组指导你一步一步完成报表创建的说明。（1）要显示所要可用的向导，可以点击 helpcheat sheets，打开如图 2-1 所示向导选择对话框。图 2-1 向导选择对话框展开 Myeclipse Reports 目录，选择要用的向导点击 OK 按钮，这样就在工

4、作台的右边打开了向导视图，可以很方便的同时读或执行向导。（2）向导将会指引你完成每一步，当做完一步后，点击下面的图标，下一步会自动显示除了，？ 图标允许你打开一个该步的帮助页面。3、 创建 Report Web ProjectMyeclipse 报表引入了一种新的项目（工程）Report Web Project，这种项目（工程）是一种具有报表开发功能的 J2EE Web Project。创建一个 Report Web Project 有两种方法，一种是使用 Report Web Project 向导，如果不是在一个已有的 Web Project 上进行报表开发，请用这种方法。另一种是为一个已经

5、存在的 Myeclipse Web Project 添加报表开发功能（Report Capabilities）。接下来将分别介绍这两种方法。3.1 使用 Report Web Project 向导（1） 通过FileNewProjectReport Web Project 启（2） 输入项目（工程）名称：reportdemo导来创建一个Report Web Project。（3）点击 Next 进入下一步可以查看生成的报表目录结构和选择报表引擎的日志级别。（4）点击 Finish 来创建 reportdemo 项目。下图展示了 Myeclipse Report Web Project的结构。（

6、5）向导关闭后 Myeclipse 会询问是否打开 Myeclipse 报表设计Report Design perspective），选择 Yes。图（MyEclipse3.2 添加报表开发功能到一个 Web Project。可以通过 Report Capabilities 向导给任何 Myeclipse Web Project 添加报表开发功能。如下图所示。（1）在 project explorer 视图或 package explorer 视图中选中目标项目，单击右键，在上下文菜单中选择 MyeclipseAdd Report Capabilities，这样可以启动 Report Capa

7、bilities 向导。也可以通过菜单栏中的 MyeclipseProject Capabilities Add Report Capabilities启动 Report Capabilities 向导。（2）（3）完成向导，点击 Finish 更新项目。向导关闭后 Myeclipse 会询问是否打开 Myeclipse 报表设计图（MyEclipseReport Design perspective），选择 Yes。如果要手动打开该视图，可以通过 Windowopen perspectiveotherMyeclipse Report Desigen 打开。4、 创建一个报表（Report）（

8、1）选择项目 reportdemo，选择 FileNewReport 来打开新建 Report 向导。也可以点击工具栏中的新建报表（New Report）按钮来打开向导。（2）（3）输入报表名 new_report.rptdesign。扩展名必须是.rptdesign。保持复选框 Generate sample report access webpage 选中状态点 Next。（4）向导第二步给出了几个可选的模板，因为我们要创建的是一个简单报表，所以选择 Blank 模板，点 Next。向导的第三步允许创建一个样例 JSP 页面来演示如何由页面打开报表。例如，可以在页面中包含一个连接到报表的超

9、链接，也可以直接把网页和报表绑定到一起。注意：如果前面没有选中 Generate sample report access webpage，也可以在后面报表的上下文菜单中选择 Generate sample report access webpage 来生成。（5） 使用默认的文件夹结构和 JSP 文件名，如：new_report.jsp。（6） 选中生成一个绑定的报表阅读器单选按钮。（7） 点击 Finish，将会自动在报表设计器中打开报表。5、 创建 Myeclipse JDBC 数据源客户列表的数据存放在 Myeclipse Derby Server 中，我们可以使用任何可以在Myecl

10、ipse Database Explorer 中配置的数据库。如 Oracle、MS SQL SERVER 等。Myeclipse Derby Server 是为了测试方便而在 Myeclipse 6 Server Sandbox 中提供的一部分，其中已经预配置了一个 JDBC 驱动。（1） 启动 Myeclipse Derby Server。在服务视图中，选择 Myeclipse Derby Server 并且在右键上下文菜单中选择 Run 或点击服务视图工具栏中的 Run。本教程中采用的是 Myeclipse Derby 数据库，如果要使用其它数据库，请确保该数据库正在运行。（2） 启动数

11、据源向导。在 Data Explorer 视图中的右键上下文菜单中选择 DataSourcesNew Data Source 。 可 以 通 过 菜 单 栏 中 选 择 WindowShow ViewOtherMyeclipse Reports DesignData Explorer 打开 Data Explorer 视图。（3）（4）（5）在数据源类型列表中选择 Myeclipse JDBC Data Source。在输入数据源名称，如：Data Source。点击 Next。（6）选择已有的 Myeclipse Derby 驱动，点击 Finish。注意：也可以打开本布中的连接来创建或编辑

12、一个 Myeclipse JDBC 驱动。6、 创建数据集数据集是从数据源中返回的将要在报表中显示的数据的集合。本节将创建一个 SQL 数据源。（1）启动New Data Set 向导，可以通过选择 Data Explorer 视图的上下文菜单中的Data SetNew Data Set 启动。（2）（3）（4）选择前面创建的数据源。输入数据集名称：Customers。在 data set type 下拉列表中选择 Myeclipse Data Set，点 Next。在向导的第二步输入返回给数据集的 SQL 查询。当输入 SQL 查询时，查询编辑器支持内容辅助功能。也可以双击树形视图中表或列名

13、，该元素将自动插入当前编辑的查询的最后。（5） 输入如下 SQL 查询语句。Select CUSTOMERNAME, CONTATFIRSTNAME, CONTACTLASTNAME, PHONE fromCLASSICCARS.CUSTOMER（6） 点 Finish 开始执行 SQL 查询，并创建数据集。（7） 如果数据集创建成功，将会启动一个编辑数据集对话框，允许对数据集做进一步的定制。选择预览模型可以查看执行 SQL 查询返回的数据结果。7、 布局、定制、式样化报表7.1 布局报表创建了数据源和数据集，接下来要为报表添加控件。首先添加一个表格（table），然后将数据集中的列绑定到表格

14、中的列。表格有如下功能：表格遍历数据集的所有数据行。可以很方便的按行列格式布局数据。（1）打开面板视图（Palette View）来查看能添加到报表的控件。（2）从面板中拖放一个表格到报表设计器中，此时弹出一个插入表格对话框，输入列数和明细行数并将数据集与表格绑定起来。如图设置后点击 OK 开始创建表格。接下来要将数据集中的元素绑定到表格的列。在 Data Explorer 视图中展开 Customers 数据集，其中列出了查询中所指定的列。将 CASTOMERNAME 列从数据集拖放到如图表格明细行的第一个单元格中。表格的明细行定义了数据集中各列以及他们在表格数据行中的显示顺序。当 CAST

15、OMERNAME 列从数据集中拖到明细列后，报表设计器就会添加一个【CASTOMERNAME】的数据绑定元素。另外，在新的【CASTOMERNAME】数据元素上面的表头行中， 报表设计器会自动添加一列表头标签文本CASTOMERNAME。如图所示：（3） 将 PHONE 从数据集中托到明细行的第二行。依此将余下的列从数据集拖到明细行。报表的布局如下：（4） 要查看报表数据和表格布局是否正确， 可以选择报表设计器下面的预览（preview）页签进行浏览。也可以通过选择 FileView Report下面的其它格式进行预览。7.2 数据排序如上图所示预览结果可以看出，数据行是按照数据集查询返回的顺

16、序显示的。默认的顺序可能由很多因素所致，如数据在数据库中创建的顺序。在大多数情况下，用户希望能够改变数据在报表中的显示顺序。本节将介绍如何对报表数据排序。（1）（2）在报表设计器中选择布局（LayOut）页签，回到设计界面。如果需要的话，打开属性编辑器（Property Editor）视图。如果使用的是默认的报表设计图，属性编辑器位于报表设计器的下面，工作台的中下方。如果该视图没有打开，可以通过 WindowShow ViewProperty Editor 来打开。在布局编辑器中，将鼠标移动到表格上，在表格左下角会出现一个表格标签， 点击它可以选中表格。属性编辑器中会显示选中表格的属性如下图：

17、（3）（4）点击排序（Sorting）页签，点击 Add 来确定排序键。在弹出的 New Sort Key 对话框中，输入以下值。Key：选择要排序的表格列，Direction：设置排序方向， 升序或降序。设置如下图：（5）（6）点击 OK，新建的排序键会显示在排序页的列表中。重新预览报表，这一次报表中数据行的是按照 CUSTOMERNAME 列数据的升序排序显示的。（7）可以看到，姓名列中大写字母的排在最前面。Myeclipse报表中的字符串数据排序是按照 UCS2 编码值进行的。基于 ASCII 字符集编码的字符，大写字符的值比小些的小，因此大写字母排在小写字母签名。下面设置排序对大小写不

18、敏感，使 ANG Resellers 出现在 American Souvenirs Inc后面，而不是前面。在属性编辑器中选择排序页签，然后选择 CUSTOMERNAME 排序键，然后点击 Edit按钮，打开排序键编辑器。（8）（9）在排序键编辑器中，修改排序表达式如下，点击。rowCUSTOMERNAME.toUpperCase()这个表达式使用 JavaScript toUpperCase()函数将所有 CUSTOMERNAME 列数据在排序前转换成大写字母。JavaScript 函数名是大小写敏感的，输入时一定要注意。引用的列名也是大小写敏感的。当前表达式使用的是 rowCUSTOMER

19、NAME， 如果书写成 rowcustomername，返回报表时会报错。预览报表，确认是按照大小写不敏感的顺序显示的。（10）7.3 格式化报表（设置报表格式）数据可以按照预定的顺序显示以后，我们就可以将注意力集中在报表界面上。本节将完成以下任务： 编辑表头标签。 设置表头格式使表头与数据行区分开。 在同一行显示联系人的姓和名。 增加行间距。7.3.1 编辑表头标签（1）（2）返回到报表设计器的布局页面。在布局页面中可以直接对标签文本进行编辑。将光标定位到标签文本中，输入表头休息后按回车键保存表头休息。将 CUSTOMERNAME 列表头休息修改如下： Customer重复步骤 2，修改余下

20、列表头如下： PhoneContact修改后报表如下图：（3）7.3.2 设置表头标签格式可以通过如下两种方法设置控件的格式： 通过设置控件的属性。 定义一个式样，将式样应用到控件上。这种方法把希望的属性设置在一个式样中，然后可以应用到多个控件上。本节将采用第一种方法，在属性编辑器中将表头文本设置为粗体，用第二种方法为表头添加颜色。（1） 在属性编辑器中设置表头文本为粗体。首先选中所有表头列，可以通过按下 shift 键完成多个表头列的选择。然后在属性编辑器中点击B按钮，将表头文本设置为粗体。（2） 使用式样给表头设置背景色：选择 Element 菜单下的New Style 菜单项，弹出下图所

21、示新建式样对话框，左侧是属性目录，右侧是选中目录中包含的属性。选中 General 目录中的 Custom Style 选项，输入如下 Style 式样名称：table_header_row选中 Background 目录，右边显示出可以设置的背景属性。通过下列方式选择背景颜色：点击颜色属性后面的按钮，在颜色模板中选择。从下拉列表中选择颜色。点击 OK。在报表设计器的布局页面选中表格，在表格的左边和上边会出现向导单元格如下图：选择紧挨着表头行的向导单元格，属性编辑器中会显示选中行的属性。选择属性编辑器中的 Properties 页签，点击 General 目录。点击 Style 旁边的下拉列表

22、，选择刚刚创建的 table_header_row 式样，报表设计器会应用该式样。预览报表，显示如下：7.3.3 在同一行显示联系人的姓和名当将多个元素拖放到同一个单元格时，报表设计器会创建多个 block 元素。如果熟悉熟悉 HTML，就会知道每个 block 都会显示在新的一行里。为了在同一行显示多个元素，需要将它们设置为同一行元素。对于本例，可以按照下面的步骤完成将姓和名显示在同一行。（1）（2）（3）返回到设计器的布局页面。删除CONTACTLASTNAME元素。双击CONTACTFIRSTNAME 元素， 打开如下图所示编辑数据绑定（ Edit Data Binding ） 对 话

23、框 ， 表 达 式 （ Expression ） 栏 中 显 示 的 数 据 元 素dataSetRowCONTACTFIRSTNAME 表示数据元素显示的数据来自数据集的CONTACTFIRSTNAME 列。（4）点击表达式输入框后面的表达式构建器按钮，打开表达式构建器如下图。表达式显示在文本编辑区的上端。（5）为了将姓和名连接在一起显示，编辑表达式如下：dataSetRowCONTACTFIRSTNAME+ + dataSetRowCONTACTLASTNAME空的双引号表示在姓和名中间加上空格。表达式的编辑可以直接在文本编辑区中输入，也可以选择左下方的元素目录，然后选择中间的子目录，在右

24、下方双击表达式元素，则该元素自动添加到文本编辑区。点击 OK 返回编辑数据绑定对话框，点 OK 将修改应用到报表。预览报表，显示结果如下图：（6）（7）7.3.4 增加行间距默认情况下，报表的行间距是按最小的间距设定的。下面的步骤介绍如何调整行间距。（1）（2）（3）返回到设计器的布局页面。选中表格的明细行。在属性编辑器的 General 目录下，设置高度（Height）为 24points。如下图所示：（4）预览报表，显示结果如下：7.4 添加报表标题为了美化、修饰报表，需要为报表添加标题，可以通过添加一个标签（Label）元素、文本（Text）元素或一个数据（Data）元素为报表添加标题。标签元素适用于短的、内容固定的文本，如表格的列表头标签。文本元素适用于多行的、包含不同格式的或动态值的文本。数据元素适用于显示来自数据集或计算列的动态值。本节将介绍使用一个文本元素和 HTML 标签来格式化文本。（1）（2）返回设计器的布局页面。从面板视图拖放一个文本元素到表格是上边，如下图：（3）在弹出的文本元素编辑对话框中，选择显示