مقدمة
في Odoo، تُعرّف النماذج بنية البيانات وطريقة حفظها في قاعدة البيانات. كل عنصر من بيانات العمل — من عروض البيع إلى الفواتير وحتى بيانات الموظفين — يُخزن داخل نموذج معيّن.
فهم النماذج في Odoo ضروري لكل من المطوّرين والاستشاريين الوظيفيين. النماذج تشكل العمود الفقري لمخطط بيانات Odoo: تحدد الحقول، الروابط بين السجلات، والمنطق التجاري.
المقالة تركز على نموذج رئيسي في تطبيق الموارد البشرية: hr.employee. سواء كنت تبني سير توظيف، توصل نظام كشوف رواتب خارجي، أو تضبط الحضور والإجازات، ستتعامل مع هذا النموذج كثيرًا.
ما هو نموذج hr.employee
نموذج hr.employee يمثل سجلات الموظفين داخل النظام؛ هو المخزن المركزي لمعلومات العاملين في المؤسسة.
هذا النموذج جزء من تطبيق الموارد البشرية ويُعاد استخدامه في الحضور، الإجازات، العقود، الرواتب، وسجلات الوقت.
يتم تفعيله عند إضافة تطبيق الموظفين، ويمكن توسيعه عبر وراثة النماذج في وحدات إضافية. على سبيل المثال، وحدات العقود والحضور والإجازات تضيف حقولها الخاصة دون إعادة اختراع بنية الموظف الأساسية.
يوفر Odoo أيضًا عرضًا مقيدًا للبيانات باسم hr.employee.public للمستخدمين الذين يحتاجون رؤية محدودة. هذه آلية مفيدة للتحكم في الوصول عبر طبقات نموذجية.
الحقلـات الأساسية في النموذج
فيما يلي الحقول الأكثر أهمية في hr.employee والتي ستتكرر أثناء إعداد النظام والتكاملات والتقارير.
1. name
نوع: نص قصير (Char). يحمل اسم الموظف ويظهر في القوائم والنماذج كمعرّف رئيسي للملف.
2. create_date
نوع: تاريخ ووقت. تاريخ إنشاء السجل تلقائيًا — مفيد لتتبّع الإضافات والتدقيق.
3. write_date
نوع: تاريخ ووقت. تاريخ آخر تعديل على السجل؛ يساعد في معرفة متى تغيّرت بيانات الموظف.
4. active
نوع: منطقي (Boolean). علامة أرشفة افتراضية؛ عند إيقافها يُخفي السجل دون حذفه نهائيًا — مناسب عند خروج الموظف.
5. company_id
نوع: ارتباط إلى res.company. في إعدادات تعدد الشركات يحدد الشركة التي يتبع لها الموظف؛ ضروري لمعظم العمليات متعددة الكيان.
6. user_id
نوع: ارتباط إلى res.users. يربط الموظف بحساب مستخدم Odoo. عندما يُعيّن يمكنه تسجيل الدخول والمشاركة في التصاريح، الجداول الزمنية، والموافقات.
7. work_email
نوع: نص. البريد الإلكتروني الوظيفي، يُستخدم للإشعارات الداخلية والتواصل الرسمي.
8. work_phone
نوع: نص. رقم الهاتف الوظيفي للاتصال بالمكتب.
9. mobile_phone
نوع: نص. رقم الجوال للعمل، مفيد للإشعارات العاجلة أو الرسائل القصيرة.
10. department_id
نوع: ارتباط إلى hr.department. يضع الموظف ضمن هيكل إداري لاستخدامه في المخططات والتقارير وسير الموافقات.
11. job_id
نوع: ارتباط إلى hr.job. الربط بالمنصب الرسمي المعرفة في النظام ويُستخدم لإدارة الوظائف الشاغرة والوصف الوظيفي.
12. job_title
نوع: نص. عنوان وظيفي حر يمكن استخدامه عند عدم وجود job_id أو لتخصيص العنوان.
13. parent_id
نوع: ارتباط إلى hr.employee. المدير المباشر؛ يبني التسلسل الإداري ويُستخدم في سلاسل الموافقة وهيكل المؤسسة.
14. coach_id
نوع: ارتباط إلى hr.employee. مشرف التطوير أو الموجه للموظف، يُستخدم في تقييم الأداء بدون صلاحيات خاصة تلقائيًا.
15. resource_id
نوع: ارتباط إلى resource.resource. يربط الموظف بموارد التخطيط للجدولة وإدارة السعة وتكامل التقويم.
16. work_contact_id
نوع: ارتباط إلى res.partner. جهة اتصال العمل المرتبطة بالمستخدم لأغراض المراسلات والوثائق الرسمية.
17. address_id
نوع: ارتباط إلى res.partner. عنوان العمل/المكتب، يُستخدم في المستندات والمواقع الوظيفية.
18. address_home_id
نوع: ارتباط إلى res.partner. العنوان الشخصي للمنزل، مفيد للرواتب والطوارئ.
19. resource_calendar_id
نوع: ارتباط إلى resource.calendar. جدول العمل المتبع: ساعات العمل، أيام العمل، ويؤثر على حسابات الحضور والإجازات.
20. employee_type
نوع: اختيار (Selection). نوع العامل: موظف، متعاقد حر، متدرب. له أثر على قواعد العقود وإدارة السجلات.
21. barcode
نوع: نص. رقم الشارة أو الباركود لاستخدامه في أجهزة الحضور والكشف.
22. pin
نوع: نص. رمز تحقق لاستخدامه في نمط كشك الحضور أو لتبديل الكاشير في نقاط البيع.
23. birthday
نوع: تاريخ. تاريخ الميلاد لأغراض السجلات أو تفعيل تذكيرات داخلية.
24. identification_id
نوع: نص. رقم الهوية الوطنية أو رقم السجل المدني للتوافق مع متطلبات الموارد البشرية والرواتب.
25. passport_id
نوع: نص. رقم جواز السفر لمتابعة السفر وتصاريح العمل إن لزم.
26. bank_account_id
نوع: ارتباط إلى res.partner.bank. حساب الموظف البنكي لصرف الرواتب.
27. private_email
نوع: نص. البريد الإلكتروني الشخصي في حال عدم توفر بريد وظيفي.
28. phone
نوع: نص. رقم الهاتف الشخصي بعيدًا عن بيانات الاتصال بالعمل.
29. contract_id
نوع: ارتباط إلى hr.contract. العقد النشط الحالي المرتبط بالموظف.
30. contract_ids
نوع: علاقة واحد إلى متعدد إلى hr.contract. محفوظة تاريخية بكل عقود الموظف.
31. image_1920
نوع: ثنائي (Binary). صورة الموظف أو الأفاتار؛ تُعرض في النماذج والتقارير وأدلة الموظفين.
32. related_partner_id
نوع: ارتباط إلى res.partner. جهة الاتصال المرتبطة التي تصِل بيانات الموظف بباقي التطبيقات مثل المبيعات أو خدمة العملاء.
33. leave_manager_id
نوع: ارتباط إلى res.users. المستخدم المسؤول عن الموافقة على الإجازات؛ إن لم يُحدد تُحال الموافقات للمدير الافتراضي.
34. expense_manager_id
نوع: ارتباط إلى res.users. من يوافق على المصروفات المتعلقة بالموظف.
35. timesheet_manager_id
نوع: ارتباط إلى res.users. من يراجع ويوافق على الجداول الزمنية المسجلة.
كيف يُستخدم هذا النموذج في سير العمل المؤسسي
1. دليل الموظفين وإجراءات الانضمام
عند إضافة موظف جديد، يقوم فريق الموارد البشرية بملء سجل hr.employee بالمعلومات الأساسية: الاسم، القسم، المنصب، المدير، وبيانات الاتصال. يتم ربط user_id حين يحتاج الموظف لحساب داخل النظام.
2. الحضور وتتبع الوقت
أوقات الدخول والخروج تُسجل عبر تطبيق الحضور وتُخزّن في hr.attendance مع ربط إلى سجل الموظف؛ حقول الباركود وpin تُمكن التشغيل في وضع الكشك.
3. الإجازات والغياب
طلبات الإجازة تعتمد على ملف الموظف؛ الحقول مثل leave_manager_id وresource_calendar_id تحدد من يوافق وكيف تُحسب أيام الإجازة.
4. الرواتب والعقود
نظام الرواتب يستعين ببيانات hr.employee لحساب البُنى الأجرية، رقم الحساب البنكي، وبيانات العقد. contract_id يُشير للعقد النشط وتُخزن كل العقود في contract_ids.
5. الجداول الزمنية وتوزيع المشاريع
عند تسجيل وقت العمل على مشاريع، تُربط القيود بسجل الموظف؛ من يوافق على الساعات يُحدَّد عبر timesheet_manager_id، والresource_id يُستخدم في التخطيط والميزنة.
كيف يطوّر المطوّرون هذا النموذج
المطوّرون يوسّعون hr.employee بعدة أساليب، ووراثة النماذج هي الآلية الأساسية لذلك.
وراثة النماذج
استخدم _inherit = 'hr.employee' لإضافة حقول، تعديل سلوك، أو تعريف قيود جديدة. إبقاء التعديلات في وحدة منفصلة يسهل الترقية والصيانة.
إضافة حقول
عرّف الحقول الجديدة في النموذج الموروث باستخدام النوع المناسب: Char، Many2one، Boolean، Integer، Text، Selection. ضع في الاعتبار الحقول المعتمدة على الشركة في بيئات متعددة الشركات.
امتدادات بايثون
يمكنك تجاوز دوال مثل create وwrite وunlink لحقن منطق عمل مخصص. احرص على استدعاء super() واعتن بالحقول المحسوبة واعتماداتها.
Odoo Studio
Odoo Studio يتيح إضافة حقول وتعديلات سريعة بدون كود، مفيد للتخصيصات البسيطة، أما للتغييرات المعقّدة أو القابلة للترقية فالوحدات المخصصة أفضل.
ممارسات موصى بها
- عيّن user_id فقط للموظفين الذين يحتاجون وصولًا للنظام؛ ليس من الضروري تحويل كل سجل موظف إلى حساب مستخدم.
- ابنِ هيكل parent_id من الأعلى للأسفل لضمان تسلسل إداري واضح وفعّال في سلاسل الموافقات.
- حدِّد resource_calendar_id لضمان اتساق حسابات الحضور والإجازات مع جداول العمل الفعلية.
- عند بناء تكاملات API استخدم XML-RPC أو JSON-RPC؛ نموذج hr.employee متاح بالكامل عبر واجهة Odoo. أدر خرائط المعرفات الخارجية بعناية لتجنب التضارب.
- للحقلـات المخصصة استخدم بادئة x_ أو بادئة مميزة للوحدة لتقليل مخاطر تعارض الأسماء مع إصدارات Odoo المستقبلية.
- الحقول الحسّاسة يجب تقييدها بمجموعة hr.group_hr_user وعدم تحميلها مسبقًا لمستخدمين بلا صلاحية؛ ضع مجموعات على تعريف الحقول.
أخطاء شائعة
- إنشاء سجلات مكررة للموظفين بدل البحث عن السجل الموجود — خطأ شائع. استخدم work_email أو identification_id للمطابقة وإلغاء التكرار.
- الخلط بين user_id وrelated_partner_id يؤدي إلى لبس وظيفي: الأول لحساب الدخول، والثاني لجهة الاتصال المرتبطة.
- نسيان تعيين employee_type قد يؤدي إلى سلوك غير متوقع لأن هذا الحقل يؤثر على منطق العقود.
- تجاوز الدوال الأساسية دون استدعاء super() قد يكسر وحدات أخرى أو يسبب مشاكل عند الترقية.
- إضافة حقول مطلوبة جديدة بدون قيم افتراضية سيفشل عند محاولة ترقية السجلات الموجودة بسبب تحقق الصحة.
- إظهار حقول الموارد البشرية الحساسة لمستخدمين بلا صلاحية يعرض خصوصية الموظفين للخطر؛ تأكد من قصر الوصول المناسب.
خلاصة
نموذج hr.employee عنصر محوري في باقة موارد البشرية في Odoo. يجمع بيانات الموظف ويربطها بالعقود، الحضور، والإجازات. فهم الحقول وآليات التوسيع يبسط إعداد النظام والتكاملات.
سواء كنت مستشارًا وظيفيًا يخطط سير عمل HR أو مطوّرًا يبني وحدات مخصصة، معرفة جيدة بـ hr.employee توفر وقتًا وتقلّل الأخطاء.
هل تحتاج مساعدة في تنفيذ Odoo؟
Dasolo تساعد الشركات في تنفيذ وتخصيص وتحسين Odoo. نتخصّص في تكاملات API وتطوير وحدات Odoo مع خبرة عميقة في بنية البيانات ونماذج مثل hr.employee.
إذا احتجت مساعدة في تنفيذ Odoo أو تطوير وحدات HR مخصصة أو تكاملات، فريقنا جاهز لدعمك. احجز عرضًا تجريبيًا لمناقشة مشروعك.