XML Publisher 培训

1、广州赛意信息科技有限公司广州赛意信息科技有限公司 XML PublisherXML Publisher培训培训 目录目录 XML Publisher 概述概述 XML Publisher 开发技术开发技术 XML Publisher 扩展功能扩展功能 XML 报表实例报表实例 XML Publisher 概述概述 XML ;XSL; XSLT; XSL-FOXML ;XSL; XSLT; XSL-FO的概念的概念 为了能够从原理上理解 XML PublisherXML Publisher，首先我们来了解几个概念。 XMLXML :可扩展的置标语言 (Extensible Markup Lang

2、uage (Extensible Markup Language )比如HTML 就 是一种XML XSLXSL :可扩展的样式表语言(Extensible Stylesheet LanguageExtensible Stylesheet Language)可以理 解为两种不同的XML之间的翻译桥梁. XSLT :XSL TransformationXSLT :XSL Transformation，专门用于进行XML数据转换（data transformation） XSL-FO :XSL Formatting Object XSL-FO :XSL Formatting Object ,专门用

3、于数据表示. DTDDTD :数据语法定义 XML Publisher 概述概述 文档管理的需求文档管理的需求 格式丰富的报表 合作伙伴的报表 财务结算报表 政府要求的表格 市场营销所需的材料 合同 支票，标签 XML EFT / EDI 文档需要分发到多个目的地 XML Publisher 概述概述 传统的报表设计工具传统的报表设计工具 昂贵的开发成本 昂贵的客户化成本 添加了升级的困难 Oracle XML Publisher 是随Oracle EBS一起发布的一套基于 模版的打印解决方案，它提供了一种设计报表和打印报表的新 方式，很好的将桌面文字处理工具和EBS数据报表输出集成在 一起。

4、 XML Publisher 将数据表现和数据结构完全分开，通过在EBS 中取得数据，在模版文件中定义报表的输出格式。 在运行的时候，XML Publisher合并数据和模版文件来输出各 种样式和格式的报表 Oracle XML Publisher 是随Oracle EBS一起发布的一套基于模版 的打印解决方案，它提供了一种设计报表和打印报表的新方式，很好 的将桌面文字处理工具和EBS数据报表输出集成在一起。 XML Publisher 将数据表现和数据结构完全分开，通过在EBS中取 得数据，在模版文件中定义报表的输出格式。 在运行的时候，XML Publisher合并数据和模版文件来输出各种

5、样 式和格式的报表 XML Publisher 概述概述 XML Publisher 概述概述 完全分离完全分离 数据数据 / / 布局布局 / UI/ UI国际化国际化 高弹性高弹性 更低的维护成本更低的维护成本 报表输出 数据逻辑 报表布局 翻译转化 XML Publisher XML Publisher 概述概述 报表模板 格式化引擎 报表输出 业务顾问可以使用自己熟悉的桌面工具 来设计报表布局 支持多个数据源 XSL XML 多个数据源 XSL-FO XML Publisher XML Publisher 开发开发 XML Publisher 概述概述 从数据源到报表输出从数据源到报表

6、输出 Web Services 模 板 XML EDI EFT Email Printer Fax WebDAV e-Commerce 输出 目标 Oracle, SQL Server PeopleSoft, SAP, Siebel Java, C+, Pearl, etc XML Publisher 数据源 Word Excel Acrobat XSL 布局设计工具 PDF RTF HTML Excel XML Spy JDeveloper Scriptura XML Publisher 概述概述 一个模板一个模板 多种输出格式多种输出格式 XML 数据 RTF PDF HTML EXCEL

7、 XML Publisher RTF 模板先转换为 XSL-FO, 然后格式化为多种类型的输出 根据前面的讨论，我们就清楚了，使用根据前面的讨论，我们就清楚了，使用XML Publisher开发报表，核心开发报表，核心 任务就是三个：任务就是三个： A) 如何准备如何准备XML数据源数据源 1 在在EBS的并发程序定义界面的并发程序定义界面 ,设置设置 并发程序的输出格式为并发程序的输出格式为XML. B) 如何制作如何制作RTF模板模板 1 用用MS Word 写手工制作写手工制作RTF模板文档模板文档. 缺点是对开发者的要求高缺点是对开发者的要求高 但是效率不高但是效率不高 2 用用Tem

