本教程将向您介绍 Oracle 电子商务套件环境中 XML Publisher(也称为 Oracle Business Intelligence Publisher,即 BI Publisher)的基本特性。您将了解如何创建模板和报表以及如何发布报表。
大约 1 小时
本教程包括下列主题:
将鼠标置于此图标上以加载和查看本教程的所有屏幕截图。(警告:因为此操作会同时加载所有屏幕截图,所以网速较慢时,响应时间可能会比较长。)
注:此外,您还可以在下列步骤中将鼠标放在每个单独的图标上,从而仅加载和查看与该步骤相关的屏幕截图。可以通过单击各个屏幕截图来将其隐藏。
XML Publisher(也称为 Oracle Business Intelligence Publisher,即 BI Publisher)是一个基于模板的报表工具,它利用了数据提取和显示的标准技术。业务用户可以通过使用通用桌面工具亲自构建报表的布局和规则。开发工程师们可以专注于用最有效的方式提取数据。部署时间将缩短。而且,获得培训最少的业务用户也能够根据工程师提供的数据源来设计模板和报表,从而大大降低了拥有成本。
本教程将向您介绍如何创建适用于应收账款客户资产负债信 (ARXCOBLX) 的布局模板。您将创建一封显示客户未结余额的信。该信中包含一个显示所有尚未付款或部分未付款的发票的表。然后,需要将模板部署到 Template Manager,运行报表并生成输出。
本课程包括:
因为该完整流程已集成入 Concurrent Manager,用户将使用与当前相同的方法提交报表。
要完成本教程,您应已经:
|
1. |
电子商务套件 11.5.10 实例或更高版本。本教程基于电子商务套件 R12 实例。 您必须具有以下职责: |
|
2. |
您的 Windows PC 上安装了 Java Runtime Environment (JRE) 1.4 和 Microsoft .Net 2.0 |
|
3. |
您的 Windows PC 上安装了 Microsoft Word 2000 或 Microsoft Word 2003 |
|
注: 本教程的屏幕截图取自 Windows XP 环境。因此,“开始”菜单选项可能略有不同。 |
可以使用 XML Publisher Desktop/Template Builder 5.6.3 或更高版本。在本教程中,将使用 BI Publisher Desktop 10.1.3.2.1。可以从此处下载 BI Publisher Desktop。
| 1. |
单击上述页面链接中的适用于 Windows 的 BI Publisher Desktop 10.1.3.2.1链接下载 BI Publisher Desktop。可以将下载的文件保存在任意位置(例如,C:\temp)。下载完成后,安装 BI Publisher Desktop。打开 File Explorer 并导航至下载目录(例如,C:\temp)。双击 BIPublisherDesktop.exe 启动安装过程。一系列安装向导页面将指导您完成安装过程。 |
| 2. |
选择 English,然后单击 Next。
|
| 3. |
在 InstallShield Wizard 屏幕中,单击 Next。 |
| 4. |
输入您希望安装 BI Publisher Desktop 的位置并单击 Next。 安装过程开始:
|
| 5. |
安装完成后,单击 Finish。
|
| 6. |
安装 BI Publisher Desktop 之后,打开 Microsoft Word。您将在菜单栏中看到一个名为 Oracle BI Publisher 的菜单项和一个新的工具栏。
|
第一个任务是将 Oracle Reports 报表设置为生成 XML 输出。您将在 Oracle Reports 报表的 Concurrent Program 定义中以 System Administrator 的身份执行此操作。
| 1. |
登录到您的电子商务套件实例。
|
| 2. |
打开 System Administrator 职责。然而,以下屏幕截图可能与您的环境不符。这取决于您的职责情况。您可能必须向下滚动,然后单击 System Administrator。
|
| 3. |
在 Concurrent: Program 中单击 Define 链接。 |
| 4. |
如果出现 Warning - Security 窗口,单击 Run。 |
| 5. |
显示 Concurrent:Programs 窗口。从 Application 菜单选择 View > Query By Example > Enter。您将看到域中的颜色变为蓝色。也可以按 [F11] 进入查询模式。 |
| 6. |
在 Short Name 域中,输入 ARXCOBLX。ARXCOBLX 是该报表的缩写名称。您应该始终使用该名称来引用该报表。使用下拉列表将 Output Format 域更改为 XML。 |
| 7. |
通过 Concurrent Programs 运行查询。从 Applications 菜单选择 View > Query By Example > Run 来运行查询。或者,您也可以按 [CTRL] + [F11] 运行查询。
|
| 8. |
执行查询后,会看到其余的域将进行自动填充。单击 Applicaitons 菜单中的 Save 图标保存结果。
|
要生成客户公开资产负债信的示例 XML 数据文件,需要通过 Concurrent Manager 提交请求来运行报表并创建 XML 格式的输出。
| 1. |
转至电子商务套件主页,将职责更改为 Receivables, Vision Operations (USA)。在左侧导航栏中,单击 Receivables, Vision Operations (USA)。然而,以下屏幕截图可能与您的环境不符。这取决于您的职责情况。
|
| 2. |
在 Control : Requests 中向下滚动,单击 Run 打开请求提交表单。第一次访问时,可能需要等待 Application 表单的出现。
|
| 3. |
您将看到 Submit a New Request 对话框。选择 Single Request 选项并单击 OK。 |
| 4. |
在 Submit Request 对话框中,单击 Name 域旁边的省略号按钮 (...)。
|
| 5. |
您将看到 Reports 搜索对话框。输入 customer% 并单击 Find。
|
| 6. |
从列表中选择 Customer Open Balance Letter,然后单击 OK。 |
| 7. |
单击 Parameters 域输入报表的其他值,Parameters 对话框显示。在 As of date 域中输入:01-Jan-2006。
|
| 8. |
要输入客户名称,向右滚动并单击 Customer Name From 域旁边的省略号按钮 (...)。在 Longlist 对话框中,输入 a% 并单击 OK。 |
| 9. |
从列表中选择 A. C. Networks,然后单击 OK。 |
| 10. |
您将看到 A. C. Networks 已输入到 Customer Name From 和 Customer Name To 域中。单击 OK。
|
| 11. |
要提交请求,单击 Submit。 |
| 12. |
Decision 对话框显示。您会看到 Request ID,单击 No,因为现在不提交任何请求。 |
| 13. |
从 Applications 菜单中选择 View > Requests。 |
| 14. |
在 Find Requests 窗口中,选择 All My Requests 选项并单击 Find。 |
| 15. |
在 Requests 窗口中,搜索您的 Job ID 并查看工作状态。如果工作已完成,单击 View Output 按钮。 |
| 16.. |
在浏览器中查看报表。因为没有与该报表相关联的模板并且您已请求 XML 输出,所以报表将是一个 XML 文件。在本地驱动器中,将 XML 文件保存为 customer.xml。 |
BI Publisher 支持多种类型的模板。RTF 模板是最常见的并且可提供多种输出格式。可以使用 BI Publisher Template Builder(Microsoft Word 的一个插件)构建 RTF 模板。在创建模板之前,请确保安装了 Template Builder 或 BI Publisher Desktop。您将使用一个名为 Balance Letter Start.rtf 的现成 RTF 模板。从这里下载初始模板,并将 rtf 文件保存在 c:\temp 下。
| 将 XML 数据加载到 Word 模板中 | ||
| 插入表单域 | ||
您将打开一个布局模板并加载 XML 数据。要加载 XML 数据,执行以下步骤:
| 1. |
在 Microsoft Word 中打开名为 Balance Letter Start.rtf 的文件。这是一个预定义的模板。在该模板中,加入页眉、页脚、Oracle 徽标和页眉中的页码。页脚中也有一段文本。这些将通过 Microsoft Word 的功能完成。可以通过使用 Microsoft Word 菜单中的 Insert > Picture > From File 插入任意图片。
|
| 2. |
从 BI Publisher 菜单中选择 Data > Load XML Data。
|
| 3. |
在 Please select XML data 对话框中,选择 customer.xml 文件并单击 Open。
|
| 4. |
出现“Data loaded successfully”消息后,单击 OK。
|
要在客户信函中插入表单域,执行以下步骤:
| 1. |
选中 <INSERT ADDRESS HERE> 并从 BI Publisher 菜单中选择 Insert > Field。
|
| 2. |
在 Field 对话框中,选择 Customer Name 并单击 Insert。
|
| 3. |
将光标放在 Customer Name 下面的行上并选择 Address Line 1。单击 Insert。采用同样的方法插入 Address Line 3、Address Line 4、City、State 和 Country。关闭 Field 对话框。
|
| 4. |
选择 <INSERT DATE HERE>。从 BI Publisher 菜单中选择 Insert > Field。选择 C As of Date Display 并单击 Insert。
|
| 5. |
采用同样的方法更改下面的其他域: <INSERT CURRENCY CODE HERE> 改为 TRX CURRENCY CODE <AMOUNT> 改为 C_INV_OPEN_BALANCE
|
| 6. |
在 Microsoft Word 菜单中,单击 File > Save 保存模板。在 BI Publisher 菜单中,单击 Preview > PDF 查看 PDF 格式的报表。
|
在该信函中,您将创建一个显示所有尚未付款或部分未付款的发票的表。要创建该表,执行以下步骤:
| 1. |
在布局模板中,选中文本 <INSERT TABLE OF INVOICES HERE>。从 BI Publisher 菜单中选择 Insert > Table Wizard。
|
| 2. |
在 Table Wizard 窗口中,选择 Table 选项并单击 Next。
|
| 3. |
对于 Grouping Field,从下拉列表中选择最后一项 List of Invoices。单击 Next。
|
| 4. |
选择下图中所示的域并将它们移至右栏中。单击 Next。 |
| 5. |
在 Group By 窗口中,单击 Next。没有用于信函中数据的组。 |
| 6. |
在 Sort By 窗口中,从下拉菜单中选择 Transaction Date。使用默认的 Ascending 排序。单击 Finish。 |
| 7. |
您的模板将与下图中所示的模板类似。使用 Microsoft Word 功能修改外观并调整模板的列。 |
| 8. |
使用 Microsoft Word 功能更改列标题,如下图所示。 |
| 9. |
在表的末尾插入一个新行,以显示到期金额总额。将光标置于最后一行内,然后从菜单中选择 Table > Insert > Rows Below。在新行的 Amount 列中输入 Total。 |
| 10. |
在最后一列中为客户添加到期金额总额。单击 Total 单元格右侧的空白单元格。选择 Insert > Field。
|
| 11. |
在 Field 窗口中,选择 Trans Amount Remaining 并从 Calculation 下拉菜单中选择 sum。单击 Insert,然后单击 Close。
|
| 12. |
您的表将与下图所示类似。
|
| 13. |
为了便于阅读,可以更改 date 和 amount 域中的数据类型和格式。选择并双击 C_AS_OF_DATE_DISPLAY 域。将显示 Text Form Field Options 窗口。将 Type 更改为 Date。按以下屏幕截图所示更改数据格式。
|
| 14. |
采用同样的方法更改 Transaction Date 列的格式。
|
| 15. |
选择并双击 TRANS_AMOUNT。选择 Number 格式 $#,##0.00,并按照下图所示对其进行编辑。在 Default number 字段中输入 $999。单击 OK。采用同样的方法更改 Trans Amount Remaining 和 sum Trans Amount Remaining 的格式。
|
| 16. |
选择 TRX_NUMBER 并单击 Microsoft Word 工具栏上的 Center align 图标。同样,中间对齐 Date 域并右侧对齐所有 amount 域。
|
| 17. |
将模板另存为 Balance Letter - Template.rtf 并以 PDF 格式预览。从 BI Publisher 菜单中选择 Preview > PDF。预览将显示示例数据的报表。
可以在模板中添加其他 Word 功能。 |
要发布报表,必须注册将与模板合并的数据源。注册布局模板文件(在下一节中)时,必须为其指定一个存在于 Template Manager 中的数据定义。这将在运行时将二者相关联。注意,多个模板可使用相同的数据定义。
要创建数据定义,执行以下步骤:
| 1. |
登录到电子商务套件,单击 XML Publisher Administrator 以更改到 XML Publisher Administrator 职责。然而,以下屏幕截图可能与您的环境不符。这取决于您的职责情况。
|
| 2. |
单击 Data Definitions 链接,您将位于 XML Publisher 的 Data Definition 选项卡中。单击 Create Data Definition 按钮创建新的数据定义。
|
| 3. |
在 Create Data Definition 下,按照下图所示填写表单。使用正确 Concurrent Program 的缩写名称(ARXCOBLX)将该数据定义正确链接到底层 Concurrent Program 和 Oracle Reports 报表是非常重要的。而对于 Name 域,您可以随意使用名称。在本教程中,我们使用“Customer Balance Data Definition”。单击 Apply。
|
| 4. |
您现在应看到一个确认消息。现在,您已经成功创建了一个适用于客户资产负债信的数据定义。
|
| 1. |
在 XML Publisher 的 Template 选项卡页面中,单击 Create Template。
|
| 2. |
输入 Customer Balance Letter - Template 作为模板名称。使用 Lookup 图标在 Application 名称中选择 Receivables。输入代码 ARXCOBLX。
|
| 3. |
单击 Data Definition 域旁的 Lookup 图标,输入 cust%,然后单击 Go。从列表中选择 the Customer Balance Data definition 选项,然后单击 Select。
|
| 4. |
从 Type 下拉列表中选择 RTF 作为模板类型。请记住,您已经将模板保存为 RTF 文件。
|
| 5. |
现在需要上载在 Microsoft Word 中创建的模板。向下滚动到 Template File 部分,选择您创建的模板。对于 File,浏览并打开名为 Balance Letter - Template.rtf 的文件。
|
| 6. |
选择 Language 为 English。
|
| 7. |
您的模板表单应如下所示。单击 Apply。您应该会收到模板已成功创建的消息。
|
| 1. |
在电子商务套件应用程序主页中,更改至 Receivables, Vision Operations (USA) 职责。在 Control : Requests 中单击 Run 链接。
|
| 2. |
您将看到 Submit a New Request 窗口。选择 Single Request 选项并单击 OK。
|
| 3. |
在 Submit Request 窗口中,单击省略号按钮 (...)。
|
| 4. |
Reports 搜索窗口显示。在 Find 域中输入 customer%,然后单击 Find。
|
| 5. |
从列表选择 Customer Open Balance Letter,然后单击 OK。 |
| 6. |
单击 Parameters 对话框,在其中输入报表的其他值。在 As of date 域中输入 01-Jan-2006。
|
| 7. |
向右滚动并单击省略号按钮 (...) 输入客户名称。在 Longlist 对话框中,输入 a% 并单击 OK。
|
| 8. |
从列表中选择 A. C. Networks,然后单击 OK。
|
| 9. |
您将看到 A. C. Networks 已自动输入到 Customer Name From 和 Customer Name To 域中。单击 OK。
|
| 10. |
您将看到该布局模板文件列在 Layout 域中。单击 Options 按钮查看其他选项,也可以在报表完成后进行设置。
|
| 11. |
Upon Completion... 窗口显示。在本窗口中,您可以指定在工作执行后可进行的操作。可以将报表通知给一个或多个人。可以发送待打印的报表。在本教程中,无需打印报表。单击 OK。
|
| 12. |
返回 Submit Request 窗口。单击 Submit 执行请求。
|
| 13. |
您将看到 Decision 对话框中已显示 Request ID 并单击 NO。
|
| 14. |
从 Applications 菜单中选择 View > Requests。 |
| 15. |
在 Find Requests 窗口,选择 All My Requests 选项并单击 Find。 |
| 16. |
在 Requests 窗口中,搜索您的 Job ID 并查看其状态。如果工作已完成,单击 View Output 按钮。 |
| 17.. |
单击 View Output 按钮在浏览器中查看报表。您将看到报表以模板中的布局显示。也可以将其他模板与同一数据定义相关联。 |
在本教程中,您学习了如何:
![]() |
安装 Oracle XML Publisher Desktop/BI Publisher Desktop | |
![]() |
将 Oracle Reports 报表输出设置为 XML | |
![]() |
使用 Concurrent Manager 创建示例 XML 文件 | |
![]() |
创建 RTF 模板 | |
![]() |
创建适用于报表的数据定义 | |
![]() |
使用 Template Manager 上载模板 | |
![]() |
通过模板运行报表 | |