نموذج hr.employee: فهم بنية موظفي أودو

مقدمة

في Odoo، تحدد النماذج كيفية هيكلة البيانات وتخزينها في قاعدة البيانات. كل قطعة من بيانات الأعمال التي تعمل معها، من طلبات المبيعات إلى الفواتير إلى الموظفين، تعيش في نموذج.

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

تركز هذه المقالة على أحد النماذج الأساسية في وحدة الموارد البشرية: hr.employee. سواء كنت تبني سير عمل موارد بشرية مخصص، أو تدمج أنظمة الرواتب، أو تقوم بتكوين الحضور والإجازات، ستعمل مع هذا النموذج.

ما هو نموذج hr.employee

يمثل نموذج hr.employee الموظفين في Odoo. إنه المكان المركزي حيث يتم تخزين جميع معلومات الموظفين.

هذا النموذج في Odoo هو جزء من تطبيق الموارد البشرية (HR). يتم استخدامه عبر الحضور، والإجازات، والعقود، والرواتب، وسجلات الوقت.

يتم تثبيته عند تمكين تطبيق الموظفين. تقوم وحدات أخرى بتوسيعه من خلال وراثة نموذج Odoo. يضيف hr_contract حقول العقد. يضيف hr_attendance تسجيل الدخول والخروج. يضيف hr_leave الإجازات. تضيف كل وحدة ما تحتاجه دون تكرار الهيكل الأساسي.

يوفر Odoo أيضًا hr.employee.public، وهو عرض مقيد لنفس البيانات للمستخدمين الذين يحتاجون إلى رؤية محدودة للموظفين. هذه مثال على كيفية استخدام Odoo لأنماط النماذج المجردة ووراثة النماذج للتحكم في الوصول.

الحقول الرئيسية في النموذج

إليك أهم حقول Odoo في نموذج hr.employee. سيساعدك فهم هذه الحقول على العمل بفعالية مع سجلات الموظفين.

1. الاسم

النوع: نص. يخزن هذا الحقل اسم الموظف. يتم عرضه عادةً في العديد من وجهات نظر Odoo وهو المعرف الرئيسي لسجل الموظف.

2. تاريخ الإنشاء

النوع: تاريخ ووقت. يخزن تاريخ ووقت إنشاء السجل. يتم إدارته تلقائيًا بواسطة Odoo. مفيد للتقارير والتدقيق.

3. تاريخ التعديل

النوع: تاريخ ووقت. يخزن تاريخ ووقت آخر تعديل. يتم إدارته أيضًا تلقائيًا. يساعد في تتبع متى تم تحديث البيانات آخر مرة.

4. نشط

النوع: بولياني. علامة الحذف الناعم. عندما تكون القيمة False، يتم أرشفة السجل وإخفاؤه عن العروض الافتراضية. استخدم هذا عندما يغادر الموظف. السجلات لا تحذف فعليًا.

5. company_id

النوع: Many2one (res.company). في إعدادات الشركات المتعددة، يشير هذا إلى الشركة التي ينتمي إليها الموظف في Odoo. مطلوب لمعظم سجلات الموظفين.

6. user_id

النوع: Many2one (res.users). يربط الموظف بمستخدم Odoo. عند تعيينه، يمكن للموظف تسجيل الدخول واستخدام Odoo. يستخدم للوصول إلى البوابة، وسجلات الوقت، والموافقات.

7. work_email

النوع: Char. عنوان البريد الإلكتروني للعمل. يستخدم للتواصل الداخلي والإشعارات.

8. work_phone

النوع: Char. رقم الهاتف للعمل. يظهر في نماذج الموظفين ويستخدم في سير العمل للاتصال.

9. mobile_phone

النوع: Char. رقم الهاتف المحمول للعمل. غالبًا ما يستخدم للإشعارات العاجلة أو الرسائل القصيرة.

10. department_id

النوع: Many2one (hr.department). القسم الذي ينتمي إليه الموظف. يُستخدم في المخططات التنظيمية، والتقارير، وسير العمل للموافقة.

11. job_id

النوع: Many2one (hr.job). وظيفة العمل. يرتبط بنموذج hr.job الذي يحدد مسميات الوظائف والوظائف الشاغرة.

12. job_title

النوع: Char. مسمى الوظيفة النصي الحر. يمكن استخدامه عندما لا يكون job_id محددًا أو للمسميات المخصصة.

13. parent_id

النوع: Many2one (hr.employee). المدير. يمكّن من هيكلية الموظفين. يُستخدم لسلاسل الموافقة وهيكلية المنظمة.

14. coach_id

النوع: Many2one (hr.employee). مدرب هذا الموظف. يُستخدم للأداء والتطوير. المدرب ليس لديه حقوق محددة بشكل افتراضي.

