odoo产品信息添加可用库存

发表于 2020-04-15 | 分类于 odoo

添加可用库存的必要性

odoo当前版本(12,13)中的产品信息中有在手数量和预测数量，在手数量指的是当前库存中实际存在的库存数量，预测数量指的是包含即将入库和即将出库的一个库存预测值。预测数量 = 在手数量 + 即将入库数量 - 即将出库数量。即将在这里的意思当然就是尚未完成的状态。

但是在实际使用的过程中，我们往往还关心另一个很重要的参数，可用数量。可用数量 = 在手数量 - 已预留数量。遗憾的是odoo官方并未提供这个字段。因此，我们需要手动实现它。

odoo的库存模型stock.quant中已经有了在手数量quantity和已预留数量reserved_quantity，因此可用数量的值可以通过定义一个计算字段available_qty：

avaliable_qty = fields.Float(
        "可用库存", compute="_get_avaliable_qty", store=True)

@api.one
@api.depends("quantity", "reserved_quantity")
def _get_avaliable_qty(self):
    self.avaliable_qty = self.quantity - self.reserved_quantity

实际效果

odoo字段继承改写类型报错问题

发表于 2020-04-05 | 分类于 odoo

本文基于13.0

由于开发需要，想要把hr模块中的address_home_id改成文本类型，本来以为很简单的事情，很快码好了代码，但是却发现后台报错了，直接导致了系统进入不了。

  File "/mnt/hgfs/codes/odoo/odoo-13.0/odoo/modules/registry.py", line 85, in new
    odoo.modules.load_modules(registry._db, force_demo, status, update_module)
  File "/mnt/hgfs/codes/odoo/odoo-13.0/odoo/modules/loading.py", line 416, in load_modules
    force, status, report, loaded_modules, update_module, models_to_check)
  File "/mnt/hgfs/codes/odoo/odoo-13.0/odoo/modules/loading.py", line 312, in load_marked_modules
    perform_checks=perform_checks, models_to_check=models_to_check
  File "/mnt/hgfs/codes/odoo/odoo-13.0/odoo/modules/loading.py", line 194, in load_module_graph
    registry.setup_models(cr)
  File "/mnt/hgfs/codes/odoo/odoo-13.0/odoo/modules/registry.py", line 247, in setup_models
    model._setup_fields()
  File "/mnt/hgfs/codes/odoo/odoo-13.0/odoo/models.py", line 2684, in _setup_fields
    field.setup_full(self)
  File "/mnt/hgfs/codes/odoo/odoo-13.0/odoo/fields.py", line 420, in setup_full
    self._setup_related_full(model)
  File "/mnt/hgfs/codes/odoo/odoo-13.0/odoo/fields.py", line 476, in _setup_related_full
    field.setup_full(target)
  File "/mnt/hgfs/codes/odoo/odoo-13.0/odoo/fields.py", line 420, in setup_full
    self._setup_related_full(model)
  File "/mnt/hgfs/codes/odoo/odoo-13.0/odoo/fields.py", line 475, in _setup_related_full
    field = target._fields[name]
AttributeError: 'bool' object has no attribute '_fields'

本来一度以为是13.0又变更了API，不支持通过继承的方式改变字段的类型了，后来google也没发现类似的错误，于是只跟踪debug。

def _setup_related_full(self, model):
    """ Setup the attributes of a related field. """
    # fix the type of self.related if necessary
    if isinstance(self.related, str):
        self.related = tuple(self.related.split('.'))

    # determine the chain of fields, and make sure they are all set up
    target = model
    for name in self.related:
        field = target._fields[name]
        field.setup_full(target)
        target = target[name]
    ...

输出日志发现

---------
mobile_phone hr.employee()
---------
employee_id res.users()
---------
phone hr.employee()
---------
address_home_id hr.employee()
---------
phone False

在setup addreess_home_id字段之后，又去setup了phone，这就有点微妙了。

后来，突然想到，address_home_id肯定是被别的字段做了关联引用，从而导致了一旦变更了本字段的类型，会导致之前代码中关联的字段不能正确挂载而导致报错。

