العمل مع مكتبة عارض المستندات – تدعم صيغ PDF و Office و CAD مع التعليقات التوضيحية المدمجة والبحث والطباعة: دليل عملي
مكتبة عارض المستندات في Doconut تتيح لك عرض ملفات PDF و Office و CAD، إضافة تعليقات توضيحية، البحث في محتواها، وطباعة، وكل ذلك من مكوّن .NET واحد.
إذا كنت تبني بوابة تركّز على المستندات، أو مدير حالات تقنية قانونية، أو أداة مراجعة رسومات هندسية، فأنت بحاجة إلى عارض يعمل بالطريقة التي يتوقعها المستخدمون: فوري، آمن، ودون الاعتماد على خدمات خارجية. تقدم Doconut هذه التجربة داخل بيئتك، داخل تطبيق ASP.NET أو .NET Core الخاص بك، مع الحفاظ على نظافة قاعدة الشيفرة وصغر حجم النشر.
في هذا الدليل العملي سنستعرض سير العمل الأساسي لمكتبة عارض المستندات، نوضح لك كيفية دمجها، ونظهر الأعمدة الثلاثة التي تجعلها لا غنى عنها—التعليقات التوضيحية، البحث (بما في ذلك OCR)، والطباعة المُتحكم فيها. في النهاية ستحصل على نموذج أولي جاهز للتشغيل وصورة واضحة عن كيفية تحويل Doconut إلى العمود الفقري لأي حل مؤسسي يعتمد على المستندات.
خيارات النشر على 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) إما كملف على القرص أو كـ Stream. يقرأ المكتبة الرخصة تلقائيًا أثناء إنشاء أول نسخة من العارض. - إنشاء نسخة من العارض – أنشئ كائنًا من الفئة
Viewer، مع تمرير أي خدمات مطلوبة مثل ذاكرة التخزين المؤقت الموزعة أوIHttpContextAccessor. - تهيئة خيارات العرض – أنشئ كائن إعدادات (مثال:
PdfConfig) للتحكم في سلوك العرض الافتراضي، استخراج الروابط التشعبية، ودقة الرستر لرسومات CAD. - فتح المستند – استدعِ طريقة
OpenDocumentمع مسار الملف (أو الـ Stream) والإعدادات المعرفة مسبقًا. تُعيد الطريقة رمزًا آمنًا يستخدمه الواجهة الأمامية بلغة JavaScript لطلب صور الصفحات، التعليقات، ونتائج البحث.
تؤدي هذه الخطوات إلى الحصول على عارض يعمل على الخادم لبيئات Windows تعمل على .NET 6. يضمن النهج القائم على الرموز المميزة خفة وزن العميل: فالواجهة الأمامية تحتاج فقط إلى الإشارة إلى مكوّن عارض Doconut المستضاف على https://doconut.app.
التعليقات التوضيحية المدمجة لتدفقات مراجعة الوقت الحقيقي
تحوّل التعليقات التوضيحية العارض الساكن إلى مساحة عمل تعاونية. يدير مدير التعليقات في Doconut التعليقات على مستوى كل صفحة ويخزن كل شيء كملف XML، مما يتيح لك بسهولة إصدار نسخ، تدقيق، أو دمج التغييرات في قاعدة البيانات.
سير عمل التعليقات النموذجي
- استدعِ مدير التعليقات للصفحة الحالية عبر طريقة
GetAnnotationManager، مع تمرير أبعاد الصفحة. - أنشئ كائن تعليق (مثال: ختم صورة، تمييز، أو رسم يدوي) وحدد موقعه، حجمه، وخصائصه البصرية.
- أضف التعليق إلى المدير.
- احفظ XML التعليقات باستخدام
GetAnnotationXmlوخزّنه في مخزن البيانات الخاص بك. - عند إعادة فتح المستند، حمّل XML المحفوظ مرة أخرى إلى العارض عبر
LoadAnnotationXML.
سيناريوهات مؤسسية
- تقنية قانونية – يضع المحامون ختم “توقيع” على عقد، ثم يرسلون XML إلى خدمة إدارة القضايا للتدقيق.
- مراجعة هندسية – يضيف المصممون رسومات red‑line مباشرةً على صفحة 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 الخاص بك في دقائق.