خطأ في قاعدة بيانات Nextcloud بعد التحديث: ما الذي يجب التحقق منه أولاً
استعادة الوصول إلى Nextcloud بعد التحديث عن طريق تشخيص أخطاء SQL، والتحقق من اتصال قاعدة البيانات، وإكمال عمليات الترحيل المتقطعة بأمان.
لتبسيط محرر Collabora Online Development Edition (CODE)، اختر "مُصغّر" أو "مُبَوَّب" للتصميم العام، ثم استخدم تكامل PostMessage الخاص بمضيف WOPI لإخفاء الأوامر أو الأزرار أو علامات تبويب Notebookbar. يُعدّ طي شريط الأدوات تغييرًا مُريحًا في العرض؛ بينما يُعدّ إخفاء عنصر تحكم من خلال المضيف أكثر ملاءمةً عندما ترغب في واجهة مُوحّدة لكل جلسة تحرير.
يُقدّم برنامج CODE تصميمًا مُدمجًا مع قوائم وأشرطة أدوات تقليدية، وتصميمًا مُبَوَّبًا مع شريط أدوات دفتر الملاحظات. ابدأ بتحديد التصميم الذي يراه المستخدمون: مُعرّف زر شريط الأدوات ومُعرّف علامة تبويب شريط أدوات دفتر الملاحظات غير قابلين للتبديل. تُشير إرشادات دعم Collabora إلى أن الأسماء القديمة classicقد notebookbarتم إيقافها لصالح الأسماء الجديدة compactبدءًا tabbedمن سلسلة 21.11. راجع إرشادات تكوين واجهة Collabora .


