附录¶

约定事项¶

指南¶

关于 OpenERP 模块的开发指南和一般建议，请参阅贡献文件里的指南

模块结构和文件名称¶

模块的结构应该如下:

/module/

    /__init__.py
    /__openerp__.py
    /module.py
    /module_other.py
    /module_view.xml
    /module_data.xml
    /module_demo.xml

    /wizard/
    /wizard/__init__.py
    /wizard/wizard_name.py

    /report/
    /report/
    /report/__init__.py
    /report/report_name.sxw
    /report/report_name.rml
    /report/report_name.py

命名方式约定¶

模块: 模块名称应该使用下划线(_)，加上小写字母。模块的名称就是服务器上插件所在的路径名称。如果某个模块依赖其他的模块，你可以用最重要的模块作为名称的开始，把其他几个模块的名称用下划线分别串起来。例如:

sale

sale_commission

物件: 物件的名称必须依照以下的形式模块名称.物件名称1.物件名称2.物件名称3.... 物件名称i 的排列顺序必须是由最重要的到最不重要的，由左到右，而且要是小写字母。尽量不要在物件名称里使用复数形式，同时要避免在名称里使用捷径。例如:

sale.order

sale.order.line

sale.shop

sale_commission.commission.rate

字段: 字段必须是小写，加上分隔的下划线。尽量使用一般常用的字段名称，例如：name, state, active, partner_id, 等等。字段名称是依据字段的属性来约定的:

多对一: 必须在结尾加上 ‘_id’ (例如: partner_id, order_line_id)

多对多: 必须在结尾加上’_ids’ (例如: category_ids)

一对多: 必须在结尾加上’_ids’ (例如: line_ids)

翻译¶

OpenERP 是多语言的。你想要加进多少种语言都没问题。每个用户都可以用他自己的语言作为工作界面，而且某些资源 (报表的内容，产品名称等等) 也可以翻译成想要的语言。

这一段说明了如何改变每个用户看到的语言，以及如何在 OpenERP 里新增语言。

几乎所有在使用界面里用到的标签都有储存在服务器上，同样的，标签的翻译也都有储存在服务器上。服务器的预设值是把英文的字典储存在服务器上，所以如果用户想要尝试除了英文以外的语言，这些语言的定义(字典)必须要储存在服务器上。

然而，要把 “所有的东西” 存在服务器上是不可能的。实际上，在连上服务器之前，一定会有一些文字显示在某些菜单，按键等等使用者界面上，这些为数不多的文字和句子是使用 GETTEXT 来翻译的；系统预设会依照用户(连上服务器的)电脑的语言来翻译以上的文字和句子。

OpenERP 的翻译系统不限于使用界面的文字；它对报表及某些数据库里的字段 “内容” 同样有效。显然并非所有的数据库字段都需要翻译，所以如果字段内容需要是多语言的，这个字段会有一个旗标图标作为标示。

如何变更用户使用界面的语言？¶

用户可以设定偏好的语言。当前用户要改变语言设定，在菜单上按：用户 > 偏好选项。

系统管理员也可以在菜单里修改用户的偏好语言(包含用户的使用界面语言)：系统管理 > 用户群 > 用户群。系统管理员只需要选择一个用户，然后切换 “偏好选项” ，就可以完成偏好语言的修改。

在服务器上储存翻译文件¶

用以下的指令上传包含翻译内容的文件 :

./openerp_server.py –i18n-import=file.csv -l LANG

这里的 LANG 是以 CVS 格式保存的文件，存有这个语言的翻译资料。

注意，翻译的文件内容必须使用 UTF8 编码!

翻译成新的语言¶

请时刻记得，对于相同的资源要使用相同的翻译词句 。在 Launchpad 线上翻译里，可以找到一些有用的提示。

在以下这个网站上可以找到更多关于翻译加速器的资讯: http://translate.sourceforge.net/wiki/guide/translation/accelerators

想要翻译成某种语言，或是想要修改某个语言的翻译内容，必须依照以下步奏:

1. 把要翻译的所有词句输出到 CSV 文件¶

使用以下指令输出这个文件:

./openerp_server.py –i18n-export=file.csv -l**LANG**

这里的 LANG 是你想翻译的标的语言。

2. 翻译文件的最后一列¶

你可以制作某个语言的翻译文件，不论这个语言是已经被翻译过的还是一个新的语言。如果你处理的是一个已经翻译过的语言，以前翻译好的词句应该要写在最后一列。

例如，以下是某个翻译文件(荷兰语)的前几行:

type	name	res_id	src	value
field	“account.account,code”	0	Code	Code
field	“account.account,name”	0	Name	Name
model	“account.account,name”	2	Assets	Aktiva
model	“account.account,name”	25	Results	Salden
model	“account.account,name”	61	Liabilities	Verbindlichkeiten

3. 把这个文件导入 OpenERP (如同前一节所说明的)¶

注释

你应该要在一个空的数据库里进行这些工作，以免覆盖到其他资料。

用以下的指令创建一个新的数据库 (名为 ‘terp_test’):

createdb terp_test –encoding=unicode terp_server.py –database=terp_test –init=all

或者，你也可以用以下的指令删除你当前的数据库 :

dropdb terp createdb terp –encoding=unicode terp_server.py –init=all

4. 采用 Launchpad / Rosetta 来翻译模块和应用程序¶

以下的链接是一个很好的开始 https://launchpad.net/openobject

线上翻译

选择模块翻译的段落，输入你的翻译。

离线翻译

如果你想一次性翻译100个名词，就采用离线翻译的方式。

