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

菜单管理

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

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

粉丝管理

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

消息记录

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

素材管理

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

自动回复

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

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

多媒体回复

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

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

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

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

创建字段类型

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

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

1
2
3
4
5

from odoo import fields

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

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

创建Widget

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

1
2
3
4
5

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方法。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18

_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);
 }

最终效果

在ubuntu18.04上升级postgresql10 到postgresql11

安装postgresql 11

1
2
3
4
5

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

查看安装的版本

查看此时集群：

1
2
3
4
5

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

很早之前，在博客园的文章中曾经介绍过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例子来看一下：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17

<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方法:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

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经常碰到的老朋友们:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121

...
<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方法:

1
2
3
4
5
6
7
8
9
10
11

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源文件：

1
2
3
4

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

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

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 12.0

对于销售单订单中仅包含服务类的产品时，如果直接开票会提示如下错误：

1

There is no invoiceable line. If a product has a Delivered quantities invoicing policy, please make sure that a quantity has been delivered.

其意思就是订单行中没有已经交货的数量（因为我们的服务产品根本就不会产生交货单），因此提示你需要手动修改一下交货数量。

交货数量只有服务产品可以修改，库存商品只读。

hexo 在win下可以正常使用，在ubuntu 18.04和macOS中会报如下错误：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22

Template render error: (unknown path) [Line 8, Column 25]
Error: Unable to call `the return value of (posts["first"])["updated"]["toISOString"]`, which is undefined or falsey
at Object._prettifyError (/Users/kevinkong/Documents/codes/hexo/hexo/node_modules/nunjucks/src/lib.js:36:11)
at /Users/kevinkong/Documents/codes/hexo/hexo/node_modules/nunjucks/src/environment.js:567:19
at Template.root [as rootRenderFunc] (eval at _compile (/Users/kevinkong/Documents/codes/hexo/hexo/node_modules/nunjucks/src/environment.js:637:18), <anonymous>:214:3)
at Template.render (/Users/kevinkong/Documents/codes/hexo/hexo/node_modules/nunjucks/src/environment.js:556:10)
at Hexo.module.exports (/Users/kevinkong/Documents/codes/hexo/hexo/node_modules/hexo-generator-feed/lib/generator.js:40:22)
at Hexo.tryCatcher (/Users/kevinkong/Documents/codes/hexo/hexo/node_modules/bluebird/js/release/util.js:16:23)
at Hexo.<anonymous> (/Users/kevinkong/Documents/codes/hexo/hexo/node_modules/bluebird/js/release/method.js:15:34)
at Promise.map.key (/Users/kevinkong/Documents/codes/hexo/hexo/node_modules/hexo/lib/hexo/index.js:318:20)
at tryCatcher (/Users/kevinkong/Documents/codes/hexo/hexo/node_modules/bluebird/js/release/util.js:16:23)
at MappingPromiseArray._promiseFulfilled (/Users/kevinkong/Documents/codes/hexo/hexo/node_modules/bluebird/js/release/map.js:61:38)
at MappingPromiseArray.PromiseArray._iterate (/Users/kevinkong/Documents/codes/hexo/hexo/node_modules/bluebird/js/release/promise_array.js:114:31)
at MappingPromiseArray.init (/Users/kevinkong/Documents/codes/hexo/hexo/node_modules/bluebird/js/release/promise_array.js:78:10)
at MappingPromiseArray._asyncInit (/Users/kevinkong/Documents/codes/hexo/hexo/node_modules/bluebird/js/release/map.js:30:10)
at _drainQueueStep (/Users/kevinkong/Documents/codes/hexo/hexo/node_modules/bluebird/js/release/async.js:142:12)
at _drainQueue (/Users/kevinkong/Documents/codes/hexo/hexo/node_modules/bluebird/js/release/async.js:131:9)
at Async._drainQueues (/Users/kevinkong/Documents/codes/hexo/hexo/node_modules/bluebird/js/release/async.js:147:5)
at Immediate.Async.drainQueues [as _onImmediate] (/Users/kevinkong/Documents/codes/hexo/hexo/node_modules/bluebird/js/release/async.js:17:14)
at runCallback (timers.js:705:18)
at tryOnImmediate (timers.js:676:5)
at processImmediate (timers.js:658:5)

最初以为是操作系统的问题，升级npm、nodejs等方法均不起作用。

后来在github上的一个issue中找到了答案，原来是hexo-generator-sitemap, hexo-generator-feed两个插件不兼容hexo3 导致的。

解决方案,卸载hexo-generator-sitemap, hexo-generator-feed连个插件。

