BI Publisher ToolBox 入门

开发人员：Oracle电子商务套件BIPublisherToolBox入门作者：IkeWiggins了解这个免费实用程序如何显著简化BIPublisher报表组件的运行。2009年10月发布您是否曾希望OracleBIPublisherAPI变得更易于使用？您是否曾希望只需一次单击即可为EBSTemplateBuilder加载应用程序？您是否曾希望只需一次单击即可测试报表？这些期望终于成真！BIPublisherToolBox是我为OracleBIPublisher创建的一个免费配置管理工具，它提供了这些特性以及许多其他特性。您可能对OracleBIPublisher的某些功能还不太熟悉，OracleBIPublisher是一个生成高保真文档和报表的工具。它还提供了一组丰富的API，可以为随处可见的各种平台生成和交付内容。下载OracleBIPublisher标签bipublisher,bi,全部图1OracleBIPublisher概览由于开发者现在可以连接到任何环境、任何全异数据源或任何ERP系统，因此ToolBox加快了开发速度。该功能带来了许多好处，无需用户创建或输入任何系统配置、将文件复制到服务器，以及等待并发管理器请求（对电子商务套件开发人员很有利）。ToolBox不仅使您的生活更轻松，还可大大节省您宝贵的开发时间。为了说明这点，下面的示例介绍了Oracle电子商务套件开发人员如何开发一个典型的BIPublisher报表并进行单元测试：1.将Reports6i报表复制到服务器或者上载一个数据模板：5秒2.上载格式模板（假设您已经登录）：5秒3.复制一个并发请求并重新提交10秒4.等待该并发请求的启动和完成：30秒5.查看日志和输出文件：10秒6.重复这个过程所有这些非增值步骤将会浪费一分多钟的时间来进行单击、输入、文件复制和等待。而使用ToolBox，您只需单击一个按钮。报表将实时运行，日志文件也将自动显示在屏幕上，输出内容也将直接输出到配置的目录中。ToolBox只需一半时间即可完成同样的工作。BIPublisherToolBox是什么？ToolBox是一个轻型Swing应用程序，开发人员可以使用它在自己的PC上以本地方式通过良好的前端GUI运行BIPublisherAPI。（参见图2。）无需进行任何部署，也无需具备任何OAF或Java知识。因此，可以使开发人员快速创建和测试BIPublisher数据模板、格式模板、分发控制文件等内容。图2运行BIPublisher模板的示例配置ToolBox最重要的一个方面在于它的易用性。一个BIPublisher开发新手能够轻松地设置必要的配置来运行任何类型的BIPublisher报表。下面列出了ToolBox提供的核心功能：格式模板—rtf转换、将xsl模板应用于xml文件数据模板—生成xml文件（替代Reports6i）ETEXT—生成EFT和EDI文档分发—通过http、电子邮件、ftp、文件系统等发送文档。上载格式模板（电子商务套件）上载数据模板（电子商务套件）安装本节介绍成功运行BIPublisherToolBox的技术设置。1.安装Java运行时环境(JRE)版本6。可从此处下载JRE版本6。2.验证PC内存大于500MB。（注：最好为1GB）3.下载BIPublisherToolBox.zip4.下载BIPublisherToolBoxSrc.zip（可选）5.解压缩BIPublisherToolBox。可将ToolBox解压缩到任何目录。不要将可执行文件、批处理文件或shell脚本移至其他目录。也不能从解压缩目录中复制可执行文件。如果进行了这种操作，将无法找到该应用程序的jar文件及其路径。请记住，您可以将整个解压缩文件夹(BIPublisherToolBox)移至所选位置。示例ToolBox预先打包了一些开发人员可以运行的基本示例。为了运行数据模板示例，必须安装scott/tiger模式，还必须有正常工作的数据源。建议开发人员先加载这些示例，然后再进行到“配置”一节。1.运行可执行程序—-转到BIPublisherToolBox\bin目录。双击BIPublisherToolBox.exe。应显示ToolBox屏幕。2.打开BIPublisherToolBox_SampleConfig.xml文件—单击OpenFolder按钮，转到BIPublisherToolBox\corporate_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步：运行可执行文件转到BIPublisherToolBox\bin目录。双击BIPublisherToolBox.exe。应显示ToolBox屏幕。运行ToolBox之前，首先要先设置数据源。要配置数据源，只需键入数据源所需信息，然后单击Add按钮。每个域都必须输入，不会对数据源设置进行验证。如果输入的信息错误，则通过创建新文件或编辑现有的xml配置文件解决这一问题。（参见图4。）图4配置和添加数据源单击Add按钮后，该数据源将可用于运行任何报表。首次创建新数据源时，系统将提示您创建并保存一个配置文件（如果尚未进行该操作。而且，首次打开该配置文件时，数据源组合框应自动填充。添加数据源之后，存在下拉列表不刷新这个尚未解决的问题。要解决此问题，请关闭应用程序，然后重新打开配置文件。对能够保存或创建的数据源数量没有限制。注：该应用程序尚未针对非Oracle数据库进行测试，因此，如果没有合适的jdbc驱动程序，SQLServer和DB2数据源可能无法运行。第2步：必填字段概述要运行数据模板、格式模板和分发之类的的BIPublisher组件，只需很少的几个步骤。无需在电子商务套件或其他相关系统中创建或更新任何新配置，即可实现此功能；模板配置考虑了BIPublisher技术的各种变体。其中包含的硬编码业务规则会强制执行该流程。下面列出了必填字段。（注：每个字段都有工具提示。工具提示显示一条简短的消息，说明高亮显示的字段中应输入的内容。）对所有配置，以下字段都是必填的：TemplateTypeOutputFormat（如果为空，则用于分发）OutputDirectoryOutputFile一般规则：在您的输出文件的OutputDirectory路径中绝不能存在空格。OutputDirectory字段应以斜线(\)结尾。FormatTemplate和DataTemplate名称中绝不能存在空格。OutputDirectory必须包含格式模板和数据模板。没有多目录配置。不要向这些文件（数据模板/格式模板）附加文件路径。这将不起作用。在OutputFile上绝不要附加文件扩展名。系统将忽略扩展名，或者会附加相关的扩展名。要保存输入内容，必须单击磁盘，或者按CTRL-S（在字段外单击以便按CTRL-S）第3步：创建/删除配置行New按钮—为了创建新配置行，必须单击New按钮。初始加载默认配置。单击New将始终在表的底部新建一行，有时，可能需要向下滚动才能看见该行。Duplicate按钮—单击Duplicate按钮将复制当前所选行。可能需要向下滚动才能看见位于表底部的新行。Delete按钮—单击Delete按钮将删除现有的行。单击Save按钮将使保存该行。ClearLog按钮—单击ClearLog按钮将清除输出控制台。但不清除现有的日志文件，日志文件将重新显示。（如果您知道如何解决此问题，请发电子邮件给我，我的个人简历中有邮件地址。这是一个已知的问题。）第4步：配置模板在下面的几节中，我们假定：开发人员在选定模板类型后，正在尝试决定可能的配置组合。所选的模板类型对配置行的执行具有非常针对性的、适用的业务规则。下面是TemplateType字段和配置行的概况。模板类型设置报表的第二步是选择合适的模板类型。有三个选项可供选择：RTF、BURST或ETEXT。有一个业务规则适用于所有模板类型，因此，当只有一个数据模板可用时，它将作为生成xml输出文件的源。图5显示了使用每个模板类型的大致情况。图5可以运行的模板类型包括RTF、BURST、ETEXT。数据模板不分类型，可以选择任何类型。RTF模板（格式模板）如果提供了某个数据模板，ToolBox将生成指定的输出文件。如果未提供数据模板，则假设存在输出xml文件。ToolBox将调用RTFProcessor和FOProcessorAPI处理输出文件。（参见图6。）图6高亮显示的行是RTF配置的示例—格式模板数据模板数据模板最多可以配置20个参数。（这是ToolBox的限制，不是BIPublisher的限制。）如果FormatTemplate字段为空，则通过调用DataProcessorAPI将只能创建xml输出文件。如果提供了格式模板，ToolBox将使用RTFProcessor和FOProcessorAPI生成指定的输出文件并应用该格式模板（参见RTF模板）。（参见图7。）图7高亮显示的行是数据模板配置的示例因为没有提供格式模板文件或分发文件，所以模板类型不会影响这个处理。分发模板（格式模板）如果提供了某个数据模板，ToolBox将使用该数据模板生成指定的输出文件。如果未提供数据模板，则假设存在输出xml文件。ToolBox将调用BIPublisherDocumentProcessorAPI并处理输出文件。（参见图7。）FormatTemplate字段应填充了分发配置文件。（注：不要为输出文件附加xml文件扩展名；这将导致ToolBox分发引擎输出错误消息。）图8高亮显示的行是分发配置的示例。ETEXT模板如果提供了某个数据模板，ToolBox将使用数据模板生成指定的输出文件。如果未提供数据模板，则假设存在输出xml文件，ToolBox将调用EFTProcessorAPI并处理输出文件。必须选择ETEXT为输出格式，文件扩展名将始终是.txt。（参见图9。）图9高亮显示的行是ETEXT配置的示例。第5步：执行配置要执行所选的配置行（蓝色的行），单击Execute按钮。请确保执行该配置前进行了保存（单击磁盘图标）。第6步：查看错误消息BIPublisherAPI的日志记录特性非常有助于诊断和排除模板问题。ToolBox捕获并重定向所有系统消息，并在输出控制台中显示这些消息。（参见图10。）输出控制台消息是由输出日志文件(errors.txt)重定向而来的。ToolBox必须在现有的目录结构中运行，否则将无法分析和显示日志文件。图10错误消息日志示例第7步：上载模板（可选）正如前边提到的，ToolBox允许电子商务套件开发人员将自己的数据模板和格式模板上载到数据库中，而无需登录到电子商务套件。（参见图11。）对于模板上载配置，以下字段都是必填的：UploadLobCodeUploadShortName图11高亮显示的行是上载格式模板/数据模板配置的示例。注：如果您想知道如何查找数据模板和格式模板的lob_code，可以使用以下查询：select*fromxdo_lobswherelob_codelike:1上载数据模板单击UploadDataTemplate按钮将向数据库中上载数据模板。默认情况下，仅支持[00-00]。上载格式模板单击UploadFormatTemplate按钮将向数据库中上载格式模板。对US模板，仅支持en-US。如果需要上载多地区模板配置，