Oracle XML Publisher
Oracle XML Publisher
一、什么是XML?
XML (extensible Markup Language)
最简单的定义就是:「遵守特定规则的文字」,而这些规则跟HTML的规则很像,但更严谨一些,并加上些补强
1998/2由全球信息网协会(World Wide Wed Consortium;W3C) 提出与制定的一种规格
主要语法:Tag成对出现的语法,例如<Name> ….. </Name>
XML的批注与HTML语法相同,都是利用<!--批注内容-->来表示
XML(data+metadata), XSL(style sheet;presentation)
(一)、preparation(准备)
1.Microsoft Word
2.Java Runtime Environment (JRE) version 1.4 or later
3.Oracle XML Publisher Template Builder for Word
4.Add “XML Publisher Administrator” to your responsibility and Re-login
5.Concurrent Program Output Post Processor MUST active
6.Profile - FND: NATIVE CLIENT ENCODING MUST set to UTF8
(二)、修改report中的属性,设置encoding=“UTF-8”
(三)、生成XML文档
1、打开Template Builder.
- 导入XML Data
2、导入XML DATA
选择有Report Builder所生产的XML档
3.建立模板.
使用手动的方式在Word下建立如下模板
4.预览
预览:Template Builder->Preview->RTF
Tag-Group
- Template的建立过程中,Group的概念很重要。
Group:一笔资料就是为一个group.
Group可以嵌套循环。 - 例如:一张PO的资料包括header和line两部分。可以把这两部分Header和Line的资料看成是一个Group,同时也可以把Line的每一笔资料做为一个Group,嵌套在Header中。
<?for-each:<group name>?>做为一个Group的开头,放在资料的第一个Field的前面。
<?end for-each?>做为一个Group的结尾,放在资料的最后一个Field的后面。
Tag-<?<Field Name>?>
- <?<Field Name>?>为一Field的引用,<Field Name>栏位名必须与XML里面的一样,区分大小写。
- 在报表的执行过程中,<?<Field Name>?>将由XML里面对应的Element所取代。
Tag-<?sort:<Item_Column>?>
- <?sort:<Item_Column>?>为排序Tag
- 可以使用Group中的任何Element做为排序的准则。
- 如果需要多Element的排序,可以使用如下的方式
<?sort:<Item_Column1>?><?sort:<Item_Column2>?>
- 降序排序:<?sort:<Item_Column>; 'descending'?>
- 升序排序:<?sort:<Item_Column>; ‘ascending'?>
- 例如:<?sort:PO_NUM?> 将按PO单号排序
- 排序有分按Date/Text还是按Number排序。按Date/Text,400将排在50前面。
例如:<?sort:PO_NUM;'descending';data-type='text'?>
<?sort:PO_NUM;'ascending';data-type='number'?>
Tag-Page Break
- 可以使用<?split-by-page-break:?>进行分页
- 在Group的结束标志符<?end for-each?>前加上<?split-by-page-break:?>,当该group结束后将会自动分页,下一个group的资料将show在下一页里。
Tag-Section
- 有时一张report中包含了很多资料,比如一张report中包含多张PO的资料,而页码、页面加总的要根据不同的PO进行重置。如果页眉和页脚也使用了body里面的一些元素,这时候也需要重置。
使用<?for-each@section:group name?>可以达到这样的效果
Insert an image in the template
url也可以XML里面的一个元素(当这个元素为完整的图片URL):
url:{IMAGE_LOCATION}( IMAGE_LOCATION为group中一元素)
url中也可以是只是一个目录而已:
url:{’${OA_MEDIA}/image name’}( OA_MEDIA->为一个目录)
例如:url:{’${OA_MEDIA}/ORACLE_LOGO.gif’}
- 如果是多个截断的,也可以用concat这个function进行串联:
- 例如:
- url:{concat(SERVER,’/’,IMAGE_DIR,’/’,IMAGE_FILE
- url:{concat(’${OA_MEDIA}’,’/’,IMAGE_FILE
- 利用Report Builder生成.rtf报表,不需生成其layout,然后点选File ->Generate to File ->XML 生成XML文档
(四)、XML资料格式------ test.xml
- XML文档中的encoding为UTF-8,以减小出现乱码的可能性