غيّر الإعدادات الافتراضية للخادم فقط عندما يكون من الضروري أن يبدأ معظم المستخدمين بنفس التخطيط. في عمليات التثبيت ذاتية الإدارة، يقبل user_interface.modeالإعداد القيم التالية : أو أو . قم بعمل نسخة احتياطية من التكوين، ثم غيّر القيمة الحالية بدلاً من إضافة عنصر XML آخر.coolwsd.xmldefaultcompacttabbedmode
<user_interface>
<mode>tabbed</mode>
</user_interface>يوضح ملف XML المختصر هذا الإعداد، وليس بديلاً عن قسم التكوين الكامل. طبّق التغيير من خلال عملية التكوين وإعادة تشغيل الخدمة المعتادة في عملية النشر، ثم أعد فتح المستند. يمكن لعمليات نشر الحاويات بدلاً من ذلك تمرير --o:user_interface.mode=tabbedتجاوزات بدء التشغيل الخاصة بها في CODE. يمكن لتطبيق التضمين أيضًا التأثير على وضع بدء التشغيل من خلال ui_defaultsقيمة WOPI الخاصة به. قد يكون لتفضيل المضيف أهمية عند استخدام الخادم default، لذا لا تفترض أن تعديل الخادم سيلغي خيارًا خاصًا بالتكامل.
للحصول على مساحة أكبر أثناء القراءة، يمكن طي شريط الملاحظات بالنقر على علامة التبويب المحددة حاليًا؛ والنقر مرة أخرى يُوسّعه. تشرح Collabora هذا السلوك في مقدمة شريط الملاحظات الرسمية . كما توثّق واجهة برمجة تطبيقات PostMessage Collapse_Notebookbarخاصية إخفاء أزرار شريط الملاحظات أو شريط الأزرار المُصغّر. هذه حالة عرض قابلة للعكس، وليست سياسة إدارية دائمة.
لتحكم أدق، اختر إجراء PostMessage الذي يطابق العنصر. ترد التعيينات التالية في دليل Collabora Online SDK :
| ما الذي يجب إخفاؤه | إجراء PostMessage | تنسيق المعرف |
|---|---|---|
| زر واحد في شريط الأدوات | Hide_Button | معرف الزر |
| أمرٌ يُطبّق على القوائم وأشرطة الأدوات | Hide_Command | أمر أونو، مثل.uno:ThemeDialog |
| علامة تبويب واحدة في تخطيط علامات التبويب | Hide_NotebookTab | معرّف علامة التبويب، مثلHelp |
| مدخل قائمة مختصرة | Hide_Menu_Item | معرف عنصر القائمة |
تم توثيق الإجراء الخاص بالتبويب بدءًا من الإصدار 24.04.11.1 . كما يشير SDK إلى تغطية موسعة لقوائم السياق Hide_Commandفي الإصدار 24.04.11.2 . تحقق من إصدار CODE المنشور قبل الاعتماد على أي من السلوكين.
يتم إرسال هذه الإجراءات من قِبل التطبيق الذي يُضمّن التعليمات البرمجية في إطار iframe، وليس عن طريق إدخالها في مربع حوار إعدادات التعليمات البرمجية. أنت بحاجة إلى التحكم في تكامل المضيف، CheckFileInfoواستجابة WOPI فعّالة، وقيمة PostMessageOriginتُطابق مصدر تطبيق الويب المضيف. إذا كنت تستخدم تكامل Nextcloud أو ownCloud مُجمّعًا، فقد لا يُتيح لك الوصول إلى خطافات PostMessage المُخصصة؛ في هذه الحالة، قم بإجراء التغيير في التكامل نفسه أو استخدم إعداداته المدعومة.
قم بتسجيل مستمع للرسائل في صفحة المضيف. تحقق من كلٍ من نافذة المرسل ومصدره. عندما يُبلغ CODE App_LoadingStatusعن رسالة Status: Document_Loaded، أرسلها Host_PostmessageReadyقبل رسائل التخصيص. بدون هذه المصافحة، قد يتجاهل CODE أوامر المضيف - وهو عطل موضح في مشكلة Collabora رقم 13224 .
يفترض كود جافا سكريبت التالي، المُنفذ على جانب المضيف، أن صفحتك تحتوي بالفعل على إطار iframe بمعرّف collabora-frame. عيّن هذا المعرّف editorOriginإلى مصدر HTTPS الذي يُشغّل مُحرّر التعليمات البرمجية الخاص بك، وليس خادم تخزين WOPI. سجّل المُستمع قبل تهيئة المستند في تطبيقك الفعلي.
const frame = document.getElementById('collabora-frame');
const editorOrigin = 'https://office.example.com';
function sendToCode(MessageId, Values = {}) {
frame.contentWindow.postMessage(JSON.stringify({
MessageId, SendTime: Date.now(), Values
}), editorOrigin);
}
window.addEventListener('message', (event) => {
if (event.source !== frame.contentWindow ||
event.origin !== editorOrigin) return;
let message;
try {
message = typeof event.data === 'string'
? JSON.parse(event.data) : event.data;
} catch { return; }
if (message?.MessageId !== 'App_LoadingStatus' ||
message?.Values?.Status !== 'Document_Loaded') return;
sendToCode('Host_PostmessageReady');
sendToCode('Hide_NotebookTab', { id: 'Help' });
sendToCode('Hide_Command', { id: '.uno:ThemeDialog' });
});
هذا Helpهو هدف علامة تبويب Notebookbar، بينما .uno:ThemeDialogيُحدد أمر LibreOffice UNO. يُوضح مطورو Collabora هذا المعرّف تحديدًا في إرشاداتهم حول إخفاء عناصر UNO . لإخفاء زر مُحدد من شريط أدوات Compact، استبدل الإجراء بـ [ Hide_Buttonاسم الإجراء] وقدّم معرّف الزر المُؤكد. لا تُخمّن المعرّف من التسمية الظاهرة؛ راجع مصدر التعليمات البرمجية المُثبّت أو إرشادات معرّف شريط الأدوات في SDK.
تحقق من وحدة تحكم المتصفح ونشاط الشبكة قبل تعديل ملفات التعليمات البرمجية. من أكثر الأسباب شيوعًا عدم وجود Host_PostmessageReadyمصافحة، أو عدم تطابق PostMessageOrigin، أو إرسال رسائل قبل Document_Loaded، أو استهداف عنصر قائمة مضغوطة أثناء وجود المحرر في وضع علامات التبويب. إعادة فتح الملف تبدأ جلسة جديدة، لذا قم بتطبيق إخفاء الرسائل في كل مرة.
توجد أيضًا عيوب خاصة بكل إصدار. على سبيل المثال، تصف المشكلة رقم 15910 في CollaboraHide_NotebookTab خطأً في جافا سكريبت في الإصدار 25.04.9.4 من البرنامج، والذي تم الإبلاغ عنه في يونيو 2026؛ وقد تم إغلاق المشكلة، ولكن هذا وحده لا يُحدد أي الإصدارات المنشورة تحتوي على إصلاح. تحقق من إصدارك المحدد وملاحظات الإصدار الخاصة به إذا واجهت الخطأ المذكور.
أخيرًا، لا يُعدّ الإخفاء تحكمًا في الوصول. فقد يُتيح زر الطباعة أو التنزيل المخفي الوصول إلى واجهات برمجة التطبيقات أو مسارات أخرى مماثلة. إذا كان الهدف هو منع هذه العمليات، فاستخدم WOPI DisablePrintأو DisableExportالعلامات الموثقة، وفرض أذونات التخزين حسب الحاجة، بدلًا من الاعتماد Hide_Buttonعلى Hide_Command.
افتح مستندًا جديدًا بالتصميم المطلوب. تأكد من Helpاختفاء علامة التبويب في وضع علامات التبويب، وأن أمر "السمة" لم يعد متاحًا في المكان الذي كان يظهر فيه سابقًا. ثم عدّل مستندًا تجريبيًا واحفظه للتأكد من استمرار عمل خاصية التأليف بشكل طبيعي. كرر الفحص مع نوع مستند آخر وبعد إعادة تحميل الصفحة، لأن الخادم سيُعيد تطبيق أوامر الإخفاء الخاصة بالجلسة.

