odoo-demo-addons-tutorial-odoo-12

此版本為 odoo12, odoo14 版本請參考 odoo14 分支.

本文章會持續更新:smile:

這邊文章主要是會手把手教大家撰寫 odoo 的 addons, 建議再閱讀這篇文章之前, 你已經看過以下的文章

odoo-development-environment-tutorial - 建立 odoo 開發環境 ( source code )

odoo-docker-tutorial - 利用 docker 快速建立 odoo 環境

前言

為甚麼我要寫一堆 addons, 因為其實 odoo 和 django 一樣的點是都很麻煩, 要寫個範例超級麻煩的,

因為一個小地方錯可能就會造成錯誤之類的:sweat:

addons 目錄

非常建議按照順序看, 因為會一步一步帶大家:smile:

其他

Youtube Tutorial - 使用 CLI 安裝,更新 addons

建立 addons 模組

./odoo-bin scaffold your_addons_name my-addons/

在介紹如何透過 cli 安裝 addons 之前, 請先知道一件事情,

就是你可以選擇將指令全部放到 cli 中, 或是在 odoo.conf 設定,

像是如果有設定 odoo.conf

[options]
......
db_user = odoo
db_password = odoo
db_port = 5432

這樣我們直接執行以下指令即可

python3 odoo-bin -d odoo -c /home/twtrubiks/work/odoo12/odoo/config/odoo.conf

如果你沒有設定 odoo.conf , 也可以在 cli 中設定

python3 odoo-bin -r odoo -w odoo  -d odoo -c /home/twtrubiks/work/odoo12/odoo/config/odoo.conf

-r 代表 db_user. -w 代表 db_password. -d 代表指定 database.

安裝 addons

python3 odoo-bin -i addons_1 -d odoo

更新 addons

python3 odoo-bin -u addons_1 -d odoo

也可以一次更新或安裝多個 addons

python3 odoo-bin -u addons_1,addons_2 -d odoo

例外還有比較進階的用法 --dev

python3 odoo-bin -u addons_1 -d odoo --dev=all

--dev=all 代表全部都啟用.

--dev=xml 代表當 xml 改變的時候, 會自動幫你更新(不用手動更新).

--dev=reload 代表當 python code 改變時, 自動更新(不用手動更新).

但有時候如果你覺得怪怪的, 我還是建議手動重新直接更新 addons 的指令比較好:smile:

注意:exclamation:沒有刪除 addons 的指令, 只能從 web 上移除.

shell

Youtube Tutorial - odoo shell 基本教學 - CRUD

python odoo-bin shell -w odoo -r odoo -d odoo --db_port=5432 --db_host=localhost --addons-path='/home/twtrubiks/odoo/addons'

如果有很多路徑請使用 , 隔開

--addons-path='/home/twtrubiks/odoo/addons,/home/twtrubiks/odoo/addons2'

search

>>> self.env['res.partner'].search([])
res.partner(14, 26, 33, 27, 10, 35, 18, 19, 11, 20, 22, 31, 23, 15, 34, 12, 21, 25, 37, 24, 36, 30, 38, 13, 29, 28, 9, 17, 32, 16, 1, 39, 40, 8, 7, 3)
>>> self.env['res.partner'].search([('name', 'like', 'kim')])
res.partner(24,)
>>> self.env['res.partner'].browse([11, 20])
res.partner(11, 20)

Youtube Tutorial - odoo shell orm 基本教學 - search_read

search_read

通常比較常使用在 js 呼叫 odoo 或是第三方呼叫 odoo api,

>>> self.env['hr.expense'].search_read([], ['id', 'employee_id'])
[{'id': 4, 'employee_id': (7, 'Marc Demo')}, {'id': 3, 'employee_id': (7, 'Marc Demo')}, {'id': 2, 'employee_id': (1, 'Mitchell Admin')}, {'id': 1, 'employee_id': (1, 'Mitchell Admin')}]

>>> self.env['hr.expense'].search_read([('employee_id', '=', 1)], ['id', 'name', 'employee_id'])
[{'id': 2, 'name': 'Hotel Expenses', 'employee_id': (1, 'Mitchell Admin')}, {'id': 1, 'name': 'Travel by Air', 'employee_id': (1, 'Mitchell Admin')}]

