openerp 表格

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.

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

o.create_uid.name

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

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

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

[[ setTag('para','image',{'width':'100.0','height':'80.0'}) ]] o.image or setTag('image','para')[[ ? p['image'] ? and ?setTag('para','image',{'width':'78.0','height':'78.0'}) or removeParentNode('blockTable') ]] [[ p['image'] ]]

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

tiny_sxw2rml.py template.sxw > template.rml

import timefrom report import report_sxwclass 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)

<?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>

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. 的拓展。

<cost type="call" name="compute_seller_costs" args="">    <name value="name"/>    <amount value="amount"/></cost>

<?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>

<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="http://www.cnblogs.com/custom/corporate_defaults.xsl"/>    <xsl:import href="http://www.cnblogs.com/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>

没有公司表头( corporate header )的示例

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

<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="http://www.cnblogs.com/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>

每个报表都有自己的公司表头( corporate header )

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

<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="http://www.cnblogs.com/custom/corporate_defaults.xsl"/>    <xsl:import href="http://www.cnblogs.com/base/report/rml_template.xsl"/>    <xsl:variable name="page_format">a4_normal</xsl:variable>    .....................    </xsl:template></xsl:stylesheet>

条形码(Bar Codes)

如何生成一个新的报表

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

常用标签

Unicode 报表

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

import reportlab.rl_configreportlab.rl_config.warnOnMissingFontGlyphs = 0from reportlab.pdfbase import pdfmetricsfrom reportlab.pdfbase.ttfonts import TTFontimport reportlabenc = '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') #normaladdMapping('DejaVuSans-Bold', 1, 0, 'DejaVuSans') #normal

'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报表

this is x: ${x}    上式被模板输出流解析(template output stream)，从本地上下文(localcontext)传递给模板生成函数(template rendering function).    标签 ${} 中的代码直接被Python解析.

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

## -*- 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>