报表¶

OpenERP 主要有三种类型的报表:

OpenOffice.org 报表

XML 报表

自定义报表 (基于 PostgreSQL 视图，显示在界面上)

这一部分主要描述 OpenOffice.org 报表, 和 XSL:XML 报表. 自定义报表在高级建模部分描述 - PostgreSQL 基于数据库视图的报表.

OpenOffice.org 报表¶

文件流

OpenOffice.org是OpenERP中最常用的报表格式。OpenOffice.org Writer被用来生成RML模板，而RML模板用来生成pdf报表。

内部过程

.SXW 模板文件

我们用OpenOffice1.0的.sxw文件作为模板。模板中包含用中括号括起来的表达式或OpenOffice字段(field)，用来提供给OpenERP server填充数据。但这只是作为帮助开发者更直观地生成.RML文件的一种方法。OpenERP并不需要SXW文件产生报表。

.RML 模板

可以使用Open SXW2RML从SXW文件生成RML文件。RML文件是一种表现PDF文档的XML格式，可以转换为PDF文件。RML是一种更容易的方法，至少XML语法比PDF语法更加通俗易懂。

报表引擎

报表引擎(report engine)从数据库中读出数据，插入在RML文件的表达式中。

在.RML文件中，将以发票上客户的城市名称替换掉相应表达式。报表引擎以真实数据替换所有表达式之后，生成相同的.RML文件。

生成最终文档

最后RML文件会根据OpenReport代码的需要，转换成PDF或者HTML文件。

生成 SXW 文件¶

你可以使用 OpenOffice 设计报表。举个例子，如： server/bin/addons/sale/report/order.sxw.

OpenOffice 报表中的动态内容¶

动态内容

SXW/RML报表中，你可以在中括号中加入Python代码，以获得OpenERP中的对象(object)。代码可以使用如下变量

可用的变量

可以用的 Python 对象/变量:

objects : 将要打印的object记录(例如发票（invoice)对象）.

data : 向导(wizard)中获得的数据

time : Python的time模块(详见Python文档).

user : 运行这个报表的用户.

可用的函数

可以用的 Python 函数:

setLang(‘fr’) : 设置语言，用于自动取得对应翻译.

repeatIn(list, varname[, tagname]) : 遍历模板当前部分list中的对象 (整个文档, 当前段落, 表格中的当前行)，可以在模板中使用varname作为变量名。从 4.1.X版开始, 你可以使用第三个(可选的)参数指定循环结果放在哪个.RML标记中.

setTag(‘para’,’xpre’) : 在由sxw转换rml文档过程中，替换指定标记。这里是用xpre替换para (xpre 是一个预定义格式的段落)。(?)

removeParentNode(‘tr’) : 移除类型’tr’的父结点, 这个参数经常在条件语句中使用 (如下例)

标签示例:

[[ repeatIn(objects,’o’) ]] : 循环objects，指定变量名为o.

[[ repeatIn(o.invoice_line,’l’) ]] : 对o的invoice_line循环，指定变量名为’l’.

[[ repeatIn(o.invoice_line,’l’, ‘td’) ]] : 循环每行，并为每行数据创建一个单元格

[[ (o.prop==’draft’)and ‘YES’ or ‘NO’ ]] : 根据变量‘prop’输出YES或 NO

[[ round(o.quantity * o.price * 0.9, 2) ]] : 可以进行变量计算.

[[ ‘%07d’ % int(o.number) ]] : 数字的格式化输出

[[ reduce(lambda x, obj: x+obj.qty , list , 0 ) ]] : 列表中所有对象 qty 字段值的和 (可以试一下用 “object” 作为列表变量)

[[ user.name ]] : 打印报表的当前用户名

[[ setLang(o.partner_id.lang) ]] : 从变量中取得语言

[[ time.strftime(‘%d/%m/%Y’) ]] : 以dd/MM/YYYY格式输出时间, 查阅python文档获得关于“%d”的帮助, ...

