Oracle+XML+Publisher在Oracle+R11i中的实际运用

1、oracle xml publisher在oracle r11i中的实际运用客户在实施oracle e-businsess suite时,会有大量客户化开发需求. 首要的需求往往是客户化报表; 在早期的erp版本, 客户化及系统报表, 只能通过文本模式或html格式查看输出结果. 样式比较单一, 报表格式往往不能满足客户需求.在后期的ebs版本中, 使用pdf格式或postscript格式输出的报表方法日益普遍和成熟, 但也存在一些问题, 例如在utf8等字符下的pdf报表输出问题(参考metalink note: 222663.1,189708.1,333504.1等), postscrip

2、t输出格式调整等; 客户化开发人员需要花费很多精力去调整报表格式, 如果格式需求发生变化,开发人员不得不重新定制报表. 同时,对于pdf,ps等格式的输出, 系统管理员在后台还必须做很多配置工作. 配置不当则容易引起ps报表乱码或format格式问题. 使用xml publisher报表输出工具,可以轻松解决报表格式输出的调整问题.并满足客户多种格式(如word,pdf)的需求.目前, 在11.5.10及以上的ebs版本,已经集成xml publisher 报表输出工具, 对11.5.10以下的版本,也提供了patch供客户升级. 使用xml publisher, 将客户化报表开发工作和客户化

3、报表格式调整工作完全分离开来, 开发人员可致力于报表sql(数据源)的调整, 报表格式方面的调整需求可通过xml publisher轻易实现, 并且满足word,pdf,excel,html等各种格式的不同需求.以下用ebs系统自带的标准报表为例子,简要介绍如何通过xml publisher调整报表格式, 以及在ebs系统中需要做的设置.实例:gl职责标准报表: 按单据编号列出日记帐(journals - document number , 报表简称: glrsgnj), 我们需要对该报表重新做xml格式设计,调整输出内容需求,并将新的报表输出格式挂接到ebs系统中.步骤一. 报表模板的设计设

4、置正确的profile和客户首选项检查profile “fnd: native client encoding”; 用户首选项：客户机字符编码等设置; 本例在ebs utf8环境中测试,因此设置以上选项为utf8; 如果profile设置不正确, 则在第二步(设置报表格式为xml)中，查看输出可能会遇到错误：the xml page cannot be displayed. cannot view xml input using xsl style sheet. please correct the error and then click the refresh butto

5、n, or try again later,参考note:369943.1设置报表格式为xml：在系统管理员并发方案定义中，查询出需要更改的报表，将报表输出设置为xml格式本例将” journals - document number”报表的输出格式选项修改为”xml”3. 运行更改后的报表切换至gl职责, 运行” 日记帐 - 单据编号”报表, 报表运行完成后，点击查看输出按钮，可看到报表输出变为xml格式, 例如生成文件为: - - - - 1781 - - jp gl journal entry 1781 fnd_doc_seq_1781_s 1 a - - 1 24-10-03 已输入

6、ar 38639 receivables 2547771: a 38639 trade receipts usd 商业收据 1781 已过帐 28-10-03 usd 13000 13000 1 0 13,000.00 13,000.00 80 0 80 . 163298699320 jp gl journal entry 163298696320 已输入 已删除 未输入 jp gl journal entry 163298699320 163298696320 1 dd-mon-yyyy xml文件中红色部分为数据结构部分, 黑色字体为数据部分, 开发人员无需关心如何读懂xml文件,直接将x

7、ml文件保存至本地即可.例如,保存为journals_document_number.xml文件4. 在开发员的客户端安装”oracle xml publisher desktop”xml publisher desktop等xml工具可在otn网站下载, 在客户端安装完成后，新建一个rtf文档做为该报表的输出模板，可看到在word上已经自动添加了数据/插入/预览/工具/帮助等工具栏.注:可选择新建空白word文档,也可选择按已有的word模板新建一个输出模板.新建的文档存为rtf文件5. 在rtf模板上点”数据/装入xml数据”在步骤4建立的rtf模板上, 点”数据/装入xml数据”工具栏,

8、 选择步骤3保存的xml文件: journals_document_number.xml. 系统提示 ”已成功装入数据”, 如下图:6. 初步设计报表格式根据客户需求,用word的方法定义报表题头,增加logo,页眉页脚等.报表格式可随时更改,采用windows word等工具即可, 开发人员无需在oracle report builder等软件中对客户化报表的布局进行繁琐的调整.以上步骤搭建了一个基本的xml报表模板, 以下步骤开始涉及调整报表输出内容和格式.在本例中,我们需要更改glrsgnj报表的传统输出模式,对按商业类别划分的日记帐单据进行借项统计做出饼图, 并同样对按商业类别划分的日

