کار با کتابخانه نمایشگر سند – پشتیبانی از فرمتهای PDF، Office و CAD با حاشیهنویسی، جستجو و چاپ داخلی: راهنمای عملی
کتابخانه نمایشگر سند در Doconut به شما امکان میدهد فایلهای PDF، Office و CAD را رندر کنید، به آنها حاشیهنویسی کنید، محتوا را جستجو کنید و چاپ کنید—همه اینها از یک مؤلفهٔ .NET.
اگر در حال ساخت یک پورتال متمرکز بر اسناد، یک مدیر پروندهٔ حقوقی‑تکنولوژی، یا یک ابزار بازبینی نقشههای مهندسی هستید، به یک نمایشگر نیاز دارید که همانطور که کاربران شما انتظار دارند کار کند: فوری، ایمن و بدون سرویسهای خارجی. Doconut این تجربه را بهصورت در‑محل، داخل برنامهٔ ASP.NET یا .NET Core شما ارائه میدهد، در حالی که کدبیس را تمیز نگه میدارد و ردپای استقرار را کوچک میکند.
در این راهنمای عملی، جریان کاری اصلی کتابخانه نمایشگر سند را گام به گام مرور میکنیم، نشان میدهیم چگونه آن را ادغام کنید و سه ستون اساسی که آن را غیرقابل جایگزین میکند—حاشیهنویسی، جستجو (شامل OCR) و چاپ کنترلشده—را به نمایش میگذاریم. در پایان، یک نمونهٔ آماده‑به‑اجرا خواهید داشت و تصویر واضحی از اینکه چگونه Doconut میتواند ستون فقرات هر راهحل سازمانی سنگین‑اسناد باشد، خواهید دید.
استقرار در ویندوز و گزینههای نسخهٔ آزمایشی رایگان
کتابخانهٔ Doconut بر روی .NET 6 اجرا میشود و بهطور کامل در محیطهای ویندوز پشتیبانی میشود. چه برنامهٔ خود را در Azure، AWS یا در‑محل میزبانی کنید، رندرینگ و عملکرد حاشیهنویسی سازگار باقی میماند.
برای شروع سریع، Doconut یک نسخهٔ آزمایشی رایگان ارائه میدهد که دسترسی کامل به موتور حاشیهنویسی، جستجوی فعالشده با OCR و ویژگیهای چاپ کنترلشده را شامل میشود. در سایت رسمی ثبتنام کنید، لایسنس آزمایشی را دانلود کنید و مراحل یکپارچهسازی زیر را دنبال کنید تا کتابخانه را در عرض چند دقیقه در عمل ببینید.
چرا کتابخانه نمایشگر سند یک تغییر بازی برای سازمانهای .NET است
سازمانهایی که قراردادها، نقشههای مهندسی یا سوابق کارمندان را مدیریت میکنند، با سه چالش مکرر مواجهاند:
- تنوع فرمت – PDFها، اسناد Word، جدولهای Excel و نقشههای CAD در همان مخزن همزیست هستند.
- بازبینی تعاملی – کاربران تجاری نیاز دارند بدون ترک برنامه، متن را برجسته، نظر بدهند یا مهر بزنند.
- دسترسی تنظیمشده – چاپ باید قابل حسابرسی باشد و متن قابل جستجو حتی برای تصاویر اسکنشده در دسترس باشد.
کتابخانهٔ نمایشگر سند Doconut این سه مورد را با یک مؤلفهٔ .NET سمت‑سرور که از بیش از ۳۳ نوع فایل—including DOCX, XLSX, PPTX, DWG, DXF—پشتیبانی میکند، حل میکند. این کتابخانه هر فرمت را بهصورت بومی رندر میکند و نیازی به Microsoft Office، Acrobat یا سرویسهای تبدیل خارجی نیست. چون رندرینگ در سرور انجام میشود، دادههای حساس را پشت فایروال خود نگه میدارید؛ این برای حوزههای بهداشت، حقوقی و مالی حیاتی است.
موتور حاشیهنویسی داخلی به شما اجازه میدهد برجستهسازی، رسم آزاد یا تأییدهای مهر شده را مستقیماً روی بوم نمایشگر اضافه کنید. حاشیهنویسیها بهصورت XML سبک ذخیره میشوند و بهراحتی میتوانند در پایگاه داده یا سیستم کنترل نسخه نگهداری شوند. پلاگین جستجو امکان جستجوی متنی فوری در هر سند باز را فراهم میکند؛ وقتی منبع یک تصویر اسکنشده باشد، موتور OCR بهصورت زنده رشتههای قابل جستجو را استخراج میکند. در نهایت، ویژگی چاپ کنترلشده به شما اجازه میدهد محدودیتهای بازهٔ صفحه، واترمارک یا لاگهای حسابرسی چاپ را از طریق یک فراخوانی API واحد اعمال کنید.
این قابلیتها به شما این امکان را میدهند که یک استک پیچیده از نمایشگرهای شخص ثالث، افزونههای JavaScript و سرویسهای تبدیل خارجی را با یک کتابخانهٔ تک، قابل نگهداری جایگزین کنید که از چند کاربر تا استقرارهای سازمانی مقیاسپذیر است.
ادغام نمایشگر: راهنمای گام‑به‑گام در ASP.NET Core
در زیر توصیف مختصری از مراحل مورد نیاز برای یکپارچهسازی کتابخانهٔ نمایشگر سند Doconut در یک برنامهٔ ASP.NET Core آمده است:
- ثبت میدلویر Doconut – میدلویر
UseDoconutرا پیکربندی کنید تا نقطهٔ انتهایی داخلی تصویر‑Tile (DocImage.axd) را مدیریت کند. این نقطهٔ انتهایی صفحات رندرشده را بهصورت کاشیهای PNG میفرستد و حتی برای فایلهای بزرگ CAD نیز UI را پاسخگو نگه میدارد. - بارگذاری لایسنس – فایل لایسنس Doconut (مثلاً
DoconutLicense.xml) را یا بهصورت فایل روی دیسک یا بهصورت استریم فراهم کنید. کتابخانه لایسنس را بهصورت خودکار هنگام اولین ایجاد نمونهٔ نمایشگر میخواند. - ایجاد نمونهٔ نمایشگر – کلاس
Viewerرا نمونهسازی کنید و سرویسهای مورد نیاز مانند کش توزیعشده یا دسترسی به HttpContext را پاس دهید. - پیکربندی گزینههای رندرینگ – یک شیء پیکربندی (مثلاً
PdfConfig) تنظیم کنید تا رفتار پیشفرض رندرینگ، استخراج لینکها و وضوح رستر برای نقشههای CAD را کنترل کند. - باز کردن سند – متد
OpenDocumentرا با مسیر فایل (یا استریم) و پیکربندی قبلی فراخوانی کنید. این متد یک توکن امن برمیگرداند که فرانت‑اند JavaScript برای درخواست تصاویر صفحه، حاشیهنویسیها و نتایج جستجو استفاده میکند.
این مراحل منجر به یک نمایشگر سمت‑سرور برای محیطهای ویندوزی با .NET 6 میشود. رویکرد مبتنی بر توکن، کلاینت را سبک نگه میدارد: فرانت‑اند فقط کافی است به مؤلفهٔ نمایشگر Doconut میزبانیشده در https://doconut.app ارجاع دهد.
حاشیهنویسی داخلی برای جریانهای کاری بازبینی لحظهای
حاشیهنویسی یک نمایشگر منفعل را به یک فضای کاری تعاملی تبدیل میکند. مدیر حاشیهنویسی Doconut بهصورت صفحه‑محور عمل میکند و همه چیز را بهصورت XML ذخیره میکند، به این معنی که میتوانید بهراحتی نسخهبندی، حسابرسی یا ادغام تغییرات را در پایگاه داده انجام دهید.
جریان کاری معمول حاشیهنویسی
- مدیر حاشیهنویسی صفحهٔ جاری را با فراخوانی متد
GetAnnotationManagerنمایشگر و ارائهٔ ابعاد صفحه دریافت کنید. - یک شیء حاشیهنویسی (مثلاً مهر تصویر، برجستهسازی یا رسم آزاد) ایجاد کنید و موقعیت، اندازه و ویژگیهای بصری آن را تنظیم کنید.
- حاشیهنویسی را به مدیر اضافه کنید.
- XML حاشیهنویسی را با
GetAnnotationXmlدریافت کنید و در مخزن دادهٔ خود ذخیره کنید. - هنگام بازگشایی مجدد سند، XML ذخیرهشده را با
LoadAnnotationXMLبه نمایشگر بارگذاری کنید.
سناریوهای سازمانی
- فناوری حقوقی – وکلا یک مهر «امضا» را روی قرارداد میگذارند و سپس XML را به سرویس مدیریت پرونده برای حسابرسی میفرستند.
- بازبینی مهندسی – طراحان خطوط قرمز را مستقیماً روی صفحهٔ DWG میکشند؛ XML حاشیهنویسی همراه با تاریخچهٔ نسخه ذخیره میشود.
- منابع انسانی و جذب – جذبکنندگان بخشهای کلیدی رزومه را برجسته میکنند، نظر میگذارند و نسخهٔ حاشیهنویسیشده را به پروفایل نامزد میپوشانند.
چون دادهٔ حاشیهنویسی روی سرور نگهداری میشود، کنترل کامل بر اینکه چه کسی میتواند ویرایش، مشاهده یا چاپ کند، دارید. API بهصورت عمدی ساده است: فقط به دریافت مدیر، افزودن و بارگذاری نیاز دارید و میتوانید ویژگیهای UI اضافی (undo/redo، ابزارهای سفارشی) را بدون افزودن وابستگیهای دیگر بسازید.
جستجوی لحظهای و OCR: یافتن هر سند
یک مخزن اسناد تنها زمانی ارزش دارد که کاربران بتوانند اطلاعات مورد نیاز خود را در ثانیهها پیدا کنند. پلاگین جستجوی Doconut جستجوی متن کامل لحظهای را در هر فایل باز ارائه میدهد. برای PDFهای فقط رستر یا نقشههای CAD اسکنشده، موتور OCR داخلی متن را بهصورت درخواست‑به‑درخواست استخراج میکند و تصاویر را به محتوای قابل جستجو تبدیل میکند بدون نیاز به پیشپردازش جداگانه.
جریان کاری معمول جستجو
- متد جستجوی نمایشگر (از طریق پلاگین جستجو) را با کلیدواژهٔ موردنظر فراخوانی کنید.
- فهرستی از شمارههای صفحهٔ مطابق و مختصات هر تطابق دریافت کنید.
- برای هر تطابق، مدیر حاشیهنویسی صفحه را دریافت کنید و یک حاشیهنویسی موقت برجسته برای نشان دادن مکان اصطلاح به کاربر اضافه کنید.
زمانی که کاربر یک PDF اسکنشده از یک فاکتور را باز میکند، نمایشگر بهصورت خودکار OCR را بر روی هر صفحه هنگام رندر اجرا میکند. متن استخراجشده در حافظه ایندکس میشود و جستجوهای بعدی لحظهای میشوند. این رویکرد نیاز به سرویس OCR جداگانه را از بین میبرد، تاخیر را کاهش میدهد و تضمین میکند که متن جستجو شونده هرگز از محیط امن شما خارج نمیشود.
مزایای سازمانی
- پورتالهای مشتری میتوانند با یک فشار کلید بندهای مربوط به قرارداد را نشان دهند.
- ابزارهای گزارش مالی به تحلیلگران اجازه میدهند یک ردیف هزینه را در میان دهها صورتحساب اسکنشده پیدا کنند.
- سیستمهای سوابق بهداشتی میتوانند نام داروها را در یادداشتهای اسکنشده پزشکان جستجو کنند و ایمنی بیمار را ارتقا دهند.
تمام اینها با صفر وابستگی شخص ثالث انجام میشود، استک را سبک نگه میدارد و سطح انطباق را کوچک میکند.
چاپ کنترلشده از نمایشگر – امنیت همراه با راحتی
چاپ اغلب ضعیفترین نقطه در امنیت اسناد است. ویژگی چاپ کنترلشده Doconut به شما اختیار میدهد چه، چه زمانی و چگونه یک سند چاپ شود، در حالی که همچنان دیالوگ چاپ آشنا در مرورگر را ارائه میدهد.
جریان کاری معمول چاپ
- یک شیء
PrintConfigتعریف کنید که گزینههایی مانند محدودیتهای بازهٔ صفحه، واترمارکها و ثبت لاگ هر درخواست چاپ را مشخص میکند. - پیکربندی را بههمراه توکن سند به متد
Printنمایشگر پاس دهید. - نمایشگر صفحات انتخابشده را روی سرور رندر میکند، واترمارکها را اعمال میکند و PDF قابل چاپ را به مرورگر کلاینت استریم میکند.
- یک ورودی حسابرسی بهصورت خودکار ایجاد میشود تا مدیران بتوانند ببینند چه کسی چه چیزی و چه زمانی چاپ کرده است.
با انجام چاپ روی سرور، Doconut اطمینان میدهد که سند اصلی هرگز از محیط محافظتشده شما خارج نمیشود و شما دید کامل بر فعالیت چاپ دارید—یک نیاز بحرانی برای صنایع تحتنظر.
نتیجهگیری
کتابخانهٔ نمایشگر سند Doconut برای تیمهای .NET یک مؤلفهٔ تک، ایمن و پر ویژگی برای رندر PDFها، فایلهای Office و نقشههای CAD فراهم میکند و آنها را با حاشیهنویسی، جستجوی فعالشده با OCR و چاپ کنترلشده غنی میسازد. با پردازش سمت‑سرور، تبدیل داخلی و پشتیبانی از بیش از ۳۳ فرمت فایل، میتوانید وابستگیهای هزینهبر شخص ثالث را حذف کنید و دادههای حساس را تحت کنترل مستقیم خود نگه دارید.
آمادهاید تا جریان کاری اسناد سازمانی خود را مدرن کنید؟ امروز نسخهٔ آزمایشی رایگان Doconut را شروع کنید، کتابخانه را دانلود کنید و مراحل یکپارچهسازی بالا را دنبال کنید تا قابلیتهای قدرتمند مشاهده، حاشیهنویسی و جستجو را در برنامهٔ .NET خود در عرض چند دقیقه بهکار بگیرید.