要成功的完成翻译的一个周期，必须严格遵守以下的步奏。 (在 Linux 上测试的结果)

从 Launchpad 下载 <po 文件> 。

从 bzr 分支找到模板文件 <pot 文件>

记得 <pot 文件> 不一定会包含所有字串，因为 <pot 文件> 是不定期更新的。

msgmerge <pot 文件> <po 文件> -o <新 po 文件>

采用 poedit, kbabel (KDE) 翻译 <新 po 文件>

有些程序 (例如 kbabel) 可以用字典进行大略的翻译。

有一个特别有用的做法，就是从现有的翻译中创建一个完整的字典，以便能重复使用与应用程序相关的现有词汇。

在 OpenERP 里载入全部或是大部分的模块

载入你的语言

将你的语言的全部模块输出成 po 文件，然后把这个文件当成是字典。依据模块内容的不同，这个做法可以产生准确度 30-80% 的翻译。

<新 po 文件> 一定不可以有 kbabel 大略翻译产生的 <模糊> 叙述

grep -v fuzzy <新 po 文件> > <po 文件>

检查拼字是否正确

msgfmt <po 文件> -o <mo 文件>

检查翻译的连贯性

导入 (模块的) <po 文件>

安装 <mo 文件> ，然后重启应用程序

调整 OpenERP 里的线上翻译

检查连贯性

检查字串的长度

输出 <po 文件>

把 <po 文件> 上传到 Launchpad

记住 Launchpad / Rosetta 会抓取某些 (不确定是哪些) 藏在输出文件 <po 文件> 标头段落的标签，来判别导入的 <po 文件> 是否有效。

一段时间 (几小时) 后，你会收到一封 E-Mail ，确认结果是成功还是有错误。

采用上下文词典进行翻译¶

上下文词典在以下段落有详细说明 “物件 - 方法 - 上下文词典”. 如果使用管理菜单安装新增加语言，上下文词典里会新增加一个主要 : 语言。例如，如果安装了法语，而且设置为当前使用者的语言，使用者的上下文词典里会新增加一个主要语言，而且这个主要语言会被连结到 fr_FR 这个值上。

技术备忘录¶

技术备忘录，通常被昵称为 “欺骗表(cheat sheet)”，是 OpenERP 开发人员的快速参考指南。

技术备忘录

技术备忘录一般是每个 OpenERP 的主要版次更新，而且包含了 OpenERP 的程序编程界面(API)的全体概览；其中有模块的宣告， ORM，XML 语法，动态视窗和工作流程。备忘录并不是一个广泛的参考，而是一个快速找到存取或使用某些 OpenERP 功能的指南。所以每个主题都只有一小段叙述，通常还附带一个小范例。

在技术备忘录里的范例全部是来自范例模块 idea ；这个模块可以让一个组织管理成员提交的一般 ideas(想法) 。

备忘录有2种版本，第一种是适合A4横向打印，每一页有3个栏位的文字，整个备忘录只有不到 20 迷你页 (栏位)。这种设计是为了把这些页打印出来装订在一起，变成参考手册。第二种版本包含了许多细节资讯，依照A4纵向排版，这样比较容易阅读内容，但是尺寸大些。

所有版次的技术备忘录 (包含以前的版次) ，都可以在这里找到 : 技术备忘录

信息库¶

信息库是一种树状结构的语义描述方式，用于描述所储存的资料，而不是资源。信息库的结构如下:

预设的值

有条件的值；

州（省）取决于邮编，

付款方法取决于伙伴，

事件客户端的反应动作；

滑鼠在请款单菜单上单击，

打印一份请款单，

对一个伙伴的动作， ...

信息库(IR)有 3 个物件方法；

在语义树里增加值

在语义树里删除值

在一个选定表单里取得所有值

设定数值¶

ir_set（信息库_设置）标签让你能在 “信息库” 里新增数值。这个标签必须包含数个 字段（field） 标签，这些字段标签要具备 name 及 eval 属性。

这些属性是依据存取信息库的方法定义的；我们必须在提供标签时设置以下属性：keys, args, name, value, isobject, replace, meta, 和其他一些可选的属性。

范例:

<ir_set>
    <field name="keys" eval="[('action','client_print_multi'),('res_model','account.invoice')]"/>
    <field name="args" eval="[]"/>
    <field name="name">Print Invoices</field>
    <field name="value" eval="'ir.actions.report.xml,'+str(l0)"/>
    <field name="isobject" eval="True"/>
    <field name="replace" eval="False"/>
</ir_set>

信息库物件方法¶

def ir_set(cr, uid, key, key2, name, models, value, replace=True, isobject=False, meta=None)

def ir_get(cr, uid, key, key2, models, meta=False, context={}, res_id_req=False)

def ir_del(cr, uid, id):

字段描述:

key:

key2:

name:

models):

value:

isobject:

replace: 所描述的动作是否应该覆盖现有的动作，或是应该被加到现在的动作清单里。

meta:

使用 ir_set 和 ir_get:

...

    res = ir.ir_set(cr, uid, key, key2, name, models, value, replace, isobject, meta)

...

...

    if not report.menu_id:

        ir.ir_set(cr, uid, 'action', 'client_print_multi', name, [(model, False)], action, False, True)

    else:

        ir.ir_set(cr, uid, 'action', 'tree_but_open', 'Menuitem', [('ir.ui.menu', int(m_id))], action, False, True)

...

...

    res = ir.ir_get(cr, uid, [('default', self._name), ('field', False)], [('user_id',str(uid))])

...

    account_payable = ir.ir_get(cr, uid, [('meta','res.partner'), ('name','account.payable')], opt)[0][2]

...