多公司下的税率设置

发表于 2020-03-18 | 分类于 odoo

事情的起因是这样的，公司的odoo系统使用了多公司，集团零售门店部门使用的是B公司，供应链系统使用的是A公司，某天B公司的采购报告，下不了采购单，提示res.company对象因为Rule的问题，没有访问权限。从后台日志中可以看到，B在下单的时候试图访问A公司的资料。

既然是安全规则的问题，那么我就去看了一下公司对象的设置，一切正常。奇怪的是B公司的采购明明只有B公司的访问权限，为什么要去访问A公司的资料呢？

根据前端提示的报错代码，定位到了，B公司采购在下单的时候使用了A公司的供应商税。问题又来了，B公司下采购单，为什么要访问A公司的税种呢？后来发现，A公司的采购税居然在B公司下可见，显然，税的访问设置出了问题。

我们找到税率的安全规则，看到了如下的访问设置:

1	[(1,'=',1)]

显然，这里的设置是不对的，改为

1	[('company_id','child_of',[user.company_id.id])]

即恢复正常。

结论

从上面的过程中，我们可以反思Odoo是如何处理多公司条件下的税种隔离方案，靠的就是安全规则，不同公司的人看到的税种不一样。而对于成本价，odoo的处理方式是另外一种，改天再细谈。

在odoo中使用Swagger

发表于 2020-02-27 | 分类于 odoo

感谢OCA为我们提供了基础模块

做后台的同学一定听说过swagger的大名，现在改名叫OpenApi了，简单说就是一个提供了方便测试的接口界面。跟我们做对接的人，打开界面就能轻松地知道如何正确的调用我们的接口和接收返回值。

网上比较多的是flask和swagger结合的例子，如果我们想要在odoo中实现类似的REST Swagger模式，我们可以按照下面的方式进行。

安装依赖

本文依赖于OCA的一个模块base_rest，读者可以自行搜索，也可以关注odoohub回复base_rest获取下载链接。

编写接口

由于odoo自带的jsonrpc并不能满足我们的需求(我们不可能给第三方系统的人提供一种类似res.partner的对象，并给他们解释对象的意思)，因此，我们需要重新定义一些业务接口。

定义一个新的Service

我们把新的API接口定义为一个Service，继承base.rest.service这个对象，并定义好usage、description等属性。

class AladinService(Component):
    _inherit = "base.rest.service"
    _name = "aladin.service"
    _usage = "Aladin"
    _collection = "base.rest.aladin.services"
    _description = """
        阿拉丁业务API
    """

定义接口

rest_api借助cerberus(Cerberus是一个用于Python的轻量级且可扩展的数据验证库)来验证我们输入的字段值。

一个典型的get接口可以写成下面这样：

@skip_secure_response
def get(self, _id, size):
    """
    Get partner's image
    """
    field = "image"
    if size == "small":
        field = "image_small"
    elif size == "medium":
        field = "image_medium"
    status, headers, content = self.env["ir.http"].binary_content(
        model="res.partner", id=_id, field=field, env=self.env
    )
    if not content:
        raise MissingError(_("No image found for partner %s") % _id)
    image_base64 = base64.b64decode(content)
    headers.append(("Content-Length", len(image_base64)))
    response = request.make_response(image_base64, headers)
    response.status_code = status
    return response

其中方法的描述会自动加载到swagger的方法描述中。

定义API路径

在controller中，定义API接口的路径：

class BaseRestDemoPrivateApiController(main.RestController):
    _root_path = "/base_rest_demo_api/private/"
    _collection_name = "base.rest.demo.private.services"
    _default_auth = "user"

base_rest提供了基本的权限认证，基于odoo自身的账户设置。_default_auth的可选值有public和user。两个值会被加载到controller的auth参数中，以用来标识验证方法。

这并非当前流行的验证方式，可惜的是oca并没有提供oatuh的验证机制。因此，笔者在实际的应用过程中，借鉴了另外的一个模块restapi的方式。

页面展示

