استعادة النسخ واللصق بين تطبيقات Collabora وتطبيقات سطح المكتب
اختبر حافظة النظام، واضبط أذونات المتصفح، وحدد متى يحتاج تكامل Collabora المضمن إلى تغيير سياسة iframe.
ابدأ بالاختبار باستخدام نص عادي ولوحة المفاتيح: انسخ من تطبيق محلي، انقر داخل مستند Collabora، واضغط على مفتاح الاختصار Ctrl+V(أو Command+Vعلى نظام macOS). للنسخ، حدد النص في Collabora، واضغط على مفتاح الاختصار Ctrl+Cأو Command+Cمفتاح اللصق، ثم الصقه في تطبيق محلي. إذا عملت الاختصارات ولكن لم يعمل شريط الأدوات أو النقر بزر الماوس الأيمن ثم اللصق، فمن المحتمل أن يكون مسار أذونات الحافظة في المتصفح هو المشكلة. إذا فشلت الاختصارات أيضًا، فجرب كلا الاتجاهين وتحقق مما إذا كان Collabora مضمنًا في موقع آخر.
الحافظة النظامية هي المخزن المؤقت المشترك الذي ينقل البيانات بين التطبيقات. يعمل برنامج Collabora Online داخل متصفح، لذا فإن النسخ عبر حدوده يمر أيضًا عبر قواعد أمان المتصفح.
استخدم نصًا عاديًا للاختبار الأول. يمكن للصور والجداول ونطاقات جداول البيانات والنصوص المنسقة استخدام تنسيقات مختلفة للحافظة، لذا فإن اختبار النص العادي يفصل بين مشاكل الوصول الأساسي ومشاكل تحويل التنسيق.

انقر على منطقة تحرير المستند لتفعيلها. استخدم اختصار النظام بدلاً من شريط أدوات المحرر أو قائمة السياق في المتصفح. في نظامي التشغيل ويندوز ولينكس، استخدم مفتاحي Ctrl Ctrl+Cو Ctrl Ctrl+V؛ وفي نظام macOS، استخدم مفتاحي Ctrl Command+Cو Ctrl Command+V. عندما تظهر لك رسالة من Collabora تفيد بأن المتصفح لديه وصول محدود إلى الحافظة وتطلب منك استخدام الاختصارات، اتبع هذه التعليمات. يرتبط إجراء لوحة المفاتيح مباشرةً بإيماءة المستخدم، ويمكن أن يعمل حتى عندما يكون إجراء القائمة الذي يستدعي واجهة برمجة تطبيقات الحافظة غير المتزامنة محظورًا.
إذا لم ينجح ذلك، فتأكد من إمكانية تحرير المستند، وأن المؤشر موجود داخل المستند وليس في مربع البحث أو شريط الأدوات، وأن النص المصدر قد تم تحديده بالفعل. أغلق المستند وأعد فتحه بعد تغيير الأذونات؛ فقد يحتفظ إطار المحرر القديم بالسياسة السابقة.
تأكد أولاً من وصول النص العادي. ثم اختبر المحتوى المنسق الذي تحتاجه؛ فقد لا يتم نقل الخطوط والصيغ والصور وتنسيقات الخلايا بشكل متطابق. استخدم خاصية "لصق خاص" إذا كانت متاحة في الوجهة.
تقتصر واجهة برمجة تطبيقات الحافظة الحديثة على السياقات الآمنة، وعادةً ما تكون HTTPS، وقد تتطلب المتصفحات إيماءة من المستخدم أو إذنًا. في متصفحي Chrome أو Edge، افتح عنصر تحكم معلومات الموقع بجوار العنوان، ثم افتح إعدادات الموقع، واضبط الحافظة على " السماح " للموقع الموثوق به عند توفر هذا الإذن. إذا ظهرت لك نافذة منبثقة من المتصفح عند اختيار "لصق"، فامنح الإذن فقط لخدمة Office التي تثق بها. أعد تحميل المستند وكرر اختبار النص ثنائي الاتجاه.

