← Semua artikel

Artikel

Kustomisasi Odoo Tanpa Fork: Pola Inheritance

Cara mengkustomisasi Odoo dengan inheritance dan modul ekstensi, bukan mengubah kode inti, agar upgrade tetap murah. Pola, jebakan, dan tabel keputusan.

5 menit baca
  • mid
  • odoo

Jawaban singkat

Jangan pernah mengedit file inti Odoo. Taruh setiap perubahan di modul custom terpisah yang memperluas model, view, dan method yang ada melalui mekanisme inheritance Odoo. Kode inti tetap utuh sehingga bisa di-upgrade, dan perubahan Anda menjadi lapisan kecil yang mudah direview.

Fork, yaitu salinan kode Odoo yang dimodifikasi, terasa lebih cepat di hari pertama. Namun fork menjadi mahal saat Anda butuh patch keamanan atau upgrade versi, karena setiap perubahan harus dicari dan digabungkan secara manual. Inheritance menghindari masalah itu.

Mengapa upgrade adalah biaya sebenarnya

Dokumentasi upgrade Odoo sendiri cukup tegas: database dengan modul custom tidak dapat di-upgrade sampai tersedia versi modul tersebut untuk versi Odoo tujuan. Di Odoo.sh, source code modul custom yang terpasang harus sudah sesuai dengan versi tujuan sebelum upgrade dapat berjalan.

Jadi ukuran dan kebersihan kode custom menentukan seberapa berat setiap upgrade. Modul kecil yang memperluas model dengan cara standar biasanya hanya butuh penyesuaian ringan. Core yang di-fork, atau modul yang menulis ulang banyak perilaku standar, bisa berarti proyek implementasi ulang kecil setiap kali upgrade.

Tiga mekanisme inheritance

Referensi ORM Odoo menjelaskan opsi di level model. Dalam praktik, Anda akan memakai ini:

PolaFungsiContoh penggunaan
Extension (_inherit tanpa _name baru)Memodifikasi model yang ada di tempat: field baru, method baru, override methodMenambah field pada sales order, mengubah logika validasi
Classical inheritance (_inherit plus _name baru)Membuat model baru yang menyalin struktur parentJenis dokumen baru yang mirip dokumen yang sudah ada
Delegation (_inherits atau delegate=True pada Many2one)Model baru menampilkan field parent tetapi menyimpannya di record parent yang tertautEntitas baru yang sekaligus partner atau produk

Sebagian besar kustomisasi masuk baris pertama. Menurut referensi ORM, bila _name tidak diisi, _inherit menyebut satu model yang diperluas di tempat.

Contoh ekstensi minimal:

from odoo import fields, models


class SaleOrder(models.Model):
    _inherit = "sale.order"

    delivery_window = fields.Char(string="Delivery window")

Setelah modul dipasang, field tersebut ada di sale.order. Tidak ada kode inti yang diedit.

Meng-override perilaku dengan aman

Saat mengubah cara kerja sebuah method, tutorial server framework Odoo memberi dua aturan yang layak ditempel di dinding tim:

  1. Selalu panggil super(), kecuali dalam beberapa kasus khusus. Dalam kata dokumentasinya, “It is very important to always call super() to avoid breaking the flow.”
  2. Kembalikan data yang konsisten dengan method parent. Jika parent mengembalikan dict, milik Anda juga harus dict.
class SaleOrder(models.Model):
    _inherit = "sale.order"

    def action_confirm(self):
        for order in self:
            if not order.delivery_window:
                raise UserError("Set a delivery window before confirming.")
        return super().action_confirm()

Tutorial yang sama menyarankan memakai method dengan @api.ondelete untuk mengontrol penghapusan, bukan meng-override unlink() langsung. Dengan begitu aturan Anda tidak mengganggu uninstall modul dan operasi internal lainnya.

Satu kebiasaan lagi: override di titik sesempit mungkin. Jika bisa mengait ke method helper kecil, lakukan itu dibanding method publik yang besar. Setiap baris logika standar yang Anda salin ke dalam override adalah baris yang bisa diam-diam menyimpang dari standar di versi berikutnya.

Memperluas view tanpa menggantinya

Tampilan mengikuti prinsip yang sama. Anda tidak mengedit XML view standar. Anda membuat view turunan yang menunjuk ke parent lewat inherit_id dan memilih letak perubahan, biasanya dengan ekspresi XPath atau referensi field, serta posisi seperti inside, before, after, replace, atau attributes. Referensi view membahas sintaksnya.