8、plete Builder . 是一个是一个Word插件插件. 优点是使用方便优点是使用方便,效率高效率高. C) 在在EBS中如何关联中如何关联XML数据源和模板数据源和模板 1 在在EBS中有中有XML Publisher 模板管理界面模板管理界面,可定义数据源、注册模可定义数据源、注册模 板。可实现板。可实现XML数据源和模板的关联关系数据源和模板的关联关系. 如何使用如何使用XML Publisher开发报表开发报表 XML Publisher开发报表开发报表 开发工具开发工具 安装安装 Oracle XML Publisher DesktopOracle XML Publisher

9、Desktop Java Running Environment(Java Running Environment(安装安装OracleOracle开发工具后一般都会有的开发工具后一般都会有的) ) 安装好后打开MS Word 可以找到如下工具条 XML Publisher开发报表开发报表 1、设计报表数据模型，上传报表到ERP中 2、为报表定义可执行，并发程序，并添加到相应的请求组中 （注意：要记住可执行的简称；定义并发程序时，输出格式要选择XML） 3、运行报表，并另存为一个XML文件 4、在word中，使用第3步的XML，设计创建RTF模板 （注意：不能直接创建后缀为.rtf的文件，要以

10、另存为的方式创 建.rtf的文件） 5、在ERP中的Oracle XML Publisher 管理员的职责中,使用模板管理 器，定义数据源、注册模板；实现XML数据源和模板的关联关系 6、运行报表，查看输出结果 开发步骤开发步骤 Report Builder是报表开发工具.做普通报表时,有数据模型和布局 两个方面的工作.但是作为XML Publisher 报表的数据源提供者时, 只需要做好数据模型即可 XML Publisher开发报表开发报表 XML Publisher开发报表开发报表 要支持中文,则必须设置报表的XML Prolog Value= XML Publisher开发报表开发报表

11、 为报表定义可执行，并发程序，并添加到相应的请求组中（注意： 要记住可执行的简称；定义并发程序时，输出格式要选择XML） 运行报表，查看输出，获取XML文件 XML Publisher开发报表开发报表 R12 新功能新功能 传统的XML 报表执行方式为： Oracle Report ，rdf 文件作为数据源，与。 查看下图可以发现R12 XML 报表执行方式为：Java Concurrent ProgramOracle 数据源已经定义在XML 文件中，可以预测Report Builder 快要退出舞台，Oracle 应用 开发副总裁曾经也说过将来XML Publisher 会完全取代 Repo

12、rt Builder. XML Publisher开发报表开发报表 XML 有着类似Report Builder 结构 XML Publisher开发报表开发报表 参数定义参数定义 XML Publisher开发报表开发报表 数据源定义数据源定义 XML Publisher开发报表开发报表 Item 定义定义:rdf 报表报表item值是通过写值是通过写function 返回的，返回的，XML 报表需要报表需要 在后台定义在后台定义package 在在EBS 中启用中启用XML Publisher 创建创建RTFRTF模板模板 Rich Text Format (RTF) 是被文字处理应用 程

13、序广泛使用一个规范，如Microsoft Word。 XML Publisher RTF 模板解析器转换RTF文件 为 XSL-FO XML Publisher 不仅支持Word本身的格式功能， 还支持其它高级的报表功能，如： 条件格式化 动态数据列 连接累积 图表 模板中可以直接包括标记代码，可以包括任何 的 XSL 元素 FO 元素和 XML Publisher扩展的SQL表达式 RTF模板 RTF处理器 XSL-FO模板 FO 引擎 XML HTMLRTFPDF 创建创建RTFRTF模板模板 创建模板的方法创建模板的方法 基本的基本的RTFRTF方法方法 使用任何支持RTF1.6版本以上

14、的文字处理应用程序来设计，并使 用XML Publisher的简单语法，直接在模板中字段显示的地方输入 Placeholder 命令语句： 例如，模板中的 “Supplier” 影射到 XML 数据的 VENDOR_NAME 字段元素，在模板文档中输入如下： 创建创建RTFRTF模板模板 创建模板的方法创建模板的方法 窗体域方法窗体域方法 使用Microsoft Word窗体域的功能，将命令语句放到隐藏窗体域的 帮助文字中，而无需直接设计模板。XML Publisher支持Microsoft Word2000以上版本 从窗体工具条中选择“文字型窗体域”， 将窗体域插入模板文件中显示字段的地 方

