أهلا ومرحبا بكم في جرعة مركزة من نفس العمل المستمر في إطار تطوير بعض إضافات أودو (ضمن مشروع متكامل)، وهذا هو المقال الثالث، حيث سأبدأ في التركيز على جزئيات وتفاصيل بعينها.
قبل أن أشرع في صلب الموضوع أريد سرد شيء بخصوص هذا الملف (manifest) وهو عندما بدأت العمل على تطوير إضافات أودو لأول مرة، كان الموضوع مفاجيء بالنسبة لي في ما يتعلق بالبساطة المنظمة التي تعتمد عليها بنية الإضافات بشكل عام، لكن الأكثر إثارة للفضول هو هذا الملف الذي يعتبر أحد أهم العناصر الأساسية في نظام إدارة موارد المؤسسات أودو !
ربما يبدو هذا الملف صغيرًا وغير مؤثر للوهلة الأولى، لكنه في الحقيقة القلب النابض لأي إضافة في أودو (ولا أبالغ !).
ما علينا، في هذا المقال، سأختصر وأركز على الجانب التقني العملي،والتركيز على ما يجب أن يحتوي عليه وكيفية استخدامه بشكل عملي وفعال أثناء تطوير الإضافات.
الآ، ما هو ملف manifest؟
هو ببساطة ملف مكتوب بلغة بايثون يحمل الاسم _manifest_.py (هذه العرائض جزء من اسمه بالمناسبة) دوره الأساسي هو تعريف الإضافة للنظام، بحيث يُفهم ما هي وظيفتها، ما هي مكوناتها، وما هي المتطلبات التي تحتاجها لتعمل بشكل صحيح.
يمكنك اعتباره بطاقة تعريف تحتوي على:
- اسم الإضافة.
- وصف موجز لوظيفتها.
- قائمة بالإضافات التي تعتمد عليها.
- إصدار الإضافة والإصدارات المدعومة من أودو.
- قائمة بالملفات التي تحتاج إلى تحميلها (كالواجهات أو إعدادات الأمان).
ماذا يحتوي ملف manifest؟
دعني أشرح ذلك من خلال مثال عملي. إليك محتوى ملف manifest لإضافة بسيطة باسم “b2bstock”:
شرح الحقول:
- name: اسم الإضافة كما يظهر في النظام.
- version: إصدار الإضافة لتتبع التحديثات.
- author: اسم المطور أو الشركة المطورة.
- category: تصنيف الإضافة (مثل المبيعات، المخزون، الموارد البشرية).
- summary وdescription: وصف مختصر وطويل للإضافة.
- depends: قائمة بالإضافات الأخرى التي تعتمد عليها.
- data: قائمة بالملفات التي يتم تحميلها أثناء التثبيت.
- installable وapplication: تحدد ما إذا كانت الإضافة قابلة للتثبيت وما إذا كانت تطبيقًا مستقلًا.
أخطاء شائعة يجب تجنبها
- نسيان تحديد التبعيات (depends): إذا كانت الإضافة تعتمد على أخرى ولم تُذكر، فلن تعمل بشكل صحيح وستظهر أخطاء أثناء التثبيت.
- عدم تضمين ملفات البيانات: إذا نسيت إدراج ملفات الواجهات أو الأمان ضمن قسم data، فلن يتم تحميلها.
- تجاهل تحديث رقم الإصدار: عند إجراء تغييرات جوهرية على الإضافة، يجب تحديث رقم الإصدار لتسهيل تتبع النسخ.
نصائح عملية
- تأكد دائمًا من اختبار ملف manifest بعد تعديله باستخدام أمر إعادة التشغيل:
./odoo-bin -u b2bstock
- إذا كنت تعمل ضمن فريق، استخدم وصفًا واضحًا في الحقول summary و description لتوضيح أهداف الإضافة.
- استخدم ملفات أمان لتحديد الصلاحيات بدقة لضمان أمان البيانات.