کار با کتابخانه نمایشگر سند – پشتیبانی از فرمت‌های PDF، Office و CAD با حاشیه‌نویسی، جستجو و چاپ داخلی: راهنمای عملی
← Back to Blog9 min read

کار با کتابخانه نمایشگر سند – پشتیبانی از فرمت‌های PDF، Office و CAD با حاشیه‌نویسی، جستجو و چاپ داخلی: راهنمای عملی

کتابخانه نمایشگر سند در Doconut به شما امکان می‌دهد فایل‌های PDF، Office و CAD را رندر کنید، به آن‌ها حاشیه‌نویسی کنید، محتوا را جستجو کنید و چاپ کنید — همه این‌ها از یک مؤلفهٔ .NET واحد.
اگر در حال ساخت یک پورتال متمرکز بر اسناد، یک مدیر پروندهٔ حقوقی‑تکنولوژی یا ابزاری برای بررسی نقشه‌های مهندسی هستید، به یک نمایشگر نیاز دارید که همان‌گونه که کاربران شما کار می‌کنند عمل کند: فوری، ایمن و بدون سرویس‌های خارجی. Doconut این تجربه را به‌صورت در‑محل، داخل برنامهٔ ASP.NET یا .NET Core شما ارائه می‌دهد، در حالی که کدبیس را تمیز نگه می‌دارد و ردپای استقرار را کوچک می‌کند.

در این راهنمای عملی، جریان کاری اصلی کتابخانه نمایشگر سند را قدم به قدم مرور می‌کنیم، نشان می‌دهیم چگونه آن را ادغام کنید و سه ستون اساسی که آن را غیرقابل جایگزین می‌سازند — حاشیه‌نویسی، جستجو (شامل OCR) و چاپ کنترل‌شده — را به تصویر می‌کشیم. در پایان، یک نمونهٔ آماده‑به‑اجرا خواهید داشت و تصویری واضح از این‌که Doconut چگونه می‌تواند ستون فقرات هر راه‌حل سازمانی سنگین‑اسناد شود، خواهید دید.

نمایشگر سند امن سازمانی که PDF، Office و فایل‌های CAD را با ابزارهای حاشیه‌نویسی و چاپ نمایش می‌دهد
نمایشگر سند امن سازمانی که PDF، Office و فایل‌های CAD را با ابزارهای حاشیه‌نویسی و چاپ نمایش می‌دهد

استقرار در ویندوز و گزینه‌های نسخهٔ آزمایشی رایگان

کتابخانهٔ Doconut بر روی .NET 6 اجرا می‌شود و به‌طور کامل در محیط‌های ویندوز پشتیبانی می‌شود. چه برنامهٔ خود را در Azure، AWS یا در‑محل میزبانی کنید، رندرینگ و عملکرد حاشیه‌نویسی سازگار باقی می‌ماند.

برای شروع سریع، Doconut یک نسخهٔ آزمایشی رایگان ارائه می‌دهد که دسترسی کامل به موتور حاشیه‌نویسی، جستجوی فعال‌شده با OCR و ویژگی‌های چاپ کنترل‌شده را شامل می‌شود. در سایت رسمی ثبت‌نام کنید، لایسنس آزمایشی را دانلود کنید و مراحل ادغام زیر را دنبال کنید تا کتابخانه را در عرض چند دقیقه در عمل ببینید.


چرا کتابخانه نمایشگر سند یک تغییر بازی برای شرکت‌های .NET است

شرکت‌هایی که قراردادها، نقشه‌های مهندسی یا سوابق کارمندان را مدیریت می‌کنند، با سه چالش مکرر مواجه‌اند:

  1. تنوع فرمت – PDFها، اسناد Word، صفحات Excel و نقشه‌های CAD در همان مخزن هم‌زیست می‌کنند.
  2. بازبینی تعاملی – کاربران تجاری نیاز دارند بدون ترک برنامه، متن را برجسته، نظر دهند یا مهر بزنند.
  3. دسترسی تنظیم‌شده – چاپ باید قابل حسابرسی باشد و متن قابل جستجو حتی برای تصاویر اسکن‌شده در دسترس باشد.

