ユーティリティのアップグレード¶
Upgrade utils は、アップグレードスクリプトの書き込みを容易にするヘルパー関数を含むライブラリです。 Odoo が標準モジュールのアップグレードスクリプトに使用するこのライブラリは、信頼性を提供し、アップグレードプロセスを高速化するのに役立ちます。
ヘルパー関数は、データベース内のデータが一貫していることを確認するのに役立ちます。
更新されたレコードの間接参照を処理します。
関数を呼び出すことができ、コードを書くことを避け、時間を節約し、開発リスクを削減します。
ヘルパーはアップグレードにとって重要なことに集中し、詳細を考えることはありません。
インストール¶
Upgrade utils repository をローカルにクローンし、src
ディレクトリで --upgrade-path
オプションの先頭にある odoo
を起動します。
$ ./odoo-bin --upgrade-path=/path/to/upgrade-util/src,/path/to/other/upgrade/script/directory [...]
Odooを自分で管理していないプラットフォームでは、`pip`でこのライブラリをインストールすることができます。
$ python3 -m pip install git+https://github.com/odoo/upgrade-util@master
Odoo.sh では、 requirementsに追加することをお勧めします。 カスタム リポジトリの xt
。次の行をファイルの中に追加します。
odoo_upgrade @ git+https://github.com/odoo/upgrade-util@master
アップグレードユーティリティの使用¶
インストールが完了すると、以下のパッケージがアップグレードスクリプトに利用可能になります。
odoo.upgrade.util
: ヘルパー自体。odoo.upgrade.testing
: base TestCase classes.
スクリプトのアップグレードで使用するには、以下をインポートしてください:
from odoo.upgrade import util
def migrate(cr, version):
# Rest of the script
これで、ヘルパー関数は util
を介して呼び出すことができます。
Util 関数¶
Upgrade utils はアップグレードプロセスを容易にする多くの便利な機能を提供する. ここでは、最も便利なもののいくつかを説明する. ヘルパー関数の包括的な宣言については、 util folder を参照してください。
注釈
The cr
parameter in util functions always refers to the database cursor. Pass the one
received as a parameter in migrate()
. Not all functions need this parameter.