15. resource_id

النوع: Many2one (resource.resource). يرتبط بنموذج الموارد. يُستخدم للتخطيط الزمني، وتخطيط السعة، ودمج التقويم.

16. work_contact_id

النوع: Many2one (res.partner). جهة الاتصال للعمل. يربط بسجل الشريك المستخدم في الاتصالات والمستندات المتعلقة بالعمل.

17. address_id

النوع: Many2one (res.partner). عنوان العمل. يربط بسجل res.partner لموقع المكتب أو العمل.

18. address_home_id

النوع: Many2one (res.partner). العنوان الخاص. عنوان منزل الموظف، وليس المكتب. يُستخدم للرواتب وجهات الاتصال الطارئة.

19. resource_calendar_id

النوع: Many2one (resource.calendar). جدول العمل. يحدد ساعات وأيام العمل. يُستخدم للحضور والإجازات والتخطيط.

20. employee_type

النوع: اختيار. نوع الموظف: موظف، مستقل، أو متدرب. مطلوب. يؤثر على تاريخ العقد: يُفترض أن يكون نوع الموظف فقط تحت العقد.

21. barcode

النوع: Char. معرف الشارة. يُستخدم لتحديد هوية الموظف في كشك الحضور وغيرها من عمليات مسح الباركود.

22. pin

النوع: حرف. الرقم السري المستخدم لتسجيل الدخول والخروج في وضع كشك تطبيق الحضور. يُستخدم أيضًا لتغيير أمين الصندوق في نقطة البيع.

23. تاريخ الميلاد

النوع: تاريخ. تاريخ الميلاد. يُستخدم لسجلات الموارد البشرية وتذكيرات عيد الميلاد الاختيارية.

24. رقم الهوية

النوع: حرف. رقم الهوية الوطنية. يُستخدم للامتثال في الموارد البشرية والرواتب.

25. رقم جواز السفر

النوع: حرف. رقم جواز السفر. يُستخدم لتتبع السفر وتصاريح العمل.

26. رقم حساب البنك

النوع: Many2one (res.partner.bank). حساب البنك للموظف لمدفوعات الرواتب.

27. البريد الإلكتروني الشخصي

النوع: حرف. البريد الإلكتروني الشخصي للموظف. يُستخدم عندما لا يكون البريد الإلكتروني الخاص بالعمل متاحًا.

28. الهاتف

النوع: حرف. رقم الهاتف الشخصي. مختلف عن تفاصيل الاتصال بالعمل.

29. contract_id

النوع: Many2one (hr.contract). العقد الحالي. إشارة إلى العقد النشط.

30. contract_ids

النوع: One2many (hr.contract). جميع العقود المرتبطة بهذا الموظف. تاريخ العقود.

31. image_1920

النوع: ثنائي. صورة الموظف أو الصورة الرمزية. يخزن Odoo أحجامًا متعددة. تُستخدم في النماذج والتقارير والدليل.

32. related_partner_id

النوع: Many2one (res.partner). جهة الاتصال المرتبطة بهذا الموظف. تربط بيانات الموظف بنموذج الشريك لنظام إدارة علاقات العملاء (CRM) ووحدات أخرى.

33. leave_manager_id

النوع: Many2one (res.users). المستخدم المسؤول عن الموافقة على الإجازات. إذا كانت فارغة، تذهب الموافقة إلى مسؤول أو موافق.

34. expense_manager_id

النوع: Many2one (res.users). المستخدم المسؤول عن الموافقة على النفقات. إذا كان فارغًا، تذهب الموافقة إلى مسؤول أو موافق.

35. timesheet_manager_id

النوع: Many2one (res.users). المستخدم المسؤول عن الموافقة على جداول العمل. إذا كان فارغًا، تذهب الموافقة إلى مسؤول جداول العمل أو المستخدم.

كيف يتم استخدام هذا النموذج في سير العمل التجاري

1. دليل الموظفين والتوظيف

عندما تقوم إدارة الموارد البشرية بإنشاء موظف جديد، فإنهم يملأون سجل hr.employee. الاسم، القسم، الوظيفة، المدير، وبيانات الاتصال. يتم تعيين رابط user_id عندما يحصل الموظف على وصول إلى Odoo.

2. الحضور وتتبع الوقت

يقوم الموظفون بتسجيل الدخول والخروج عبر تطبيق الحضور. يتم تخزين أوقات تسجيل الدخول والخروج في hr.attendance، المرتبطة بـ hr.employee. تمكّن حقول الباركود ورقم التعريف الشخصي وضع الكشك.

3. الإجازات والغياب

تشير طلبات الإجازة إلى الموظف. drives leave_manager_id و resource_calendar_id من يوافق وكم عدد الأيام المخصصة.

4. الرواتب والعقود