15、 1. 插入“文字型窗体域” 双击窗体域打开文字型窗体域选项窗 口，将命令语句写入窗体域帮助文字 中 2. 插入命令语句 创建创建RTFRTF模板模板 设计步骤设计步骤 创建创建RTFRTF模板包括如下两个基本步骤：模板包括如下两个基本步骤： 1. 1. 设计模板布局设计模板布局 使用Word格式化的功能并且将文件保存为 RTF格式 2. 2. 添加标记添加标记 添加XML Publisher标记到模板中 创建创建RTFRTF模板模板 使用使用XML Publisher Template BuilderXML Publisher Template Builder Template Builde

16、r是为了简化RTF模板开发而对Word进行扩展的工具， 它替我们完成了很多手工操作，提高了工作效率，下面是Template Builder在Word中的工具条： 插入数据字段 插入数据驱动的表格 插入数据驱动的表单 插入数据驱动的图表 使用样例数据预览模板 Template Builder具有以下的功能： 创建创建RTFRTF模板模板 关联关联XMLXML数据和模板数据和模板 需要在模板中定义的有两类内容： 数据域数据域：需要使用XML数据动态替换的数据字段 循环控制命令标记循环控制命令标记：当报表运行的时候，根据XML数据自动进行循环 控制的命令标记 XML数据有一个层次结构，换句话说它们存

17、在父子关系。层次关系需要在模板文件中使用嵌 套循环的方式来表现出来。 而XML中的数据元素在模板中则是一个对应的 Placeholder，保证Placeholder中的标记名 称和XML数据中的标记名称相同。 10001 201 XX公司 1 1232 100 10.2 1020 创建创建RTFRTF模板模板 创建创建PlaceholderPlaceholder 在模板中的每个数据域都必须与XML文件中的一个元素对应起来。在设计 报表模板的时候，在模板中为XML数据元素定义 Placeholder。 在报表运行的时候，模版中的 Placeholder 被具有同样标记名称的XML 数据替换 10

18、001 201 XX公司 1 1232 100 10.2 1020 2 234 10 2 20 PlaceholdePlaceholder 创建创建RTFRTF模板模板 定义组定义组 组 定义一个组的目的是告诉 XML Publisher 对重复的数据行进行循环 显示，也就是说需要使用for-each进行数据记录的循环显示 创建创建RTFRTF模板模板 定义页眉和页脚定义页眉和页脚 使用Word内置的功能来定义页眉页脚功能 如果模板中要求多个页眉页脚，使用下面的标记来标示出报表的主体部分 创建创建RTFRTF模板模板 定义页眉和页脚定义页眉和页脚 嵌套模板嵌套模板 1. . 定义子模板定义子模

19、板 子模板标记之间可以使用任何的标记和内容，和模板的主体部分没有任何区别 由于在页眉和页脚中不允许使用窗体域，而当报表页眉页脚中希望插入XML数据的时候， 可以考虑使用嵌套模板。 嵌套模板是在模板中定义一个子模板，然后在需要的地方调用它，如在页眉页脚中调用 它。 2. 2. 调用子模板调用子模板 创建创建RTFRTF模板模板 图片图片 直接插入图片直接插入图片 可以直接在模板中插入 jpg、gif 或 png 格式图片 URLURL链接图片链接图片 OA Media OA Media 库图片库图片 在模板中随意插入一张图片 在设置图片对话框中的网站标签页中，在可选文字中输入如下的URL格式链接

20、 url:http:/image location url:http:/ 在模板中随意插入一张图片 在设置图片对话框中的网站标签页中，在可选文字中输入如下的URL格式链接 url:$OA_MEDIA/image name url:$OA_MEDIA/ORACLE_LOGO.gif 创建创建RTFRTF模板模板 WordWord内置的格式化功能内置的格式化功能 使用Word中的对齐功能来对齐文本、图像、对象和表格 分页符分页符 在分组结束标记之前添加 Ctrl+Enter，使用这个功能会使报表打印的最后有一 空白页，为了避免打印空白页，需要使用XML Publisher的分页别名 页码页码 使用

21、Word的插入页码功能来给模板添加页码 对齐对齐 创建创建RTFRTF模板模板 WordWord内置的格式化功能内置的格式化功能 嵌套表格 单元格对齐 行合并和列合并 表格自动调整：在运行的时候，根据选择的方法自动调整 单元格样式和颜色 重复标题行 防止跨页断行 固定列宽 支持的表格功能支持的表格功能 创建创建RTFRTF模板模板 WordWord内置的格式化功能内置的格式化功能 日期日期 使用Word的插入日期功能来定义模板的日期，这个日期对应的是报表 的发布日期而不是请求允许的日期。 分栏分栏 XML Publisher 支持Word中的分栏功能，使报表输出能够以多栏的方式 打印。 如下是