کتابخانهٔ نمایشگر سند Doconut این سه مورد را با یک مؤلفهٔ .NET سمت‑سرور که بیش از ۳۳ نوع فایل — از جمله DOCX، XLSX، PPTX، DWG و DXF — را به‌صورت بومی پشتیبانی می‌کند، حل می‌کند. این کتابخانه هر فرمت را به‌صورت بومی رندر می‌کند و نیازی به Microsoft Office، Acrobat یا سرویس‌های تبدیل خارجی نیست. چون رندرینگ روی سرور انجام می‌شود، داده‌های حساس را پشت فایروال خود نگه می‌دارید؛ این برای حوزه‌های بهداشت، حقوقی و مالی حیاتی است.

موتور حاشیه‌نویسی داخلی به شما اجازه می‌دهد برجسته‌سازی، رسم آزاد یا تأییدهای مهر‌دار را مستقیماً روی بوم نمایشگر اضافه کنید. حاشیه‌نویسی‌ها به‌صورت XML سبک ذخیره می‌شوند و به‌راحتی می‌توانند در پایگاه داده یا سیستم کنترل نسخه نگهداری شوند. افزونهٔ جستجو امکان جستجوی متنی فوری در هر سند باز را فراهم می‌کند؛ وقتی منبع یک تصویر اسکن‌شده باشد، موتور OCR به‌صورت زنده رشته‌های قابل جستجو را استخراج می‌کند. در نهایت، ویژگی چاپ کنترل‌شده به شما اجازه می‌دهد محدودیت‌های بازهٔ صفحات، واترمارک‌ها یا لاگ‌های حسابرسی چاپ را از طریق یک فراخوانی API واحد اعمال کنید.

این قابلیت‌ها به شما اجازه می‌دهند یک پشتهٔ پیچیده از نمایشگرهای شخص ثالث، افزونه‌های JavaScript و سرویس‌های تبدیل خارجی را با یک کتابخانهٔ تک، قابل نگهداری که از تعداد کمی کاربر تا استقرارهای سطح سازمانی مقیاس‌پذیر است، جایگزین کنید.


ادغام نمایشگر: راهنمای گام‑به‑گام در ASP.NET Core

در زیر توصیف مختصری از مراحلی که برای ادغام کتابخانهٔ نمایشگر سند Doconut در یک برنامهٔ ASP.NET Core لازم است، آورده شده است:

  1. ثبت میدلور Doconut – میدلور UseDoconut را پیکربندی کنید تا نقطهٔ انتهایی داخلی تصویر‑تایل (DocImage.axd) را مدیریت کند. این نقطهٔ انتهایی صفحات رندرشده را به‌صورت تایل‌های PNG استریم می‌کند و حتی برای فایل‌های بزرگ CAD نیز UI را پاسخگو نگه می‌دارد.
  2. بارگذاری لایسنس – فایل لایسنس Doconut (مثلاً DoconutLicense.xml) را یا به‌صورت فایل روی دیسک یا به‌صورت استریم فراهم کنید. کتابخانه به‌صورت خودکار لایسنس را در اولین ایجاد نمونهٔ نمایشگر می‌خواند.
  3. ایجاد نمونهٔ نمایشگر – کلاس Viewer را نمونه‌سازی کنید و سرویس‌های مورد نیاز مانند کش توزیعی یا دسترسی به HTTP context را پاس دهید.
  4. پیکربندی گزینه‌های رندر – یک شیء پیکربندی (مثلاً PdfConfig) تنظیم کنید تا رفتار پیش‌فرض رندر، استخراج لینک‌ها و وضوح رستر برای نقشه‌های CAD را کنترل کند.
  5. باز کردن سند – متد OpenDocument را با مسیر فایل (یا استریم) و پیکربندی قبلی فراخوانی کنید. این متد یک توکن امن برمی‌گرداند که فرانت‑اند JavaScript برای درخواست تصاویر صفحه، حاشیه‌نویسی‌ها و نتایج جستجو استفاده می‌کند.

