يجب أن يشعر عرض المستندات المدمج كأنه جزء من التطبيق، وليس كتحويل إلى امتداد متصفح قديم أو برنامج سطح مكتب مثبت محليًا. بالنسبة للمشاريع المستندة إلى Windows باستخدام ASP.NET و .NET، يوفر Doconut (https://doconut.com/) مجموعة أدوات عارض المستندات التي يمكنها عرض المستندات التجارية داخل تطبيق الويب الخاص بك.

تشرح هذه الدليل الهندسة المعمارية لتجربة عرض بدون إضافات دون تقديم شفرة مصدر Doconut غير موثقة.

مستندات تمر عبر خدمة تحويل .NET إلى عارض مدمج بدون إضافات

ما يعنيه “بدون إضافات”

العارض بدون إضافات لا يطلب من المستخدم النهائي تثبيت تقنيات مثل ActiveX أو Flash أو Silverlight أو امتداد متصفح مخصص قبل فتح المستند.

هذا يقلل من عدة مصادر احتكاك:

لا يحتاج المستخدمون إلى أذونات تثبيت محلية.
لا تحتاج فرق تكنولوجيا المعلومات إلى توزيع وتحديث إضافة من جانب العميل.
يبقي التطبيق سير عمل العرض داخل واجهته الخاصة.
لا تصبح الاعتمادات على الإضافات القديمة شرطًا لفتح الملف.

بدون إضافات لا يعني خالٍ من الاعتماديات. لا يزال الخادم يحتاج إلى SDK الصحيح، ووقت التشغيل، والخطوط، والوصول إلى التخزين، والتكوين، والترخيص. كما يظل التطبيق مسؤولًا عن المصادقة، والتفويض، والاحتفاظ، والمراقبة.

لماذا يساعد عرض المستندات من جانب الخادم

المستندات التجارية أكثر تعقيدًا من محتوى الويب العادي. ملفات Office، رسومات CAD، رسائل البريد الإلكتروني، والصور عالية الدقة كل منها يتطلب معالجة واعية للصيغة.

يمكن لمكوّن .NET من جانب الخادم معالجة ذلك بينما يقدم تطبيق الويب تجربة العرض الناتجة. هذا يتجنب طلب تثبيت كل مستخدم للبرنامج الأصلي للإنشاء.

تم تصميم Doconut لهذا الدور. تصف معلومات المنتج الحالية الدعم لأنواع المستندات بما في ذلك PDF، مستندات Office، رسومات CAD، ملفات البريد الإلكتروني، والصور. تحقق من الصيغ والميزات المطلوبة لتطبيقك على صفحة عارض Doconut (https://doconut.com/en/products/viewer).

خطط سير عمل العرض

عادةً ما يتبع طلب المستند الآمن الخطوات التالية:

يختار المستخدم مستندًا باستخدام معرف التطبيق.
يقوم ASP.NET بالمصادقة على الطلب.
يتحقق الخادم من صلاحية الوصول إلى ذلك المستند المحدد.
يحل التطبيق موقع التخزين المحمي.
يُمرَّر المستند إلى طبقة العرض باستخدام طريقة التكامل المدعومة.
يسجل التطبيق النتيجة ويحرّر الموارد المؤقتة.

يجب ألا يتلقى العميل بيانات اعتماد التخزين، أو مسارات خادم غير مقيدة، أو معلومات مستند أكثر مما تتطلبه الجلسة المصرح بها.

استخدم حدود أمان ASP.NET القياسية

يجب حماية صفحة العرض مثل أي مورد حساس آخر.

يمكن أن تشمل آليات .NET القياسية:

Middleware المصادقة
السمة [Authorize]
سياسات التفويض والادعاءات
التفويض القائم على الموارد
حقن الاعتمادات لخدمات التخزين والعرض
تسجيل منظم مع تصفية البيانات الحساسة

يجب تقييم التفويض على الخادم. إخفاء إجراء شريط أدوات أو مسار في واجهة المستخدم لا يمنع عميلًا مصممًا من طلبه مباشرة.

احتفظ بالوصول إلى SDK خلف خدمة تطبيقية

تجنب نشر استدعاءات العارض عبر المتحكمات والصفحات. يمكن لخدمة تطبيقية مخصصة أن:

تحل معرّفات المستند المصرح بها
تفتح Stream مُتحكم فيه
تطبق التكوين لإصدار SDK المثبت
تُحرّر موارد الملف و الـ Stream
تحول الأخطاء التقنية إلى أخطاء تطبيقية آمنة
تسجل أوقات التنفيذ والتشخيصات المنقحة

هذه الحدود تجعل التطبيق أسهل للاختبار وتقلل من تأثير ترقيات SDK المستقبلية.

استخدم الموارد الرسمية لتنزيل Doconut والوثائق (https://doconut.com/en/download) لتثبيت الحزمة وإرشادات API الخاصة بالإصدار.

بناء مضيف عارض مفيد

يجب أن يحصل حاوية العارض المملوكة للتطبيق على مساحة كافية للمستندات الحقيقية. تجنّب البطاقات الضيقة والعروض الثابتة لسطح المكتب.

.viewer-workspace {
  display: grid;
  grid-template-rows: auto minmax(0, 1fr);
  width: 100%;
  min-height: 36rem;
  height: calc(100dvh - 4rem);
}

.viewer-host {
  min-width: 0;
  min-height: 0;
  overflow: hidden;
}

هذا CSS قياسي للصفحة المحيطة، وليس تكوين Doconut. لا تستهدف محددات داخلية غير موثقة أو تخترع خيارات SDK.

يجب أن توفر الصفحة أيضًا:

حالة تحميل واضحة
رسالة خطأ آمنة
عنوان مستند مرئي
طريقة للعودة إلى سير العمل الأصلي
عناصر تحكم تطبيقية قابلة للوصول
مساحة كافية لجداول البيانات العريضة والرسومات التفصيلية

تحقق من المستندات قبل العرض

إذا قام المستخدمون بتحميل ملفات، تحقق من:

حجم الملف
الامتداد وتوقيع الملف
الصيغة المدعومة
متطلبات كلمة المرور أو التشفير
القيود الخاصة بالأعمال
اسم التخزين الذي يولده الخادم

لا تُنشئ مسارات خادم مباشرةً من اسم الملف الأصلي. احفظ معرف تطبيق آمن واحله عبر خدمة خادم مصرح بها.

إعداد خادم Windows

قد يعتمد سلوك العرض على بيئة الخادم. تأكد من:

إصدارات Windows و .NET المدعومة
الخطوط المطلوبة
موقع التخزين المؤقت وأذوناته
موارد CPU، الذاكرة، وسعة القرص المتاحة
الحد الأقصى لحجم المستند وعدد الجلسات المتزامنة
تكوين الترخيص
إجراءات التنظيف

اختبر مستندات العملاء النموذجية على بيئة مطابقة للإنتاج.

قائمة التحقق من الأمان والخصوصية

قبل الإصدار:

صادق على طلبات العرض حيثما يلزم.
خذ التفويض للمستخدم للمستند المحدد.
احتفظ بمسارات التخزين وبيانات الاعتماد على الخادم.
قيد أذونات الملفات المؤقتة.
عرّف سياسات الاحتفاظ بالأصول، والبيانات المؤقتة، والصادرات.
نقِّ الأخطاء المعروضة للمستخدمين.
استبعد محتوى المستندات والسرّيات من السجلات.
طبّق حدودًا للتحميل والتزامن.
حافظ على تحديث SDK واعتمادات التطبيق.

يجب أن تعكس الادعاءات المتعلقة بالامتثال النظام الكامل المُنَفَّذ وإجراءات مؤسستك، وليس مكوّن واجهة مستخدم واحد.

اختبار أكثر من المسار السعيد

يجب أن تشمل مكتبة الاختبار الخاصة بك:

ملفات PDF متعددة الصفحات
جداول بيانات كبيرة
رسومات CAD تفصيلية
عروض تقديمية بخطوط غير شائعة
ملفات بريد إلكتروني مع مرفقات
صور كبيرة
ملفات تالفة وغير مدعومة
طلبات غير مصرح بها
جلسات عرض متزامنة
طلبات مقطوعة وإعادة تشغيل التطبيق

تأكد من أن الفشل لا يكشف عن مسارات الخادم، أو تتبع الأخطاء، أو عناوين URL للتخزين.

أين يتناسب Doconut

يوفر Doconut القدرة على تضمين عرض المستند داخل تطبيق ويب .NET. يوفر تطبيقك الأمان المحيط، والتخزين، وسير العمل، وتخطيط الاستجابة، وعناصر التحكم التشغيلية.

هذا الفصل يسمح للفرق باستبدال سير عمل يعتمد على الإضافات القديمة دون الادعاء بأن معالجة المستندات تصبح بلا جهد أو خالية من المسؤولية.

استكشف SDK عارض المستندات .NET من Doconut (https://doconut.com/en/products/viewer)، ثم استخدم صفحة التنزيل الرسمية (https://doconut.com/en/download) للحصول على التعليمات التي تتطابق مع الإصدار المختار.

الخلاصة

تجربة عرض المستندات بدون إضافات تقلل من احتكاك التثبيت وتبقي المستخدمين داخل تطبيقك. بنِها على تدفق مستندات مصرح به من الخادم، عزل وصول SDK، توفير مضيف عارض واسع، واختبار ملفات حقيقية تحت حمل مشابه للإنتاج.

بالنسبة لتطبيقات ASP.NET و .NET المستندة إلى Windows، يمكن لـ Doconut توفير طبقة عرض المستندات بينما يحتفظ فريقك بالتحكم في التطبيق ودورة حياة المستند.