دمج عارض المستندات SDKs مع التخزين السحابي ومنصات التعاون

دمج مجموعة تطوير عارض المستندات مع التخزين السحابي ومنصات التعاون يتيح لك تقديم تجارب مستندات سلسة، آمنة، وقابلة للبحث مباشرةً من تطبيق .NET الخاص بك. مع Doconut—عارض مستندات شامل للواجهات الخلفية على .NET—يمكنك عرض ملفات PDF، ملفات Office، رسومات CAD، والصور بشكل أصلي، إضافة بحث مدفوع بتقنية OCR، تمكين التعليقات في الوقت الفعلي، والتحكم في الطباعة، كل ذلك مع الحفاظ على البيانات داخل السحابة التي تختارها أو بيئة داخلية. يوضح هذا الدليل للمطورين ذوي الخبرة ومهندسي البرمجيات كيفية ربط Doconut بـ Azure Blob أو Amazon S3 أو Google Cloud Storage، وكيفية إتاحة العارض عبر بوابات التعاون مثل Microsoft Teams أو SharePoint أو مساحات عمل مخصصة مبنية على React.

لماذا يعتبر عرض المستندات السحابي مهمًا لتطبيقات .NET الحديثة

اتساق عبر المنصات باستخدام نواة .NET واحدة

تتحول المؤسسات بعيدًا عن أدوات المستندات التي تعمل على سطح المكتب فقط وتتبنى تجارب ويب أولاً تعمل على Windows. محرك العرض من جانب الخادم في Doconut يعمل على .NET 6 وما بعده، مما يضمن مخرجات بكسل‑مثالية بغض النظر عن نظام التشغيل الأساسي. لأن العارض يعمل مع التدفقات (streams)، يمكنك سحب ملف من أي دلو سحابي، تمريره مباشرةً إلى مكوّن Doconut، وإرجاع الصفحات أو الصور المصغرة إلى العميل دون الحاجة إلى كتابة الملف على القرص.

تقليل الكمون وعرض النطاق الترددي

عندما يكون المستند مخزنًا في Azure Blob Storage، فإن تحميل الملف بالكامل إلى العميل لمجرد عرض الصفحة الأولى يخلق كمونًا غير ضروري. يدعم Doconut إنشاء صور مصغرة عند الطلب، مما يتيح لك طلب معاينة منخفضة الدقة أولاً وجلب العرض الكامل للصفحة فقط عندما يقوم المستخدم بالتمرير. هذا النمط يكون ذا قيمة خاصة للرسومات الكبيرة مثل CAD (DWG، DXF) التي قد تصل إلى مئات الميجابايت.

معالجة أمان أولاً

كل الأعمال الثقيلة تبقى على الخادم. باستخدام قدرات معالجة جانب الخادم في Doconut، تحتفظ بملفات PDF السرية، العقود القانونية، أو السجلات الطبية داخل شبكة VNet الخاصة أو خلف جدار حماية مؤسسي. لا يتم استدعاء أي خدمة SaaS طرف ثالث، ولا يقوم العارض ببث البايتات الخام إلى محرك المتصفح—فقط مربعات الصور أو مقتطفات HTML التي تُنشئها خلف الكواليس.

ربط Doconut بخدمات التخزين السحابي الشائعة

نهج التكامل العام

الحصول على تدفق المستند – استخدم SDK لمزود السحابة المختار (Azure Blob، Amazon S3، Google Cloud Storage) لتنزيل الملف إلى كائن Stream.
تمرير التدفق إلى Doconut – يقبل عارض Doconut تدفقًا مع خيارات عرض اختيارية. هذا يلغي الحاجة إلى ملفات مؤقتة على خادم الويب.
إنشاء رمز مميز للعارض – تُعيد Doconut رمزًا مميزًا يحدد المستند المفتوح للجلسة الحالية. يمكن إرجاع الرمز المميز إلى الواجهة الأمامية كـ JSON واستخدامه لطلبات عرض الصفحات أو التعليقات اللاحقة.
عرض الصفحات عند الطلب – تستدعي الواجهة الأمامية نقطة النهاية في Doconut مع الرمز المميز ورقم الصفحة المطلوب؛ يرسل Doconut صورة أو مقطع HTML.