安装模块后，我们可以在Odoo中的模块界面中看到一个swagger的图标：

点击进入swagger api界面：

在odoo中管理微信公众号

发表于 2020-02-17 | 分类于 odoo

odoo用来管理微信公众号是非常合适的，今天我们就来介绍一下正在开发中的微信公众号模块的主要功能。后续功能正在添加中，欢迎持续关注。

菜单管理

最基础的功能就是将微信公众号的菜单管理系统接入到odoo中。

在odoo中的新增、编辑和删除菜单都会自动同步到微信公众号中。

粉丝管理

我们同样可以把关注公众号的用户信息同步到odoo中。

消息记录

我们这里把用户发送的消息存储了起来，方便归档查询使用。

素材管理

通过素材管理，用户可以在odoo系统内完成对公众号图片、语音、视频信息的上传、删除等管理功能。
配合自动回复，可以实现灵活丰富地回复效果。

自动回复

公众号的一大功能就是自动回复，根据不同的事件类型回复不同的内容。

支持输入Python代码，在页面中灵活定制返回内容，不用再每次都修改源代码了。

多媒体回复

自动回复可以使用多媒体文件进行回复了。

演示系统地址: demo13.mixoo.cn
账号 odoohub 密码 odoohub
演示公众号:

Odoo图片URL模块开发手记

发表于 2020-02-16 | 分类于 odoo

我们都知道，odoo中的图片支持两种存储方式，一种是将图片存储在数据库中，另外一种是存储在本地文件中。项目小时，这两种方式其实都没有什么问题，但是随着项目的扩大，一旦使用了集群，这种静态文件的增长会让问题变得棘手。于是，一直在思考有没有一种方式，可以将图片放到现在比较流行的云存储上面。之前写过一片关于AWS S3自动上传媒体文件的文章，今天我们就来实现另外一种图片模块，让用户输入URL地址，然后显示出对应的图片来。

这里主要用到了自定义字段的技术，下面就大体描述一下整个开发的过程和其中碰到的坑。

创建字段类型

我们希望能够在odoo中创建一种新的字段类型，这种字段类型在只读模式下表现为图片，当用户编辑时，变为一个输入框，当用户输入URL后，自动将URL关联的图片显示出来。

首先，我们需要创建一个新的字段类，该类是Field类的子类：

from odoo import fields

class ImageURL(fields.Field):
    type = "imageurl"
    column_type = ('varchar', 'varchar')

我们给字段类型定义为imageurl，暗示本字段在编辑模式下表现为input输入框，在只读模式下表现为图片。

odoo中的每种字段类型都有与之匹配的widget，我们这里主要拿Input控件来进行改造，因此widget继承自InputField:

