انت مبرمج محترف في البرمجة باستخدام frappe framework ولغة البرمجة paython ولغة البرمجة…
- User
انت مبرمج محترف في البرمجة باستخدام frappe framework ولغة البرمجة paython ولغة البرمجة JavaScrept, وانا اريد مساعدتك , لدي Doctype باسم Timesheet Tool ولذي سوف ارسل لك الكود الخاص بملف البايثون وملف الجافاء سكربت الخاص به , يوجد في هذا ال Doctype مجموعة الحقول التاليه : { project:Link, company:Link, day:Date, get_employee:Button, timesheet_tool_details:Table } حيث ان الجدول الفرعي timesheet_tool_details يحتوي على حقل employee وهو عباره عن حقل من نوع Link من Doctype ال Employee , و عند الضغط على زر get_employee يتم جلب كل الموظفين واظافتهم الى الجدول الفرعي timesheet_tool_details , ولدي Doctype خاص بالاعدادات باسم Timesheet Tool Setting ويحتوي على الحقول الاتيه :{ is_project_mandatory:Check, is_company_mandatory:Check, n_over_time:Float, h_over_time:Float, from_time:Time, standard_working_hours:Int, salary_component_overtime_n:Link, salary_component_overtime_h:Link, salary_component_deduction:Link, dufault_activity:Link, } ,مع العلم ان الزر يعمل بشكل جيد ومن دون مشاكل وانا اريد ان اضيف ميزه جديده الى Timesheet Tool , اريد منك انتساعدني في اضافة هذه الميزة ولتي سوف ارسل لم تفاصيلها , والان واريد منك انا تخبرني كيف ابداء بارسال محتواء الملفات اليك وماهي الخطوات التي اتبعها للتعامل معك , المخرجات اريد ان تكون مخرجات كود كل ملف بعد التعديل وشرح للتعديلات.
- Assistant
بالطبع، يمكنني مساعدتك في تعديل الكود وإضافة الميزة الجديدة إلى Doctype
Timesheet Tool. لتسهيل عملية التعامل بيننا، دعني أشرح لك كيف يمكننا تنفيذ ذلك بشكل منظم مع تحديد الخطوات اللازمة.
الخطوات التي عليك اتباعها:
-
تحضير الملفات: اجمع الكود الحالي الخاص بملفات Python وJavaScript (ملفات الخادم والعميل)، بالإضافة إلى أي تفاصيل إضافية قد تكون موجودة مثل الإعدادات أو الوظائف ذات الصلة.
-
تفاصيل الميزة المطلوبة: وضح تفاصيل الميزة الجديدة التي تريد إضافتها. من المهم أن تقدم وصفًا واضحًا ودقيقًا لما تريد أن تفعله الميزة مع الخطوات أو المواصفات الوظيفية المطلوبة.
-
إرسال الأكواد:
- يمكنك نسخ محتويات الأكواد والنصوص إلى الرسائل ليتمكن النظام من قراءتها والعمل عليها.
- في حال كان محتوى الكود طويلًا جدًا، يمكنك تقسيمه إلى أجزاء صغيرة وإرساله على دفعات.
-
مراجعة الكود: سأدرس الكود الحالي لمعرفة كيفية عمله حاليًا. بناءً على ذلك، سأعمل على تعديل الأكواد الموجودة (في الملفات الأصلية) لإضافة الميزة المطلوبة دون التأثير على الوظائف الحالية.
-
تقديم الحلول:
- سأرسل إليك الكود المعدل لكل ملف.
- سأشرح التعديلات التي تمت على الكود خطوة بخطوة .
- سأساعدك في تنفيذ الكود الجديد وتحقيق الميزة المقصودة.
كيفية البدء الآن:
-
ابدأ بإرسال ملفات الكود الأصلية كتعليقات هنا:
- ملف Python (المسمى عادةً بـ
timesheet_tool.pyأو ما شابه). - ملف JavaScript (إذا كان لديك واحد).
- ملف Python (المسمى عادةً بـ
-
أرفق وصف الميزة الجديدة التي تريد إضافتها إلى
Timesheet Tool. -
إذا كنت بحاجة إلى أي مساعدة أثناء إرسال الأكواد، فأخبرني وسأرشدك.
بعد ذلك، بمجرد أن أحصل على الكود ووصف الميزة، سأبدأ العمل على التعديلات المطلوبة.
المخرجات:
- كود Python المعدل.
- كود JavaScript المعدل.
- ملف شرح شامل للتعديلات التي تمت إنشاؤها لتسهيل فهم الكود الجديد.
-
- User
# For license information, please see license.txt # timesheet_tool.py import frappe from frappe.model.document import Document from frappe import _ class TimesheetTool(Document): @frappe.whitelist() def get_all_employees(self, project=None): settings = get_settings() over_time_n = settings.n_over_time over_time_h = settings.h_over_time from_time = settings.from_time standard_working_hours = settings.standard_working_hours dufault_activity = settings.dufault_activity ratio_attendance = settings.ratio_attendance salary_component_overtime_h = settings.salary_component_overtime_h salary_component_overtime_n = settings.salary_component_overtime_n salary_component_deduction = settings.salary_component_deduction # Clear the timesheet_tool_details table self.set("timesheet_tool_details", []) if project: # Fetch employees from the project_team child table of the given project employees = frappe.db.sql(""" SELECT DISTINCT pt.employee As name , pt.employee_name FROM `tabProject Team` pt WHERE pt.parent = %s """, (project,), as_dict=True) if not employees: frappe.throw(_("No employees found in the Project Team for the selected project.")) else: # Fetch active employees directly when no project is selected employees = frappe.db.sql(""" SELECT DISTINCT emp.name ,emp.employee_name , emp.hourly_rate FROM `tabEmployee` emp JOIN `tabSalary Structure Assignment` ssa ON emp.name = ssa.employee WHERE emp.status = 'Active' AND ssa.docstatus = 1 """, as_dict=True) # Append employees to the child table for emp in employees: self.append("timesheet_tool_details", { "employee": emp.get('employee', emp.get('name')), "employee_name": emp.get('employee', emp.get('employee_name')), "hourly_rate": emp.get('employee', emp.get('hourly_rate')), "attendance": dufault_activity, "ratio_attendance": ratio_attendance, }) return employees @frappe.whitelist() def fetch_settings_and_update_mandatory(self): """Fetch settings from Timesheet Tool Setting and check if project and company are mandatory.""" settings = get_settings() # Check and update mandatory fields dynamically based on settings is_project_mandatory = settings.is_project_mandatory is_company_mandatory = settings.is_company_mandatory return { "is_project_mandatory": is_project_mandatory, "is_company_mandatory": is_company_mandatory } def on_cancel(self): pass def on_submit(self): pass def before_save(self): pass def get_settings(): # Fetch the latest settings settings = frappe.get_single("Timesheet Tool Setting") return settings def create_timesheet(doc,employee): timesheet = frappe.get_doc({ "doctype": "Timesheet", "timesheet_tool":doc.name, "company": doc.company, "parent_project": doc.project, "employee":employee, "time_logs": [] }) for time_log in doc.timesheet_tool_details: child_time_logs = { "activity_type": time_log.attendance, "hours": time_log.hour, } timesheet.append("time_logs", child_time_logs) timesheet.insert(ignore_permissions=True) frappe.db.commit() def create_additional_salary(doc,employee,salary_component,amount): additional_salary = frappe.new_doc("Additional Salary") additional_salary.timesheet_tool = doc.name additional_salary.company = doc.company additional_salary.employee = employee additional_salary.payroll_date = doc.day additional_salary.salary_component = salary_component additional_salary.amount = amount additional_salary.insert(ignore_permissions=True) ``` - Assistant
شكرًا لإرسال الكود الخاص بملف Python. يبدو الكود مكتوبًا بشكل جيد، ويتعامل مع
Timesheet Toolبشكل صحيح. لفهم متطلباتك بشكل أفضل وإجراء التعديلات المطلوبة، أحتاج منك الآن الخطوة التالية:
الخطوات التالية:
-
إرسال كود JavaScript: إذا كان لديك ملف JavaScript يعمل ضمن Doctype هذا أو يحتوي على وظائف إضافية تتعلق بـ frontend، يرجى إرساله لي. هذا سيساعدني على فهم الصورة الكاملة.
-
تفصيل الميزة الجديدة: ما هي الميزة الجديدة بالتحديد التي تريد إضافتها إلى
Timesheet Tool؟ على سبيل المثال:- إضافة معالجة معينة عند الضغط على زر
get_employee. - تنفيذ معالجة إضافية عند الحفظ أو التقديم.
- إنشاء أو تحديث السجلات بناءً على شروط معينة.
- أو أي وظيفة أخرى.
- إضافة معالجة معينة عند الضغط على زر
-
رؤية النواتج المتوقعة: إذا كان لديك شكل معين من النتائج أو الوظائف التي تريد تحقيقها، يرجى توضيح ذلك لأتمكن من برمجة المطلوب بالطريقة الصحيحة.
بمجرد استلام الكود النهائي للـ JavaScript وتفاصيل الميزة المطلوبة، سأقوم بتحليلها ووضع خطة لتنفيذ التعديلات، وسأشرح لك خطوة بخطوة كيف تمت التغييرات.
-
- User
// For license information, please see license.txt // timesheet_tool.js let settings = {} frappe.ui.form.on("Timesheet Tool", { refresh(frm) { frm.fields_dict['timesheet_tool_details'].grid.get_field('employee').get_query = function(doc) { return { "filters": { status:"Active", } } }; // Fetch settings and dynamically update mandatory fields frappe.call({ method: "fetch_settings_and_update_mandatory", doc: frm.doc, callback: function(response) { if (response.message) { // Update mandatory fields for 'project' and 'company' settings = response.message; frm.toggle_reqd("project", settings.is_project_mandatory); frm.toggle_reqd("company", settings.is_company_mandatory); } } }); if(frm.doc.docstatus==0){ frm.add_custom_button(__("Create"), function() { if (frm.is_dirty()){ frappe.throw(__("You have unsaved changes in this form. Please save before you continue.")); } }); } }, // Event for the custom "get_employee" button get_employee(frm) { // Check if project is mandatory and empty if (settings.is_project_mandatory && !frm.doc.project) { frappe.msgprint(__('Please select a Project before fetching employees.')); return; } // Call the get_all_employees method with or without the project frappe.call({ method: "get_all_employees", doc: frm.doc, args: { project: frm.doc.project || null }, callback: function(response) { if (!response.exc) { frm.refresh_field("timesheet_tool_details"); frappe.msgprint(__('Employees have been fetched successfully.')); } } }); } }); - Assistant
شكرًا على مشاركتك كود JavaScript الخاص بـ
Timesheet Tool. لدي الآن الرؤية كاملة للكود الخاص بالملفات المستخدمة، بما في ذلك وظائف الـ backend (Python) وواجهة المستخدم (JavaScript).الآن لنبدأ بتنفيذ متطلباتك حسب ما تم ذكره مسبقًا.
تحليل الكود الحالي:
-
Backend (
timesheet_tool.py): -هناك وظيفتان رئيسيتان:- جلب الموظفين (سواء من مشروع معين أو لجميع الموظفين).
- دعم إنشاء
TimesheetوAdditional Salaryعند الحاجة.
-
Frontend (
timesheet_tool.js):- الزر
get_employeeمبرمج ليعمل بالتزامن مع وظيفة backend (get_all_employees) لجلب الموظفين إلى الجدول. - يتم أيضًا تحديث الإعدادات الحية (
settings) لتحديد ما إذا كان الحقلينprojectوcompanyإجباريين.
- الزر
التفاصيل المطلوبة:
قبل أن نبدأ، أحتاج إلى معرفة الميزة الجديدة التي تود إضافتها. إذا لم يكن لديك تفاصيل محددة حتى الآن، سأقترح بعض الميزات التي يمكن أن تكون مفيدة بناءً على الكود الحالي:
اقتراحات للميزات:
-
إضافة ساعات عمل الموظفين تلقائياً:
- إذا كان الجدول الفرعي يحتوي على موظفين، يمكنك إضافة حقل جديد لكل موظف لساعات العمل اليومية بناءً على معايير (مثل الدوام الاعتيادي من الإعدادات أو
standard_working_hours).
- إذا كان الجدول الفرعي يحتوي على موظفين، يمكنك إضافة حقل جديد لكل موظف لساعات العمل اليومية بناءً على معايير (مثل الدوام الاعتيادي من الإعدادات أو
-
إضافة حقل "الغياب" في الجدول:
- اعتمادًا على وجود جدول أيام العمل (Attendance)، يمكن مقارنة السجلات وإضافة غياب الموظفين تلقائيًا بناءً على الحضور أو مواعيد الدوام.
-
إنشاء التقارير من خلال الجدول:
- إضافة زر لإنشاء تقارير أو تصدير البيانات (ملف Excel مثلًا) للموظفين المدرجين في الجدول.
-
التأكد من الإدخالات قبل الحفظ:
- إذا كان لديك شروط أو معايير معينة لتعبئة البيانات (مثل التأكد بأن ساعات العمل لكل موظف قد تم إضافتها بشكل صحيح) قبل تقديم النموذج، يمكن دمج ذلك.
يرجى:
- تقديم وصف الميزة الدقيقة التي ترغب في تنفيذها.
- الاتفاق على واحدة من الاقتراحات السابقة (إن كانت مناسبة).
بالمقابل، بعد تلقي الإجابة، سأبدأ بتنفيذ المطلوب مع إجراء تعديلات متكاملة على الأكواد.
-
- User
تفاصيل الميزة المطلوبة : " في ﺟﺪول timesheet_tool_details ﻳﺘﻢ ﺿﺮب ﻗﻴﻤﺔ hour في ratio_attendance ووضع الناتج في total_working_hours ﻓﻲ ﺣﺎﻟﺔ اﺿﺎﻓﺔ over_time_h , over_time_n أو Deduction ﻳﺘﻢ اﻧﺸﺎء Salary Additional ﻓﻲ ﻫﺪا اﻟﺤﺎﻟﺔ ﻳﺘﻢ اﺳﺘﺨﺪام [salary_component_overtime_n,salary_component_overtime_h,salary_component_deduction] ﻓﻲ Timesheet Tool Details ﺑﻨﺎء ﻋﻠﻲ over_time_h , over_time_n أو Deduction ﻛﻴﻒ ﺣﺴﺎب over_time_h , over_time_n أو Deduction ﻓﻲ ﺟﺪول timesheet_tool_details ﻳﺘﻢ وﺿﻊ ﻗﻴﻤﺔ ﺳﺎﻋﺎت over_time_h , over_time_n أو Deduction ﻳﺘﻢ ﺿﺮب ﻗﻴﻤﺔ اﻟﺴﺎﻋﺔ over_time_h , over_time_nالتي في اﻟﺠﺪول ﻓﻲ اﻟﻘﻴﻤﺔ اﻟﻤﻌﺮﻓﺔ ﻓﻲ Timesheet Tool Details وﻓﻲ ﺣﺎﻟﺔ Deduction ﻻ ﺗﻀﺮب عند انشاء Additional Salary ﻳﺘﻢ ﺣﺴﺎب القيمة ﻣﻦ ﺣﺎﺻﻞ ﺿﺮب total_working_hours ﻓﻲ hourly_rate "
- Assistant
شكرًا على توضيحك الميزة المطلوبة. بناءً على التفاصيل التي أوضحتها، فإننا سنضيف الميزة الجديدة بحيث:
-
سيتم تحديث حساب الحقول الموجودة في الجدول
timesheet_tool_details:- ضرب قيمة
hour×ratio_attendanceلإجمالي ساعات العمل (total_working_hours). - في حال وجود قيم في الحقول
over_time_h,over_time_n, أوDeduction، سيتم إنشاء سجل فيAdditional Salary. - في حال
over_time_hوover_time_n: سيتم ضرب الساعات في القيم المعرفة في الإعدادات. - في حال
Deduction: لن يتم الضرب وسيستخدم الرقم بشكل مباشر.
- ضرب قيمة
-
عند إنشاء
Additional Salary، يتم حساب القيمة باستخدام:
total_working_hours × hourly_rate.
تعديلات الشيفرة:
سنعمل على الشيفرة لتعديل الميزة عبر:
- Backend (
timesheet_tool.py): تعديل الوظائف لتشمل الحسابات الجديدة لكل صف في الجدول. - Frontend (
timesheet_tool.js): تحديث القيم في واجهة الجدول مباشرة عند قيام المستخدم بتعديل الحقول.
1. تعديل
timesheet_tool.py:قمنا بإضافة وظيفة جديدة ستقوم بتنفيذ الحسابات على أساس القيم المدخلة وستقوم بإنشاء سجلات
Additional Salary. كما قمنا بتعديل طريقة التعامل مع الجدول الفرعي:# تعديل الملف: timesheet_tool.py import frappe from frappe.model.document import Document from frappe import _ class TimesheetTool(Document): @frappe.whitelist() def calculate_details(self): """ حساب الحقول المطلوبة في جدول timesheet_tool_details """ settings = get_settings() # إعداد الحقول من الإعدادات ratio_attendance = settings.ratio_attendance salary_component_overtime_h = settings.salary_component_overtime_h salary_component_overtime_n = settings.salary_component_overtime_n salary_component_deduction = settings.salary_component_deduction for detail in self.timesheet_tool_details: # حساب total_working_hours detail.total_working_hours = detail.hour * detail.ratio_attendance # حساب Additional Salary (Overtime H, Overtime N, Deduction) if detail.over_time_h: amount = detail.over_time_h * settings.h_over_time create_additional_salary(self, detail.employee, salary_component_overtime_h, amount) if detail.over_time_n: amount = detail.over_time_n * settings.n_over_time create_additional_salary(self, detail.employee, salary_component_overtime_n, amount) if detail.deduction: create_additional_salary(self, detail.employee, salary_component_deduction, detail.deduction) # تحديث إجمالي دفعة العمل detail.total_payment = detail.total_working_hours * detail.hourly_rate @frappe.whitelist() def process_all(self): """ وظيفة لتنفيذ جميع الحسابات وإنشاء السجلات المطلوبة. """ self.calculate_details() frappe.msgprint(_("Calculations and Additional Salaries have been processed."))
2. تعديل
timesheet_tool.js:تعديل Frontend لجلب القيم وتحديث الجدول بعد أي تغييرات على القيم.
// تعديل الملف: timesheet_tool.js frappe.ui.form.on("Timesheet Tool", { refresh(frm) { frm.fields_dict['timesheet_tool_details'].grid.get_field('employee').get_query = function(doc) { return { "filters": { status: "Active" } }; }; // استدعاء الإعدادات لتحديث الحقول الإجباريّة frappe.call({ method: "fetch_settings_and_update_mandatory", doc: frm.doc, callback: function(response) { if (response.message) { settings = response.message; frm.toggle_reqd("project", settings.is_project_mandatory); frm.toggle_reqd("company", settings.is_company_mandatory); } } }); if (frm.doc.docstatus == 0) { frm.add_custom_button(__("Process"), function() { if (frm.is_dirty()) { frappe.throw(__("You have unsaved changes in this form. Please save before you continue.")); } frappe.call({ method: "process_all", doc: frm.doc, callback: function() { frm.refresh_field("timesheet_tool_details"); } }); }); } }, // تحديث الحسابات عند تعديل الجدول timesheet_tool_details: { hour(frm, cdt, cdn) { let row = frappe.get_doc(cdt, cdn); // تحديث total_working_hours row.total_working_hours = row.hour * row.ratio_attendance; frm.refresh_field("timesheet_tool_details"); }, over_time_h(frm, cdt, cdn) { let row = frappe.get_doc(cdt, cdn); // حساب القيمة الجديدة لـ Overtime H frappe.call({ method: "process_all", // معالجة الحسابات عبر الخادم doc: frm.doc, callback: function() { frm.refresh_field("timesheet_tool_details"); } }); }, over_time_n(frm, cdt, cdn) { let row = frappe.get_doc(cdt, cdn); // حساب القيمة الجديدة لـ Overtime N frappe.call({ method: "process_all", doc: frm.doc, callback: function() { frm.refresh_field("timesheet_tool_details"); } }); }, deduction(frm, cdt, cdn) { frappe.call({ method: "process_all", doc: frm.doc, callback: function() { frm.refresh_field("timesheet_tool_details"); } }); } } });
ملخص التعديلات:
-
Backend:
- أضفنا وظيفة
calculate_detailsلحساب القيم في جدولtimesheet_tool_details. - قمنا بتضمين إنشاء سجلات
Additional Salaryمباشرة بناءً على القيمover_time_h,over_time_n, وDeduction.
- أضفنا وظيفة
-
Frontend:
- أضفنا تحديثات مباشرة على الجدول عند إدخال القيم (مثل
hour,over_time_h, إلخ). - أضفنا زرًا جديدًا باسم "Process" ينفذ الحسابات بشكل سريع.
- أضفنا تحديثات مباشرة على الجدول عند إدخال القيم (مثل
اختبار الكود:
- قم بإعادة تشغيل الخادم.
- افتح نموذج
Timesheet Toolوقم بإدخال البيانات في الجدول. - استخدم زر "Process" بعد إدخال القيم للتحقق من التحديثات.
- تأكد أن سجلات
Additional Salaryيتم إنشاؤها بشكل صحيح من خلال قائمة السجلات.
-
- User
Error: Value missing for Additional Salary: Salary Component
- Assistant
الخطأ الذي تواجهه (
Value missing for Additional Salary: Salary Component) يشير إلى أن الحقلSalary ComponentفيAdditional Salaryلم يتم تمرير قيمته أثناء إنشاء السجل. بناءً على الكود الذي أرسلته، فإن القيم الخاصة بأسماء حقلsalary_componentيتم استردادها من الإعدادات (Timesheet Tool Settings). لذا، إذا لم يتم إعداد تلك القيم بشكل صحيح في الإعدادات، فسيؤدي ذلك إلى هذا الخطأ.لنقم بتحليل السبب وإصلاح هذا الخطأ.
خطوات الإصلاح:
1. التحقق من الإعدادات (
Timesheet Tool Setting)- توجه إلى نموذج
Timesheet Tool Settingوتأكد من القيم التالية:salary_component_overtime_n: يحتوي على الاسم الصحيح لمكون الراتب الخاص بـ[Over Time Normal].salary_component_overtime_h: يحتوي على الاسم الصحيح لمكون الراتب الخاص بـ[Over Time Holiday].salary_component_deduction: يحتوي على الاسم الصحيح لمكون الراتب الخاص بـ[Deduction].
إذا كانت أي من هذه الحقول فارغة، يجب تعبئتها بالقيم الصحيحة (في الغالب تكون قيم
Salary Componentمتوفرة بالفعل في النظام وتحتاج فقط إلى الربط).2. إضافة معالجة للأخطاء عند القيم الفارغة
سنضيف تحققًا في طريقة إنشاء السجلات للتأكد من أن قيم
salary_componentموجودة دائمًا. في حال وجود نقص، سنبلغ المستخدم بخطأ واضح.3. تعديل الشيفرة
أ. تعديل
create_additional_salaryقم بتعديل دالة
create_additional_salaryبحيث يتم التحقق مما إذا كانت قيمةsalary_componentفارغة. إذا كانت فارغة، قم بإرسال رسالة خطأ واضحة للمستخدم:def create_additional_salary(doc, employee, salary_component, amount): """ Create an Additional Salary record for the employee. """ if not salary_component: frappe.throw(_("Salary Component is missing for Additional Salary. Please check the settings.")) additional_salary = frappe.new_doc("Additional Salary") additional_salary.timesheet_tool = doc.name additional_salary.company = doc.company additional_salary.employee = employee additional_salary.payroll_date = doc.day additional_salary.salary_component = salary_component additional_salary.amount = amount additional_salary.insert(ignore_permissions=True)بهذا التعديل، سنرسل رسالة خطأ واضحة، إذا كانت قيمة
salary_componentمفقودة، مع توجيه المستخدم للتحقق من إعداداتTimesheet Tool Setting.
ب. تعزيز عملية الحسابات في
calculate_detailsسنضيف أيضًا التحقق المباشر من الإعدادات ضمن دالة
calculate_detailsلتجنب إرسال قيم فارغة لدالةcreate_additional_salary. هنا هو التحديث الكامل لدالةcalculate_details:@frappe.whitelist() def calculate_details(self): """ حساب الحقول المطلوبة في جدول timesheet_tool_details """ settings = get_settings() # إعداد الحقول من الإعدادات ratio_attendance = settings.ratio_attendance salary_component_overtime_h = settings.salary_component_overtime_h salary_component_overtime_n = settings.salary_component_overtime_n salary_component_deduction = settings.salary_component_deduction # تحقق من وجود القيم اللازمة if not salary_component_overtime_h or not salary_component_overtime_n or not salary_component_deduction: frappe.throw(_("Please configure the Salary Components in Timesheet Tool Settings.")) for detail in self.timesheet_tool_details: # حساب total_working_hours detail.total_working_hours = detail.hour * detail.ratio_attendance # حساب Additional Salary (Overtime H, Overtime N, Deduction) if detail.over_time_h: amount = detail.over_time_h * settings.h_over_time create_additional_salary(self, detail.employee, salary_component_overtime_h, amount) if detail.over_time_n: amount = detail.over_time_n * settings.n_over_time create_additional_salary(self, detail.employee, salary_component_overtime_n, amount) if detail.deduction: create_additional_salary(self, detail.employee, salary_component_deduction, detail.deduction) # تحديث إجمالي دفعة العمل detail.total_payment = detail.total_working_hours * detail.hourly_rate
النتيجة المتوقعة
عند إدخال المعلومات بشكل صحيح في
Timesheet Tool Setting:- إذا كان الحقول التي تخص مكونات الرواتب (Salary Components) مكتملة، فلن تواجه أي مشكلة.
- إذا كانت الحقول مفقودة، ستظهر رسالة واضحة توجه المستخدم إلى تحديث هذه الحقول في
Timesheet Tool Setting.
التحقق والاختبار
-
التحقق من إعداد الإعدادات:
- افتح نموذج
Timesheet Tool Settingوتأكد من إدخال القيم (مثلOT Normal,OT Holiday, إلخ.). - تأكد من أن أسماء الحقول تتوافق مع القيم الموجودة في Doctype
Salary Component.
- افتح نموذج
-
إجراء حالات اختبار مختلفة:
- حاول إنشاء سجل مع
over_time_h,over_time_n, أوDeductionمع إعدادات مكتملة وتحقق من أنAdditional Salaryيتم إنشاؤها بدون مشاكل. - حاول ترك أحد الحقول فارغًا (مثل
salary_component_overtime_n) وتأكد من ظهور رسالة توجيه للمستخدم.
- حاول إنشاء سجل مع
-
مراجعة النتائج في نظام
Additional Salary:- تحقق من ظهور السجلات في Doctype
Additional Salaryمع الحقول الصحيحة (مثل اسم الموظف، المبلغ، المكون).
- تحقق من ظهور السجلات في Doctype
إذا استمر الخطأ:
إذا كنت لا تزال تواجه مشكلات أو تحتاج إلى مساعدة إضافية، لا تتردد في مشاركتنا بمخرجات الأخطاء أو البيئة الحالية كي نقوم بمساعدتك بشكل كامل.
- توجه إلى نموذج
- User
في حالة over_time_h , over_time_n يتم ضرب قيم over_time_h , over_time_n في القيم الماقابله له في Timesheet Tool Setting في الحقول [n_over_time,h_over_time]
- Assistant
شكرًا لجعل الأمر أكثر وضوحًا! بناءً على المعلومات الإضافية، إذا كانت الحقول
over_time_hوover_time_nفي جدولtimesheet_tool_detailsتحتوي على قيم، سيتم ضرب تلك القيم بالقيم المقابلة لها في الإعدادات (h_over_timeوn_over_time، على التوالي) وسنستخدم الناتج لحساب المبالغ أثناء إنشاء سجل "Additional Salary".دعنا نعدل الكود ليشمل الحساب الجديد المحدد.
التعديلات على الكود:
1. تعديل دالة
calculate_detailsكما هو مطلوب، سيتم تعديل
calculate_detailsلتعكس هذه القواعد:- عند وجود
over_time_h: يتم ضرب القيمة فيh_over_timeمن الإعدادات. - عند وجود
over_time_n: يتم ضرب القيمة فيn_over_timeمن الإعدادات. - عند وجود
Deduction، لا يتم ضرب القيمة وتستخدم كما هي.
الكود بعد التعديل:
@frappe.whitelist() def calculate_details(self): """ حساب الحقول المطلوبة في جدول timesheet_tool_details """ settings = get_settings() # إعداد الحقول من الإعدادات ratio_attendance = settings.ratio_attendance h_over_time = settings.h_over_time n_over_time = settings.n_over_time salary_component_overtime_h = settings.salary_component_overtime_h salary_component_overtime_n = settings.salary_component_overtime_n salary_component_deduction = settings.salary_component_deduction # تحقق من وجود القيم اللازمة if not salary_component_overtime_h or not salary_component_overtime_n or not salary_component_deduction: frappe.throw(_("Please configure the Salary Components in Timesheet Tool Settings.")) # تنفيذ الحسابات على الجدول for detail in self.timesheet_tool_details: # حساب total_working_hours detail.total_working_hours = detail.hour * detail.ratio_attendance # حساب Additional Salary (Overtime H) if detail.over_time_h: amount = detail.over_time_h * h_over_time create_additional_salary(self, detail.employee, salary_component_overtime_h, amount) # حساب Additional Salary (Overtime N) if detail.over_time_n: amount = detail.over_time_n * n_over_time create_additional_salary(self, detail.employee, salary_component_overtime_n, amount) # حساب Additional Salary (Deduction) if detail.deduction: create_additional_salary(self, detail.employee, salary_component_deduction, detail.deduction) # تحديث إجمالي دفعة العمل detail.total_payment = detail.total_working_hours * detail.hourly_rate
2. اختبار المخرجات
للتأكد من النتائج:
-
استرجاع الإعدادات:
h_over_time: قيمة معدل الدفع للدوام الإضافي المرتبط بالعطلات.n_over_time: قيمة معدل الدفع للدوام الإضافي العادي.salary_component_overtime_h,salary_component_overtime_n, وsalary_component_deduction: أسماء مكونات الرواتب.
-
التحقق من الجدول الفرعي (
timesheet_tool_details):- إضافة قيم ضمن الحقول
over_time_h,over_time_n, أوdeduction. - بعد استدعاء هذه الدالة، يتم:
- ضرب
over_time_h×h_over_time. - ضرب
over_time_n×n_over_time. - إضافة
deductionمباشرةً بدون ضرب.
- ضرب
- إضافة قيم ضمن الحقول
-
مخرجات الحسابات:
- في حال كانت الإعدادات صحيحة، ستتم كل العمليات دون مشاكل.
- في حال الحقول فارغة (مثل مكونات الرواتب)، ستظهر رسالة خطأ موجهة للمستخدم لتصحيح الإعدادات.
المخرجات النهائية:
Backend (
timesheet_tool.py):def create_additional_salary(doc, employee, salary_component, amount): """ إنشاء سجل Additional Salary للموظف. """ if not salary_component: frappe.throw(_("Salary Component is missing for Additional Salary. Please check the settings.")) additional_salary = frappe.new_doc("Additional Salary") additional_salary.timesheet_tool = doc.name additional_salary.company = doc.company additional_salary.employee = employee additional_salary.payroll_date = doc.day additional_salary.salary_component = salary_component additional_salary.amount = amount additional_salary.insert(ignore_permissions=True)
Frontend (
timesheet_tool.js):سيبقى كما هو لأنه لا حاجة لتغيير أي شيء في المنطق الخاص بـواجهة المستخدم. كل التعديلات يمكن معالجتها على مستوى الخادم.
ملاحظات إضافية:
-
الاختبار: قم بالاختبار بإضافة سجلات تحتوي على أنواع مختلفة من
over_time_h,over_time_n, وdeduction. تأكد من أنAdditional Salaryيتعامل مع التحسابات بالشكل الصحيح. -
التحقق من الإعدادات: تأكد أن جميع الحقول الضرورية (مثل
h_over_time,n_over_time) تحتوي على قيم صحيحة وإلا لن تعمل الحسابات بشكل صحيح.
إذا استمرت أي مشكلة، سأكون هنا لدعمك!
- عند وجود