报表
报表打印
Odoo 8.0 开始使用新的基于QWeb，Twitter Bootstrap 和 Wkhtmltopdf的报表引擎。一个报表有两个元素组成：
其一是ir.actions.report.xml中，针对报表提供的快捷元素
另一个是标准的QWeb视图，实例如下：
Report title
the standard rendering context provides a number of elements, the most
important being:
``docs``
the records for which the report is printed
``user``
the user printing the report
由于报表是标准的web页面，所以都可以通过URL和输出参数来访问，例如HTML版本的发票报表可以通过这个地址访问：http://localhost:8069/report/html/account.report_invoice/1（如果安装了account），而PDF版本可以通过这个地址访问：http://localhost:8069/report/pdf/account.report_invoice/1。
警告
如果出现了PDF报表没有样式（比如有文本显示但是与html版本的风格/布局不一致），可能是wkhtmltopdf进程不能为下载提供web服务。
如果你检查服务日志，并且看到生成PDF报表时CSS样式未被下载，那么就可以肯定是这个问题。
wkhtmltopdf进程使用web.base.url这个系统参数作为根路径来组合所有文件路径，但是这个参数是在管理员帐户登录后自动生成的。如果你的服务器位于某种代理服务器之后，则无法访问该服务器。你可以添加一个系统参数来固化它：
-
report.url，可以访问你的服务器的URL地址，比如http://localhost:8069或者类似的地址。这个参数仅用于这个特殊情况。 -
web.base.url.freeze，当设置这个参数值为True时将停止自动更新web.base.url。
练习创建授课模型的报表
对于每个授课，报表都将显示它的授课名称，开始和结束时间，以及课程出席人列表。
openacademy / __ manifest__.py
'views/openacademy.xml',
'views/partner.xml',
'views/session_workflow.xml',
'reports.xml',
],
# only loaded in demonstration mode
'demo': [
openacademy/reports.xml
From to
Attendees:
仪表盘
练习定义一个仪表盘
定义一个仪表盘，这个仪表盘包含了已经建立的图形视图、授课日历视图、课程列表视图（可以选择form视图）。这个仪表盘可以通过菜单中的菜单项使用，并且当选择开放学院主菜单时自动显示在web客户端。
- 建立文件
openacademy/views/session_board.xml。这个文件包含面板视图，视图的触发action，打开仪表盘的action，以及重新定义主菜单项以添加仪表盘的action。
注意
可以使用的仪表盘风格有：1，1-1，2-1和1-1-1
- 更新
openacademy/__manifest__.py文件，以引用新的数据文件。
openacademy/__manifest__.py
'version': '0.1',
# any module necessary for this one to work correctly
'depends': ['base', 'board'],
# always loaded
'data': [
'views/openacademy.xml',
'views/partner.xml',
'views/session_workflow.xml',
'views/session_board.xml',
'reports.xml',
],
# only loaded in demonstration mode
openacademy/views/session_board.xml
Attendees by course
openacademy.session
form
graph
Sessions
openacademy.session
form
calendar
Courses
openacademy.course
form
tree,form
Session Dashboard Form
board.board
form
Session Dashboard
board.board
form
form
menu
WebServices
WebService模型为所有web服务提供通用接口：
- XML-RPC
- JSON-RPC
业务对象也可以通过这种分布式机制进行访问，在客户端界面通过上下文编辑这些业务对象。
Odoo支持通过XML-RPC/JSON-RPC接口访问，这两种协议在许多开发语言中都有库支持。
XML-RPC库
下面的例子是Python程序通过xmlrpclib库访问Odoo服务器：
import xmlrpclib
root = 'http://%s:%d/xmlrpc/' % (HOST, PORT)
uid = xmlrpclib.ServerProxy(root + 'common').login(DB, USER, PASS)
print "Logged in as %s (uid: %d)" % (USER, uid)
# Create a new note
sock = xmlrpclib.ServerProxy(root + 'object')
args = {
'color' : 8,
'memo' : 'This is a note',
'create_uid': uid,
}
note_id = sock.execute(DB, uid, PASS, 'note.note', 'create', args)
练习在客户端添加新服务
编写Python程序，用来发送XML-RPC请求到运行Odoo的PC。这个程序将显示全部授课，以及所对应的座位数。也可以为课程创建新的授课。
import functools
import xmlrpclib
HOST = 'localhost'
PORT = 8069
DB = 'openacademy'
USER = 'admin'
PASS = 'admin'
ROOT = 'http://%s:%d/xmlrpc/' % (HOST,PORT)
# 1. Login
uid = xmlrpclib.ServerProxy(ROOT + 'common').login(DB,USER,PASS)
print "Logged in as %s (uid:%d)" % (USER,uid)
call = functools.partial(
xmlrpclib.ServerProxy(ROOT + 'object').execute,
DB, uid, PASS)
# 2. Read the sessions
sessions = call('openacademy.session','search_read', [], ['name','seats'])
for session in sessions:
print "Session %s (%s seats)" % (session['name'], session['seats'])
# 3.create a new session
session_id = call('openacademy.session', 'create', {
'name' : 'My session',
'course_id' : 2,
})
不使用硬编码，通过课程名称查找课程ID：
# 3.create a new session for the "Functional" course
course_id = call('openacademy.course', 'search', [('name','ilike','Functional')])[0]
session_id = call('openacademy.session', 'create', {
'name' : 'My session',
'course_id' : course_id,
})
JSON-RPC库
下面的例子是一个Python程序，通过Pythong的标准库urllib2和json与Odoo服务器交互。
import json
import random
import urllib2
def json_rpc(url, method, params):
data = {
"jsonrpc": "2.0",
"method": method,
"params": params,
"id": random.randint(0, 1000000000),
}
req = urllib2.Request(url=url, data=json.dumps(data), headers={
"Content-Type":"application/json",
})
reply = json.load(urllib2.urlopen(req))
if reply.get("error"):
raise Exception(reply["error"])
return reply["result"]
def call(url, service, method, *args):
return json_rpc(url, "call", {"service": service, "method": method, "args": args})
# log in the given database
url = "http://%s:%s/jsonrpc" % (HOST, PORT)
uid = call(url, "common", "login", DB, USER, PASS)
# create a new note
args = {
'color' : 8,
'memo' : 'This is another note',
'create_uid': uid,
}
note_id = call(url, "object", "execute", DB, uid, PASS, 'note.note', 'create', args)
下面是使用jsonrpc完成相同功能的程序
import jsonrpclib
# server proxy object
url = "http://%s:%s/jsonrpc" % (HOST, PORT)
server = jsonrpclib.Server(url)
# log in the given database
uid = server.call(service="common", method="login", args=[DB, USER, PASS])
# helper function for invoking model methods
def invoke(model, method, *args):
args = [DB, uid, PASS, model, method] + list(args)
return server.call(service="object", method="execute", args=args)
# create a new note
args = {
'color' : 8,
'memo' : 'This is another note',
'create_uid': uid,
}
note_id = invoke('note.note', 'create', args)
提醒
有许多语言可以通过XML-RPC或JSON-RPC访问Odoo系统的高级API，例如：
- https://github.com/akretion/ooor
- https://github.com/syleam/openobject-library
- https://github.com/nicolas-van/openerp-client-lib
- http://pythonhosted.org/OdooRPC
- https://github.com/abhishek-jaiswal/php-openerp-lib