#معاينة ملفات Office v1.8.11+

تُستخدم إضافة معاينة ملفات Office لمعاينة الملفات بصيغة Office، مثل Word و Excel و PowerPoint، مباشرةً ضمن تطبيق NocoBase.
تعتمد هذه الإضافة على خدمة مايكروسوفت العامة عبر الإنترنت، والتي تتيح تضمين الملفات التي يمكن الوصول إليها عبر رابط URL عام في واجهة المعاينة، مما يمكّن المستخدمين من عرض هذه الملفات في المتصفح دون الحاجة إلى تنزيلها أو استخدام تطبيقات Office.

#دليل الاستخدام

بشكل افتراضي، تكون هذه الإضافة غير مُفعّلة. يمكن تفعيلها من مدير الإضافات، ولا تتطلب أي إعدادات إضافية.

بعد رفع ملف Office (Word / Excel / PowerPoint) بنجاح في Field الملفات في الـ Collection، يمكنك النقر على أيقونة الملف أو الرابط المقابل لمعاينة محتواه في واجهة معاينة منبثقة أو مضمنة.

#آلية العمل

تعتمد المعاينة المضمنة في هذه الإضافة على خدمة مايكروسوفت العامة عبر الإنترنت (Office Web Viewer)، وتتمثل العملية الرئيسية فيما يلي:

• تقوم الواجهة الأمامية (Frontend) بإنشاء رابط URL عام للملف الذي رفعه المستخدم (بما في ذلك روابط URL الموقعة من S3).

• تقوم الإضافة بتحميل معاينة الملف ضمن إطار iframe باستخدام العنوان التالي:

  https://view.officeapps.live.com/op/embed.aspx?src=<public file URL>

• تطلب خدمة مايكروسوفت محتوى الملف من رابط URL هذا، ثم تقوم بمعالجته وعرضه، وتعيد صفحة قابلة للمعاينة.

#ملاحظات هامة

• بما أن هذه الإضافة تعتمد على خدمة مايكروسوفت عبر الإنترنت، يجب التأكد من أن اتصال الشبكة يعمل بشكل صحيح وأن خدمات مايكروسوفت متاحة.
• ستصل مايكروسوفت إلى رابط URL للملف الذي تقدمه، وقد يتم تخزين محتوى الملف مؤقتًا على خوادمها لغرض عرض صفحة المعاينة. هذا يثير بعض المخاوف المتعلقة بالخصوصية، وإذا كانت لديك تحفظات بشأن ذلك، يُنصح بعدم استخدام هذه الإضافة لتوفير ميزة المعاينة¹.
• يجب أن يكون الملف المراد معاينته متاحًا عبر رابط URL عام. في العادة، يتم إنشاء روابط عامة للملفات التي تُرفع إلى NocoBase تلقائيًا (بما في ذلك روابط URL الموقعة التي تنشئها إضافة S3-Pro). ومع ذلك، إذا كانت الملفات تحتوي على قيود وصول أو مخزنة في شبكة داخلية، فلن تتمكن من معاينتها².
• لا تدعم هذه الخدمة المصادقة عبر تسجيل الدخول أو الموارد المخزنة بشكل خاص. على سبيل المثال، لا يمكن استخدام ميزة المعاينة للملفات التي لا يمكن الوصول إليها إلا ضمن شبكة داخلية أو التي تتطلب تسجيل الدخول.
• بعد أن تقوم خدمة مايكروسوفت بجلب محتوى الملف، قد يبقى مخزنًا مؤقتًا لفترة قصيرة. حتى لو تم حذف الملف الأصلي، قد يظل محتوى المعاينة متاحًا لبعض الوقت.
• توجد قيود موصى بها لحجم الملفات: يُنصح ألا يتجاوز حجم ملفات Word و PowerPoint 10 ميجابايت، وملفات Excel 5 ميجابايت، لضمان استقرار المعاينة³.
• لا يوجد حاليًا بيان رسمي واضح بخصوص ترخيص الاستخدام التجاري لهذه الخدمة. يرجى تقييم المخاطر بنفسك عند استخدامها⁴.

#صيغ الملفات المدعومة

تدعم هذه الإضافة معاينة صيغ ملفات Office التالية فقط، ويتم تحديد ذلك بناءً على نوع MIME للملف أو امتداد الملف:

• مستندات Word: application/vnd.openxmlformats-officedocument.wordprocessingml.document (.docx) أو application/msword (.doc)
• جداول بيانات Excel: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet (.xlsx) أو application/vnd.ms-excel (.xls)
• عروض PowerPoint التقديمية: application/vnd.openxmlformats-officedocument.presentationml.presentation (.pptx) أو application/vnd.ms-powerpoint (.ppt)
• نص OpenDocument: application/vnd.oasis.opendocument.text (.odt)

لن يتم تفعيل ميزة المعاينة لهذه الإضافة لملفات الصيغ الأخرى.