22、地址簿的多栏打印效果： 创建创建RTFRTF模板模板 模板功能模板功能 为了在特定的元素之后进行分页，只要在元素之前插入如下的命令标记： 这个方法避免了使用Word内置的分页功能导致报表最后会有空白页的情况 页码初始值页码初始值 有些报表要求报表的页码被设置为一个特定的值，可以使用如下 的标记来设置初始化页码： 如XML数据如下： 200 . 页码的初始值为PAGESTART元素的值200 引用参数的值 1 2 分页符分页符 创建创建RTFRTF模板模板 模板功能模板功能 超链接超链接 使用word中的插入超链接功能来插入静态链接 如果超链接包括了模板中的数据元素，可以在运行时动态的创建超链

23、接，在链接地址中按如下格式输入： URL_LINKURL_LINK URL_LINK可以是一个完整的URL地址，也可以使URL地址中的一部 分。它是动态传入的数据元素，如下传入URL的参数： http:/?product=PRODUCT_NAMEhttp:/?product=PRODUCT_NAME PRODUCT_NAME是运行时传入值的数据元素名称 SUPPLIER_URLSUPPLIER_URL SUPPLIER_URL 是运行时传入值的数据元素名称 如下是一个完整的URL地址 1 2 创建创建RTFRTF模板模板 模板功能模板功能 表格表格 XML Publisher 支持通过XML数

24、据来动态创建表格内容和题头 动态创建题头的步骤： 使用 标记的方式来插入题头，并将其格式化为题头。这里不能使 用表单域的功能。 例如报表要求将公司名称显示为题头，XML数据标记名为， 在报表模板中需要显示标题的地方输入即可 通过word的内置功能创建表格的其他内容 在运行的时候，系统自动替换表格中和题头标记的值 创建创建RTFRTF模板模板 模板功能模板功能 复选框复选框 可以在模板中定义复选框，并根据传入的值来决定是否被选中 定义复选框的步骤： 使用word中的复选框型窗体域功能添加复选框 打开复选框型窗体域选项窗口 设置默认值：未选中或选中 在窗体域帮助文字中输入复选框选中的条件表达式，它

25、必须 是一个布尔表达式，只能返回true或false 如：XML数据中包括了的元素，如果的值大于 10000则复选框被选中，则在窗体域帮助文字中输入如下的条件表达式： 10000? 创建创建RTFRTF模板模板 条件格式化条件格式化 IF IF 语句语句 例子 If 语句的有效范围 创建创建RTFRTF模板模板 条件格式化条件格式化 The program was not successful 样板文本中使用样板文本中使用IFIF语句语句 The program was not successful The program was not successful. The program was

26、 successful. 创建创建RTFRTF模板模板 条件格式化条件格式化 1000 then Higher Else if AMOUNT If-then-ElseIf-then-Else 语句语句 创建创建RTFRTF模板模板 条件格式化条件格式化 Choose Choose 语句语句 创建创建RTFRTF模板模板 条件格式化条件格式化 格式化列格式化列 根据条件显示或隐藏列 当条件满足的时候加亮行 设置行的背景颜色 满足条件的时候才显示行 lightgray 根据条件来格式化表格的行 格式化行格式化行 创建创建RTFRTF模板模板 条件格式化条件格式化 创建创建RTFRTF模板模板 条件

27、格式化条件格式化 red 1000? red 单元格加亮单元格加亮 可以根据条件来加亮单元格 创建创建RTFRTF模板模板 页面级别的计算页面级别的计算 TotalFieldName：合计值对应的字段 element：被合计的XML元素名称 计算合计值计算合计值 可以对多个字段进行合计，由于页合计在XML数据中是不存在的，所以需要 定义一个变量，定义变量的同时将计算的字段关联起来了 创建创建RTFRTF模板模板 页面级别的计算页面级别的计算 显示页合计显示页合计 TotalFieldName：合计值对应的字段 number-format：合计值显示的格式 创建创建RTFRTF模板模板 页面级别