search_count

>>> self.env['res.partner'].search_count([])
73

recordset.ids 回傳 recordset 全部的 id

>>> recordset = self.env['res.partner'].search([])
>>> recordset.ids
[14, 26, 33, 27, 10, 35, 18, 19, 11, 20, 22, 31, 23, 15, 34, 12, 21, 25, 37, 24, 36, 30, 38, 13, 29, 28, 9, 17, 32, 16, 1, 39, 40, 8, 7, 3]

繼續使用上面的範例

recordset.filtered(func) 和 python 中的 filter 類似

>>> recordset.filtered(lambda r: r.name.startswith('C'))
res.partner(33, 39)

recordset.mapped(func) 和 python 中的 map 類似

>>> recordset.mapped('name')
['Azure Interior', 'Brandon Freeman', 'Colleen Diaz', 'Nicole Ford', 'Deco Addict', 'Addison Olson', 'Douglas Fletcher', 'Floyd Steward',...

recordset.sorted(func) 和 python 中的 sorted 類似

>>> recordset.sorted(key=lambda r: r.id, reverse=True)
res.partner(40, 39, 38, 37, 36, 35, 34, 33, 32, 31, 30, 29, 28, 27, ...

create

>>> partner = self.env['res.partner']
>>> partner.create({'name': 'twtrubiks', 'is_company': True})
res.partner(66)
>>> self.env.cr.commit() # 需要特別執行這行才會寫進資料庫中

write

update data

>>> partner = self.env['res.partner'].browse([2])
>>> partner
res.partner(2,)
>>> partner.name
'OdooBot'
>>> partner.write({'name': 'hello'})
True
>>> partner.name
'hello'
>>> self.env.cr.commit() # 需要特別執行這行才會寫進資料庫中

當你更新 One2many 和 Many2many 時, 要使用比較特別的語言,

我之後會補充上來.

copy

如果 fields 有定義 copy=False, 就沒有辦法複製.

# odoo/addons/base/data/res_users_demo.xml
>>> demo = self.env.ref('base.user_demo')
>>> demo.copy({'name': 'twtrubiks', 'login': 'twtrubiks', 'email':''})
>>> self.env.cr.commit() # 需要特別執行這行才會寫進資料庫中

delete

>>> user = self.env['res.users'].browse([3])
>>> user.unlink()
2020-06-21 06:45:51,958 19735 INFO odoo odoo.models.unlink: User #1 deleted ir.model.data records with IDs: [1884]
2020-06-21 06:45:51,996 19735 INFO odoo odoo.models.unlink: User #1 deleted res.users records with IDs: [3]
True
>>> self.env.cr.commit() # 需要特別執行這行才會寫進資料庫中

sudo

Youtube Tutorial - odoo 基本教學 - sudo

可參考 odoo 原始碼的 odoo/models.py

def sudo(self, user=SUPERUSER_ID):
    """ sudo([user=SUPERUSER])

    Returns a new version of this recordset attached to the provided
    user.

    By default this returns a ``SUPERUSER`` recordset, where access
    control and record rules are bypassed.

    .. note::

        Using ``sudo`` could cause data access to cross the
        boundaries of record rules, possibly mixing records that
        are meant to be isolated (e.g. records from different
        companies in multi-company environments).

        It may lead to un-intuitive results in methods which select one
        record among many - for example getting the default company, or
        selecting a Bill of Materials.

    .. note::

        Because the record rules and access control will have to be
        re-evaluated, the new recordset will not benefit from the current
        environment's data cache, so later data access may incur extra
        delays while re-fetching from the database.
        The returned recordset has the same prefetch object as ``self``.

    """
    return self.with_env(self.env(user=user))

sudo([user=SUPERUSER]) 如果裡面沒有填入 user id, 預設就是使用 SUPERUSER, 如果

有帶入 user id, 就是使用指定的 user 的權限.

來看下面這個例子,

因為沒有指定 user id, 所以是使用 SUPERUSER, 自然可以看到全部的 records,

>>> self.env['hr.expense'].sudo().search([])
hr.expense(4, 3, 2, 1)

再來看這個例子, user_id = 6 只能看到自己的 records, 因為他是一般的 user,

>>> self.env['hr.expense'].sudo(user=6).search([])
hr.expense(4, 3)

也就是說, 知道這個特性, 我們甚至可以讓沒有權限的人看到 records (請依照自己的需求去調整):smile:

with_context

可參考 odoo 原始碼的 odoo/models.py

def with_context(self, *args, **kwargs):
    """ with_context([context][, **overrides]) -> records

    Returns a new version of this recordset attached to an extended
    context.

    The extended context is either the provided ``context`` in which
    ``overrides`` are merged or the *current* context in which
    ``overrides`` are merged e.g.::

        # current context is {'key1': True}
        r2 = records.with_context({}, key2=True)
        # -> r2._context is {'key2': True}
        r2 = records.with_context(key2=True)
        # -> r2._context is {'key1': True, 'key2': True}

    .. note:

        The returned recordset has the same prefetch object as ``self``.
    """
    context = dict(args[0] if args else self._context, **kwargs)
    return self.with_env(self.env(context=context))

with_context 可以用在很多地方, 這邊用一個翻譯的舉例, 如果我同時有 en_US 和 zh_TW

這兩個語言, 可以使用 with_context帶入不同的語言, 會自動依照語言進行翻譯,

>>> self.env['product.product'].with_context(lang='zh_TW').browse(41).name
'飛機票'
>>> self.env['product.product'].with_context(lang='en_US').browse(41).name
'Air Flight'

odoo shell 注意事項

Youtube Tutorial - odoo shell 教學 - 注意事項

odoo-shell 下 command 無法 save 問題,

當使用 Odoo Shell 測試資料時, 會發現當我們下了指令時, db 裡面的值沒有改變,

這時候必須另外執行

self.env.cr.commit()

在非 Odoo Shell 中會自動執行, 在 Odoo Shell 中不會自動執行 (需要手動執行)

odoo log 說明

2019-12-05 03:04:15,734 1 INFO localhost werkzeug: 172.18.0.1 - - [05/Dec/2019 03:04:15] "POST /longpolling/poll HTTP/1.0" 200 - {query_count} {query_time} {remaining_time}

query_count = query 次數

query_time = query 時間

remaining_time = 剩餘時間

如何透過 elk 搭配 odoo, 請參考 docker-elk-tutorial 7.6.0

odoo 使用 gmail 發信

Youtube Tutorial - odoo 教學 - 使用 gmail 發信

gmail 需要一些前製作業, 建議先閱讀使用 Gmail 寄信 - 前置作業這篇的 gmail 設定

Technical -> Email -> Outgoing Mail Servers

SMTP Server 填入 smtp.gmail.com

SMTP Port 填入 465

Connection Security 填入 SSL/TLS

填入自己的 Username 和 Password

建議輸入資料後, 可以先點選測試連接 (以下是成功的畫面)

如果出現錯誤, 請確認你的帳密是否有錯誤

以及把權限安全性調整為低一點, 可參考以下的兩個連結

https://www.google.com/settings/security/lesssecureapps

https://www.google.com/accounts/DisplayUnlockCaptcha

接著可以使用 odoo 內的 email 測試看是否可以成功發信

成功發信

如何全域修改時間日期格式

路徑為 Translations -> Languages, 點選語言, 就會看到以下的畫面,

圖片下方有一些參數的說明(可自行依照需求調整)

其他注意事項

odoo.conf 中的 data_dir 參數建立好了就不要亂改,

因為亂改動可能會導致你的 odoo 打開時一片空白或是破圖的狀況.

[options]
......
data_dir = /home/twtrubiks/work/odoo12/odoo-data

另外如果你的 odoo 不知道甚麼原因導致破圖(非上述的狀況),

錯誤訊息通常可能是遺失 filestore, 這時候可以嘗試以下的幾個方法,

可以試試看更新 odoo 中的 base,

或是從 db 中刪除 ir_attachment table,

重新使用 debug mode 中的 Regenerate Assets Bundles.

Donation

文章都是我自己研究內化後原創，如果有幫助到您，也想鼓勵我的話，歡迎請我喝一杯咖啡:laughing:

綠界科技ECPAY ( 不需註冊會員 )

贊助者付款

歐付寶 ( 需註冊會員 )