var ImageURLField = InputField.extend(TranslatableFieldMixin, {
        className: "o_field_image",
        tagName: 'span',
        supportedFieldTypes: ['char']
}

widget创建完，必须要注册到registry才能在view中加载。registry就像一个钩子，将你创建的widget与具体的前端view关联起来。

1	registry.add('imageurl', ImageURLField);

渲染图片

我们的字段的行为有连个特点，只读模式下为图片，编辑模式下为输入框。这个需要用到渲染函数_render, _render内部调用了_renderReadonly和_renderEdit方法。

_renderReadonly: function () {
    var url = this.value;
    var $img = $(qweb.render("FieldBinaryImage-img", { widget: this, url: url }));
    // override css size attributes (could have been defined in css files)
    // if specified on the widget
    var width = this.nodeOptions.size ? this.nodeOptions.size[0] : this.attrs.width;
    var height = this.nodeOptions.size ? this.nodeOptions.size[1] : this.attrs.height;
    if (width) {
        $img.attr('width', width);
        $img.css('max-width', width + 'px');
    }
    if (height) {
        $img.attr('height', height);
        $img.css('max-height', height + 'px');
    }
    this.$('> img').remove();
    this.$el.prepend($img);
}

这里我们借用了BinaryImage部件的代码，因为我们想让图片在只读模式下表现的跟BinaryImage行为一致。

在没有重载_renderEdit方法时，ImageURL在只读模式下没有值，原因是其内部的值是图片，无法正确显示。因此，我们这里需要将字段的值重新赋给输入框。

1
2
3

_renderEdit: function () {
    this.$el.val(this.value);
 }

最终效果

postgresql-upgrade-10-11-ubuntu18.04

发表于 2020-02-11 | 分类于 postgresql

在ubuntu18.04上升级postgresql10 到postgresql11

安装postgresql 11

echo "deb http://apt.postgresql.org/pub/repos/apt/ $(lsb_release -cs)-pgdg main 11" | sudo tee /etc/apt/sources.list.d/pgsql.list

wget --quiet -O - https://www.postgresql.org/media/keys/ACCC4CF8.asc | sudo apt-key add -

sudo apt update && sudo apt install postgresql-11

安装完成后，此时机器上是有两个postgresql的。可以使用

1	dpkg -l \| grep postgresql

查看安装的版本

查看此时集群：

pg_lsclusters

-------------
10  main    5432 online postgres /var/lib/postgresql/10/main /var/log/postgresql/postgresql-10-main.log
11  main    5433 online postgres /var/lib/postgresql/11/main /var/log/postgresql/postgresql-11-main.log

可以看到有两个版本的pg

升级10到11

停止11集群

1	sudo pg_dropcluster 11 main --stop

采用以下命令升级：

1	sudo pg_upgradecluster 10 main

再次使用pg_lsclusters命令查看，可以看到10已经停止 11启动：

1
2
3

Ver Cluster Port Status Owner    Data directory              Log file
10  main    5433 down   postgres /var/lib/postgresql/10/main /var/log/postgresql/postgresql-10-main.log
11  main    5432 online postgres /var/lib/postgresql/11/main /var/log/postgresql/postgresql-11-main.log

释放pg10

1	sudo pg_dropcluster 10 main

完成以后移除旧包：

1	sudo apt purge postgresql-10 postgresql-client-10 postgresql-contrib-10

不知道为什么，我这里移除时竟然装上了postgresql12，只好又使用apt purge移除了12

Odoo中的Relax NG

发表于 2020-02-11 | 分类于 odoo

很早之前，在博客园的文章中曾经介绍过Relax NG，如今odoo发展到了12.0，13.0时代，重新梳理一下有关Relax NG的知识点。

Relax NG是什么

Relax NG 是 REgular LAnguage for XML Next Generation的缩写，即“可扩展标记语言的下一代正规语言”，是一种基于语法的可扩展标记语言模式语言，可用于描述、定义和限制可扩展标记语言（标准通用标记语言的子集）词汇表。简单地说 Relax NG是解释XML如何被定义的一套XML。Odoo就是通过定义了一套rng文件定义了自己一套xml框架结构，在模块被安装或者升级的时候将其解析成与之相对应的内置对象，存储在数据库中。关于Relax NG的语法规则，可以参考Relax NG的官网。

Relax NG语法

我们可以结合odoo中的一个Relax NG例子来看一下：

<rng:define name="data">
    <rng:element name="data">
        <rng:zeroOrMore>
            <rng:choice>
                <rng:ref name="field"/>
                <rng:ref name="label"/>
                <rng:ref name="separator"/>
                <rng:ref name="xpath"/>
                <rng:ref name="button"/>
                <rng:ref name="group"/>
                <rng:ref name="filter"/>
                <rng:ref name="html"/>
                <rng:element name="newline"><rng:empty/></rng:element>
            </rng:choice>
        </rng:zeroOrMore>
    </rng:element>
</rng:define>

这是我们常用的odoo视图文件中的data节点的结构。

define 定义一个节点，方便引用。
zeroOrMore 表示接受零个或多个节点。
choice 表示在列表中选择。

关于Relax NG更多介绍，请参见官方网站

odoo解析Relax NG

模块安装时

模块在安装时，odoo会解析xml文件是否符合既有的xml架构，解析方法使用的是odoo.tools.convert.py中的convert_xml_import方法:

def convert_xml_import(cr, module, xmlfile, idref=None, mode='init', noupdate=False, report=None):
    doc = etree.parse(xmlfile)
    relaxng = etree.RelaxNG(
        etree.parse(os.path.join(config['root_path'],'import_xml.rng' )))
    try:
        relaxng.assert_(doc)
    except Exception:
        _logger.error('The XML file does not fit the required schema !')
        _logger.error(misc.ustr(relaxng.error_log.last_error))
        raise

    if idref is None:
        idref={}
    obj = xml_import(cr, module, idref, mode, report=report, noupdate=noupdate)
    obj.parse(doc.getroot(), mode=mode)
    return True

从上面的代码中可以看出，解析的文件是import_xml.rng，由此文件我们可以看到我们xml经常碰到的老朋友们:

...
<rng:define name="field">
    <rng:element name="field">
        <rng:attribute name="name" />
        <rng:choice>
            <rng:group>
                <rng:attribute name="type">
                    <rng:choice>
                        <rng:value>base64</rng:value>
                        <rng:value>char</rng:value>
                        <rng:value>file</rng:value>
                    </rng:choice>
                </rng:attribute>
                <rng:choice>
                    <rng:group>
                        <rng:attribute name="file"/>
                        <rng:empty/>
                    </rng:group>
                    <rng:text/>
                </rng:choice>
            </rng:group>
            <rng:group>
                <rng:attribute name="type"><rng:value>int</rng:value></rng:attribute>
                <rng:choice>
                    <rng:data type="int"/>
                    <rng:value>None</rng:value>
                </rng:choice>
            </rng:group>
            <rng:group>
                <rng:attribute name="type"><rng:value>float</rng:value></rng:attribute>
                <rng:data type="float"/>
            </rng:group>
            <rng:group>
                <rng:attribute name="type">
                    <rng:choice>
                        <rng:value>list</rng:value>
                        <rng:value>tuple</rng:value>
                    </rng:choice>
                </rng:attribute>
                <rng:oneOrMore><rng:ref name="value"/></rng:oneOrMore>
            </rng:group>
            <rng:group>
                <rng:attribute name="type">
                    <rng:choice>
                        <rng:value>html</rng:value>
                        <rng:value>xml</rng:value>
                    </rng:choice>
                </rng:attribute>
                <rng:oneOrMore>
                    <rng:ref name="any"/>
                </rng:oneOrMore>
            </rng:group>
            <rng:group>
                <rng:attribute name="ref"/>
                <rng:empty/>
            </rng:group>
            <rng:group>
                <rng:attribute name="eval"/>
                <rng:optional><rng:attribute name="model"/></rng:optional>
                <rng:empty/>
            </rng:group>
            <rng:group>
                <rng:attribute name="search"/>
                <rng:optional><rng:attribute name="model"/></rng:optional>
                <rng:optional><rng:attribute name="use"/></rng:optional>
                <rng:empty/>
            </rng:group>
            <rng:text/>
        </rng:choice>
    </rng:element>
</rng:define>


<rng:define name="record">
    <rng:element name="record">
        <rng:optional>
            <rng:attribute name="id" />
            <rng:optional>
                <rng:attribute name="forcecreate" />
            </rng:optional>
        </rng:optional>
        <rng:attribute name="model" />
        <rng:optional><rng:attribute name="context"/></rng:optional>
        <rng:zeroOrMore>
            <rng:ref name="field" />
        </rng:zeroOrMore>
    </rng:element>
</rng:define>

<rng:define name="template">
    <rng:element name="template">
        <rng:optional><rng:attribute name="id"/></rng:optional>
        <rng:optional><rng:attribute name="t-name"/></rng:optional>
        <rng:optional><rng:attribute name="name"/></rng:optional>
        <rng:optional><rng:attribute name="forcecreate"/></rng:optional>
        <rng:optional><rng:attribute name="context"/></rng:optional>
        <rng:optional><rng:attribute name="priority"/></rng:optional>
        <rng:optional><rng:attribute name="key"/></rng:optional>
        <rng:optional><rng:attribute name="website_id"/></rng:optional>
        <rng:group>
            <rng:optional>
                <rng:attribute name="inherit_id"/>
                <rng:optional>
                    <rng:attribute name="primary">
                        <rng:value>True</rng:value>
                    </rng:attribute>
                </rng:optional>
            </rng:optional>
            <rng:optional><rng:attribute name="groups"/></rng:optional>
            <rng:optional><rng:attribute name="active"></rng:attribute></rng:optional>
            <rng:optional><rng:attribute name="customize_show"></rng:attribute></rng:optional>
        </rng:group>
        <rng:zeroOrMore>
            <rng:choice>
                <rng:text/>
                <rng:ref name="any"/>
            </rng:choice>
        </rng:zeroOrMore>
    </rng:element>
</rng:define>
...

由此文件，我们可以总结出xml可以出现的一级节点列表：

menuitem

id（必填）
name
parent
action
sequence
groups
icon
web_icon
web_icon_hover
string

record

id(可选)
forcecreate（可选）
model
context（可选）
子节点：field（可多个）

template

id
t-name
name
forecreate
context
priority
inherit_id
primary
groups
active
customzie_show
page

delete

model
id
search

act_window

id
name
res_model
domain
src_model
context
view_id
view_type
view_mode
multi
target
key2
groups
limit
usage
auto_refresh

url

id
name
url
target

assert

model
search
count
string
id
context
severity
test

report

id
string
model
name
report_type
multi
menu
keyword
rml
file
sxw
xml
xsl
parser
auto
header
webkit_header
attachment
attachment_use
groups
usage

workflow

model
action
uid
context
ref
value

function

model
name
id
context
eval

ir_set

子节点：field

这就解释了，笔者曾经的困惑，xml中为什么可以出现act_window这样一个节点？menuitem是在哪里定义的？

视图渲染时

上面提到的只是对静态代码的约束，我们知道，odoo中非常有特点的功能就是可以在界面中编辑xml代码，那么，odoo又是如何确保用户手动填写的代码符合Relax NG架构的呢？

经过几番跟踪测试，我们发现，当odoo渲染页面视图时，会调用tools.view_validation中的relaxng方法:

def relaxng(view_type):
    """ Return a validator for the given view type, or None. """
    if view_type not in _relaxng_cache:
        with tools.file_open(os.path.join('base', 'rng', '%s_view.rng' % view_type)) as frng:
            try:
                relaxng_doc = etree.parse(frng)
                _relaxng_cache[view_type] = etree.RelaxNG(relaxng_doc)
            except Exception:
                _logger.exception('Failed to load RelaxNG XML schema for views validation')
                _relaxng_cache[view_type] = None
    return _relaxng_cache[view_type]

从上述方法中可以看出，每种视图都要经过验证，只有符合定义的属性才会通过。定义的文件位于base模块下的rng文件夹中。这里包含了我们经常用到的search、tree、pivot、graph、gantt、diagram、calendar等视图的结构文件。

自定义视图架构

了解了视图架构的验证机制，那么我们自然就想到了可以拓展视图的架构。最简单的方法莫过于直接修改RNG文件，但是这样污染了源代码。
想要避免修改源码的方法也很简单，重载relaxng方法，使之先查找自定义的RNG文件夹，如果找不到再去base模块查找。例如，笔者为了禁止日历视图拖拽，编写了一个calendar_draggle模块，其中就新增了一个draggable属性而没有修改RNG源文件：

<?xml version="1.0"?>
<calendar date_start="date_deadline" string="Tasks" mode="month" color="user_id" draggable="false">
    <field name="name"/>
</calendar>

odoo 配置文件不可读

发表于 2020-02-10 | 分类于 odoo

由于配置文件权限变化，导致启动报错:

1
2
3

Usage: odoo [options]

odoo: error: The config file '/etc/odoo/odoo.conf' selected with -c/--config doesn't exist or is not readable, use -s/--save if you want to generate it

解决方案：

检查配置文件权限和配置文件所在文件夹权限。

Odoo销售单中给服务类型产品开票