9、记帐单据进行贷项统计并做出条形图, 然后象标准的glrsgnj报表一样,按单据编号列出日记帐明细信息.7. 在模板上点”插入/图表”,插入饼图通过模板工具栏/插入/图表,选择插入饼图,并定义分组和运算规则. 例如,在此例子中,我们插入饼图,按category(商业类别)分组,对借项数额求和:8. 在模板上点”插入/图表”,插入条形图通过模板工具栏/插入/图表,选择插入条形图, 并定义分组和运算规则. 例如,在此例子中,我们插入垂直条形图,按category(商业类别)分组,对贷项数额求和:9. 在模板上点”插入/表单/高级”在模板上选择工具栏”插入/表单/高级” 后,会出现弹出窗口”插入表/表

10、单”,rtf模板会根据我们在步骤5导入的xml数据,列出可用的数据源.将报表显示中需要的数据源拖至模板栏,客户可根据需要自由选取或删除不需要显示在报表上的数据列.在窗口最右边的栏目,会显示”预览”和相关属性对于数据列的含义, 如果格式设计人员不十分清楚,在选择工具栏” 插入/字段”时,可看到对每个数据列都有详细实例说明:开发人员也可按客户需求对表单格式进行分组排序,例如, 在弹出窗口”插入表/表单”右边的属性栏目中, 按照单据编号排序或按商业类别排序.输出内容设计完成后,可以用word工具更改变量字段的格式属性等,例如,在表格中双击变量字段,将表格中借项/贷项的属性改为数字型,将过帐日期(po

11、sted_date)等日期变量属性更改为日期型等:10. 报表格式的细化和调整通过以上步骤,我们给新的glrsgnj报表增加了按商业类别对借项金额做的饼图统计,按商业类别对贷项金额做的条形图统计,以及日记帐单据明细表等. 客户需要看到的报表输出我们通过以上设计已经轻松获得.我们可以通过word工具,进一步调整报表字体及字体大小, 增加图表的题注, 调整分页符等, 这些步骤都完全通过word工具实现,这里就不再赘述完成格式调整后,通过rtf模板的”预览” 工具栏, 可以按pdf,rtf,excel或html格式预览你设计的报表格式.如有需要则可进一步调整格式.将格式调整完成的模板保存在本地,命名

12、为: glrsgnj.rtf步骤二. 报表模板在ebs中的设置我们在步骤一中,对glrsgnj报表设计了新的报表模板并保存在客户端本地电脑中, 现在,我们通过以下步骤,将新的报表模板:glrsgnj.rtf挂接到ebs系统中, 使客户可在ebs系统中运行glrsgnj报表, 并按我们设计的报表模板, 生成pdf等格式的报表输出1. 创建新的数据定义添加”xml publisher 管理员”职责, 进入该职责”home/data definitions”选择”创建新的数据定义”, 输入名称,应用产品,起始日期,代码等字段.注意: 代码字段需和报表程序简称一致,例如,在”系统管理员/程序/定义”中

13、,查询” 日记帐 - 单据编号”的代码为glrsgnj, 则此处代码字段为glrsgnj2. 创建新的模板在”xml publisher 管理员”职责, 进入该职责”home/templates”在”general”栏目中: 选择”创建新的模板”, 输入自定义的模板名称,选择和该报表相关的应用产品, 起始日期,代码等字段选择在步骤1创建的数据定义在”template file”栏目中:选择我们在步骤一.”报表模板设计”中创建的rtf模板: glrsgnj.rtf, 并选择相应的语言和地区格式, 如下图为本文例子在ebs里定义的模板模板完成后,我们就可以修改报表格式为xml格式,并按我们设计的模

14、板输出报表了.我们可对同一个报表加入不同格式的template .以满足不同的客户对格式的不同需求.3. 检查报表定义在”系统管理员/程序/定义”中,检查报表” 日记帐 - 单据编号”的格式定义为”xml”类型4. 运行报表检查在gl职责,提交运行” 日记帐 - 单据编号”报表在”option”选项, 客户可选择他所需要的template模板布局和输出格式:报表运行正常完成后, 用户即可按我们定义的格式看到报表输出,以下图中的输出为例, ” 日记帐 - 单据编号”报表以pdf格式输出,客户除可看到单据明细表外,还可看到按商业类别进行的借项,贷项统计饼图和条形图: 通过以上实验,我们已经大致介绍

15、了xml publisher在ebs中的运用, 如何采用xml publisher在ebs中创建格式更加灵活的报表. 客户如对xml publisher有更多的兴趣, 可访问我们的metalink网站和otn网站, 阅读以下文档:1. 362496.1 2. 295036.1 3. 316447.1 4. 337999.1 5. 357308.1 6. 367394.1 7. 8. 附注: xml publisher 5.6.2 java api :packagesoracle.apps.xdooracle.apps.xdo.batchmon.lobmon.pdf.utiloracle.apps.xdo.dataengineoracle.apps.xdo.deliveryxml publisher delivery api.oracle.apps.xdo.delivery.ftp