openerp学习笔记 webkit 打印

1.webkit 打印需要安装的支持模块

请首先安装 Webkit 报表引擎（report_webkit），再安装 Webkit 报表的支持库（report_webkit_lib）,该模块讲自动安装和设置 wkhtml2pdf 的路径。

另外，安装 oecn_base_fonts 模块可解决打印中文乱码问题，安装 web_pdf_preview 模块可以实现在浏览器中直接预览打印 pdf 文件。

2.webkit 打印模块文件结构

其中：hr_expense_report.xml 定义了报表名称和菜单，hr_expense_report.py 定义了报表解析类，hr_expense_report.mako 定义了报表模版。

3.报表定义文件（hr_expense_report.xml）

<?xml version="1.0" encoding="utf-8"?>

<openerp>

    <data>

        <report id="report_hr_expense_webkit"

                name="hr.expense.webkit"

                model="hr.expense.expense"

                file="hr_expense_webkit\\report\\hr_expense_report.mako"

                string="员工费用申请(html)"

                report_type="webkit"

                menu="True"

                auto="False"

                header="False" />

    </data>

</openerp>

说明:

　　id: 报表id，任意字符串，不重复即可。
　　name: 报表名称，为报表解析类（hr_expense_report.py）中 webkit_report.WebKitParser() 函数第一个参数去掉 report. 。
　　string: 打印菜单中显示的名字。
　　model: 报表渲染对象，打印菜单创建在该对象上。
　　file: 报表模版(.mako)文件路径，路径以本模块的路径开始，注意7.0早期版本webkit类型的报表中报表模版的路径必须用\\分割，7.0升级后的版本已经修正该Bug，使用/分割路径即可。
　　report_type: 报表类型，此处为 webkit 。
　 menu: True or False，是否在客户端上显示菜单， False 一般用语Wizard 向导时，不需要菜单。
　　auto: 是否利用缺省方法分析 .RML文件。

4.报表解析类定义文件(hr_expense_report.py)

# -*- coding: utf-8 -*-

import time

from report import report_sxw

from report_webkit import webkit_report

class hr_expense_report_webkit(report_sxw.rml_parse):

    def __init__(self, cr, uid, name, context):

        super(hr_expense_report_webkit, self).__init__(cr, uid, name, context=context)

        self.localcontext.update({

            'time': time,

            'cr':cr,

            'uid': uid,

        })

webkit_report.WebKitParser('report.hr.expense.webkit',

                       'hr.expense.expense',

                       'addons/hr_expense_webkit/report/hr_expense_report.mako',

                       parser=hr_expense_report_webkit, header=False)

说明:
　　解释器继承自 report_sxw.rml_parse 对象并且增加了 time、cr、uid 变量，因此在报表中可以调用。
　　webkit_report.WebKitParser 实例生成之后，需要如下参数:
　　　　报表的名字
　　　　report关联的 object 名字
　　　　mako文件的路径
　　　　parser，默认的 mako 解释器(默认为 rml_parse)
　　　　header=False，使用报表自己定义的报表头

5.hr_expense_report.mako

<html>

<head>

</head>

% for expense in objects:

<body>

<table width="1369" height="363" border="3" bordercolordark="#000000" frame="border" rules="groups">

  <tr>

    <td height="42" colspan="8"><h2 align="center">员工费用申请单</h2></td>

  </tr>

  <tr>

    <td width="144" height="32">员工：</td>

    <td width="146" height="32">${ expense.employee_id.name or '' }</td>

    <td width="221" height="32">日期：</td>

    <td height="32" colspan="2">${ expense.date or '' }</td>

    <td width="150" height="32">部门：</td>

    <td height="32" colspan="2">${ expense.department_id.name or '' }</td>

  </tr>

  <tbody>

  <tr>

    <td height="32">产品</td>

    <td height="32">费用日期</td>

    <td height="32">费用备注</td>

    <td width="154" height="32">单号</td>

    <td width="137" height="32"><div align="center">计量单位</div></td>

    <td height="32"><div align="right">单价</div></td>

    <td width="159" height="32"><div align="center">数量</div></td>

    <td width="206" height="32"><div align="right">合计</div></td>

  </tr>

  % for line in expense.line_ids:

  <tr>

    <td width="144" height="32">${ line.product_id.name or '' }</td>

    <td width="146" height="32">${ line.date_value or '' }</td>

    <td width="221" height="32">${ line.name or '' }</td>

    <td width="154" height="32">${ line.ref or '' }</td>

    <td width="137" height="32"><div align="center">${ line.uom_id.name or '' }</div></td>

    <td width="150" height="32"><div align="right">${ line.unit_amount or '' }</div></td>

    <td width="159" height="32"><div align="center">${ line.unit_quantity or '' }</div></td>

    <td width="206" height="32"><div align="right">${ line.total_amount or '' }</div></td>

  </tr>

  % endfor

  <tr>

    <td height="32" colspan="7"><div align="right">合计：</div></td>

    <td height="32"><div align="right">${ expense.amount or '' }</div></td>

  </tr>

  </tbody>

  <tr>

    <td height="32">说明：</td>

    <td height="32" colspan="7">${ expense.name or '' }</td>

  </tr>

  <tr>

    <td height="32">备注：</td>

    <td height="32" colspan="7">${ expense.note or '' }</td>

  </tr>

</table>

</body>

 % endfor

</html>

说明，以下关于Mako模版的介绍引用自：http://www.cnblogs.com/alangwansui/archive/2013/02/05/2892839.html

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:

this is x: ${x}

    上式被模板输出流解析(template output stream)，从本地上下文(localcontext)传递给模板生成函数(template rendering function).

    标签 ${} 中的代码直接被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/