[[ time.strftime(time.ctime()[0:10]) ]] 或 [[ time.strftime(time.ctime()[-4:]) ]] : 只输出日期.

[[ time.ctime() ]] : 输出当前日期 & 时间

[[ time.ctime().split()[3] ]] : 只输出时间

[[ o.type in [‘in_invoice’, ‘out_invoice’] and ‘Invoice’ or removeParentNode(‘tr’) ]] : 如果type是 ‘in_invoice’ 或‘out_invoice’ 那么输出 ‘Invoice’；如果不是，‘tr’类型的父节点会被删除.

一个有趣的标记(tag)：如果想输出当前记录的创建者(create_uid)或者最后一位修改者你需要在报表要输出的类中加入如下字段:

'create_uid': fields.many2one('res.users', 'User', readonly=1)

然后在报表中用这个变量输出相应的名字:

o.create_uid.name

有时你希望根据条件打印。你可以用python的逻辑操作符＂not＂,＂and＂,＂or＂构造自己的判断语句。 Python中的每个对象都有自己的逻辑值(TRUE或FALSE):

(o.prop=='draft') and 'YES' or 'NO' #prints YES or NO

注意and要比or的优先级高，表达式等价为:

((o.prop=='draft') and 'YES') or 'NO'

如果 o.prop是 ‘draft’, 那么计算结果为:

o.prop == ‘draft’ 为 True.
True and ‘YES’ 为 ‘YES’. 左项为真时, 返回右项, 否则返回左项.这里返回字符串’YES’.
‘YES’ or ‘NO’ is ‘YES’. 左项为真， or操作会忽略右项。只计算左项值.返回字符串’YES’.

如果 o.prop 是‘confirm’之类其他的操作, 那么计算如下:

o.prop == ‘draft’ 为 False.
False and ‘YES’ is False. 因为左项为 “false” 值, and 操作截断并忽略右项. 只计算左项.
False or ‘NO’ is ‘NO’. 因为左项为 “false” 值, or 计算右项.

可以使用更复杂的的结构。可以参照python 手册章节 `Python’s boolean operators`_ 。

可以用python的“filter”函数。示例:

repeatIn(filter( lambda l: l.product_id.type=='service' ,o.invoice_line), 'line')

只输出每段中product 含有 type=’service’的行.

报表中显示二进制字段图像

[[ setTag('para','image',{'width':'100.0','height':'80.0'}) ]] o.image or setTag('image','para')

SXW2RML¶

Open Report 手册¶

关于¶

The OpenERP 的报表引擎.

Open Report 是一个模块，可让您从OpenOffice的模板文件（sxw）和任何关系数据库中渲染出高质量报表。它可以用来作为OpenERP模块或作为独立的程序.

SXW 转 RML 代码的安装，适用于Windows用户¶

为了使用python代码‘tiny_sxw2rml.py’，你需要安装如下包:

