本教程介绍集成到 Oracle PeopleSoft 中的 XML Publisher 的基本特性。您将学习如何创建模板和报表，以及如何发布您的报表。
大约 1 小时。
本教程包括下列主题：
 |
概述 |
|
情景 |
|
前提条件 |
|
安装 Oracle XML Publisher Desktop |
|
修改现有查询 |
|
创建并注册数据源 |
|
创建 RTF 模板 |
| 将 XML 数据加载到 Word 模板中 | |
| 创建饼图和条形图 | |
| 创建表 | |
|
定义报表 |
|
运行和查看 XML Publisher 报表 |
|
总结 |
将鼠标置于此图标上可以加载和查看本教程的所有屏幕截图。（警告：因为此操作会同时加载所有屏幕截图，所以网速较慢时，响应时间可能会比较长。）
注：此外，您还可以在下列步骤中将鼠标放在每个单独的图标上，从而仅加载和查看与该步骤相关的屏幕截图。可以通过单击各个屏幕截图来将其隐藏。
XML Publisher（现在称为 Oracle Business Intelligence Publisher，即 BI Publisher）是一个基于模板的报表工具，它利用了数据提取和显示的标准技术。XML Publisher 工具可以在开发报表时将数据逻辑从表示层隔离出来，并在运行时再将二者组合在一起。因此，尽管技术顾问（使用 Application Engines/PeopleCode 或 PSQuery）可以独立地设计通用数据提取逻辑，但功能顾问或最终用户可以使用通用桌面工具（如 Microsoft Word）根据技术顾问创建的数据源来设计呈现方式。由于查询还可以用作数据源，因此 XML Publisher 实质上是针对需要查看报表的那个人（最终用户）扩展工具的灵活性。这意味着，获得培训最少的最终用户能够根据一般设计的数据源来设计模板和报表，从而大大降低了拥有成本。
您将在本教程中生成的报表是一个 PeopleSoft 查询，它将显示三个部门（ADMIN、ADMISSION 和 ALL_DEPTS）的工资年增长率。该数据仅用于演示目的。您将先后生成两个图表和一个表。如果您愿意，可以跳过创建图表这一步，而只创建表。
为使本教程顺利进行，您应当：
|
1. |
运行 PeopleSoft Tools 版本 8.48。 |
|
2. |
安装了 Java 运行时环境 (JRE) 版本 1.4 和 Microsoft .Net 2.0。 |
|
3. |
Microsoft Word 2000 或更高版本。 |
|
注：本教程中的屏幕截图是在 Windows XP 环境下进行的，因此“开始”菜单选项可能略有不同。 |
XML Publisher Desktop/Template Builder 随 PeopleSoft Tools 8.48 一起提供，您可以从 PeopleSoft XML Publisher 页面下载该软件。
| 1. |
在 PeopleSoft Applications 的左侧导航栏中，选择 XML Publisher > Setup link > Design Helper 链接以下载 Template Builder。
|
| 2. |
单击 Plug-in 链接下载 Template Builder。您可以将该下载保存在任何地方，例如 c:\temp。
|
| 3. |
下载完成后，安装 XML Publisher Desktop。打开 File Explorer 并导航到下载目录，例如 c:\temp。下面的示例显示了在 c:\temp\xmlp_desktop 下展开的文件。双击 setup.exe 启动安装过程。
|
| 4. |
选择 English，然后单击 Next。
|
| 5. |
确定没有安装 XML Publisher Desktop 的以前版本。单击 Next。
|
| 6. |
XML Publisher Desktop 要求安装 Java 运行时环境 (JRE) 版本 1.4 或更高。输入 Java 运行时环境的位置，然后单击 Next。
|
| 7. |
取消选择 Open the Word Template Builder Tutorial file 并单击 Next。输入您将在其中安装 XML Publisher Desktop 的文件夹的名称，然后单击 Next。
|
| 8. |
单击 Install 开始安装。
|
| 9. |
安装完成后，单击 Finish 按钮。
|
| 10. |
安装 XML Publisher Desktop 之后，打开 Microsoft Word。注意菜单栏中一个名为 Template Builder 的菜单项和一个新工具栏。
|
首先，您将修改一个现有查询 PERSONAL_DATA_PAY，并在 department id 上应用标准以减少数据量。要修改查询，执行下列步骤：
| 1. |
登录到 PeopleSoft Application，从左侧菜单中选择 Reporting Tools > Query > Query Manager。在 begins with 域中输入 PERSONAL_DATA_PAY。查询 PERSONAL_DATA_PAY 将返回。
|
| 2. |
要修改查询，单击 Edit 列下面的 Edit 链接。这将显示查询中的所有域。
|
| 3. |
由于过滤器将位于 DeptID 上，因此单击 DeptID 上的过滤器图标。
|
| 4. |
在 Edit Criteria Properties 页面上，从 Condition Type 下拉列表中选择 in list。
|
| 5. |
单击 Edit List 框中 List Members 的搜索图标。
|
| 6. |
输入 ADMIN 并单击 Add Value。
|
| 7. |
以同样的方法添加以下部门：ADMISSION 和 ALL DEPTS。针对标准输入所有部门之后，单击 OK。
|
| 8. |
在 Edit Criteria Properties 页面中，单击 OK。
|
| 9. |
单击 Run 选项卡，运行该报表。确保只返回了 3 个部门（即 ADMIN、ADMISSION 和 ALL DEPTS）。该查询应该只返回 30 行。
|
在创建任何报表之前，您都必须创建并注册一个数据源。用户查询是应用程序用于为 XML Publisher 报表检索数据的数据源。XML Publisher 支持 PS Query、Rowsets、XML Files 以及其他各种类型的数据源。在本教程中，您刚刚修改的查询将是您的数据源。
| 1. |
登录到 PeopleSoft Application，在左侧导航栏中展开 Reporting Tools > XML Publisher > Data Source。
|
| 2. |
由于您将使用 PS 查询，因此单击 Add a New Value。选择 PS Query 作为 Data Source 类型，并单击 Data Source ID 的 Look Up Query 搜索图标。
|
| 3. |
在 begins with 域中输入 P，然后单击 Lookup 按钮。
|
| 4. |
向下滚动并单击 PERSONAL_DATA_PAY。
|
| 5. |
单击 Data Source 页面上的 Add 按钮。
|
| 6. |
在 Data Source 页面的 Data Source Properties 部分中，在 Description 域中输入 Departmental Annual Salary。对于 Sample Data File，单击 Generate File 列下的 Generate。
|
| 7. |
一旦生成数据源之后，会创建一个 PERSONAL_DATA_PAY xml 文件。单击 Save 按钮。
|
| 8. |
单击 PERSONAL_DATA_PAY.XML 文件。会出现一个浏览器窗口，并显示文件中的 xml 数据。将该 xml 文件保存在 C:\temp 文件夹中。
|
您将使用 Microsoft Word 插件生成 rtf 模板。您将使用一个名为 Personal_Data_Pay.rtf 的现成 rtf 模板文件。从这里下载该模板，并将 rtf 文件保存在 c:\temp 下。
|
将 XML 数据加载到 Word 模板中 | |
|
创建饼图和条形图 | |
|
||
您将打开一个基础模板并加载 xml 数据。要加载 xml 数据，执行下列步骤：
| 1. |
在 Microsoft Word 中打开名为 Personal_Data_Pay.rtf 的文件。
|
| 2. |
单击 Data，并选择 Load XML Data。
|
| 3. |
在 Please select XML data 对话框中，选择 PERSONAL_DATA_PAY.xml 文件并单击 Open。
|
| 4. |
当出现“Data loaded successfully”消息后，单击 OK。
|
如果您不打算创建饼图和条形图，可以跳过此部分。要创建饼图和条形图，执行下列步骤：
| 1. |
在表的第一个单元格中，删除文本 <insert a pie chart here>。从菜单中选择 Insert > Chart。
|
| 2. |
在 Chart 窗口中，选择 Row 并输入以下所示的详细信息。
|
| 3. |
单击 OK。重新调整饼图的大小，使其与单元格的宽度相符。
|
| 4. |
以同样的方法插入一个条形图。删除文本 <insert a vertical bar chart here>。从菜单中选择 Insert > Chart。在 Chart 窗口中，选择 Row 并输入以下所示的详细信息。
|
| 5. |
单击 OK。重新调整条形图的大小。
|
| 6. |
保存模板并以 PDF 格式预览。单击 Preview，并从下拉列表中选择 PDF。
|
您将创建一个表格报表。您已经加载了数据。要创建一个表，执行下列步骤：
| 1. |
将光标移到图表下方，添加几个空白行并插入一个新表。单击 Insert 并从下拉列表中选择 Table/Form..。
|
| 2. |
Insert Table/Form 窗口出现。从左侧的 Data Source 列表中选择 Row。
|
| 3. |
将 Row 从左侧拖动到 Template 列，并选择 Drop all Nodes。
|
| 4. |
通过选择字段并单击删除按钮来删除下列字段：
最后，您应该拥有 4 个字段。
|
| 5. |
提供详细的分组信息。选择 Template 列中的 Row，然后在 Properties 窗口中，从下拉列表中为 Grouping 属性选择 DEPTID。
|
| 6. |
单击 OK。您将返回 Word。通过拖动列的大小调整手柄来重新调整表的大小，使其与下图相匹配。
|
| 7. |
使用 Word 功能，选择 G DEPTID 字段，将其剪切并粘贴到表的上方。
|
| 8. |
选择内表和控制字符 E，如下所示。
|
| 9. |
剪切选中的区域并将其粘贴到外表下面几行的位置。
|
| 10. |
删除外表。选择外表，然后从菜单中选择 Table > Delete > Table。
|
| 11. |
在表的末尾输入新行，以显示部门的年平均增长率。将光标置于表的行内，然后从菜单中选择 Table > Insert > Rows Below。在新行的第一列中输入 Average Rate。
|
| 12. |
按下图所示更改列标题：
|
| 13. |
将部门平均增长率字段添加到 Annual Salary Rate 列的最后一行。单击 Total 行的空白 Annual Salary Rate 列的任意位置，以定位您的光标。单击 Insert > Field。
|
| 14. |
在 Field 窗口中，为 Calculation 选择 Annual Rt 和 average。选中 On Grouping。单击 Insert，然后单击 Close。
|
| 15. |
您的表看起来应与下图类似：
|
| 16. |
更改 Annual Salary Rate 的列数据格式。双击 ANNUAL_RT。Text Form Field Options 窗口会出现。将 Type 更改为 Number。选择 Number 格式 $#,##0.00，并按下图所示对其进行编辑。在 Default 数字字段中输入 $999。单击 OK。
|
| 17. |
以同样的方法更改平均 ANNUAL_RT 的格式。
|
| 18. |
保存模板并以 PDF 格式预览。选择 Preview > PDF。预览报表将显示虚拟数据。
您可以在模板中添加其他 Word 功能。 |
现在，您将利用上面创建的 rtf 模板定义一个报表。要定义报表，执行下列步骤：
| 1. |
选择 XML Publisher > Report Definition。
|
| 2. |
在 Report Definition 页面中，单击 Add a New Value。输入报表名称 PERSONAL_PAY。
|
| 3. |
对于 Data Source ID，单击 Look up Datasource 图标。
|
| 4. |
在 begins with 域中输入 P，然后单击 Lookup 按钮。
|
| 5. |
从列表中选择 PERSONAL_DATA_PAY 作为数据源。单击 Add 按钮。
|
| 6. |
在 Definition 选项卡上，输入任意报表描述。将 Report Status 设置为 Active。
|
| 7. |
单击 Report Category ID 的查找图标。
|
| 8. |
选择 ALLUSER 目录。
|
| 9. |
在 Template 选项卡上，上载 rtf 模板。将模板的 Status 设置为 Active。
|
| 10. |
单击 Upload 按钮。导航到 Personal_Data_Pay.rtf 模板，并单击 Upload。
|
| 11. |
在 Output 选项卡上，选择 pdf 作为默认输出。单击 Save。现在，您可以在报表查看器中查看该报表了。
|
| 1. |
在 PeopleSoft Applications 的左侧导航栏中，选择 Reporting Tools > XML Publisher > Query Report Viewer。
|
| 2. |
在 Query Report Viewer 页面中，单击 Search 按钮。
|
| 3. |
从报表列表中，选择 PERSONAL_PAY 并单击 View Report。
|
| 4. |
在报表处理过程中，其顶部将显示 Processing。处理完成后，系统将显示一个包含图表和表的 3 页 PDF 报表。
恭喜！您已经使用 XML Publisher 在 PeopleSoft Applications 中创建了一个报表！ |
在本课程中，您学习了如何执行下列任务：
|
安装 Oracle XML Publisher Desktop | |
|
修改现有查询 | |
|
创建并注册数据源 | |
|
创建 RTF 模板 | |
|
定义报表 | |
|
运行和查看 XMLP 报表 | |
将鼠标置于该图标上可以隐藏所有的屏幕截图。