Myeclipse报表开发教程基础篇.docx

Myeclipse报表开发教程基础篇1、 介绍在我们的日常生活或商业领域中，经常会用到报表。数据以很好的方式（比如以商业报表的形式）组织起来，会极大的改善关键的决策制定。报表开发工作流程和Myeclipse报表开发工具可以帮助我们开发各种Web报表。本教程将根据基本的流程在Myeclipse中开发、部署和测试一个简单的客户清单的Web报表。图1-1是整个客户清单报表的一个截图，可以用Examples On-Demand浏览器按照按照本教程开发的客户清单报表。图1-1 本教程开发的客户清单报表在Web浏览器中的截图面向的读者本教程假设读者熟悉Myeclipse Web开发、部署以及相关工具和MyEclipse Database Explorer特性。如果在练习时遇到问题或想获取更详细的信息，请参考Resources部分获得更多的资源。为了更好的体会Myeclipse请参考产品文档。系统需求本系统是用Myeclipse6.0.1专业版创建的。如果您使用的是更新的版本，本教程中的大部分图片和说明是向后兼容的。Myeclipse Reports需要Myeclipse6.0.1或更高的版本。是专业级的特性并且只能注册获取。2、 报表开发流程开发流程是创建一个新报表所要做的工作的概要：（1） 创建一个Report Web Project（2） 创建一个report（3） 创建一个Myeclipse JDBC DataSource（4） 创建一个DataSet（5） 规划、定制和风格化报表（6） 部署Report Web Project（7） 浏览测试Web Report每项都将在下面依此展开讨论。2.1 Myeclipse报表向导Myeclipse为每种报表提供有开发向导，开发向导一组指导你一步一步完成报表创建的说明。（1） 要显示所要可用的向导，可以点击helpcheat sheets，打开如图2-1所示向导选择对话框。图2-1 向导选择对话框（2） 展开Myeclipse Reports目录，选择要用的向导点击OK按钮，这样就在工作台的右边打开了向导视图，可以很方便的同时读或执行向导。向导将会指引你完成每一步，当做完一步后，点击下面的图标，下一步会自动显示除了，？图标允许你打开一个该步的帮助页面。3、 创建Report Web ProjectMyeclipse报表引入了一种新的项目（工程）Report Web Project，这种项目（工程）是一种具有报表开发功能的J2EE Web Project。创建一个Report Web Project有两种方法，一种是使用Report Web Project向导，如果不是在一个已有的Web Project上进行报表开发，请用这种方法。另一种是为一个已经存在的Myeclipse Web Project添加报表开发功能（Report Capabilities）。接下来将分别介绍这两种方法。3.1 使用Report Web Project向导（1）通过FileNewProjectReport Web Project启动向导来创建一个Report Web Project。（2）输入项目（工程）名称：reportdemo（3） 点击Next进入下一步可以查看生成的报表目录结构和选择报表引擎的日志级别。（4） 点击Finish来创建reportdemo项目。下图展示了Myeclipse Report Web Project的结构。（5） 向导关闭后Myeclipse会询问是否打开Myeclipse报表设计透视图（MyEclipse Report Design perspective），选择Yes。3.2 添加报表开发功能到一个Web Project。可以通过Report Capabilities向导给任何Myeclipse Web Project添加报表开发功能。如下图所示。（1） 在project explorer视图或package explorer视图中选中目标项目，单击右键，在上下文菜单中选择MyeclipseAdd Report Capabilities，这样可以启动Report Capabilities向导。也可以通过菜单栏中的MyeclipseProject Capabilities Add Report Capabilities启动Report Capabilities向导。（2） 完成向导，点击Finish更新项目。（3） 向导关闭后Myeclipse会询问是否打开Myeclipse报表设计透视图（MyEclipse Report Design perspective），选择Yes。如果要手动打开该视图，可以通过Windowopen perspectiveotherMyeclipse Report Desigen打开。4、 创建一个报表（Report）（1） 选择项目reportdemo，选择FileNewReport来打开新建Report向导。也可以点击工具栏中的新建报表（New Report）按钮来打开向导。（2） 输入报表名new_report.rptdesign。扩展名必须是.rptdesign。（3） 保持复选框Generate sample report access webpage选中状态点Next。（4） 向导第二步给出了几个可选的模板，因为我们要创建的是一个简单报表，所以选择Blank模板，点Next。 向导的第三步允许创建一个样例JSP页面来演示如何由页面打开报表。例如，可以在页面中包含一个连接到报表的超链接，也可以直接把网页和报表绑定到一起。注意：如果前面没有选中Generate sample report access webpage，也可以在后面报表的上下文菜单中选择Generate sample report access webpage来生成。（5） 使用默认的文件夹结构和JSP文件名，如：new_report.jsp。（6） 选中生成一个绑定的报表阅读器单选按钮。（7） 点击Finish，将会自动在报表设计器中打开报表。5、 创建Myeclipse JDBC数据源客户清单列表的数据存放在Myeclipse Derby Server中，我们可以使用任何可以在Myeclipse 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） 启动数据源向导。在Data Explorer视图中的右键上下文菜单中选择Data SourcesNew Data Source。可以通过菜单栏中选择WindowShow ViewOtherMyeclipse Reports DesignData Explorer打开Data Explorer视图。（3） 在数据源类型列表中选择Myeclipse JDBC Data Source。（4） 在输入数据源名称，如：Data Source。（5） 点击Next。（6） 选择已有的Myeclipse Derby驱动，点击Finish。注意：也可以打开本布中的连接来创建或编辑一个Myeclipse JDBC驱动。6、 创建数据集数据集是从数据源中返回的将要在报表中显示的数据的集合。本节将创建一个SQL数据源。（1） 启动New Data Set向导，可以通过选择Data Explorer视图的上下文菜单中的Data SetNew Data Set启动。（2） 选择前面创建的数据源。（3） 输入数据集名称：Customers。（4） 在data set type下拉列表中选择Myeclipse Data Set，点Next。在向导的第二步输入返回给数据集的SQL查询。当输入SQL查询时，查询编辑器支持内容辅助功能。也可以双击树形视图中表或列名，该元素将自动插入当前编辑的查询的最后。（5） 输入如下SQL查询语句。Select CUSTOMERNAME, CONTATFIRSTNAME, CONTACTLASTNAME, PHONE from CLASSICCARS.CUSTOMER（6） 点Finish开始执行SQL查询，并创建数据集。（7） 如果数据集创建成功，将会启动一个编辑数据集对话框，允许对数据集做进一步的定制。选择预览模型可以查看执行SQL查询返回的数据结果。7、 布局、定制、式样化报表7.1 布局报表创建了数据源和数据集，接下来要为报表添加控件。首先添加一个表格（table），然后将数据集中的列绑定到表格中的列。表格有如下功能：表格遍历数据集的所有数据行。可以很方便的按行列格式布局数据。（1） 打开面板视图（Palette View）来查看能添加到报表的控件。（2） 从面板中拖放一个表格到报表设计器中，此时弹出一个插入表格对话框，输入列数和明细行数并将数据集与表格绑定起来。如图设置后点击OK开始创建表格。接下来要将数据集中的元素绑定到表格的列。在Data Explorer视图中展开Customers数据集，其中列出了查询中所指定的列。将CASTOMERNAME列从数据集拖放到如图表格明细行的第一个单元格中。表格的明细行定义了数据集中各列以及他们在表格数据行中的显示顺序。当CASTOMERNAME列从数据集中拖到明细列后，报表设计器就会添加一个【CASTOMERNAME】的数据绑定元素。另外，在新的【CASTOMERNAME】数据元素上面的表头行中，报表设计器会自动添加一列表头标签文本CASTOMERNAME。如图所示：（3） 将PHONE从数据集中托到明细行的第二行。依此将余下的列从数据集拖到明细行。报表的布局如下：（4） 要查看报表数据和表格布局是否正确，可以选择报表设计器下面的预览（preview）页签进行浏览。也可以通过选择FileView Report下面的其它格式进行预览。7.2 数据排序如上图所示预览结果可以看出，数据行是按照数据集查询返回的顺序显示的。默认的顺序可能由很多因素所致，如数据在数据库中创建的顺序。在大多数情况下，用户希望能够改变数据在报表中的显示顺序。本节将介绍如何对报表数据排序。（1） 在报表设计器中选择布局（LayOut）页签，回到设计界面。（2） 如果需要的话，打开属性编辑器（Property Editor）视图。如果使用的是默认的报表设计透视图，属性编辑器位于报表设计器的下面，工作台的中下方。如果该视图没有打开，可以通过WindowShow ViewProperty Editor来打开。（3） 在布局编辑器中，将鼠标移动到表格上，在表格左下角会出现一个表格标签，点击它可以选中表格。属性编辑器中会显示选中表格的属性如下图：（4） 点击排序（Sorting）页签，点击Add来确定排序键。在弹出的New Sort Key对话框中，输入以下值。Key：选择要排序的表格列，Direction：设置排序方向，升序或降序。设置如下图：（5） 点击OK，新建的排序键会显示在排序页的列表中。（6） 重新预览报表，这一次报表中数据行的是按照CUSTOMERNAME列数据的升序排序显示的。（7） 可以看到，姓名列中大写字母的排在最前面。Myeclipse 报表中的字符串数据排序是按照UCS2编码值进行的。基于ASCII字符集编码的字符，大写字符的值比小些的小，因此大写字母排在小写字母签名。下面设置排序对大小写不敏感，使ANG Resellers出现在American Souvenirs Inc后面，而不是前面。（8） 在属性编辑器中选择排序页签，然后选择CUSTOMERNAME排序键，然后点击Edit按钮，打开排序键编辑器。（9） 在排序键编辑器中，修改排序表达式如下，点击。rowCUSTOMERNAME.toUpperCase()这个表达式使用JavaScript toUpperCase()函数将所有CUSTOMERNAME列数据在排序前转换成大写字母。JavaScript函数名是大小写敏感的，输入时一定要注意。引用的列名也是大小写敏感的。当前表达式使用的是rowCUSTOMERNAME，如果书写成rowcustomername，返回报表时会报错。（10） 预览报表，确认是按照大小写不敏感的顺序显示的。7.3 格式化报表（设置报表格式）数据可以按照预定的顺序显示以后，我们就可以将注意力集中在报表界面上。本节将完成以下任务： 编辑表头标签。 设置表头格式使表头与数据行区分开。 在同一行显示联系人的姓和名。 增加行间距。7.3.1 编辑表头标签（1） 返回到报表设计器的布局页面。（2） 在布局页面中可以直接对标签文本进行编辑。将光标定位到标签文本中，输入表头休息后按回车键保存表头休息。将CUSTOMERNAME列表头休息修改如下：Customer（3） 重复步骤2，修改余下列表头如下：PhoneContact修改后报表如下图：7.3.2 设置表头标签格式可以通过如下两种方法设置控件的格式： 通过设置控件的属性。 定义一个式样，将式样应用到控件上。这种方法把希望的属性设置在一个式样中，然后可以应用到多个控件上。本节将采用第一种方法，在属性编辑器中将表头文本设置为粗体，用第二种方法为表头添加颜色。（1） 在属性编辑器中设置表头文本为粗体。首先选中所有表头列，可以通过按下shift键完成多个表头列的选择。然后在属性编辑器中点击B按钮，将表头文本设置为粗体。（2） 使用式样给表头设置背景色：选择Element菜单下的New Style菜单项，弹出下图所示新建式样对话框，左侧是属性目录，右侧是选中目录中包含的属性。选中General目录中的Custom Style选项，输入如下Style式样名称：table_header_row选中Background目录，右边显示出可以设置的背景属性。通过下列方式选择背景颜色：点击颜色属性后面的按钮，在颜色模板中选择。从下拉列表中选择颜色。点击OK。在报表设计器的布局页面选中表格，在表格的左边和上边会出现向导单元格如下图：选择紧挨着表头行的向导单元格，属性编辑器中会显示选中行的属性。选择属性编辑器中的Properties页签，点击General目录。点击Style旁边的下拉列表，选择刚刚创建的table_header_row式样，报表设计器会应用该式样。预览报表，显示如下：7.3.3 在同一行显示联系人的姓和名当将多个元素拖放到同一个单元格时，报表设计器会创建多个block元素。如果熟悉熟悉HTML，就会知道每个block都会显示在新的一行里。为了在同一行显示多个元素，需要将它们设置为同一行元素。对于本例，可以按照下面的步骤完成将姓和名显示在同一行。（1） 返回到设计器的布局页面。（2） 删除CONTACTLASTNAME元素。（3） 双击CONTACTFIRSTNAME元素，打开如下图所示编辑数据绑定（Edit Data Binding）对话框，表达式（Expression）栏中显示的数据元素dataSetRowCONTACTFIRSTNAME表示数据元素显示的数据来自数据集的CONTACTFIRSTNAME列。（4） 点击表达式输入框后面的表达式构建器按钮，打开表达式构建器如下图。表达式显示在文本编辑区的上端。（5） 为了将姓和名连接在一起显示，编辑表达式如下：dataSetRowCONTACTFIRSTNAME+ + dataSetRowCONTACTLASTNAME空的双引号表示在姓和名中间加上空格。表达式的编辑可以直接在文本编辑区中输入，也可以选择左下方的元素目录，然后选择中间的子目录，在右下方双击表达式元素，则该元素自动添加到文本编辑区。（6） 点击OK返回编辑数据绑定对话框，点OK将修改应用到报表。（7） 预览报表，显示结果如下图：7.3.4 增加行间距默认情况下，报表的行间距是按最小的间距设定的。下面的步骤介绍如何调整行间距。（1） 返回到设计器的布局页面。（2） 选中表格的明细行。（3） 在属性编辑器的General目录下，设置高度（Height）为24points。如下图所示：（4） 预览报表，显示结果如下：7.4添加报表标题为了美化、修饰报表，需要为报表添加标题，可以通过添加一个标签（Label）元素、文本（Text）元素或一个数据（Data）元素为报表添加标题。标签元素适用于短的、内容固定的文本，如表格的列表头标签。文本元素适用于多行的、包含不同格式的或动态值的文本。数据元素适用于显示来自数据集或计算列的动态值。本节将介绍使用一个文本元素和 HTML标签来格式化文本。（1） 返回设计器的布局页面。（2） 从面板视图拖放一个文本元素到表格是上边，如下图：（3） 在弹出的文本元素编