نظرًا لأن سير العمل يعتمد فقط على التدفقات، فإن استبدال كود Azure بـ Amazon S3 أو Google Cloud Storage يتطلب فقط تعديل استدعاء SDK السحابي الذي ينشئ التدفق؛ يبقى باقي خط أنابيب Doconut كما هو.

التعامل مع تخزين متعدد المستأجرين

في نظام إدارة مستندات SaaS، قد يكون لكل مستأجر دلو أو بادئة منفصلة. بما أن Doconut يعمل مع التدفقات، يمكنك تحديد الدلو الصحيح في وقت التشغيل، فتح المستند، والحفاظ على الرمز المميز مقيدًا بمطالبات المستخدم الحالية. يمكن تكوين التخزين المؤقت الداخلي لـ Doconut (IDistributedCache) لاستخدام Redis أو Azure Cache for Redis، مما يضمن أن الطلبات المتكررة لنفس الصفحة تُستجاب من الذاكرة بدلاً من إعادة العرض.

تمكين التعليقات في الوقت الفعلي و OCR داخل سير العمل التعاوني

مكوّن التعليقات: تحويل عارض ثابت إلى مركز مراجعة

يأتي Doconut مع مكوّن التعليقات الذي يسمح للمستخدمين بتمييز النص، إضافة ملاحظات لاصقة، أو رسم أشكال يدوية. بعد فتح المستند، تحصل على مدير التعليقات من العارض، تضيف أو تعدل كائنات التعليق، وتخزن حالة التعليقات كملف XML. تخزين XML بجانب سجل المستند يتيح تاريخ مراجعة إصداري، وتحميل XML عند الفتحات اللاحقة يعيد الحالة البصرية الدقيقة.

بحث مدفوع بـ OCR للملفات PDF الممسوحة ضوئيًا

العقود، الإيصالات، أو الصور الطبية الممسوحة ضوئيًا غالبًا ما تكون PDF بصور فقط. يقوم مكوّن البحث في Doconut تلقائيًا بتشغيل OCR على الخادم عندما تقوم بتمكينه في تكوين العارض. محرك OCR يعمل داخل مجموعة الخادم، لذا لا يغادر النص المستخرج بيئتك المحمية. بمجرد اكتمال OCR، يمكنك استدعاء واجهة برمجة البحث لاسترجاع أرقام الصفحات ومستطيلات الحدود المتطابقة، والتي يمكن للواجهة الأمامية تمييزها. لأن OCR يعمل على الخادم، يمكنك أيضًا فهرسة النص المستخرج في Azure Cognitive Search أو Elasticsearch أو أي خدمة بحث أخرى لتوفير بحث نص كامل فوري عبر المستودع بأكمله.

التعاون عبر الرموز المميزة المشتركة

في تكاملات Teams أو SharePoint، عادةً ما تُنشئ رمزًا مميزًا قصير العمر يشفّر معرف المستند، أذونات المستخدم، والطابع الزمني. يمكن تغليف سلسلة الرمز المميز التي تُرجعها Doconut من استدعاء OpenDocument في JWT أو تخزينها في إدخال ذاكرة مؤقتة. عندما ينقر مستخدم آخر على الرابط المشترك، يُستخدم نفس الرمز المميز لإعادة إحياء العارض، مع الحفاظ على طبقات التعليقات و OCR للجميع.

التحويل الآمن من جانب الخادم والطباعة المتحكم فيها باستخدام Doconut

تحتاج العديد من المؤسسات إلى تحويل ملفات Word أو Excel أو CAD إلى PDF للأرشفة، أو لفرض سياسة “الطباعة فقط إذا تم الموافقة”. يتعامل مكوّن المحول في Doconut مع هذه السيناريوهات دون الحاجة إلى Microsoft Office أو خدمات طرف ثالث. تستدعي واجهة برمجة التحويل على الخادم، مرّر مسار الملف المصدر (أو التدفق) وصيغة الإخراج المطلوبة. يتم تنفيذ التحويل بالكامل على الخلفية، وينتج PDF يمكن تخزينه في مستودع المستندات الخاص بك.

