Diskusi: Cara Inherit Template View di Odoo (Custom Module)
Diposting pada 26 Mar 2026, 10:18
Halo teman-teman praktisi Odoo di sini,
Saya Diana dari tim IT perusahaan. Saat ini saya lagi develop beberapa custom module di Odoo 15 untuk kebutuhan internal kami. Nah, saya lagi coba mau meng-customize tampilan salah satu form atau report yang sudah ada di Odoo default.
Rencananya, saya mau menambahkan beberapa field atau element baru di bagian tertentu dari template view yang sudah ada, tanpa harus memodifikasi langsung file core Odoo-nya. Tujuannya biar nanti kalau ada upgrade Odoo ke versi berikutnya lebih aman dan minim konflik.
Saya familiar dengan konsep `inheritance` di Odoo untuk Python dan XML, tapi untuk `template view` ini kadang masih suka bingung mana approach yang paling efektif dan "bersih". Apakah lebih baik pakai `xpath` biasa, `t-call`, atau ada cara lain yang lebih direkomendasikan untuk skenario seperti ini? Terutama ketika yang mau di-inherit itu bukan cuma elemen tapi keseluruhan struktur dalam `div` atau `section` tertentu.
Barangkali ada teman-teman yang punya pengalaman atau tips 'best practice' dalam meng-inherit template view, terutama yang sering dipakai untuk customization di custom module? Mungkin ada contoh sederhana atau hal-hal yang perlu diperhatikan agar tidak terjadi error atau duplikasi kode.
Mohon pencerahannya ya! Terima kasih sebelumnya.
Salam,
Diana
Balasan (1)
Halo Mba Diana! Salam kenal dari komunitas Odoo Indonesia. Senang sekali bisa berdiskusi bareng di sini.
Wah, ini pertanyaan yang sering banget muncul dan memang krusial untuk para developer Odoo. Konsep inherit view ini kunci banget biar kustomisasi kita aman dari masalah upgrade Odoo di masa depan. Salut nih, Mba Diana sudah mikirin strategi jangka panjang!
Untuk skenario Mba Diana yang mau menambahkan field atau elemen baru di template view default Odoo, tanpa memodifikasi core, pendekatan yang paling direkomendasikan dan "bersih" di Odoo adalah dengan menggunakan XML Inheritance, khususnya dengan memanfaatkan `xpath`.
Mari kita bahas lebih detail dan kenapa `xpath` jadi pilihan utama, serta perbedaan dengan `t-call` atau cara lainnya:
1. Kenapa `xpath`?
`xpath` adalah metode standar dan paling powerful di Odoo untuk memodifikasi struktur XML/QWeb dari view yang sudah ada. Dengan `xpath`, Mba Diana bisa menentukan secara spesifik di mana dan bagaimana perubahan akan diterapkan:
`position="after"`: Menambahkan elemen baru setelah elemen target.
`position="before"`: Menambahkan elemen baru sebelum elemen target.
`position="inside"`: Menambahkan elemen baru sebagai anak (child) terakhir di dalam elemen target. Ini sering dipakai untuk menambahkan field baru di dalam `div`, `group`, atau `page` yang sudah ada.
`position="replace"`: Mengganti seluruh elemen target dengan elemen baru yang Mba Diana definisikan. Hati-hati menggunakan ini, karena konten asli akan hilang total kecuali Mba Diana menyertakannya kembali di elemen pengganti.
`position="attributes"`: Memodifikasi atribut dari elemen target, misalnya menambahkan class CSS, mengubah `t-if`, atau atribut lainnya.
2. Perbedaan dengan `t-call`
Konsep `t-call` di QWeb sebetulnya lebih ke arah memanggil atau menggunakan ulang sebuah template atau fragmen QWeb yang sudah didefinisikan. Contohnya, jika Mba Diana punya komponen UI yang sama dan ingin dipakai di beberapa tempat, Mba Diana bisa mendefinisikannya sebagai template terpisah, lalu memanggilnya dengan `t-call="nama_template"`.
Meskipun secara teknis Mba Diana bisa saja membuat template baru berisi modifikasi, lalu entah bagaimana "mengganti" bagian dari template asli Odoo dengan `t-call` itu, ini bukan cara yang efektif atau direkomendasikan untuk skenario inherit view seperti yang Mba Diana inginkan. `xpath` jauh lebih presisi dan dirancang untuk memodifikasi struktur yang sudah ada pada titik tertentu.
3. Inherit Keseluruhan Struktur dalam `div` atau `section`
Untuk kasus Mba Diana yang ingin menambahkan field atau elemen di dalam `div` atau `section` tertentu:
Jika tujuannya menambahkan sesuatu ke dalam `div` atau `section` tanpa menghapus isinya, Mba Diana bisa menggunakan `xpath` dengan `position="inside"` dan menargetkan `div` atau `section` tersebut. Misalnya, jika `div` tersebut memiliki `id` atau `class` yang unik, targetkan itu.
Contoh: ` ... Tambahkan field atau elemen baru di sini ... `
Jika tujuannya mengganti keseluruhan `div` atau `section` tersebut dengan `div` atau `section` baru yang Mba Diana desain sendiri (termasuk isinya), maka Mba Diana bisa menggunakan `xpath` dengan `position="replace"`. Tapi, pastikan untuk menyertakan kembali elemen-elemen penting dari `div` asli yang masih dibutuhkan agar fungsionalitas Odoo tidak rusak.
Tips dan `Best Practice` dalam Meng-inherit Template View:
1. Identifikasi Target `xpath` yang Paling Spesifik: Ini kuncinya! Jangan menargetkan elemen terlalu umum (misal hanya `//div`), karena bisa jadi ada banyak `div` yang mirip. Cari atribut unik seperti:
`name="nama_field"` (untuk field input)
`id="nama_id"` (untuk elemen dengan ID unik)
`class="nama_class"` (jika kelasnya unik dan stabil)
`t-name="nama_template"` (untuk QWeb template tertentu)
`t-att-name="'nama_atribut'"` (untuk atribut custom pada QWeb)
`data-section="section_name"` (sering dipakai di beberapa report atau form)
Semakin spesifik target Mba Diana, semakin kecil kemungkinan `xpath` Mba Diana akan rusak di masa depan jika ada sedikit perubahan di Odoo core.
2. Pilih `position` yang Tepat: Pikirkan baik-baik apakah Mba Diana ingin menambahkan `after`, `before`, `inside`, atau `replace`. Kesalahan memilih `position` bisa menyebabkan tata letak jadi berantakan atau bahkan fungsionalitas hilang.
3. Struktur Custom Module:
Pastikan file XML inherit view Mba Diana didefinisikan di `__manifest__.py` modul kustom Mba Diana, di bawah bagian `data`.
Contoh: `data = ['views/custom_sale_order_view.xml']`
4. Contoh Sederhana Struktur Inherit View (Conceptual):
Misalkan Mba Diana ingin menambahkan field baru setelah field 'Customer' di form penjualan.
```xml
sale.order.form.inherit.diana
sale.order
```
(Ingat ya, `x_custom_field` dan `x_another_custom_field` ini harus Mba Diana definisikan dulu di model Python modul kustom Mba Diana).
5. Debug dengan Mode Developer: Gunakan mode developer Odoo. Ketika Mba Diana membuka view yang ingin dimodifikasi, klik icon serangga (debug), lalu pilih "Edit View: Form" atau "Edit View: XML". Di sana Mba Diana bisa melihat struktur XML view aslinya dan menemukan target `xpath` yang paling tepat.
6. Test, Test, dan Test: Setelah setiap perubahan `xpath`, jangan lupa `upgrade` modul Mba Diana dan lakukan pengujian menyeluruh untuk memastikan tidak ada error dan tampilannya sudah sesuai harapan.
Jadi, intinya, untuk skenario Mba Diana, `xpath` adalah pahlawan utama kita. Pastikan Mba Diana menargetkan elemen dengan spesifik dan memilih `position` yang paling cocok dengan kebutuhan.
Semoga pencerahan ini membantu Mba Diana dalam develop custom module Odoo-nya ya! Kalau ada pertanyaan lebih lanjut atau ingin eksplorasi contoh spesifik, jangan ragu untuk bertanya lagi. Semangat terus!
Wah, ini pertanyaan yang sering banget muncul dan memang krusial untuk para developer Odoo. Konsep inherit view ini kunci banget biar kustomisasi kita aman dari masalah upgrade Odoo di masa depan. Salut nih, Mba Diana sudah mikirin strategi jangka panjang!
Untuk skenario Mba Diana yang mau menambahkan field atau elemen baru di template view default Odoo, tanpa memodifikasi core, pendekatan yang paling direkomendasikan dan "bersih" di Odoo adalah dengan menggunakan XML Inheritance, khususnya dengan memanfaatkan `xpath`.
Mari kita bahas lebih detail dan kenapa `xpath` jadi pilihan utama, serta perbedaan dengan `t-call` atau cara lainnya:
1. Kenapa `xpath`?
`xpath` adalah metode standar dan paling powerful di Odoo untuk memodifikasi struktur XML/QWeb dari view yang sudah ada. Dengan `xpath`, Mba Diana bisa menentukan secara spesifik di mana dan bagaimana perubahan akan diterapkan:
`position="after"`: Menambahkan elemen baru setelah elemen target.
`position="before"`: Menambahkan elemen baru sebelum elemen target.
`position="inside"`: Menambahkan elemen baru sebagai anak (child) terakhir di dalam elemen target. Ini sering dipakai untuk menambahkan field baru di dalam `div`, `group`, atau `page` yang sudah ada.
`position="replace"`: Mengganti seluruh elemen target dengan elemen baru yang Mba Diana definisikan. Hati-hati menggunakan ini, karena konten asli akan hilang total kecuali Mba Diana menyertakannya kembali di elemen pengganti.
`position="attributes"`: Memodifikasi atribut dari elemen target, misalnya menambahkan class CSS, mengubah `t-if`, atau atribut lainnya.
2. Perbedaan dengan `t-call`
Konsep `t-call` di QWeb sebetulnya lebih ke arah memanggil atau menggunakan ulang sebuah template atau fragmen QWeb yang sudah didefinisikan. Contohnya, jika Mba Diana punya komponen UI yang sama dan ingin dipakai di beberapa tempat, Mba Diana bisa mendefinisikannya sebagai template terpisah, lalu memanggilnya dengan `t-call="nama_template"`.
Meskipun secara teknis Mba Diana bisa saja membuat template baru berisi modifikasi, lalu entah bagaimana "mengganti" bagian dari template asli Odoo dengan `t-call` itu, ini bukan cara yang efektif atau direkomendasikan untuk skenario inherit view seperti yang Mba Diana inginkan. `xpath` jauh lebih presisi dan dirancang untuk memodifikasi struktur yang sudah ada pada titik tertentu.
3. Inherit Keseluruhan Struktur dalam `div` atau `section`
Untuk kasus Mba Diana yang ingin menambahkan field atau elemen di dalam `div` atau `section` tertentu:
Jika tujuannya menambahkan sesuatu ke dalam `div` atau `section` tanpa menghapus isinya, Mba Diana bisa menggunakan `xpath` dengan `position="inside"` dan menargetkan `div` atau `section` tersebut. Misalnya, jika `div` tersebut memiliki `id` atau `class` yang unik, targetkan itu.
Contoh: ` ... Tambahkan field atau elemen baru di sini ... `
Jika tujuannya mengganti keseluruhan `div` atau `section` tersebut dengan `div` atau `section` baru yang Mba Diana desain sendiri (termasuk isinya), maka Mba Diana bisa menggunakan `xpath` dengan `position="replace"`. Tapi, pastikan untuk menyertakan kembali elemen-elemen penting dari `div` asli yang masih dibutuhkan agar fungsionalitas Odoo tidak rusak.
Tips dan `Best Practice` dalam Meng-inherit Template View:
1. Identifikasi Target `xpath` yang Paling Spesifik: Ini kuncinya! Jangan menargetkan elemen terlalu umum (misal hanya `//div`), karena bisa jadi ada banyak `div` yang mirip. Cari atribut unik seperti:
`name="nama_field"` (untuk field input)
`id="nama_id"` (untuk elemen dengan ID unik)
`class="nama_class"` (jika kelasnya unik dan stabil)
`t-name="nama_template"` (untuk QWeb template tertentu)
`t-att-name="'nama_atribut'"` (untuk atribut custom pada QWeb)
`data-section="section_name"` (sering dipakai di beberapa report atau form)
Semakin spesifik target Mba Diana, semakin kecil kemungkinan `xpath` Mba Diana akan rusak di masa depan jika ada sedikit perubahan di Odoo core.
2. Pilih `position` yang Tepat: Pikirkan baik-baik apakah Mba Diana ingin menambahkan `after`, `before`, `inside`, atau `replace`. Kesalahan memilih `position` bisa menyebabkan tata letak jadi berantakan atau bahkan fungsionalitas hilang.
3. Struktur Custom Module:
Pastikan file XML inherit view Mba Diana didefinisikan di `__manifest__.py` modul kustom Mba Diana, di bawah bagian `data`.
Contoh: `data = ['views/custom_sale_order_view.xml']`
4. Contoh Sederhana Struktur Inherit View (Conceptual):
Misalkan Mba Diana ingin menambahkan field baru setelah field 'Customer' di form penjualan.
```xml
sale.order.form.inherit.diana
sale.order
Ini adalah teks tambahan di dalam detail section.
```
(Ingat ya, `x_custom_field` dan `x_another_custom_field` ini harus Mba Diana definisikan dulu di model Python modul kustom Mba Diana).
5. Debug dengan Mode Developer: Gunakan mode developer Odoo. Ketika Mba Diana membuka view yang ingin dimodifikasi, klik icon serangga (debug), lalu pilih "Edit View: Form" atau "Edit View: XML". Di sana Mba Diana bisa melihat struktur XML view aslinya dan menemukan target `xpath` yang paling tepat.
6. Test, Test, dan Test: Setelah setiap perubahan `xpath`, jangan lupa `upgrade` modul Mba Diana dan lakukan pengujian menyeluruh untuk memastikan tidak ada error dan tampilannya sudah sesuai harapan.
Jadi, intinya, untuk skenario Mba Diana, `xpath` adalah pahlawan utama kita. Pastikan Mba Diana menargetkan elemen dengan spesifik dan memilih `position` yang paling cocok dengan kebutuhan.
Semoga pencerahan ini membantu Mba Diana dalam develop custom module Odoo-nya ya! Kalau ada pertanyaan lebih lanjut atau ingin eksplorasi contoh spesifik, jangan ragu untuk bertanya lagi. Semangat terus!