(06)odoo报表
----------
更新时间：
18:06 2016-09-18 星期日
18:13 2016-04-05 星期二
10:31 2016-03-01 星期二
----------
* odoo8 采用是Qweb报表，废弃了7.0中的RML报表
* 创建业务报表
报表是通过Qweb的技术来建立的
#一般报表结构如下：
purchase
├ views
│ ├ report_purchaseorder.xml (报表模板)
│ ├ report_purchasequotaion.xml
├ purchase_report.xml (模块中报表定义 模块名_report.xml)
当要建立报表时，就按这样的结构来创建,
#注意，报表，用到了wkhtmltopdf依赖
http://wkhtmltopdf.org/downloads.html wkhtmltopdf-0.12.1 版本
$ sudo apt-get remove --purge wkhtmltopdf
$ cd /tmp
$ wget http://downloads.sourceforge.net/project/wkhtmltopdf/archive/0.12.1/
wkhtmltox-0.12.1_linux-trusty-adm64.deb
$ sudo dpkg -i wkhtmltox-0.12.1_linux-trusty-amd64.deb
#报表定义purchase_report.xml：(注册报表)
<?xml version="1.0" encoding="utf-8"?>
<openerp>
<data>
<report
string="Purchase Order"
id="action_report_purchase_order"
model="purchase.order"
report_type="qweb-pdf"
name="purchase.report_purchaseorder"
file="purchase.report_purchaseorder"
/>
<report
string="Request for Quotation"
id="report_purchase_quotation"
model="purchase.order"
report_type="qweb-pdf"
name="purchase.report_purchasequotation"
file="purchase.report_purchasequotation"
/>
</data>
</openerp>
@string: 在打印按钮那里的显示名称
@id:外id标识
@name: 完整主模板名称 模块名.主板模名称 用于管理和调用
@file: 完整模板文件名 模块名.模板文件名 用于更好地关联模板
@model:相关的模型显示在那个模块进行打印报表 通常在各视图中的打印那里会出现
上面表示在采购订单相关视图时，会出现“打印-询价单/采购订单”
@report_type: 报表类型 是 qweb-pdf 或 qweb-html
@report_name: 打印出来的文件名
@groups_id:指定权限
--------
attachment_use="True"
attachment="(object.state in ('open','paid')) and
('INV'+(object.number or '').replace('/','')+'.pdf')"
@attachment_use：使用附件，这样不会一直查数据库，只能当数据变化时才会查数据库
@attachment：附件的名称，当我们下载下来的文件名
------
<report> 是 ir.actions.report.xml 模型的快捷方式
<record id="action_report_purchase_order" model="ir.actions.report.xml">
<field name="name">Purchase Order</field>
<field name="model">purchase.order</field>
<field name="report_type">qweb-pdf</field>
<field name="template_name">
purchase.report_purchaseorder
</field>
<field name="paper_format_id" ref="report.paperformat_euro"/>
#指定的纸张 可以到 addons/report/data/report_paperformat.xml 查看可用纸张规格
</record>
报表可以在 设置->技术->报表 可以查到
t-call 调用的标准报告架构，这个很重要
report.external_layout 包含头部和尾部 ，也可以只用 report.internal_layout 只用
基础架构的头部，其它部分自己写
# 报表模板 report_purchaseorder.xml
# /addons/purchase/views/report_purchase.xml:
<?xml version="1.0" encoding="utf-8"?>
<openerp>
<data>
<template id="report_purchaseorder_document">
<t t-call="report.external_layout"> <!--套上头尾的模板布局-->
<div class="page">
<div class="oe_structure"/>
<div class="row">
<div class="col-xs-6"> <!--bootstrap布局方式-->
<strong>Shipping address:</strong>
<div t-if="o.dest_address_id">
<div t-field="o.dest_address_id"
t-field-options='{"widget": "contact", "fields": ["address", "name", "phone", "fax"], "no_marker": true}'/>
</div>
<div t-if="not o.dest_address_id and o.picking_type_id and o.picking_type_id.warehouse_id">
<span t-field="o.picking_type_id.warehouse_id.name"/>
<div t-field="o.picking_type_id.warehouse_id.partner_id"
t-field-options='{"widget": "contact", "fields": ["address", "phone", "fax"], "no_marker": true}'/>
</div>
</div>
<div class="col-xs-5 col-xs-offset-1">
<div t-field="o.partner_id"
t-field-options='{"widget": "contact", "fields": ["address", "name", "phone", "fax"], "no_marker": true}'/>
<p t-if="o.partner_id.vat">VAT: <span t-field="o.partner_id.vat"/></p>
</div>
</div>
...
<div class="oe_structure"/>
</div>
</t>
</template>
<template id="report_purchaseorder">
<t t-call="report.html_container">
<t t-foreach="doc_ids" t-as="doc_id">
<!--采用合作伙伴设定的语言来翻译报表-->
<t t-raw="translate_doc(doc_id, doc_model, 'partner_id.lang', 'purchase.report_purchaseorder_document')"/>
</t>
</t>
</template>
</data>
</openerp>
来一段没有翻译的模板
<template id="report_invoice">
<t t-call="report.html_container">
<t t-foreach="docs" t-as="o">
<t t-call="report.external_layout">
<div class="page">
<h2>Report title</h2>
<p>This object's name is <span t-field="o.name"/></p>
</div>
</t>
</t>
</t>
</template>
@docs 当前报表记录集
@doc_ids 报表记录集的ids列表
@doc_model 报表录集对应的模型
@translate_doc 翻译报表
<t t-foreach="doc_ids" t-as="doc_id">
<t t-raw="translate_doc(doc_id, doc_model, 'partner_id.lang', account.report_invoice_document')"/>
</t>
@user 打印报表的人
@res_company 当前用户的公司
@调用了report.external_layout 模板 所在的布局文件在 /addons/report/views/layouts.xml
@注意translate_doc 中的 purchase.report_purchaseorder_document ，这个要报表视图id前加模块名
这个名称和模板的id名称要一致
@模板名称 report_purchaseorder_documen 和模板名称 report_purchaseorder
这样在报表定义时 purchase.report_purchaseorder 就可以关联到定义的模板
@ 大家可能注意到了o 对于o是代表当前报表模型数据 在/addons/report/models/report.xml
translate_doc 这个方法
def translate_doc(self, cr, uid, doc_id, model, lang_field, template, values, context=None):
ctx = context.copy()
doc = self.pool[model].browse(cr, uid, doc_id, context=ctx)
qcontext = values.copy()
# Do not force-translate if we chose to display the report in a specific lang
if ctx.get('translatable') is True:
qcontext['o'] = doc
else:
# Reach the lang we want to translate the doc into
ctx['lang'] = eval('doc.%s' % lang_field, {'doc': doc})
qcontext['o'] = self.pool[model].browse(cr, uid, doc_id, context=ctx)
return self.pool['ir.ui.view'].render(cr, uid, template, qcontext, context=ctx)
看到o就是报表中的的对象，若选择多个就是objects ,单个用o
报表中除了html的布局，剩下的就是用qweb语言来写的，和python类似。
#在报表中呈现数据
可用的变量：
docs 循环打印出一个记录集
doc_ids 一个记录集的ids列表打印出来
doc_model 调用哪个模型来处理
time 时间
user 本次执行报告的用户
res_company 当前用户所在的公司
字段值用 t-field 属性 还可以用其补充属性 t-field-options
上一道菜：
<h2 t-field="o.name"/>
<p t-field="o.user_id.name"/>
<ul>
<t t-foreach="o.message_follower_ids" t-as="f">
<li>
<img t-if="f.image_small"
t-att-src="'data:image/png;base64,%s' % f.image_small"
style="max-height: 45px;"/>
<span t-field="f.name"/>
</li>
</t>
</ul>
有货币字段：
<span t-field="o.amount"
t-field-options='{
"widget": "monetary",
"display_currency": "o.pricelist_id.currency_id"}'/>
<div t-field="res_company.partner_id"
t-field-options='{
"widget": "contact",
"fields": ["address", "name", "phone", "fax"],
"no_marker": true}' />
支持语言翻译
<template id="report_todo_task_template">
<t t-call="report.html_container">
<t t-foreach="doc_ids" t-as="doc_id">
<t t-raw="translate_doc(doc_id, doc_model,
'user_id.partner_id.lang',
'todo_kanban.report_todo_task_doc')"/>
</t>
</t>
</template>
translate_doc
注：col-xs-N N代表多少列 像bootstrap写法，一行划成12列
<t t-if="f_last"> 循环到了最后
#纸张格式
<record id="report_todo_task_action" model="ir.actions.report.xml">
<field name="name">To-do Tasks</field>
<field name="model">todo.task</field>
<field name="report_type">qweb-html</field>
<field name="template_name">
todo_kanban.report_todo_task_template
</field>
<field name="paper_format_id" ref="report.paperformat_euro"/>
</record>
paper_format_id 引用了 report.paperformat_euro 这个格式，这个值，可以在
设置->技术->报告->纸张格式
定义纸张格式
<record id="paperformat_frenchcheck" model="report.paperformat">
<field name="name">French Bank Check</field>
<field name="default" eval="True"/>
<field name="format">custom</field>
<field name="page_height">80</field>
<field name="page_width">175</field>
<field name="orientation">Portrait</field>
<field name="margin_top">3</field>
<field name="margin_bottom">3</field>
<field name="margin_left">3</field>
<field name="margin_right">3</field>
<field name="header_line" eval="False"/>
<field name="header_spacing">3</field>
<field name="dpi">80</field>
</record>
#模板加入模块中(__openerp__.py)
'data': [
'views/report_purchaseorder.xml',
'views/report_purchasequotation.xml',
],
#加入条件码：
<img t-att-src="'/report/barcode/QR/%s' % 'My text in qr code'"/>
<img t-att-src="'/report/barcode/?
type=%s&value=%s&width=%s&height=%s'%('QR', 'text', 200, 200)"/>
# 报表加入css
<template id="report_saleorder_style" inherit_id="report.layout">
<xpath expr="//style" position="after">
<style type="text/css">
.example-css-class {
background-color: red;
}
</style>
</xpath>
</template>
#自定义报表
默认有 get_html方法来调用报表传递数据，这时，我们只要定义模型时，重写这个方法就
可以完成自定义报表输出
from openerp import api, models
class ParticularReport(models.AbstractModel):
_name = 'report.module.report_name'
@api.multi
def render_html(self, data=None):
report_obj = self.env['report']
report = report_obj._get_report_from_name('module.report_name')
docargs = {
'doc_ids': self._ids,
'doc_model': report.model,
'docs': self,
}
return report_obj.render('module.report_name', docargs)