28、的计算页面级别的计算 结转合计结转合计 某些报表要求将页的合计显示在页尾和下一页的页头，这种合计叫做 结转合计。下面是结转合计的例子： 在第一页的尾部显示了页的合计；在第二页的顶部结转显示了第一页的合 计，依次类推 创建创建RTFRTF模板模板 页面级别的计算页面级别的计算 结转合计结转合计( (续续) ) 需要在页码的顶部实现结转合计，只要在每页的(除了第一页)顶部使用如 下的语句： Brought Forward: 创建创建RTFRTF模板模板 页面级别的计算页面级别的计算 连续合计连续合计 报表实现如下的累积合计值 1. 1. 定义变量定义变量 2. 2. 添加每行值添加每行值 3. 3

29、. 显示累积合计值显示累积合计值 xdoxslt:get_variable($_XDOCTX, Variable Name)? xdoxslt:get_variable($_XDOCTX, RTotalVar)? 创建创建RTFRTF模板模板 数据处理数据处理 排序排序 可以使用组中的字段对组进行排序，在组标记内插入如下的命令标记： 也可以对组中的多个字段进行排序： 创建创建RTFRTF模板模板 数据处理数据处理 对对XMLXML数据从新分组数据从新分组 XML Publisher提供了对XML数据从新分组的功能，这样报表可以根据需要随意 进行层次结构的从新组织，无需按照原有的结构显示 为了在

30、已定义的分组中再进行分组，使用如下的命令标记实现嵌套分组： 在运行时，XML Publisher根据新的分组规则，循环显示模板中定义的字段 值，使用如下的命令标记显示显示的信息： 使用上述的语法方式，可以通过表达式来进行分组： 创建创建RTFRTF模板模板 变量、参数和熟悉变量、参数和熟悉 变量使用“set get”的方式来分配、更新和取得变量的值 使用变量使用变量 ?xdoxslt:set_variable($_XDOCTX, x, xdoxslt:get_variable($_XDOCTX, x + 1)? 创建创建RTFRTF模板模板 变量、参数和属性变量、参数和属性 这个语法必须在窗体

31、域帮助文字中使用，窗体域可以放到模板中的任意位置 定义参数定义参数 PARAMETERNAME：参数的名称 DEFAULT：参数的默认值，select可以省略 xdofo:ctx=“begin“ 是必须的，它代表了在模板开始的时候就声明变量 可以传递运行时参数给模板，但是Oracle Application并发管理器不支持传参 数给模板，只能在程序中通过API传递参数 创建创建RTFRTF模板模板 变量、参数和属性变量、参数和属性 模板中使用参数的方法是在参数名称前添加$字符， 如：声明了参数“InvThresh”，则通过”$InvThresh”来引用它 引用参数引用参数 也可以在API中通过

32、程序来引用参数值 Properties prop = new Properties(); prop.put(xslt.InvThresh, 1000); 创建创建RTFRTF模板模板 数字和日期格式化数字和日期格式化 Oracle的抽象日期格式掩码语法 抽象日期格式化抽象日期格式化 抽象日期格式掩码列表 使用模板管理器使用模板管理器 模板管理器模板管理器 / Template Manager/ Template Manager 注册、查看和更新模板 维护数据定义，使数据源和模板关联起来 创建和维护 PDF 表单域和XML元素之间的映射关系 导出和上传翻译转换 XLIFF文件 根据样例数据预览模

33、板 为了在模板管理器中定义一个模板： l 首先为模板创建数据定义 l 然后注册布局模板文件 路径：XML Publisher Administrator Templates XML PublisherXML Publisher数据定义数据定义 XML Publisher Administrator Data Definitions XML PublisherXML Publisher数据定义数据定义 Name：数据定义的名称，建议输入一个友好的名称 Code：如果使用 Oracle Application 并发管理器来产生XML数据，那这个代码必须并发程 序的简称相同 Application：

34、从LOV选择报表对应的应用 Start Date：数据定义的有效起始日期 XML Schema：如果满足下面的两个条件则必须设置使用的 XML Schema： l 数据定义需要赋给一个 PDF 类型的模板 l PDF 类型的模板要求字段映射 End Date：数据定义一经保存就不能够删除，只能通过此字段来失效数据定义 Preview Data：为了能够使用模板的预览功能，需要上传一个XML样例数据 Data Template：内部使用 数据定义说明数据定义说明 数据定义创建之后，除了数据定义创建之后，除了 Application Application 和和 Code Code 之外的字段都可以修改之外的字段都可以修改 XML PublisherXML Publisher模板定义模板定义 XML Publisher Administrator Templates XML Pub