بمجرد وجود PDF، يمكنك تمكين الطباعة المتحكم فيها مباشرةً في واجهة العارض. يوفّر Doconut طريقة لتعيين أذونات الطباعة لرمز مميز مستند معين. عندما ينقر المستخدم زر الطباعة، يتحقق Doconut من العلامة إما ليولد تدفق صورة قابل للطباعة أو يُعيد رسالة “الطباعة معطلة”. يلغي هذا الحاجة إلى جافاسكريبت مخصص لحجب مربع حوار الطباعة في المتصفح.

تدقيق نشاط الطباعة

نظرًا لأن طلب الطباعة يمر عبر طبقة وسطية في Doconut، يمكنك ربطه بأنابيب تسجيل ASP.NET Core لالتقاط من قام بطباعة ماذا ومتى. احفظ سجل التدقيق في جدول SQL أو أرسله إلى نظام SIEM لتقارير الامتثال—وهو أمر حاسم لحلول التقنية القانونية أو الرعاية الصحية حيث يجب تتبع كل وصول إلى المستند.

أفضل الممارسات للتوسع والأداء في بيئات متعددة المنصات

استخدام التخزين المؤقت الموزع – يمكن أن يُدعم ذاكرة التخزين المؤقت للصفحات في Doconut بواسطة Redis أو Azure Cache أو أي تنفيذ IDistributedCache. أدرج تجزئة نسخة المستند في مفاتيح التخزين لتجنب تقديم صور قديمة بعد التحويل.
استخدام وظائف الخلفية للتحويل الجماعي – عند استيراد أرشيف كبير، ضع مهام التحويل في طابور باستخدام Hangfire أو Azure Functions. يعمل صف عارض Doconut مع عمال IHostedService لأنه يقبل التدفقات ويُعيد الرموز المميزة دون الحاجة إلى سياق HTTP.
ضبط دقة الصورة حسب الجهاز – تستفيد الأجهزة المحمولة من ImageResolution أقل (150‑200 DPI)، بينما يمكن لأجهزة سطح المكتب طلب 300 DPI لتفاصيل CAD. اضبط الدقة بناءً على سلسلة وكيل المستخدم أو إعداد جانب العميل.
تمكين التحميل الكسول للتعليقات – احفظ XML التعليقات في جدول منفصل وحمّله فقط عندما يفتح المستخدم لوحة التعليقات. يقلل ذلك من الحمولة الأولية ويسرّع عرض الصفحة الأولى.
مراقبة استهلاك الذاكرة – يمكن أن تكون صفحات CAD عالية الدقة مستهلكة للذاكرة. اضبط GC في .NET لاستخدام وضع الخادم في الإنتاج (<gcServer enabled="true"/>) وضع مهلة معقولة لمنع وظائف العرض المتطرفة.
استخدام CDN للأصول الثابتة – ملفات JavaScript وCSS الخاصة بالعارض ثابتة. قدّمها عبر Azure CDN أو CloudFront أو Cloudflare لتقليل مللي ثانية من زمن التحميل الأولي، خاصةً للفرق الموزعة عالميًا.

باتباع هذه الإرشادات، يمكنك دعم آلاف المستخدمين المتزامنين عبر القارات مع الحفاظ على زمن استجابة أقل من 200 ms للصفحة الأولى—وهو معيار تسعى إليه العديد من البوابات المؤسسية.

البدء السريع مع النسخة التجريبية المجانية لـ Doconut

أسرع طريقة لتقييم Doconut هي تنزيل النسخة التجريبية المجانية من الموقع الرسمي، إضافة حزمة NuGet إلى مشروع ASP.NET Core جديد، واتباع دليل البدء السريع. خلال دقائق ستحصل على عارض وظيفي يمكنه سحب المستندات من Azure Blob، تمكين التعليقات، تشغيل بحث مدفوع بـ OCR، وإجراء تحويل آمن من جانب الخادم. للحصول على تعليمات خطوة بخطوة، زر وثائق Doconut وابدأ في بناء تجربة مستندات سحابية أصلية اليوم.

هل أنت مستعد لتحويل سير عمل المستندات الخاص بك؟ سجّل للحصول على النسخة التجريبية المجانية لـ Doconut الآن وشاهد مدى سهولة تقديم تجارب مستندات آمنة، قابلة للبحث، وتعاونية في أي تطبيق .NET.