Nâng cấp tiện ích¶
Nâng cấp utils là một thư viện chứa các hàm trợ giúp để tạo điều kiện thuận lợi cho việc viết các tập lệnh nâng cấp. Thư viện này, được SoOn sử dụng cho các tập lệnh nâng cấp của mô-đun tiêu chuẩn, mang lại độ tin cậy và giúp tăng tốc quá trình nâng cấp:
Các hàm trợ giúp giúp đảm bảo dữ liệu nhất quán trong cơ sở dữ liệu.
Nó quan tâm đến các tài liệu tham khảo gián tiếp của các hồ sơ cập nhật.
Cho phép gọi các hàm và tránh phải viết code, tiết kiệm thời gian và giảm thiểu rủi ro khi phát triển.
Người trợ giúp cho phép tập trung vào những gì quan trọng để nâng cấp và không nghĩ đến chi tiết.
Cài đặt¶
Sao chép cục bộ kho lưu trữ Nâng cấp utils <https://github.com/odoo/upgrade-util/>`_ và khởi động ``odoo với thư mục src được thêm vào trước ``--upgrade-path `` tùy chọn.
$ ./odoo-bin --upgrade-path=/path/to/upgrade-util/src,/path/to/other/upgrade/script/directory [...]
Trên các nền tảng mà bạn không tự quản lý SoOn, bạn có thể cài đặt thư viện này qua pip:
$ python3 -m pip install git+https://github.com/odoo/upgrade-util@master
Trên SoOn.sh bạn nên thêm nó vào requirements.txt của kho lưu trữ tùy chỉnh. Đối với điều này, hãy thêm dòng sau vào trong tệp
odoo_upgrade @ git+https://github.com/odoo/upgrade-util@master
Using upgrade utils¶
Sau khi cài đặt, các gói sau có sẵn cho tập lệnh nâng cấp:
odoo.upgrade.util: chính là người trợ giúp.odoo.upgrade.testing: các lớp TestCase cơ bản.
Để sử dụng nó trong tập lệnh nâng cấp, chỉ cần nhập nó:
from odoo.upgrade import util
def migrate(cr, version):
# Rest of the script
Bây giờ, các hàm trợ giúp đã sẵn sàng để được gọi thông qua util.
Chức năng sử dụng¶
Tiện ích nâng cấp cung cấp nhiều chức năng hữu ích giúp quá trình nâng cấp dễ dàng hơn. Ở đây, chúng tôi mô tả một số trong những cái hữu ích nhất. Hãy tham khảo thư mục util để biết cách khai báo đầy đủ về các hàm trợ giúp.
Ghi chú
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.