تستخدم الرواتب hr.employee لهيكل الراتب، وحساب البنك، وبيانات العقد. يربط contract_id بالعقد الحالي. تحتوي contract_ids على التاريخ الكامل.

5. جداول العمل وتخصيص المشاريع

عندما يقوم الموظفون بتسجيل الوقت على المشاريع، يرتبط جدول الوقت بـ hr.employee. يتحكم timesheet_manager_id في الموافقة. يرتبط resource_id بأدوات التخطيط والجدولة.

كيف يقوم المطورون بتوسيع هذا النموذج

يقوم المطورون بتمديد hr.employee باستخدام عدة أنماط. وراثة نموذج Odoo هي الآلية الرئيسية.

وراثة النموذج

استخدم _inherit = 'hr.employee' لتمديد النموذج. أضف حقول جديدة، أو تجاوز طرق، أو أضف قيود. يحتفظ نموذج الوراثة في Odoo بتغييراتك في وحدة منفصلة لتسهيل التحديثات.

إضافة حقول

حدد حقول Odoo الجديدة في النموذج الموروث. استخدم نوع الحقل الصحيح: Char، Many2one، Boolean، Integer، Text، Selection. ضع في اعتبارك الحقول المعتمدة على الشركة لعدة شركات.

امتدادات بايثون

تجاوز create، write، أو unlink لإضافة منطق. استخدم super() لاستدعاء الأصل. كن حذرًا مع الحقول المحسوبة واعتمادياتها.

استوديو Odoo

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

أفضل الممارسات

• قم بتعيين user_id فقط عندما يحتاج الموظف إلى الوصول إلى Odoo. ليس كل الموظفين بحاجة إلى حساب مستخدم.
• استخدم تسلسل parent_id بشكل صحيح. قم ببناء هيكل المنظمة من الأعلى إلى الأسفل.
• قم بتعيين resource_calendar_id لساعات العمل المتسقة وحسابات الإجازات.
• عند بناء تكاملات API، استخدم واجهة برمجة التطبيقات XML-RPC أو JSON-RPC. نموذج hr.employee في Odoo مكشوف بالكامل كنموذج API. قم بتعيين المعرفات الخارجية بعناية.
• بالنسبة للحقول المخصصة، استخدم بادئة x_ أو بادئة وحدة لتجنب التعارض مع إصدارات Odoo المستقبلية.
• يجب ألا يتم جلب الحقول المقيدة إلى hr.group_hr_user مسبقًا للمستخدمين الذين ليس لديهم وصول إلى الموارد البشرية. استخدم المجموعات في تعريفات الحقول.

الأخطاء الشائعة

• إنشاء سجلات موظفين مكررة بدلاً من البحث عن السجلات الموجودة. استخدم work_email أو identification_id للتخلص من التكرار.
• خلط بين user_id وrelated_partner_id. user_id مخصص لتسجيل دخول Odoo. related_partner_id هو سجل الاتصال.
• نسيان تعيين employee_type. إنه مطلوب ويؤثر على سلوك العقد.
• تجاوز الطرق الأساسية دون استدعاء super(). يمكن أن يؤدي ذلك إلى كسر وحدات أخرى أو ترقيات مستقبلية.
• إضافة حقول مخصصة مطلوبة بدون قيم افتراضية. ستفشل السجلات الموجودة في التحقق عند الترقية.
• تعريض حقول الموارد البشرية الحساسة للمستخدمين الذين ليس لديهم hr.group_hr_user. استخدم المجموعات على الحقول التي تحتوي على بيانات خاصة.

الخاتمة

نموذج hr.employee هو محور Odoo للموارد البشرية. يخزن بيانات الموظفين، ويرتبط بالعقود، والحضور، والإجازات. سيساعدك فهم حقوله وكيفية توسيع الوحدات في تكوين Odoo وتخصيصه ودمجه بشكل فعال.

سواء كنت مستشارًا وظيفيًا يقوم بتخطيط عمليات الموارد البشرية أو مطورًا يقوم ببناء وحدات مخصصة، فإن الفهم الجيد لـ hr.employee سيوفر الوقت ويمنع الأخطاء.

هل تحتاج إلى مساعدة في تنفيذ Odoo الخاص بك؟

داسولو تساعد الشركات في تنفيذ وتخصيص وتحسين أودو. نحن متخصصون في تكامل واجهات برمجة التطبيقات وتطوير أودو. يتمتع فريقنا بخبرة عميقة في بنية بيانات أودو ونماذج مثل hr.employee.

إذا كنت بحاجة إلى مساعدة في تنفيذ أودو الخاص بك، أو وحدات الموارد البشرية المخصصة، أو التكاملات، فنحن هنا للمساعدة. احجز عرضًا توضيحيًا لمناقشة مشروعك.