Saran praktis:

  • Pilih after atau inside dengan anchor field daripada replace. Mengganti sebuah blok berarti Anda kini memiliki blok itu, dan versi berikutnya bisa mengubah elemen di sekitarnya.
  • Gunakan attributes untuk menyembunyikan field atau membuatnya wajib, bukan menghapusnya.
  • Gunakan anchor pada elemen stabil seperti field bernama, bukan path posisi seperti “group ketiga”. Path posisi mudah rusak saat rilis minor mengubah tata letak.

Apa yang termasuk fork terselubung

Tim yang mengaku tidak mem-fork kadang tetap melakukannya. Tanda bahaya:

  • Menyalin modul inti ke repositori Anda lalu mengeditnya. Ini fork, meski foldernya berganti nama.
  • Meng-override method besar dan menempelkan seluruh isi aslinya dengan sedikit perubahan.
  • Mem-patch file Odoo di server saat deployment.
  • Memakai replace pada bagian view yang besar, atau pada seluruh template.

Jika pelanggan meminta sesuatu yang benar-benar menuntut perubahan di jantung workflow standar, katakan terus terang dan timbang. Terkadang jawaban yang tepat adalah mengubah proses, bukan perangkat lunaknya.

Pakai modul komunitas sebelum menulis sendiri

Sebelum membangun, periksa apakah orang lain sudah menyelesaikannya. Odoo Community Association (OCA) adalah organisasi nirlaba yang, menurut deskripsinya sendiri, memelihara ribuan modul Odoo open source dan jalur upgrade terbuka. Modul mereka mengikuti konvensi bersama dan sering dibangun sebagai lapisan inheritance kecil, yaitu gaya yang Anda inginkan.

Trade-off yang perlu diakui: modul OCA dipelihara komunitas, sehingga kualitas dan cakupan versi bervariasi. Periksa branch versi tujuan, aktivitas terbaru, dan cakupan test sebelum bergantung pada sebuah modul. Jika Anda memakainya, kunci versinya dan perlakukan sebagai dependensi yang direview saat upgrade.

Daftar periksa praktis

  • Taruh semua perubahan di modul custom yang disimpan di version control, terpisah dari core.
  • Buat setiap modul kecil dan berfokus satu tujuan, agar bisa dibuang atau ditulis ulang tanpa menyentuh yang lain.
  • Panggil super() dan jaga tipe return tetap konsisten.
  • Perluas view dengan XPath beranchor dan referensi field, bukan penggantian menyeluruh.
  • Tulis automated test untuk perilaku yang Anda override, agar upgrade memberi tahu apa yang rusak.
  • Dokumentasikan alasan setiap kustomisasi. Dua tahun lagi, tidak ada yang ingat.
  • Lakukan gladi upgrade pada salinan database sebelum menetapkan tanggal. Dokumentasi Odoo menjelaskan cara meminta database uji hasil upgrade sambil Anda menyesuaikan kode custom secara paralel.
  • Untuk setiap permintaan, tanyakan: bisakah konfigurasi, pengaturan standar, atau alat no-code melakukannya? Kustomisasi termurah adalah yang tidak perlu ditulis.

Kapan kustomisasi adalah alat yang salah

Kustomisasi berat adalah pilihan dengan biaya berulang. Jika kebutuhan hanya menyentuh satu tim, muncul sekali per kuartal, atau bisa ditangani dengan ekspor dan spreadsheet, mungkin tidak layak ditulis menjadi kode yang harus Anda bawa di setiap upgrade. Simpan daftar singkat “hal custom yang kami miliki” dan tinjau sebelum setiap versi mayor.

Mari berdiskusi

Jika Anda sedang merencanakan kustomisasi Odoo, atau mewarisi sistem yang Anda curigai sebagai fork, kami senang melihatnya bersama Anda. Teknologia Solutions menawarkan percakapan tanpa biaya untuk meninjau pendekatan Anda, menandai risiko upgrade, dan menyarankan di mana inheritance, konfigurasi, atau modul komunitas dapat menggantikan kode custom. Tanpa tekanan dan tanpa kewajiban.


Sumber: Dokumentasi upgrade Odoo; Referensi ORM Odoo; Odoo server framework 101, bab 12: Inheritance; Referensi views Odoo; Odoo Community Association; Wiki OCA maintainer-tools. Tautan dokumentasi mengarah ke dokumen versi 18.0; detail berbeda antar versi Odoo, jadi verifikasi dengan dokumentasi resmi untuk versi yang Anda jalankan.