العمل مع مكتبة عارض المستندات – تدعم صيغ PDF و Office و CAD مع التعليقات التوضيحية المدمجة والبحث والطباعة: دليل عملي

تتيح لك مكتبة عارض المستندات في Doconut عرض ملفات PDF و Office و CAD، إضافة تعليقات توضيحية إليها، البحث في محتواها، وطباعة المستندات — كل ذلك من مكوّن .NET واحد.
إذا كنت تبني بوابة تركّز على المستندات، أو مدير حالات قانونية‑تقنية، أو أداة مراجعة رسومات هندسية، فأنت بحاجة إلى عارض يعمل بالطريقة التي يتوقعها المستخدمون: فوري، آمن، ودون الاعتماد على خدمات خارجية. تقدم Doconut هذه التجربة داخل بيئة الشركة، داخل تطبيق ASP.NET أو .NET Core الخاص بك، مع الحفاظ على نظافة قاعدة الشيفرة وصغر حجم النشر.

في هذا الدليل العملي سنستعرض سير العمل الأساسي لمكتبة عارض المستندات، نوضح لك كيفية دمجها، ونظهر الأعمدة الثلاثة التي تجعلها لا غنى عنها — التعليق التوضيحي، البحث (بما في ذلك OCR)، والطباعة المُتحكم فيها. في النهاية ستحصل على نموذج أولي جاهز للتشغيل وصورة واضحة عن كيفية تحويل Doconut إلى العمود الفقري لأي حل مؤسسي يعتمد على المستندات.

عارض مستندات مؤسسي آمن يعرض ملفات PDF و Office و CAD مع أدوات التعليق والطباعة

نشر على Windows وخيارات النسخة التجريبية المجانية

تشغل مكتبة Doconut على .NET 6 وتدعم بالكامل بيئات Windows. سواء استضافت تطبيقك على Azure أو AWS أو داخل الشركة، فإنها توفر أداءً ثابتًا في العرض والتعليق.

للبدء بسرعة، تقدم Doconut نسخة تجريبية مجانية تشمل الوصول الكامل إلى محرك التعليقات التوضيحية، البحث المدعوم بـ OCR، وميزات الطباعة المُتحكم فيها. سجّل على الموقع الرسمي، حمّل رخصة التجربة، واتبع خطوات التكامل أدناه لتشاهد المكتبة تعمل خلال دقائق.

لماذا تُعد مكتبة عارض المستندات نقطة تحول للمؤسسات التي تستخدم .NET

تواجه المؤسسات التي تدير العقود، المخططات الهندسية، أو سجلات الموظفين ثلاث تحديات متكررة:

تنوع الصيغ – تتعايش ملفات PDF، مستندات Word، جداول Excel، ورسومات CAD في نفس المستودع.
المراجعة التشاركية – يحتاج المستخدمون إلى تمييز، التعليق، أو وضع طوابع على المستند دون مغادرة التطبيق.
الوصول المنظم – يجب أن تكون عملية الطباعة قابلة للتدقيق، ويجب أن يكون النص القابل للبحث متاحًا حتى للصور الممسوحة ضوئيًا.

تحل مكتبة عارض المستندات من Doconut هذه الثلاثة عبر مكوّن .NET واحد على الخادم يدعم أكثر من 33 نوع ملف — بما في ذلك DOCX، XLSX، PPTX، DWG، و DXF — مباشرةً دون الحاجة إلى Microsoft Office أو Acrobat أو خدمات تحويل خارجية. بما أن العرض يتم على الخادم، تبقى البيانات الحساسة خلف جدار الحماية، وهو أمر أساسي لقطاعات الرعاية الصحية، القانونية، والمالية.

يتيح محرك التعليقات التوضيحية المدمج إضافة تمييزات، رسومات يدوية، أو طوابع موافقة مباشرةً على لوحة العرض. تُخزن التعليقات كملف XML خفيف، مما يسهل حفظه في قاعدة بيانات أو نظام تحكم إصدارات. يوفر ملحق البحث إمكانية البحث الفوري عن النص في أي مستند مفتوح؛ وعند التعامل مع صورة ممسوحة، يستخرج محرك OCR النص القابل للبحث في الوقت الفعلي. أخيرًا، تمنحك ميزة الطباعة المُتحكم فيها القدرة على فرض حدود نطاق الصفحات، العلامات المائية، أو سجلات تدقيق الطباعة، كل ذلك عبر استدعاء API واحد.

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

دمج العارض: خطوات التكامل في ASP.NET Core

فيما يلي وصف مختصر للخطوات المطلوبة لدمج مكتبة عارض المستندات من Doconut في تطبيق ASP.NET Core:

تسجيل Middleware الخاص بـ Doconut – قم بتهيئة middleware UseDoconut لمعالجة نقطة النهاية الداخلية للصور (DocImage.axd). تُرسل هذه النقطة الصفحات المرسومة كملفات PNG مقسمة إلى مربعات، مما يحافظ على استجابة الواجهة حتى لملفات CAD الكبيرة.
تحميل الرخصة – قدم ملف رخصة Doconut (مثال: DoconutLicense.xml) إما كملف على القرص أو كتيار. يقرأ المكتبة الرخصة تلقائيًا أثناء إنشاء أول نسخة من العارض.
إنشاء نسخة من العارض – أنشئ كائن Viewer، مع تمرير أي خدمات مطلوبة مثل ذاكرة التخزين المؤقت الموزعة أو موصل سياق HTTP.
تهيئة خيارات العرض – أنشئ كائن تكوين (مثال، PdfConfig) للتحكم في سلوك العرض الافتراضي، استخراج الروابط التشعبية، ودقة التحويل للرسومات الهندسية.
فتح المستند – استدعِ طريقة OpenDocument مع مسار الملف (أو التيار) والتكوين المحدد مسبقًا. تُعيد الطريقة رمزًا آمنًا يستخدمه الواجهة الأمامية JavaScript لطلب صور الصفحات، التعليقات، ونتائج البحث.