این مراحل یک نمایشگر سمت‑سرور برای محیط‌های ویندوزی که .NET 6 اجرا می‌شود، تولید می‌کند. رویکرد مبتنی بر توکن، کلاینت را سبک نگه می‌دارد: فرانت‑اند فقط کافی است به مؤلفهٔ نمایشگر Doconut میزبانی‌شده در https://doconut.app ارجاع دهد.


حاشیه‌نویسی داخلی برای جریان‌های کاری بازبینی بلادرنگ

حاشیه‌نویسی یک نمایشگر منفعل را به یک فضای کاری تعاملی تبدیل می‌کند. مدیر حاشیه‌نویسی Doconut بر پایهٔ هر صفحه عمل می‌کند و همه چیز را به‌صورت XML ذخیره می‌کند؛ به این معنی که می‌توانید به‌راحتی نسخه‌بندی، حسابرسی یا ادغام تغییرات را در پایگاه داده انجام دهید.

جریان کاری معمول حاشیه‌نویسی

  1. مدیر حاشیه‌نویسی صفحهٔ جاری را با فراخوانی متد GetAnnotationManager نمایشگر و ارائهٔ ابعاد صفحه دریافت کنید.
  2. یک شیء حاشیه‌نویسی (مثلاً مهر تصویر، برجسته‌سازی یا رسم آزاد) ایجاد کنید و موقعیت، اندازه و ویژگی‌های بصری آن را تنظیم کنید.
  3. حاشیه‌نویسی را به مدیر اضافه کنید.
  4. XML حاشیه‌نویسی را با GetAnnotationXml دریافت کنید و در مخزن دادهٔ خود ذخیره کنید.
  5. هنگام بازگشایی مجدد سند، XML ذخیره‌شده را با LoadAnnotationXML به نمایشگر بارگذاری کنید.

سناریوهای سازمانی

  • فناوری حقوقی – وکلا یک مهر «امضا» را روی قرارداد می‌گذارند و سپس XML را به سرویس مدیریت پرونده برای حسابرسی ارسال می‌کنند.
  • بازبینی مهندسی – طراحان خطوط قرمز را مستقیماً روی صفحهٔ DWG اضافه می‌کنند؛ XML حاشیه‌نویسی همراه با تاریخچهٔ بازنگری ذخیره می‌شود.
  • منابع انسانی و جذب – جذب‌کنندگان بخش‌های کلیدی رزومه را برجسته می‌کنند، نظرات اضافه می‌کنند و نسخهٔ حاشیه‌نویسی‌شده را به پروفایل کاندیدا می‌فرستند.

چون داده‌های حاشیه‌نویسی روی سرور نگهداری می‌شود، کنترل کامل بر اینکه چه کسی می‌تواند ویرایش، مشاهده یا چاپ کند، دارید. API به‌صورت عمدی باریک است: فقط به دریافت مدیر، افزودن و بارگذاری نیاز دارید و می‌توانید ویژگی‌های UI اضافی (undo/redo، ابزارهای سفارشی) را بدون افزودن وابستگی‌های اضافی بسازید.


جستجوی فوری و OCR: یافتن هر سندی به‌سرعت

یک مخزن اسناد تنها زمانی ارزش دارد که کاربران بتوانند اطلاعات مورد نیاز خود را در ثانیه‌ها پیدا کنند. افزونهٔ جستجوی Doconut جستجوی متن کامل فوری را در هر فایل باز ارائه می‌دهد. برای PDFهای فقط رستر یا نقشه‌های CAD اسکن‌شده، موتور OCR داخلی به‌صورت در‑طلب متن را استخراج می‌کند و تصاویر را به محتوای قابل جستجو تبدیل می‌کند، بدون نیاز به پیش‌پردازش جداگانه.

جریان کاری معمول جستجو

  1. متد جستجوی نمایشگر (از طریق افزونهٔ Search) را با کلیدواژهٔ مورد نظر فراخوانی کنید.
  2. فهرستی از شماره‌های صفحهٔ مطابق و مختصات هر مطابقت دریافت کنید.
  3. برای هر مطابقت، مدیر حاشیه‌نویسی صفحه را دریافت کنید و یک حاشیه‌نویسی موقت برجسته برای نشان دادن مکان عبارت به کاربر اضافه کنید.