1
2

sudo npm uninstall hexo-generator-sitemap
sudo npm uninstall hexo-generator-feed

双重认证可以实现一种动态的口令，使用户的账号得到更安全的保护，即便用户的密码可能泄露，但是因为双重认证的存在，使得非法人员的入侵成本更高，数据也就更为安全。今天我们就来讲一下，如何在odoo中使用双重认证。

指定用户启用双重认证

我们的模块支持一部分用户使用双重认证登录，另一部分可以不使用。开启双重认证的方式非常简单，在用户设置界面的双重认证选项卡上启用双重认证即可。

生成安全认证二维码

点击生成二维码按钮，生成包含密钥的二维码，此二维码比较敏感，不要泄露。

使用手机身份验证器

使用手机身份证验证器扫码上面提到的二维码，然后就可以看到一个动态的6位数字，每隔1分钟变更一次。用户在登录的时候，必须要输入验证器上生成的6位数字，否则登录不成功。

下载模块

模块已经在odoo官方网站上架

也可以在鄙人的淘宝店选购。

由于业务需要，公司内部的ERP系统需要与小红书对接，介于odoo当前的市场覆盖率，apps store里自然是没有与此相关的现成模块可用了，既然没有现成的轮子可用，那么就只能自己造轮子了。

小红书接口

小红书的接口大部分都可以从小红书大学的开放平台上找到。这里我们主要的目的是将小红书的订单同步到我们本地的ERP系统中。

产品的匹配

小红书有自己的一套SKU编码，要与本地的ERP做映射关系，这样才能保证产品同步的一致性。这里我们使用了包装，跟ERP中的SKU做了一对一的映射。

小红书的物流模式

小红书支持多种物流模式，其中第三方保税模式是无法从系统中读取到订单状态的，只能利用小红书的回调接口将订单变化时推送到我们的系统中。所幸的是，我们目前的业务使用的一种是直邮，一种是小红书的保税仓(即RED STANDARD模式)。

用户信息

小红书对用户的隐私设置比较严格，只能获取到未发货的订单的用户信息，一旦订单发货，用户信息就变成了脱敏信息。

订单处理

小红书提供了两个与订单相关的接口，一个是批量查询接口，一个是查询某个订单的详细信息。因此我们的同步策略可以设置为先用批量查询接口同步批量订单信息，然后根据不同的订单状态筛选，针对那些没有完成的订单，定时轮询。

一旦订单有了发货时间，就将Odoo中的销售订单设置为确认状态，等订单完成，再自动将与之相关的出库单完成。

编码思路

小红书是一个平台，我们的店是其中的店铺，与接口相关的设置与店铺绑定，因此我们需要先创建店铺这个对象：

1
2
3
4
5
6
7

class account(models.Model):
    _name = "xiaohongshu.account"

    name = fields.Char("店铺名称")
    app_key = fields.Char("APP KEY", help="OPENAPI的key")
    app_secret = fields.Char("APP SECRET", help="OPENAPI的密钥")
    ...

appkey和appsecret是调用小红书开放平台的key和密钥。

然后我们使用odoo的定时任务，自动执行同步订单的操作：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

@api.model
def _get_orders(self):
    """
    获取小红书的订单
    """
    shops = self.search([])
    for shop in shops:
        _logger.info(f"同步小红书店铺：{shop.name}的订单..")
        ark = ARK(shop.app_key, shop.app_secret)
        # 先同步待配货和配货中的订单
        # self._get_order_info(ark)
        # 再同步已发货的订单
        self._get_order_info(ark, status="shipped")
        # 已接收的订单
        self._get_order_info(ark, status="received")

为了与店铺的库位绑定，我们需要在店铺上指定销售的出库路线。

odoo中的用户类型

先从odoo中的用户类型说起，odoo中的用户大致可以分为三类：

• 内部用户： 企业内部的用户，拥有对系统内部的访问权限，具体根据不同的角色权限不同而不同。
• 门户用户： 非企业内部用户，通常为业务合作伙伴用户，拥有有限的资源访问权限。
• 公共用户： 面向公众的权限，可以理解为游客权限。

在11.0及以前，门户和公共用户是在技术设置中的一个用户组，只要将某个用户放入到对应的组中即变为相应的用户类型。从12.0开始，用户类型由技术设置迁移到了更为明显的位置：

![demo.pngdeom.png)

技术应用

12.0 中此三个用户对应的用户组分别为

• 内部用户：base.group_user
• 门户用户：base.group_portal
• 公共用户：base.group_public