BIPublisherToolBox入门知识.docx

n 更多资料请访问.(.)此资料来自：.（.）联系电话：020-.值班手机：提供50万份管理资料下载3万集企业管理资料下载1300GB高清管理讲座硬盘拷贝更多企业学院：./Shop/中小企业管理全能版183套讲座+89700份资料./Shop/40.shtml总经理、高层管理49套讲座+16388份资料./Shop/38.shtml中层管理学院46套讲座+6020份资料 ./Shop/39.shtml国学智慧、易经46套讲座./Shop/41.shtml人力资源学院56套讲座+27123份资料./Shop/44.shtml各阶段员工培训学院77套讲座+ 324份资料./Shop/49.shtml员工管理企业学院67套讲座+ 8720份资料./Shop/42.shtml工厂生产管理学院52套讲座+ 13920份资料./Shop/43.shtml财务管理学院53套讲座+ 17945份资料 ./Shop/45.shtml销售经理学院56套讲座+ 14350份资料./Shop/46.shtml销售人员培训学院72套讲座+ 4879份资料./Shop/47.shtmln此资料来自：.（.）联系电话：020-.值班手机：提供50万份管理资料下载3万集企业管理资料下载1300GB高清管理讲座硬盘拷贝更多企业学院： 中小企业管理全能版183套讲座+89700份资料总经理、高层管理49套讲座+16388份资料中层管理学院46套讲座+6020份资料 国学智慧、易经46套讲座人力资源学院56套讲座+27123份资料各阶段员工培训学院77套讲座+ 324份资料员工管理企业学院67套讲座+ 8720份资料工厂生产管理学院52套讲座+ 13920份资料财务管理学院53套讲座+ 17945份资料 销售经理学院56套讲座+ 14350份资料销售人员培训学院72套讲座+ 4879份资料n此资料来自：.（.）联系电话：020-.值班手机：提供50万份管理资料下载3万集企业管理资料下载1300GB高清管理讲座硬盘拷贝更多企业学院： 中小企业管理全能版183套讲座+89700份资料总经理、高层管理49套讲座+16388份资料中层管理学院46套讲座+6020份资料 国学智慧、易经46套讲座人力资源学院56套讲座+27123份资料各阶段员工培训学院77套讲座+ 324份资料员工管理企业学院67套讲座+ 8720份资料工厂生产管理学院52套讲座+ 13920份资料财务管理学院53套讲座+ 17945份资料 销售经理学院56套讲座+ 14350份资料销售人员培训学院72套讲座+ 4879份资料n此资料来自：.（.）联系电话：020-.值班手机：提供50万份管理资料下载3万集企业管理资料下载1300GB高清管理讲座硬盘拷贝更多企业学院： 中小企业管理全能版183套讲座+89700份资料总经理、高层管理49套讲座+16388份资料中层管理学院46套讲座+6020份资料 国学智慧、易经46套讲座人力资源学院56套讲座+27123份资料各阶段员工培训学院77套讲座+ 324份资料员工管理企业学院67套讲座+ 8720份资料工厂生产管理学院52套讲座+ 13920份资料财务管理学院53套讲座+ 17945份资料 销售经理学院56套讲座+ 14350份资料销售人员培训学院72套讲座+ 4879份资料开发人员：Oracle 电子商务套件   下载   标签, , BI Publisher ToolBox 入门作者：Ike Wiggins 了解这个免费实用程序如何显著简化 BI Publisher 报表组件的运行。 2009 年 10 月发布您是否曾希望 Oracle BI Publisher API 变得更易于使用？您是否曾希望只需一次单击即可为 EBS Template Builder 加载应用程序？您是否曾希望只需一次单击即可测试报表？这些期望终于成真！BI Publisher ToolBox 是我为创建的一个免费配置管理工具，它提供了这些特性以及许多其他特性。 您可能对 Oracle BI Publisher 的某些功能还不太熟悉，Oracle BI Publisher 是一个生成高保真文档和报表的工具。它还提供了一组丰富的 API，可以为随处可见的各种平台生成和交付内容。 图 1 Oracle BI Publisher 概览 由于开发者现在可以连接到任何环境、任何全异数据源或任何 ERP 系统，因此 ToolBox 加快了开发速度。该功能带来了许多好处，无需用户创建或输入任何系统配置、将文件复制到服务器，以及等待并发管理器请求（对电子商务套件开发人员很有利）。 ToolBox 不仅使您的生活更轻松，还可大大节省您宝贵的开发时间。为了说明这点，下面的示例介绍了 Oracle 电子商务套件开发人员如何开发一个典型的 BI Publisher 报表并进行单元测试： 1. 将 Reports6i 报表复制到服务器或者上载一个数据模板：5 秒 2. 上载格式模板（假设您已经登录）：5 秒 3. 复制一个并发请求并重新提交10 秒 4. 等待该并发请求的启动和完成：30 秒 5. 查看日志和输出文件：10 秒 6. 重复这个过程 所有这些非增值步骤将会浪费一分多钟的时间来进行单击、输入、文件复制和等待。而使用 ToolBox，您只需单击一个按钮。报表将实时运行，日志文件也将自动显示在屏幕上，输出内容也将直接输出到配置的目录中。ToolBox 只需一半时间即可完成同样的工作。 BI Publisher ToolBox 是什么？ToolBox 是一个轻型 Swing 应用程序，开发人员可以使用它在自己的 PC 上以本地方式通过良好的前端 GUI 运行 BI Publisher API。（参见图 2。）无需进行任何部署，也无需具备任何 OAF 或 Java 知识。因此，可以使开发人员快速创建和测试 BI Publisher 数据模板、格式模板、分发控制文件等内容。图 2 运行 BI Publisher 模板的示例配置 ToolBox 最重要的一个方面在于它的易用性。一个 BI Publisher 开发新手能够轻松地设置必要的配置来运行任何类型的 BI Publisher 报表。下面列出了 ToolBox 提供的核心功能： § 格式模板 rtf 转换、将 xsl 模板应用于 xml 文件 § 数据模板 生成 xml 文件（替代 Reports6i） § ETEXT 生成 EFT 和 EDI 文档 § 分发 通过 http、电子邮件、ftp、文件系统等发送文档。 § 上载格式模板（电子商务套件） § 上载数据模板（电子商务套件） 安装本节介绍成功运行 BI Publisher ToolBox 的技术设置。 1. 安装 Java 运行时环境 (JRE) 版本 6。可从下载 JRE 版本 6。 2. 验证 PC 内存大于 500 MB。（注：最好为 1 GB） 3. 下载 4. 下载（可选） 5. 解压缩 BI Publisher ToolBox。 可将 ToolBox 解压缩到任何目录。不要将可执行文件、批处理文件或 shell 脚本移至其他目录。也不能从解压缩目录中复制可执行文件。如果进行了这种操作，将无法找到该应用程序的 jar 文件及其路径。请记住，您可以将整个解压缩文件夹 (BIPublisherToolBox) 移至所选位置。 示例ToolBox 预先打包了一些开发人员可以运行的基本示例。为了运行数据模板示例，必须安装 scott/tiger 模式，还必须有正常工作的数据源。建议开发人员先加载这些示例，然后再进行到“配置”一节。 1. 运行可执行程序 - 转到 BIPublisherToolBoxbin 目录。双击 BIPublisherToolBox.exe。应显示 ToolBox 屏幕。 2. 打开 BIPublisherToolBox_SampleConfig.xml 文件 单击 Open Folder 按钮，转到 BIPublisherToolBoxcorporate_examples 目录。双击 BIPublisherToolBox_SampleConfig.xml。现在，ToolBox 屏幕应填充了示例。（参见图 3。） 图 3 已加载 BIPublisherToolBox_SampleConfig.xml 文件每个配置行概述： 第 1 行：通过生成的 xml 的数据模板进行分发第 2 行：RTF 模板处理由数据模板生成的数据第 3 行：RTF 模板处理之前生成的 xml 文件第 4 行：数据模板（独立的）生成 xml第 5 行：将之前生成的 xml 文件转换成 ETEXT 文档第 6 行：通过 ETEXT 格式对文档进行分发。注意，忽略了输出格式。但为清楚起见，依然保留。 配置第 1 步：运行可执行文件 转到 BIPublisherToolBoxbin 目录。双击 BIPublisherToolBox.exe。应显示 ToolBox 屏幕。 运行 ToolBox 之前，首先要先设置数据源。要配置数据源，只需键入数据源所需信息，然后单击 Add 按钮。每个域都必须输入，不会对数据源设置进行验证。如果输入的信息错误，则通过创建新文件或编辑现有的 xml 配置文件解决这一问题。（参见图 4。） 图 4 配置和添加数据源单击 Add 按钮后，该数据源将可用于运行任何报表。首次创建新数据源时，系统将提示您创建并保存一个配置文件（如果尚未进行该操作。而且，首次打开该配置文件时，数据源组合框应自动填充。 添加数据源之后，存在下拉列表不刷新这个尚未解决的问题。要解决此问题，请关闭应用程序，然后重新打开配置文件。对能够保存或创建的数据源数量没有限制。 注：该应用程序尚未针对非 Oracle 数据库进行测试，因此，如果没有合适的 jdbc 驱动程序，SQL Server 和 DB2 数据源可能无法运行。 第 2 步：必填字段概述 要运行数据模板、格式模板和分发之类的的 BI Publisher 组件，只需很少的几个步骤。无需在电子商务套件或其他相关系统中创建或更新任何新配置，即可实现此功能；模板配置考虑了 BI Publisher 技术的各种变体。其中包含的硬编码业务规则会强制执行该流程。下面列出了必填字段。（注：每个字段都有工具提示。工具提示显示一条简短的消息，说明高亮显示的字段中应输入的内容。） 对所有配置，以下字段都是必填的： § Template Type § Output Format（如果为空，则用于分发） § Output Directory § Output File 一般规则：§ 在您的输出文件的 Output Directory 路径中绝不能存在空格。 § Output Directory 字段应以斜线 ( ) 结尾。 § Format Template 和 Data Template 名称中绝不能存在空格。 § Output Directory 必须包含格式模板和数据模板。没有多目录配置。不要向这些文件（数据模板/格式模板）附加文件路径。这将不起作用。 § 在 Output File 上绝不要附加文件扩展名。系统将忽略扩展名，或者会附加相关的扩展名。 § 要保存输入内容，必须单击磁盘，或者按 CTRL-S（在字段外单击以便按 CTRL-S） 第 3 步：创建/删除配置行New 按钮 为了创建新配置行，必须单击 New 按钮。初始加载默认配置。单击 New 将始终在表的底部新建一行，有时，可能需要向下滚动才能看见该行。 Duplicate 按钮 单击 Duplicate 按钮将复制当前所选行。可能需要向下滚动才能看见位于表底部的新行。 Delete 按钮 单击 Delete 按钮将删除现有的行。单击 Save 按钮将使保存该行。 Clear Log 按钮 单击 Clear Log 按钮将清除输出控制台。但不清除现有的日志文件，日志文件将重新显示。（如果您知道如何解决此问题，请发电子邮件给我，我的个人简历中有邮件地址。这是一个已知的问题。） 第 4 步：配置模板在下面的几节中，我们假定：开发人员在选定模板类型后，正在尝试决定可能的配置组合。所选的模板类型对配置行的执行具有非常针对性的、适用的业务规则。下面是 Template Type 字段和配置行的概况。 模板类型 设置报表的第二步是选择合适的模板类型。有三个选项可供选择：RTF、BURST 或 ETEXT。有一个业务规则适用于所有模板类型，因此，当只有一个数据模板可用时，它将作为生成 xml 输出文件的源。图 5 显示了使用每个模板类型的大致情况。 图 5 可以运行的模板类型包括 RTF、BURST、ETEXT。数据模板不分类型，可以选择任何类型。 RTF 模板（格式模板）如果提供了某个数据模板，ToolBox 将生成指定的输出文件。如果未提供数据模板，则假设存在输出 xml 文件。ToolBox 将调用 RTFProcessor 和 FOProcessor API 处理输出文件。（参见图 6。） 图 6 高亮显示的行是 RTF 配置的示例 格式模板 数据模板数据模板最多可以配置 20 个参数。（这是 ToolBox 的限制，不是 BI Publisher 的限制。）如果 Format Template 字段为空，则通过调用 DataProcessor API 将只能创建 xml 输出文件。如果提供了格式模板，ToolBox 将使用 RTFProcessor 和 FOProcessor API 生成指定的输出文件并应用该格式模板（参见 RTF 模板）。（参见图 7。） 图 7 高亮显示的行是数据模板配置的示例因为没有提供格式模板文件或分发文件，所以模板类型不会影响这个处理。 分发模板（格式模板） 如果提供了某个数据模板，ToolBox 将使用该数据模板生成指定的输出文件。如果未提供数据模板，则假设存在输出 xml 文件。ToolBox 将调用 BI Publisher DocumentProcessor API 并处理输出文件。（参见图 7。）Format Template 字段应填充了分发配置文件。（注：不要为输出文件附加 xml 文件扩展名；这将导致 ToolBox 分发引擎输出错误消息。） 图 8 高亮显示的行是分发配置的示例。 ETEXT 模板如果提供了某个数据模板，ToolBox 将使用数据模板生成指定的输出文件。如果未提供数据模板，则假设存在输出 xml 文件，ToolBox 将调用 EFTProcessor API 并处理输出文件。必须选择 ETEXT 为输出格式，文件扩展名将始终是 .txt。（参见图 9。） 图 9 高亮显示的行是 ETEXT 配置的示例。 第 5 步：执行配置 要执行所选的配置行（蓝色的行），单击 Execute 按钮。请确保执行该配置前进行了保存（单击磁盘图标）。 第 6 步：查看错误消息 BI Publisher API 的日志记录特性非常有助于诊断和排除模板问题。ToolBox 捕获并重定向所有系统消息，并在输出控制台中显示这些消息。（参见图 10。）输出控制台消息是由输出日志文件 (errors.txt) 重定向而来的。ToolBox 必须在现有的目录结构中运行，否则将无法分析和显示日志文件。 图 10 错误消息日志示例 第 7 步：上载模板（可选）正如前边提到的，ToolBox 允许电子商务套件开发人员将自己的数据模板和格式模板上载到数据库中，而无需登录到电子商务套件。（参见图 11。）对于模板上载配置，以下字段都是必填的： Upload Lob Code Upload Short Name 图 11 高亮显示的行是上载格式模板/数据模板配置的示例。 注：如果您想知道如何查找数据模板和格式模板的 lob_code，可以使用以下查询： select * from xdo_lobs where lob_code like :1上载数据模板单击 Upload Data Template 按钮将向数据库中上载数据模板。默认情况下，仅支持 00 - 00。上载格式模板单击 Upload Format Template 按钮将向数据库中上载格式模板。对 US 模板，仅支持 en-US。如果需要上载多地区模板配置，可以通过编码实现。截至目前，当前的编码模式将支持大多数需求。 故障排除配置文件如果无法加载配置文件，可能是该文件遭到破坏。配置文件为 xml 格式，便于操作。如果 xml 文档无效，第一个方法应该是创建一个备份，然后尝试修复该文档。如果无法修复该文档，则必须创建新配置。如果该问题频繁出现，则维护一个备份。需要注意的是，对于可以保存和存储的配置文件的数量没有限制。 其他已知问题问题解决方法配置 文件加载失败尝试 修复该文件。添加 数据源后，组合框不刷新。 关闭 该应用程序后再重新打开。（注：无论组合框 是否填充，单击 Execute 按钮时，ToolBox 都将采用数据源行中填充的内容。）无法 删除数据源或没有数据源删除按钮。 没有 用于删除数据源的按钮。解决方法就是编辑 该配置文件中的数据源。 无法 上载我的格式模板或数据模板。出现 这一情况有多方面的潜在原因。参见上面的上载数据模板/格式模板一节。结论在本文中，您学习了如何设置、安装和运行 BI Publisher ToolBox。运行 BI Publisher 报表组件的从来没有像现在这样易于实现。使用 ToolBox，您的大部分开发工作都可以在本地 PC 上完成。 Ike Wiggins 是明尼苏达州明尼阿波利斯的一个 Oracle 应用程序开发人员。Ike 自 2004 年起开发 BI Publisher 报表，自 2006 年起开发免费的 BI Publisher 开发工具。他还经常撰写有关 BI Publisher 的博文，并积极参与 BI Publisher 开发论坛的活动。