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,以减小出现乱码的可能性