استعادة الوصول إلى Nextcloud بعد التحديث عن طريق تشخيص أخطاء SQL، والتحقق من اتصال قاعدة البيانات، وإكمال عمليات الترحيل المتقطعة بأمان.
استخدم أمر OCC الخاص بـ Nextcloud لإعادة تعيين كلمة مرور المسؤول من واجهة سطر الأوامر الخاصة بالخادم، مع إرشادات حول أسماء المستخدمين والأذونات وموفري تسجيل الدخول الخارجيين.
قم بإزالة تحذير HSTS الخاص بـ Nextcloud عن طريق تعيين العنوان في Apache أو NGINX أو وكيل TLS الخاص بك، ثم تحقق من استجابة HTTPS العامة بأمان.
تتبع حالات فشل تثبيت التطبيقات من متجر التطبيقات إلى مشاكل في نظام أسماء النطاقات (DNS) أو بروتوكول HTTPS أو الخادم الوكيل أو بروتوكول TLS أو مشاكل في التكوين من خادم Nextcloud نفسه.
انقل العمل على الصور المصغرة إلى جدول زمني مُتحكم به في الخلفية، وقم بتقليص أحجام المعاينة غير المستخدمة، وتحقق من قائمة الانتظار دون إثقال خادم Nextcloud الخاص بك.
ابحث عن الملف أو قاعدة الاستبعاد أو مشكلة الاتصال أو حالة قاعدة بيانات العميل التي تعيق مزامنة Nextcloud، ثم تحقق من عمليات التحميل والتنزيل بأمان.
ابحث عن حد PHP OPcache الذي يتسبب في ظهور تحذير Nextcloud، وقم بتحديث تكوين PHP الصحيح للويب، وأعد التشغيل بأمان، وتحقق من النتيجة.
قارن بين الكود المدمج والكود القائم على Docker، ثم قم بتوصيل Collabora Online بـ Nextcloud من خلال وكيل عكسي آمن HTTPS.
خطط لنشر Nextcloud عالي التوفر بشكل موثوق مع التخزين المشترك، وقفل Redis، وتوجيه MariaDB المدرك للنصاب، وفحوصات تجاوز الفشل العملية.
قم بتكوين وتحقق من إمكانية الوصول إلى مرحل TURN لـ Nextcloud Talk عندما تمنع جدران الحماية أو NAT التقييدية وسائط الاتصال المباشر.