٢٦ أغسطس ٢٠٢٦

دليل تخصيص وبناء الموديلات في نظام Odoo 18

Odoo
Python
ERP
Development

دليل تخصيص وبناء الموديلات في نظام Odoo 18

المقدمة

يُعتبر نظام Odoo ERP أحد أكثر حلول إدارة الشركات مرونة وقابلية للتوسع في العالم. من خلال بنية الموديلات المنفصلة (Modular Architecture)، يمكن للمطورين إضافة وظائف مخصصة دون التعديل على الكود المصدري الأساسي للمشروع.

في هذا المقال، أشارككم أفضل الممارسات التي اتبعتها خلال ترحيل وتطوير أكثر من 80 موديل Odoo مخصص عبر إصدارات Odoo المتتابعة.


1. الهيكل الأساسي لموديل Odoo المخصص

يتكون كل موديل في Odoo من هيكل متناسق يشمل ملف البيان __manifest__.py ونماذج بايثون (Models) وواجهات XML (Views).

# __manifest__.py
{
    'name': 'Custom Accounting Enhancements',
    'version': '18.0.1.0.0',
    'category': 'Accounting',
    'author': 'Ameer Haider',
    'depends': ['account', 'hr'],
    'data': [
        'security/ir.model.access.csv',
        'views/account_move_views.xml',
    ],
    'installable': True,
    'application': False,
}

2. ترحيل الموديلات بين الإصدارات (Module Migration)

عند ترحيل الموديلات من إصدار قديم (مثل Odoo 14) إلى إصدار حديث (مثل Odoo 17 أو 18)، يجب مراعاة التغييرات في أسماء الحقول والميثودات والـ ORM methods.

  • تحديث الميثودات: استبدال @api.multi بالميثودات المباشرة.
  • تعديل الـ XML Views: تحديث عناصر xpath والمستعرضات التفاعلية (OWL Components).

الخلاصة

تطوير موديلات Odoo متوافقة مع معايير الشركة يضمن استقرار النظام وسلاسة التحديثات المستقبلية دون مشاكل في الأداء.