تنتج هذه الخطوات عارضًا على الخادم لبيئات Windows تعمل على .NET 6. يضمن النهج القائم على الرموز المميزة خفة العميل: تحتاج الواجهة الأمامية فقط إلى الإشارة إلى مكوّن عارض Doconut المستضاف على https://doconut.app.

التعليقات التوضيحية المدمجة لتدفقات مراجعة الوقت الحقيقي

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

سير عمل التعليقات النموذجي

استدعِ مدير التعليقات للصفحة الحالية عبر طريقة GetAnnotationManager للعارض، مع تمرير أبعاد الصفحة.
أنشئ كائن تعليق (مثال: طابع صورة، تمييز، أو رسم يدوي) وحدد موقعه، حجمه، وخصائصه البصرية.
أضف التعليق إلى المدير.
احفظ XML التعليق باستخدام GetAnnotationXml وخزّنه في مخزن البيانات الخاص بك.
عند إعادة فتح المستند، حمّل XML المحفوظ مرة أخرى إلى العارض عبر LoadAnnotationXML.

سيناريوهات مؤسسية

تقنية قانونية – يضع المحامون طابع "توقيع" على عقد، ثم يرسلون XML إلى خدمة إدارة القضايا للتدقيق.
مراجعة هندسية – يضيف المصممون رسومات خط أحمر مباشرةً على صفحة DWG؛ يُخزن XML التعليق جنبًا إلى جنب مع سجل الإصدارات.
الموارد البشرية والتوظيف – يبرز مسؤولو التوظيف أقسامًا رئيسية في السيرة الذاتية، يضيفون تعليقات، ويرسلون النسخة المعلّقة إلى ملف المرشح.

نظرًا لأن بيانات التعليقات تُخزن على الخادم، تحتفظ بـ تحكم كامل في من يمكنه التحرير، المشاهدة، أو الطباعة. تم تصميم الـ API ببساطة: تحتاج فقط إلى استدعاء طرق استرجاع المدير، الإضافة، والتحميل، ويمكنك بناء ميزات واجهة مستخدم إضافية (تراجع/إعادة، أدوات مخصصة) دون إضافة تبعيات إضافية.

البحث الفوري و OCR: جعل كل مستند قابلًا للعثور عليه

يكون مستودع المستندات ذا قيمة فقط عندما يتمكن المستخدمون من العثور على المعلومات التي يحتاجونها في ثوانٍ. يقدم ملحق البحث في Doconut بحثًا فوريًا وشاملًا عبر أي ملف مفتوح. بالنسبة لملفات PDF أو رسومات CAD الممسوحة ضوئيًا، يستخرج محرك OCR المدمج النص عند الطلب، محولًا الصور إلى محتوى قابل للبحث دون خطوة تمهيدية منفصلة.

سير عمل البحث النموذجي

استدعِ طريقة البحث في العارض (المقدمة من ملحق البحث) مع الكلمة المفتاحية المطلوبة.
استقبل قائمة بأرقام الصفحات المتطابقة وإحداثيات كل تطابق.
لكل تطابق، احصل على مدير التعليقات للصفحة وأضف تعليق تمييز مؤقت لإظهار موقع المصطلح للمستخدم.

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

فوائد مؤسسية

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

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

الطباعة المُتحكم فيها من العارض – الأمان يلتقي بالراحة

غالبًا ما تكون الطباعة أضعف حلقة في أمان المستندات. تمنحك ميزة الطباعة المُتحكم فيها من Doconut الصلاحية لتحديد ماذا، ومتى، وكيف يمكن طباعة المستند، مع الحفاظ على حوار الطباعة المألوف في المتصفح.

سير عمل الطباعة النموذجي

عرّف كائن PrintConfig يحدد خيارات مثل حدود نطاق الصفحات، العلامات المائية، وما إذا كان يجب تسجيل كل طلب طباعة.
مرّر التكوين مع رمز المستند إلى طريقة Print في العارض.
يقوم العارض برسم الصفحات المحددة على الخادم، يضيف أي علامات مائية، ويُرسل ملف PDF القابل للطباعة إلى متصفح العميل.
يُنشأ سجل تدقيق تلقائيًا، مما يسمح للمسؤولين بتتبع من طبع ماذا ومتى.

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

الخلاصة

توفر مكتبة عارض المستندات من Doconut للفرق التي تستخدم .NET مكوّنًا واحدًا آمنًا وغنيًا بالميزات لعرض ملفات PDF و Office و CAD، مع تعليقات توضيحية، بحث مدعوم بـ OCR، وطباعة مُتحكم فيها. بفضل المعالجة على الخادم، التحويل المدمج، ودعم أكثر من 33 صيغة ملف، يمكنك القضاء على الاعتماد على حلول طرف ثالث مكلفة والحفاظ على البيانات الحساسة تحت سيطرتك المباشرة.

هل أنت مستعد لتحديث سير عمل المستندات المؤسسية؟ ابدأ النسخة التجريبية المجانية من Doconut اليوم، حمّل المكتبة، واتبع خطوات التكامل المذكورة أعلاه لتضيف قدرات عرض، تعليقات، وبحث قوية إلى تطبيق .NET الخاص بك في دقائق.