وقتی کاربر یک PDF اسکن‌شده از یک فاکتور را باز می‌کند، نمایشگر به‌صورت خودکار OCR را بر هر صفحه هنگام رندر اجرا می‌کند. متن استخراج‌شده در حافظه ایندکس می‌شود و جستجوهای بعدی فوری می‌شوند. این رویکرد نیاز به سرویس OCR جداگانه را حذف می‌کند، تأخیر را کاهش می‌دهد و تضمین می‌کند که متن قابل جستجو هرگز از محیط امن شما خارج نمی‌شود.

مزایای سازمانی

  • پورتال‌های مشتری می‌توانند با یک فشار کلید بندهای مرتبط از یک قرارداد را نشان دهند.
  • ابزارهای گزارش مالی به تحلیل‌گران اجازه می‌دهند یک آیتم خطی را در میان ده‌ها صورت‌حساب اسکن‌شده پیدا کنند.
  • سیستم‌های سوابق بهداشتی امکان جستجوی نام داروها در یادداشت‌های اسکن‌شده پزشکان را فراهم می‌کند و ایمنی بیمار را ارتقا می‌دهد.

تمام این‌ها بدون هیچ وابستگی شخص ثالثی انجام می‌شود، بنابراین استک سبک می‌ماند و سطح انطباق کوچک می‌شود.


چاپ کنترل‌شده از نمایشگر – امنیت همراه با راحتی

چاپ اغلب ضعیف‌ترین نقطه در امنیت اسناد است. ویژگی چاپ کنترل‌شده Doconut به شما اختیار می‌دهد چه، چه‌وقت و چگونه یک سند چاپ شود، در حالی که هنوز دیالوگ چاپ مرورگر آشنا را ارائه می‌دهد.

جریان کاری معمول چاپ

  1. یک شیء PrintConfig تعریف کنید که گزینه‌هایی مانند محدودیت بازهٔ صفحات، واترمارک‌ها و ثبت لاگ هر درخواست چاپ را مشخص می‌کند.
  2. پیکربندی را به همراه توکن سند به متد Print نمایشگر پاس دهید.
  3. نمایشگر صفحات انتخاب‌شده را روی سرور رندر می‌کند، هر واترمارکی را اعمال می‌کند و PDF قابل چاپ را به مرورگر کلاینت استریم می‌کند.
  4. یک ورودی حسابرسی به‌صورت خودکار ایجاد می‌شود تا مدیران بتوانند ببینند چه کسی چه چیزی و چه زمانی چاپ کرده است.

با انجام چاپ روی سرور، Doconut اطمینان می‌دهد که سند اصلی هرگز از محیط محافظت‌شده شما خارج نمی‌شود و شما دید کامل بر فعالیت‌های چاپ دارید — نیاز بحرانی برای صنایع تحت‌نظر مقررات.


نتیجه‌گیری

کتابخانهٔ نمایشگر سند Doconut برای تیم‌های .NET یک مؤلفهٔ تک، امن و پر ویژگی برای رندر PDFها، فایل‌های Office و نقشه‌های CAD فراهم می‌کند و آن‌ها را با حاشیه‌نویسی، جستجوی فعال‌شده با OCR و چاپ کنترل‌شده غنی می‌سازد. با پردازش سمت‑سرور، تبدیل داخلی و پشتیبانی از بیش از ۳۳ فرمت فایل، می‌توانید وابستگی‌های گران‌قیمت شخص ثالث را حذف کنید و داده‌های حساس را تحت کنترل مستقیم خود نگه دارید.

آماده‌اید تا جریان کاری اسناد سازمانی خود را مدرن کنید؟ امروز نسخهٔ آزمایشی رایگان Doconut را شروع کنید، کتابخانه را دانلود کنید و مراحل ادغام فوق را دنبال کنید تا قابلیت‌های قدرتمند مشاهده، حاشیه‌نویسی و جستجو را در برنامهٔ .NET خود در عرض چند دقیقه به‌کار بگیرید.

#Doconut#.NET#Document Viewer#Enterprise Development#PDF#CAD#Annotation#نمایشگر سند#توسعه سازمانی#حاشیه‌نویسی