تختلف مسميات أذونات الحافظة وسلوكها باختلاف المتصفحات. تستخدم بعض المتصفحات إيماءة المستخدم أو مطالبة لصق مؤقتة بدلاً من إذن دائم. كما يمكن للمتصفح المُدار فرض سياسة تتجاوز اختيارك؛ فإذا كان عنصر التحكم مُقفلًا أو تم رفض الإذن بموجب السياسة، فاطلب من مسؤول المتصفح التحقق من قاعدة موقع المكتب. حافظ على استخدام HTTPS للموقع: فمنح الإذن لا يحوّل المصدر غير الآمن إلى سياق آمن.
الإطار المضمن (iframe) هو صفحة ويب مُضمّنة داخل صفحة أخرى. تستخدم العديد من تطبيقات Collabora هذا النوع من الإطارات لتمكين النظام الأساسي المُضيف من عرض المُحرر. في المتصفحات المبنية على Chromium، قد يحتاج الإطار المضمن من مصادر مختلفة إلى الصفحة المُضمّنة لتفويض الوصول إلى الحافظة. يوثّق دليل Collabora SDK هذه الخاصية للإطار المضمن في استعلام أذونات الحافظة.
<iframe allow="clipboard-read *; clipboard-write *">
هذا إعداد خاص بالتكامل الذي يُنشئ الإطار، وليس إعدادًا خاصًا بـ Docker على خادم Collabora. إذا كنتَ تُدير التطبيق المُضيف، فتحقق من إطار iframe الخاص بالمحرر في أدوات مطوري المتصفح، وتأكد من أن Permissions-Policyرأس استجابة الصفحة الرئيسية لا يحظر الوصول إلى المحتوى المُضمّن. قد clipboard-readتمنع clipboard-writeسياسة الصفحة الرئيسية التقييدية الوصول حتى لو كان إطار iframe يحتوي على allowسمة. فوّض الوصول فقط إلى إطار Collabora الذي يحتاجه المستخدمون؛ ولا تمنح وصولًا واسع النطاق إلى الحافظة لمحتوى مُضمّن غير ذي صلة.
إذا كنت تستخدم منصة Nextcloud مستضافة، أو منصة تعليمية، أو بوابة مستندات، ولم تتمكن من تعديل ترميز الإطار أو رؤوس الاستجابة، فأرسل إلى مسؤول النظام معلومات المتصفح وإصداره، والاتجاه الذي فشل فيه الاتصال، وما إذا كانت اختصارات لوحة المفاتيح تعمل، وأي خطأ في وحدة التحكم متعلق بالحافظة. قد يحتاج المسؤول إلى تحديث التكامل. لن يؤدي تغيير منافذ شبكة CODE أو إعادة تشغيل حاويتها إلى منح إذن متصفح الإطار المضمن (iframe).
| ما تلاحظه | ما الذي يجب التحقق منه لاحقًا؟ |
|---|---|
فشل لصق شريط الأدوات، لكنه Ctrl+Vيعمل | استخدم الاختصار أو امنح إذن الوصول إلى حافظة المتصفح للموقع الموثوق به. |
| فشل النسخ من Collabora إلى سطح المكتب فقط | تحقق من قيود النسخ أو إذن الكتابة في المتصفح؛ تأكد من نسخ النص المحدد فقط. |
| فشل لصق الملفات من سطح المكتب إلى Collabora فقط | تحقق من إذن اللصق في المتصفح، وتأكد من التركيز في المستند، وما إذا كان إطار المضيف يفوض حق الوصول للقراءة. |
| تقول وحدة التحكم: "تم حظر واجهة برمجة تطبيقات الحافظة بواسطة سياسة الأذونات". | صفحة التضمين أو رأس الاستجابة الخاص بها تمنع الوصول. يجب على مالك التكامل تعديلها. |
| يعمل النص العادي، لكن المحتوى المنسق لا يعمل. | قارن بين تنسيقات الحافظة المدعومة وخيارات اللصق في التطبيق المستهدف؛ قد يكون هذا قيدًا على دقة التنسيق وليس فشلًا تامًا في الحافظة. |

بعد تغيير الأذونات أو التكامل، أعد فتح المستند وكرر اختبارَي النص العادي: من التطبيق المحلي إلى Collabora، ثم من Collabora إلى التطبيق المحلي. تأكد من ظهور النص في المكان المقصود، ثم اختبر المحتوى المنسق المحدد الذي تعتمد عليه. إذا كانت القائمة فقط هي التي تعمل بعد التغيير، فتحقق من مسار لوحة المفاتيح أيضًا؛ إذا كانت الاختصارات فقط هي التي تعمل، فإن مسار الحافظة الأساسي قابل للاستخدام، ولكن قد يظل مسار إذن المتصفح غير المتزامن محظورًا.
للاطلاع على قواعد الأمان المتعلقة بالوصول إلى حافظة المتصفح، راجع مرجع واجهة برمجة تطبيقات الحافظة (Clipboard API) على موقع MDN . وللتحكم في أذونات موقع Chrome، استخدم مساعدة إعدادات الموقع في Chrome . ويمكن لمالكي التكامل مراجعة وثائق التكامل المتقدمة لـ Collabora لمعرفة متطلبات إذن الحافظة في إطار iframe.
اختبر حافظة النظام، واضبط أذونات المتصفح، وحدد متى يحتاج تكامل Collabora المضمن إلى تغيير سياسة iframe.
قم بتثبيت ملفات الخطوط في Docker ولوحة نظام Collabora بحيث تظهر الخطوط المخصصة في المحرر ويتم عرضها بشكل صحيح في المستندات.
قم بعمل نسخة احتياطية من ملف coolwsd.xml ومصادر النشر الخاصة به، واستعدها بأمان، وتحقق من الكود قبل أن يعود المستخدمون إلى التحرير.
قم بالسماح بمصدر Nextcloud المحدد أو مصدر WOPI آخر في CODE، ثم تحقق من قائمة السماح للمضيف النشط وقم بتمييزها عن تقييد عنوان IP المصدر الخاص بـ Nextcloud.
قم بتتبع اتصالات متصفح Collabora و WOPI و WebSocket لمعرفة سبب عدم فتح المستند، ثم قم بتطبيق الإصلاح الذي يتوافق مع إعداد Nextcloud الخاص بك.
قم بنشر نسخ Collabora CODE باستخدام Helm، واحتفظ بكل مستند على وحدة واحدة من خلال تقارب WOPI، وتحقق من الدخول، ووضع العقدة، وتحرير Nextcloud.
تتبع عملية المصافحة الفاشلة من المتصفح إلى coolwsd، ثم قم بمطابقة مسار الوكيل العكسي مع إصدار Collabora الخاص بك، بما في ذلك تغيير Apache CODE 26.04.
تتبع حالات فشل إثبات Collabora WOPI إلى مفاتيح غير متطابقة، أو بيانات اكتشاف قديمة، أو انحراف الساعة، أو تغييرات عنوان URL للوكيل - دون إضعاف التحقق.
أعد ضبط تكبير/تصغير المتصفح، واختبر جلسة نظيفة، وحدد متى تحتاج قائمة الحجم المشوهة إلى تحديث خادم Collabora.
قم بنشر Collabora CODE باستخدام Docker، وقم بتوصيله بشكل آمن بـ Nextcloud Office، وتحقق من تحرير المستندات باستخدام فحوصات WOPI العملية وفحوصات البروكسي.