التطوير

اختفت مساحة عمل Frappe بعد bench migrate؟

علاء الحريرينُشر آخر تحديث: 3 دقائق للقراءة

رسم توضيحي: قائمة جانبية في التطبيق فيها مكان فارغ، ومساحة العمل المفقودة تعود إلى مكانهارسم توضيحي: قائمة جانبية في التطبيق فيها مكان فارغ، ومساحة العمل المفقودة تعود إلى مكانها

مساحة العمل (Workspace) التي تختفي بعد تشغيل أمر bench migrate إما مخفية عن المستخدم أو محذوفة من الموقع. فمن الإصدار 16 من منصة Frappe، يحذف هذا الأمر مساحات العمل العامة التي لا يحملها أي تطبيق مثبّت في ملف، بل كانت الإصدارات الأولى من 16 تحذف أيضًا المساحات التي أُنشئت من المتصفح. أما الإصدار 15 فلا يفعل ذلك، وفي كل الإصدارات تبقى مساحة العمل أداة تنقّل فقط، فلا تتأثر المستندات التي ترتبط بها.

كتبت هذا الدليلَ أكواد للبرمجة، شركة متخصصة في منصة Frappe ونظام ERPNext في الدوحة، قطر، من خبرتها في ترقيات أنظمة عملائها.

هل المساحة مخفية أم محذوفة؟

افتح قائمة مساحات العمل بحساب Administrator أو بمستخدم لديه دور Workspace Manager. تجدها في /desk/workspace في الإصدار 16، وفي /app/workspace في الإصدار 15.

  • إن وجدت السجل، فالمساحة موجودة والمشكلة في الصلاحيات والظهور.
  • وإن لم تجده، فراجع مخرجات أمر migrate، فمنصة Frappe تطبع السطر Deleting entity Workspace <name> لكل مساحة تحذفها.

لماذا لا يرى المستخدم مساحة عمل موجودة؟

مساحة العمل الموجودة التي لا تظهر تحجبها في الغالب وحدتها، أو أدوارها، أو كونها خاصة، أو خيار Is Hidden. فلا تعرض منصة Frappe مساحة العمل إلا لمن يحق له رؤيتها:

  • الوحدة (Module): يجب ألا تكون وحدة المساحة محجوبة عن هذا المستخدم.
  • الأدوار (Roles): إذا حُددت أدوار للمساحة، فيلزم أن يملك المستخدم واحدًا منها على الأقل.
  • المساحات الخاصة لا يراها إلا من أنشأها. وفي الإصدار 16 انتقلت إلى My Workspaces في شاشة سطح المكتب الجديدة، فيظن المستخدمون أنها اختفت.
  • خيار Is Hidden يُخرج المساحة من التنقّل من دون حذفها.

قارِن النتيجة بحساب لديه الصلاحيات، فقد يرى مستخدمان قائمتي تنقّل مختلفتين على الموقع نفسه.

أي مساحات العمل يحذفها bench migrate؟

في الإصدار 16 يتضمن أمر bench migrate خطوة تنظيف، تجمع فيها منصة Frappe ملفات JSON الخاصة بمساحات العمل من كل تطبيق مثبّت، ثم تحذف كل مساحة مشمولة بالخطوة لا يقابلها ملف. وقد تغيّر نطاق هذه الخطوة بين الإصدارات، بحسب الكود البرمجي (السورس كود) في مستودع frappe/frappe عند كل إصدار (راجعناه في 15 نوفمبر 2026، ونراجعه مع كل إصدار جديد من Frappe):

  • من v16.0.0 إلى v16.4.0: كل مساحة عمل عامة، بما فيها المساحات التي أُنشئت من المتصفح.
  • من v16.4.1 إلى v16.49.0: المساحات العامة التي حُدد لها حقل Module وحقل App معًا.
  • من v16.50.0 وما بعده: المساحات العامة المعلَّمة Standard فقط، وتبقى المساحات التي أُنشئت على الموقع كما هي.
  • المساحات الخاصة لا تشملها هذه الخطوة أبدًا.

أما الإصدار 15 فيحذف أثناء أمر migrate أنواع المستندات (DocTypes) اليتيمة فقط، ولا يحذف مساحات العمل.

وغيّر الإصدار 16 التنقّل أيضًا: شريط جانبي ثابت، وشاشة سطح مكتب، والانتقال من /app إلى /desk. وتذكر ملاحظات الانتقال إلى الإصدار 16 أن التعديلات على مساحات العمل القياسية، مثل Buying أو Selling، تضيع، فانسخها قبل تشغيل الأمر.

كيف تحافظ على مساحة عمل خاصة بعد كل migrate؟

صدّر مساحة العمل في ملف JSON داخل إحدى وحدات تطبيقك، فيجد الأمر bench migrate ملفًا مطابقًا ويُبقيها. ولتجعلها جزءًا من تطبيقك:

  1. شغّل وضع المطوّر (Developer Mode) على موقع التطوير.

  2. اضبط الوحدة. اختر في حقل Module إحدى وحدات تطبيقك.

  3. احفظ المساحة عامةً. وفي الإصدارات الحديثة من 16 علّمها Standard أيضًا، فتكتبها منصة Frappe في ملف:

    your_app/your_app/<module>/workspace/<workspace_name>/<workspace_name>.json
  4. احفظ الملف في نظام إدارة الإصدارات (Git) وانشره مع التطبيق. فيجده أمر migrate التالي ويُبقي المساحة.

وقبل تشغيل الأمر على موقع الإنتاج، خذ نسخة احتياطية واحفظ السجل:

bench --site your-site backup
bench --site your-site migrate 2>&1 | tee migrate.log
grep "Deleting entity Workspace" migrate.log

شغّل الأمر أولًا على نسخة اختبار (Staging) بإصدارات التطبيقات نفسها المخطط لها في الإنتاج، وقارِن قائمة مساحات العمل قبل التشغيل وبعده.

كيف تستعيد مساحة عمل محذوفة؟

استعِد آخر نسخة احتياطية أُخذت قبل تشغيل الأمر على موقع اختبار منفصل، وخذ تعريف المساحة منها. ثم أضفه إلى تطبيقك كملف، أو أعد إنشاءه بطريقة لا يحذفها أمر migrate التالي، قبل أن تشغّله مرة أخرى، وإلا حذفها من جديد.

وعند كل نشر، اجعل اختبارات الاستلام تشمل التنقّل بين مساحات العمل والصلاحيات وبعض أدوار المستخدمين.

مصادر راجعناها في 15 نوفمبر 2026

تبني أكواد للبرمجة تطبيقات خاصة على منصة Frappe، وتستضيف مواقع نظام ERPNext ومنصة Frappe للشركات في قطر، وتختبر الترقيات على نسخة اختبار منفصلة قبل تشغيلها. ونقلنا خادم نظام ERPNext لدى الاتحاد القطري لألعاب القوى إلى AWS، ونتولّى ترقياته. أخبرنا بإصدار Frappe لديك وما الذي اختفى.

تحتاج مساعدة في ترقية منصة Frappe؟

أخبرنا بما تريد إصلاحه أو بناءه على منصة Frappe، وسنقترح عليك من أين تبدأ.