Python (http://www.python.org)

ReportLab (http://www.reportlab.org)/(Installation)

Libxml for Python (http://users.skynet.be/sbi/libxml-python)

SXW 转 RML 代码的安装，适用于linux用户¶

tiny_sxw2rml.py 可以在OpenERP 模块 base_report_designer 中找到:

server/bin/addons/base_report_designer/wizard/tiny_sxw2rml/tiny_sxw2rml.py

确认 normalized_oo2rml.xsl 和 tiny_sxw2rml 在一起，否则你会遇到如下错误:

failed to load external entity normalized_oo2rml.xsl

使用 tiny_sxw2rml¶

当你做好必要的准备，打算编辑您自己的报表模板(template)时，使用如下命令:

tiny_sxw2rml.py template.sxw > template.rml

注释: tiny_sxw2rml.py 帮助建议你使用”-o OUTPUT”指定输出文件，但貌似0.9.3版本不支持

OpenERP Server PDF 输出¶

Server PDF 输出¶

关于¶

要根据rml文件生成pdf，OpenERP需要一个rml解释器.

解释器¶

语法解释器可以在模块中添加。例如如下代码:

import time
from report import report_sxw

class order(report_sxw.rml_parse):
    def __init__(self, cr, uid, name, context):
        super(order, self).__init__(cr, uid, name, context)
        self.localcontext.update({
            'time': time,
        })

report_sxw.report_sxw('report.sale.order', 'sale.order',
      'addons/sale/report/order.rml', parser=order, header=True)

解释器继承自 report_sxw.rml_parse 对象并且增加了localcontext变量和函数 time，因此在报表中可以调用.

report_sxw.report_sxw 实例生成之后，需要如下参数:

报表的名字

report关联的object名字

rml文件的路径

默认的rml解释器(默认为rml_parse)

在公司配置报表头部(默认为true)

'external' (默认)

'internal'

'internal landscape'

False - 使用报表自己定义的报表头

xml 定义¶

如果要在 client端可见, 报表应该声明在一个 xml 文件中 (一般格式为: “module_name”_report.xml) ，这个文件应该列进 __openerp__.py 文件

下面是销售订单报表的例子:

<?xml version="1.0"?>
<openerp>
        <data>
                <report
                        id="report_sale_order"
                        string="Print Order"
                        model="sale.order"
                        name="sale.order"
                        rml="sale/report/order.rml"
                        auto="False"/>
                        header="False"/>
        </data>
</openerp>

参数如下:

id: OpenERP中的报表id，类似openerp中的其他xml标记

string: 客户端按钮显示的文字

model: 报表中用到的object

name: parse中注册的报表名字去掉”report.” 之后的部分

rml: rml 文件路径

auto: 指定server是否生成默认的解释器

header: 是否允许页眉(report header)。如果需要编辑, 进入如下菜单: Administration -> Users -> Company’s structure -> Companies. 选择并编辑您的公司: 其中 “Header/Footer” 标签允许你编辑相应的 header/footer.

XSL:RML 报表¶

XML 报表不需要编程，但是需要两种简单的 XML 文件:

一种文件描述输出的数据 (*.xml)

一种文件描述输出的格式 (*.xsl)

XML模板主要描述记录的哪些字段需要输出. XSL:RML 样式表单(style sheet)处理输出数据，以及报表中的静态文本. 静态文本是指在报表中不怎么变化的部分，比如表格头部的标题.

示例

下面给出一个例子，列出用于生成ERP报表的不同文件.

XML 模板

<?xml version="1.0"?>

    <ids>
    <id type="fields" name="id">

        <name type="field" name="name"/>
        <ref type="field" name="ref"/>

    </id>
    </ids>

XML 数据文件 (生成的)

<?xml version="1.0"?>

    <ids>
    <id>

        <name>Tiny sprl</name>
        <ref>pnk00</ref>

    </id><id>

        <name>ASUS</name>
        <ref></ref>

    </id><id>

        <name>Agrolait</name>
        <ref></ref>

    </id><id>

        <name>Banque Plein-Aux-As</name>
        <ref></ref>

    </id><id>

        <name>China Export</name>
        <ref></ref>

    </id><id>

        <name>Ditrib PC</name>
        <ref></ref>

    </id><id>

        <name>Ecole de Commerce de Liege</name>
        <ref></ref>

    </id><id>

        <name>Elec Import</name>
        <ref></ref>

    </id><id>

        <name>Maxtor</name>
        <ref></ref>

    </id><id>

        <name>Mediapole SPRL</name>
        <ref></ref>

    </id><id>

        <name>Opensides sprl</name>
        <ref>os</ref>

    </id><id>

        <name>Tecsas sarl</name>
        <ref></ref>

    </id>
    </ids>

XSL 样式表

<?xml version="1.0" encoding="utf-8"?> <xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:fo="http://www.w3.org/1999/XSL/Format">

    <xsl:template match="/">

        <xsl:apply-templates select="ids"/>

    </xsl:template>

    <xsl:template match="ids">

        <document>

            <template pageSize="21cm,29.7cm">

                <pageTemplate>

                    <frame id="col1" x1="2cm" y1="2.4cm" width="8cm" height="26cm"/>
                    <frame id="col2" x1="11cm" y1="2.4cm" width="8cm" height="26cm"/>

                </pageTemplate>

            </template>

        <stylesheet>

            <blockTableStyle id="ids">

                <blockFont name="Helvetica-BoldOblique" size="12" start="0,0" stop="-1,0"/>
                <lineStyle kind="BOX" colorName="black" start="0,0" stop="-1,0"/>

                <lineStyle kind="BOX" colorName="black" start="0,0" stop="-1,-1"/>

            </blockTableStyle>

        </stylesheet>

        <story>

            <blockTable colWidths="2cm, 6cm" repeatRows="1" style="ids">

                <tr>

                    <td t="1">Ref.</td>
                    <td t="1">Name</td>

                </tr>
                <xsl:apply-templates select="id"/>

            </blockTable>

        </story>
        </document>

    </xsl:template>

    <xsl:template match="id">

        <tr>

            <td><xsl:value-of select="ref"/></td>
            <td><para><xsl:value-of select="name"/></para></td>

        </tr>

    </xsl:template>
    </xsl:stylesheet>

生成的RML文件

<?xml version="1.0"?>

    <document>
    ...

        <story>

            <blockTable colWidths="2cm, 6cm" repeatRows="1" style="ids">

                <tr>

                    <td t="1">Ref.</td>
                    <td t="1">Name</td>

                </tr>
                <tr>

                    <td>pnk00</td>
                    <td><para>Tiny sprl</para></td>

                </tr>
                <tr>

                    <td></td>
                    <td><para>ASUS</para></td>

                </tr>
                <tr>

                    <td></td>
                    <td><para>Agrolait</para></td>

                </tr>
                <tr>

                    <td></td>
                    <td><para>Banque Plein-Aux-As</para></td>

                </tr>
                <tr>

                    <td></td>
                    <td><para>China Export</para></td>

                </tr>
                <tr>

                    <td></td>
                    <td><para>Ditrib PC</para></td>

                </tr>
                <tr>

                    <td></td>
                    <td><para>Ecole de Commerce de Liege</para></td>

                </tr>
                <tr>

                    <td></td>
                    <td><para>Elec Import</para></td>

                </tr>
                <tr>

                    <td></td>
                    <td><para>Maxtor</para></td>

                </tr>
                <tr>

                    <td></td>
                    <td><para>Mediapole SPRL</para></td>

                </tr>
                <tr>

                    <td>os</td>
                    <td><para>Opensides sprl</para></td>

                </tr>
                <tr>
                <td></td>

                    <td><para>Tecsas sarl</para></td>

                </tr>

            </blockTable>

        </story>

    </document>

详见以下文档:

RML user guide

XSL specification

XSL tutorial

这些格式都是作为 XML specification. 的拓展。

XML 模板¶

XML 模板是简单的XML文件，用来描述object字段中哪些要在报表上显示.

文件格式¶

标签(tag)名称可以任意(但必须是有效XML标签)。在XSL文件中，你要用这些名称来定义。大多数情况下，标签名和对象字段保持一致.

没有**type** 属性的节点会直接复制到目标XML文件(数据文件)。有**type**属性的结点及其内容被server解析并由object中的实际数据替换。除了type属性，节点还可以有其他属性。这些属性基于type属性，type不同的节点属性也不同。大部分结点类型都有 name 属性，指向相应object的字段名称 .

类似object中的 “browse” 方法，报表中的字段名称可以使用一种类似面向对象语言中的符号来表示。这意味可以用关系字段来作为桥梁来获取相关对象的数据。

以 “account.transfer” 对象为例。Account.transfer对象包含一个partner_id字段，这个字段是一个指向”res.partner” 对象的多对一关系字段。我们假设要创建一个转账的报表,，而报表中需要用到业务伙伴的名称。我们可以这样写:

partner_id.name

其它类型¶

这里是可用的字段类型的列表:

field: 最简单的类型。针对这种类型的结点，服务器会用同名字段值来替换节点内容。

fields: 这种结点类型，服务器会在XML数据文件中生成一个和name属性相同的唯一结点.

注释:

** 这种结点通常使用 “id” 作为名称。其行为是为用户在界面上选择的每个记录创建一个节点。 ** 结点语法 <node type=”fields” name=”field_name”> 类似SQL语句 “SELECT FROM object_table WHERE id in identifier_list GROUP BY field_name” 相似，其中identifier_list 是::user 在界面上选择的对象记录。

eval: 这个结点(node)类型计算 expr 属性中表达式(expression)的值。表达式(expression)可以是python表达式，也可以是object的字段名字.

zoom: 这个结点(node)类型允许通过name属性指定的关系字段进入另一个对象。也就是说子节点的name属性不需要用关系字段名作为前缀了。如上例，我们可以通过以下方式获得parter的name字段:
<partner type="zoom" name="partner_id">

        <name type="field" name="name"/>

</partner>

在这个例子中, 不用zoom注解，标准格式也同样可以有效果:

<name type="field" name="partner_id.name"/>

zoom 类型往往用于显示同一个object的多个字段.

function: 返回name属性中所调用函数的结果。这个函数必须是提前定义的。暂时可用的函数是today，用来返回当前日期.

call: 调用name属性指定的对象方法，args属性是参数名称。函数的结果放进一个字典(dictionary)，形如：{‘name_of_variable’: value, ... } 这个结果可以被子结点使用。这些子结点必须有相应的value属性，以和调用方法所返回字典的一个键值(key)匹配.

示例:

<cost type="call" name="compute_seller_costs" args="">

    <name value="name"/>
    <amount value="amount"/>

</cost>

TODO: 要调用的方法 def compute_buyer_costs(self, cr, uid, ids, *args):

attachment: 提取属性name中对应id的记录的第一个附件，可以在报表中显示图片。

示例:: <image type=”attachment” name=”id”/>

示例

XML 文件的例子:

<?xml version="1.0" encoding="ISO-8859-1"?>
<transfer-list>

    <transfer type="fields" name="id">

        <name type="field" name="name"/>
        <partner_id type="field" name="partner_id.name"/>
        <date type="field" name="date"/>
        <type type="field" name="type"/>
        <reference type="field" name="reference"/>
        <amount type="field" name="amount"/>
        <change type="field" name="change"/>

    </transfer>

</transfer-list>

RML 介绍¶

有关RML格式的更多信息, 请参照官方文档.

http://www.reportlab.com/docs/rml2pdf-userguide.pdf

XSL:RML 样式表¶

为报表定义XSL样式表有两个选项. 或者完全自定义, 或者使用模版

可以是自由格式，也可以用公司表头 + RML模版

导入 rml_template.xsl

必须的模板:

frames?

stylesheet

story

可选的模板:

Translations¶

OpenERP可以使用多种语言，因此报表必须可以翻译成多种语言。但是一个报表中，并不是所有项目都被翻译，比如动态的文本需要翻译转换，而格式代码(format code)则不需要。一个字段如果包含在有t=”1”这个属性的XML标签内，翻译系统就会处理它。服务器会在报表生成过程中处理所有这样的字段.

一些有用的链接¶

url=http://www.reportlab.com/docs/rml2pdf-userguide.pdf RML 用户指南 (pdf) (reportlab.com)

http://www.zvon.org/xxl/XSLTutorial/Output/index.html XSL 教程 (zvon.org)

http://www.zvon.org/xxl/XSLTreference/Output/index.html XSL 参考 (zvon.org)

http://www.w3schools.com/xsl/ XSL 教程和参考 (W3Schools)

http://www.w3.org/TR/xslt/ XSL 规范 (W3C)

示例 (使用公司表头)¶

<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform" :xmlns:fo="http://www.w3.org/1999/XSL/Format">

    <xsl:import href="../../custom/corporate_defaults.xsl"/>
    <xsl:import href="../../base/report/rml_template.xsl"/>
    <xsl:variable name="page_format">a4_normal</xsl:variable>
    <xsl:template match="/">

        <xsl:call-template name="rml"/>

    </xsl:template>
    <xsl:template name="stylesheet">

        </xsl:template>

    <xsl:template name="story">

        <xsl:apply-templates select="transfer-list"/>

    </xsl:template>
    <xsl:template match="transfer-list">

        <xsl:apply-templates select="transfer"/>

    </xsl:template>
    <xsl:template match="transfer">

        <setNextTemplate name="other_pages"/>
        <para>

            Document: <xsl:value-of select="name"/>

        </para><para>

            Type: <xsl:value-of select="type"/>

        </para><para>

            Reference: <xsl:value-of select="reference"/>

        </para><para>

            Partner ID: <xsl:value-of select="partner_id"/>

        </para><para>

            Date: <xsl:value-of select="date"/>

        </para><para>

            Amount: <xsl:value-of select="amount"/>

        </para>
        <xsl:if test="number(change)>0">

            <para>

                Change: <xsl:value-of select="change"/>

            </para>

        </xsl:if>
        <setNextTemplate name="first_page"/>
        <pageBreak/>

    </xsl:template>

</xsl:stylesheet>

没有公司表头的示例¶

示例 (使用公司表头):

<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform" :xmlns:fo="http://www.w3.org/1999/XSL/Format">
     <xsl:import href="../../base/report/rml_template.xsl"/>
     <xsl:variable name="page_format">a4_normal</xsl:variable>

     <xsl:template match="/">
          <xsl:call-template name="rml"/>
     </xsl:template>

     <xsl:template name="stylesheet">
      </xsl:template>

      <xsl:template name="story">
           <xsl:apply-templates select="transfer-list"/>
      </xsl:template>

      <xsl:template match="transfer-list">
           <xsl:apply-templates select="transfer"/>
      </xsl:template>

      <xsl:template match="transfer">
           <setNextTemplate name="other_pages"/>

           <para>
                 Document: <xsl:value-of select="name"/>
           </para><para>
                 Type: <xsl:value-of select="type"/>
           </para><para>
                 Reference: <xsl:value-of select="reference"/>
           </para><para>
                 Partner ID: <xsl:value-of select="partner_id"/>
           </para><para>
                 Date: <xsl:value-of select="date"/>
           </para><para>
                 Amount: <xsl:value-of select="amount"/>
           </para>

           <xsl:if test="number(change)>0">
                <para>
                      Change: <xsl:value-of select="change"/>
                </para>
           </xsl:if>

           <setNextTemplate name="first_page"/>
          <pageBreak/>
     </xsl:template>
</xsl:stylesheet>

每个报表都有自己的公司表头¶

示例 (使用默认的公司表头):

<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform" :xmlns:fo="http://www.w3.org/1999/XSL/Format">

    <xsl:import href="../../custom/corporate_defaults.xsl"/>
    <xsl:import href="../../base/report/rml_template.xsl"/>
    <xsl:variable name="page_format">a4_normal</xsl:variable>
    .....................
    </xsl:template>

</xsl:stylesheet>

条形码¶

RML 文件中的条形码¶

可以在RML 文件中使用<barCode>标签生成条形码。支持以下格式:

codabar

code11

code128 (如果没有指定 ‘code’ ,则默认code128码)

standard39

standard93

i2of5

extended39

extended93

msi

fim

postnet

ean13

ean8

usps_4state

你可以更改以下属性来生成自己的条形码(barcode):

‘code’: ‘char’

‘ratio’:’float’

‘xdim’:’unit’

‘height’:’unit’

‘checksum’:’bool’

‘quiet’:’bool’

示例:

<barcode code=”code128” xdim=”28cm” ratio=”2.2”>`SN12345678</barcode>

如何生成一个新的报表¶

Administration -> Custom -> Low Level -> Base->Actions -> ir.actions.report.xml

常用标签¶

包含在 [[ ]] 标签中的代码是 python 代码¶

代码中的内容(你可以使用的变量值)和链接 OpenOffice 报表中的动态内容描述中的相同.

Unicode 报表¶

OpenERP 5.0-rc3 中还是不能使用Unicode 报表的。症结在于OpenERP使用的PDF标准字体(14号字体，不嵌入文档，而是由pdf reader提供)Type1只含有Latin1字符.

解决办法有三步¶

提供 TrueType 字体，让ReportLab可以使用他们.

在报表中使用Unicode之前，在ReportLab中注册TrueType 字体.

在xsl和rml模板中替换旧字体名称为TrueType.

论坛中有更详细的信息¶

免费的字体 TrueType fonts

来自DejaVu 一族，可用于解决此问题. 可访问 http://dejavu-fonts.org/wiki/index.php?title=Main_Page 安装

在 ReportLab 字体目录,

系统路径和 rl_config.py 中包含这个目录,

在 OpenERP 安装子目录提供一个路径给ReportLab作为注册字体用.

在文件 server/bin/report/render/rml2pdf/__init__.py 中

import reportlab.rl_config
reportlab.rl_config.warnOnMissingFontGlyphs = 0

from reportlab.pdfbase import pdfmetrics
from reportlab.pdfbase.ttfonts import TTFont
import reportlab

enc = 'UTF-8'

#需要的字体做如下类似的重复
pdfmetrics.registerFont(TTFont('DejaVuSans', 'DejaVuSans.ttf',enc))
pdfmetrics.registerFont(TTFont('DejaVuSans-Bold', 'DejaVuSans-Bold.ttf',enc))

from reportlab.lib.fonts import addMapping

#需要的字体做如下类似的重复
addMapping('DejaVuSans', 0, 0, 'DejaVuSans') #normal
addMapping('DejaVuSans-Bold', 1, 0, 'DejaVuSans') #normal

如果是命令行引用 trml2pdf.py ，则需要做如上修改.

所有需要修改的 xsl 和 rml 文件

需要修改调整的清单:

'Times-Roman',       'DejaVuSerif.ttf'
'Times-BoldItalic',  'DejaVuSerif-BoldItalic.ttf'
'Times-Bold',        'DejaVuSerif-Bold.ttf'
'Times-Italic',      'DejaVuSerif-Italic.ttf'

'Helvetica',     'DejaVuSans.ttf'
'Helvetica-BoldItalic',  'DejaVuSans-BoldOblique.ttf'
'Helvetica-Bold',    'DejaVuSans-Bold.ttf'
'Helvetica-Italic',  'DejaVuSans-Oblique.ttf'

'Courier',           'DejaVuSansMono.ttf'
'Courier-Bold',      'DejaVuSansMono-Bold.ttf'
'Courier-BoldItalic','DejaVuSansMono-BoldOblique.ttf'
'Courier-Italic',    'DejaVuSansMono-Oblique.ttf'

'Helvetica-ExtraLight',  'DejaVuSans-ExtraLight.ttf'

'TimesCondensed-Roman',      'DejaVuSerifCondensed.ttf'
'TimesCondensed-BoldItalic', 'DejaVuSerifCondensed-BoldItalic.ttf'
'TimesCondensed-Bold',       'DejaVuSerifCondensed-Bold.ttf'
'TimesCondensed-Italic',     'DejaVuSerifCondensed-Italic.ttf'

'HelveticaCondensed',        'DejaVuSansCondensed.ttf'
'HelveticaCondensed-BoldItalic', 'DejaVuSansCondensed-BoldOblique.ttf'
'HelveticaCondensed-Bold',   'DejaVuSansCondensed-Bold.ttf'
'HelveticaCondensed-Italic', 'DejaVuSansCondensed-Oblique.ttf

使用Mako模板的HTML报表¶

Note

只在trunk实现的

Mako的是用Python编写一个模板库。它提供了一个熟悉的，非XML的语法，编译成Python模块以获得最佳性能.

Mako 模板¶

语法¶

Mako模板可以解析 XML, HTML, email text, 等文字流(parsed from a text stream) .

Mako模板含有Mako特有的指令(Mako-specific directives), 包括变量、表达式替换(expression substitution)，控制结构(比如条件和循环,conditionals and loops)，服务器端命令，完整的Python代码块，这些就像不同功能的标签(tag)一样易用。所有这些指令都解析为Python代码.

这意味着在Mako模板中，你可以最大化发挥Python的优势.

表达式替换¶

最简单的表达式是变量替换。 Mako模板中使用 ${} 结构，而不是rml中的 [[ ]] .

eg:

这是x: ${x}

    上面表达式中“这是x”字符串直接输出，而${}里的x值来自报表解析器的localcontext中.

    标签 ${} 中的代码直接被Python解析.

控制结构:

在Mako中，控制结构 (i.e. if/else, 循环 (像 while 和 for), 包括 try/except) 都使用 % 标记，之后接上普通的Python控制表达式即可。在控制结构结束时，使用 “end<name>” 标记，”<name>” 是控制结构的关键字:

eg:

% if x==5:
  this is some output
% endif

Python 块¶

在 <% %> 标记中, 你可以加入普通的Python代码块。虽然之中的代码可以加入任意的空格，但是还是注意下格式比较好。Mako的编译器会根据周围生成的 Python代码结构，调整Python代码块中的格式.

有用的链接:: http://www.makotemplates.org/docs/

销售订单中的例子¶

销售完整的例子请从下面的地址参照 sale_report_html 模块 :

https://code.launchpad.net/~openerp-community/openobject-addons/trunk-addons-community

## -*- coding: utf-8 -*-
<html>
<head>
        <%include file="mako_header.html"/>
</head>
% for o in objects:
<body>
    <table width="100" border="0" cellspacing="0" cellpadding="0">
            <tr>
                    <td>
                                <p><small><b>Shipping address :</b></small>
                        </td>
                </tr>
                <tr>
                        <td>
                                <small>${ o.partner_id.title or '' } ${ o.partner_id.name }</small>
                        </td>
                </tr>
                <tr>
                    <td>
                                <small>${ o.partner_shipping_id.state_id and o.partner_shipping_id.state_id.name or '' } ${ o.partner_shipping_id.country_id and o.partner_shipping_id.country_id.name or '' }</small>
                        </td>
                </tr>
        </table>
        <table>
                   <tr align="left">
                          <th>Description</th>
                          <th>VAT</th>
                          <th>Quantity</th>
                          <th>Unit Price</th>
                          <th>Disc.(%)</th>
                          <th>Price</th>
                        </tr>
                % for line in o.order_line:
                          <tr>
                          <td>${line.name}</p>
                          <td>${', '.join(map(lambda x: x.name, line.tax_id))}</td>
                          <td>${line.product_uos and line.product_uos_qty or line.product_uom_qty}
                          ${line.product_uos and line.product_uos.name or line.product_uom.name}</td>
                          <td>${line.price_unit}</td>
                          <td>${line.discount or 0.00 }</td>
                          <td>${line.price_subtotal or 0.00 }</td>
                          </tr>
                  % if line['notes']:
                            <tr>
                            <td>${line.notes}</td>
                            </tr>

                  % endif
                  % endfor
        </table>
</body>
% endfor
<%include file="mako_footer.html"/>
</html>

可以根据需要用 HTML格式化报表.

有报表头和报表尾(header and footer)的报表¶

如果希望在报表中加入公司专有的页眉，需要包含 <%include file=”mako_header.html”/> 加入页脚需要包含 <%include file=”mako_footer.html”/> 这些文件会从数据库中读出你预先为公司定义好的页眉页脚.