rtf模板常用技巧

Posted 2020-09-21

以下是一些在开发XMLP（BIP）报表的时候，开发RTF模版的一些技巧：
1、word表格
做RTF模版的时候，采用word中的表格来进行设计，下面的几点很重要：
（1）标题行重复，可以实现新页重复标题。
（2）嵌套表格、行列合并、边框、底纹，可以实现特殊的布局。
（3）固定列宽、自动调整、禁止跨页断行，可以实现一些严格的布局控制。
2、行截断与禁止折行
单据打印中对格式的要求比较高，如果某一行过长或者出现多次折行，就会破坏版面，尤其是套打等要求较高的场合，这里把各种方法作个小结。其实，这个地方更网页开发很像，是否换行输出就跟html中的word-wrap和word-break非常类似，可以参见《word-wrap和word-break的区别》，如果要设置超出显示，也几乎跟css中的overflow:hidden是一样的。
（1）Word功能，不理想
固定列宽功能可以用，但固定行高不行，虽然设计时看到“固定”了，如果不加控制，运行后多出列宽的数据会自动折行。
（2）单行+截断，即控制只有以一行，多余截断，禁止折行。
在字段的后面，再加如下两个命令：
<xsl:attribute xdofo:ctx="block" name="wrap-option">no-wrap</xsl:attribute>
<xsl:attribute xdofo:ctx="block" name="overflow">hidden</xsl:attribute>
（3）多行+截断，难
如固定显示3行，多余部分截断，目前通过模版无法实现，只有在数据源中先将数据截至刚好3行的字符数，然后利用自动折行功能。这里还要注意空格，如果遇到空格，后面的单词又显示不下，将会提前自动折行。
3、条件格式化
在不同的条件下显示不同的颜色、不同的列数、不同的标题、不同的布局风格等等，这些都属于条件格式化，需要借助IF命令。
（1）比如不同币种凭证打印格式不同：
<?if:CURRENCY_CODE="CNY"?>任何布局<?end if?>
<?if:CURRENCY_CODE!="CNY"?>任何布局<?end if?>
（2）比如货币为CNY时才显示列，在目标列的单元格内写如下语句：
<[email protected]:CURRENCY_CODE="CNY"?>字段值和格式<?end if?>
注：这还不是真正的动态列。
（3）比如偶数行底色为灰色，在行的任何单元格内写如下语句：
<[email protected]:position() mod 2=0?>
<xsl:attribute xdofo:ctx="incontext" name="background-color">gray</xsl:attribute>
<?end if?>
<?if:position() mod 2=0?>
<xsl:attribute xdofo:ctx="incontext" name="background-color">gray</xsl:attribute>
<?end if?>
注意position()的意义，position()表示的是在XML数据源文件中，该条数据所处该组中全部数据中的位置，比如如果该组有10个明细行要显示，当显示到第三个明细行的时候，position()的值就是3。还有一个last()，该前面那个例子中，last()的值就是10，即最后一个明细行，有时候会用position()=last()来判断是否已经把全部明细行都显示了，非常有用。上面的那两段代码，加了@row则会使得该行全部变色，如果没有加，就表示只对加了该段代码的单元格变色。
（4）比如超过100单元格呈红色，在目标单元格内写如下语句：
<?if:QUANTITY>100?>
<xsl:attribute xdofo:ctx="block" name="background-color">red</xsl:attribute>
<?end if?>
4、字段计算建议做法
（1）计算字段可以先在SQL中完成。
（2）如果使用Oracle Reports做数据源，那么计算字段、统计字段也可以先完成。
（3）在SQL中的数据，都不带格式，格式在模版中设置；需要在模版中完成计算的字段，必须不带格式，主要指数字不能带千位符号。
5、组内合计
N: Template Builder/插入/字段
向导可以完成基本的统计，目前支持分组内的：Sum、Count、Min、Max、Avarage。
自动生成的代码示例：
<?sum (QUANTITY)?>
6、页内合计
要实现本页合计数，需分两步：声明合计变量、显示合计变量（可带格式）。
（1）对QUANTITY进行本页合计，声明变量QTYTOTAL，注意写在QUANTITY对应的组内，不然引用不到。
<?add-page-total:QTYTOTAL;’QUANTITY’?>
（2）可在任意地方显示合计数
<?show-page-total:QTYTOTAL?>
7、累计数
累计每行数字，实际上是这样完成的：先声明一个变量，初始化为0；累加；在需要的地方显示累计。
（1）在分组标记前初始化，Set变量。
<?xdoxslt:set_variable($_XDOCTX,’RTotalVar’, 0)?>
（2）计算累计值，通常写在欲累计的字段同一单元格内，比如下面的QUANTITY。
<?xdoxslt:set_variable($_XDOCTX, ‘RTotalVar’, xdoxslt:get_variable($_XDOCTX,’RTotalVar’) + QUANTITY)?>
（3）任意地方显示累计值，Get变量。
<?xdoxslt:get_variable($_XDOCTX,’RTotalVar’)?>
8、新组分页
下面几种方式都可以实现新组分页，下面的序号是表示方法，不是步骤：
（1）分组声明中加@section，如下：
<[email protected]:G_PO_HEADER?>
（2）<?end for-each?>前加<?split-by-page-break:?>。
（3）<?end for-each?>前加<xsl:attribute name="break-after">page</xsl:attribute>，此法下RTF最后无空白页，但PDF有空白页。
（4）<?end for-each?>前加<xsl:attribute name="break-before">page</xsl:attribute>此法下RTF、PDF最后都有空白页。
见得比较多的是直接用（1）的方法。
9、条件分页、固定行分页
（1）任意条件分页，需要借助IF + 上面的break-after或者break-before，如：
<?if:CURRENCY_CODE="CNY"?>
<xsl:attribute name="break-before">page</xsl:attribute>
<?end if?>
（2）固定行分页，需要借助IF + 上面的break-after或者break-before，在行<?end for-each?>前，如下语句控制每页5行：
<?if:position() mod 5 =0?>
<xsl:attribute name="break-before">page</xsl:attribute>
<?end if?>
10、页眉页脚
（1）标准的页眉页脚，即单个页眉页脚，使用Word的功能即可。
（2）扩展的页眉页脚，可使用<?start:body?><?end body?>把主体部分“框”起来，凡是在这两个标记之外的东西，都将被当作页眉页脚。
11、页码和页数
（1）可以利用word的功能，在任意地方插入页码，这个是“自然页码”。
（2）如果在某种情况下想让页码从特定值开始，比如新组页码重新编号，则需要借助命令，如在for-each后写：<?initial-page-number:1?>。这里的1，实际上也可以用数据文件中的XML元素来替换。
12、末页、奇偶页不同
（1）Word可在页眉页脚部分实现首页不同或奇偶页不同，没法实现末页不同，即使借助代码控制，实际实现的也是末页布局不同，而非“页眉页脚”不同。
<[email protected]:body?><?end body?>
报表本身仅有一页时，则用：
<[email protected]:body?><?end body?>
注意布局需要独立成页，即之前需要加分页符。
（2）以偶数页结束，主要目的是显示偶数页页眉页脚。
<?section:force-page-count;’end-on-even-layout’?>
如果仅显示空白页，则用：
<?section:force-page-count;’end-on-even’?>
（3）以奇数页结束，主要目的是显示奇数页页眉页脚。
如果仅显示空白页，则用：
<?section:force-page-count;’end-on-odd’?>
13、超链接
可以直接利用word功能设置超链接，也可以在链接地址中，全部或部分引用XML数据文件中的标记，做到动态超链接：
{SUPPLIER_SITE_URL}或者http://abcd.efg.com:8000/OA_MEDIA/{CURRENCY_CODE}.gif
14、图片
可以直接利用Word功能插入图片，也可以仅将该图片当作占位图，在图片的“设置图片格式”的网站标签页内的“可选文字”，可参考《word技巧：设置图片格式》，输入真正的图片地址：
（1）来自网站的图片：url:{‘http://localhost:8000/OA_MEDIA/forms_logo.gif‘}
（2）来自EBS的图片：url:{‘${OA_MEDIA}/forms_logo.gif‘}
（3）动态指定地址：url:{IMAGE_URL}
（4）动态拼接的地址：url:{concat(SERVER,‘/‘,IMAGE_DIR,‘/‘,IMAGE_FILE)}
（5）直接来自内容为BLOB的XML元素，仅用于“Data Templates”：
<fo:instream-foreign-object content-type="image/jpg">
<xsl:value-of select="IMAGE_ELEMENT"/>
</fo:instram-foreign-object>
15、图表
可使用Template Builder向导插入图表，类型有：条形图-垂直、条形图-水平、饼图、线形图。向导生成的代码，可在图片的“设置图片格式”网站标签页内的“可选文字”里看到，我们可以做进一步修改。
16、字段引用
在前面的窗体域中，我们直接引用XML文件中的Tag标记，如<?QUANTITY?>。这种对XML元素的引用，是相对当前层次的组来说；如果上层组中，有个同名Tag，就要通过类似“相对路径”的方式引用，如<?../QUANTITY?>。这里的“../”个数，不是布局中的相对层测个数，而是XML数据文件中的相对层次！详细可参见《Oracle BI Publiser报表开发中的路径、层级问题》。
17、函数引用
（1）行号，准确讲是分组中记录顺序号：<xsl:value-of select="position()"/>
（2）总行号：<xsl:value-of select="last()"/>
18、空值判断
（1）有标记，值不为空
<?if:Element_Name!=""?>Something Here<?end if?>
（2）有标记，值为空
<?if:Element_Name and Element_Name=""?>Something Here<?end if?>
（3）无标记
<?if:not(Element_Name)?>Something Here<?end if?>
19、嵌套模版/子模版
嵌套模板是在模板中定义一个子模板，然后在需要的地方调用它，如在页眉页脚中调用它，这样也可以突破页眉和页脚中不允许使用窗体域的限制。
（1）定义子模版
<?template:internaltemplate YOUR_TEMPLATE_NAME?>
……
<?end template?>
（2）调用子模版
<?call:internaltemplate YOUR_TEMPLATE_NAME?>
其他的一些技巧，以后在开发的过程中，遇到了再加入