کار با Modify PDF Online – حاشیه‌نویسی، برجسته‌سازی و جستجوی PDFها به‌صورت مستقیم در برنامه وب: راهنمای عملی
← Back to Blog6 min read

کار با Modify PDF Online – حاشیه‌نویسی، برجسته‌سازی و جستجوی PDFها به‌صورت مستقیم در برنامه وب: راهنمای عملی

اگر نیاز دارید به کاربران اجازه دهید تا محتویات PDF را بدون ترک مرورگر حاشیه‌نویسی، برجسته‌سازی و جستجو کنند، ویژگی Modify PDF Online Doconut دقیقاً این کار را انجام می‌دهد. این ویژگی یک نمایشگر PDF کامل را مستقیماً در برنامه وب .NET شما جاسازی می‌کند و یک API سمت‑سرور برای علامت‌گذاری بازبینی و جستجوی مبتنی بر OCR فراهم می‌کند — همه در یک مؤلفهٔ امن.

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

نمایشگر PDF سمت‑سرور امن با حاشیه‌نویسی، برجسته‌سازی، جستجوی OCR و ابزارهای چاپ کنترل‌شده
نمایشگر PDF سمت‑سرور امن با حاشیه‌نویسی، برجسته‌سازی، جستجوی OCR و ابزارهای چاپ کنترل‌شده

چرا Modify PDF Online یک تحول بزرگ برای برنامه‌های .NET سازمانی است

راه‌حل‌های متمرکز بر اسناد سازمانی — چه یک DMS، چه یک پورتال CRM، یا یک پلتفرم بازبینی legal‑tech — باید سه نیاز متقابل را برآورده کنند:

  1. تجربه کاربری – مرورکنندگان انتظار یک رابط کاربری روان و مبتنی بر مرورگر دارند که حس یک ویرایشگر PDF دسکتاپی را القا کند.
  2. امنیت و انطباق – اسناد اغلب شامل داده‌های محرمانه‌ای هستند که نمی‌توانند به سرویس‌های شخص ثالث ارسال شوند.
  3. قابلیت مقیاس‌پذیری – یک فراخوانی API ممکن است نیاز داشته باشد تا صدها کاربر همزمان در چندین منطقه را سرویس دهد.

Doconut این سه مورد را با یک کتابخانهٔ واحد که سمت‑سرور اجرا می‌شود (به‌طوری که سند هرگز از زیرساخت شما خارج نمی‌شود) برآورده می‌کند و محتوا را به مرورگرهای وب پشتیبانی‌شده ارائه می‌دهد. قابلیت Modify PDF Online بر پایهٔ همان موتور رندرینگ ساخته شده است که کتابخانهٔ Document Viewer Library داکونات را قدرت می‌دهد و دقت پیکسل‑به‑پیکسل برای PDFها، فایل‌های Office و نقشه‌های CAD تضمین می‌کند. چون این ویژگی داخل نمایشگر قرار دارد، می‌توانید حاشیه‌نویسی‌ها را بدون افزونه‌ها یا سرویس‌های خارجی اضافه، ویرایش و ذخیره کنید.

مزایای کلیدی برای توسعه‌دهندگان ارشد و معماران

مزیتمعنای آن برای راه‌حل شما
رابط کاربری HTML5/JavaScriptنمایشگر در مرورگر اجرا می‌شود بدون نیاز به ActiveX یا افزونه‌های اختصاصی PDF.
چاپ کنترل‌شدهمی‌توانید چاپ را بر اساس نقش کاربر مستقیماً از رابط نمایشگر فعال یا غیرفعال کنید.
OCR سمت‑سرورتصاویر اسکن‌شده به متن قابل جستجو تبدیل می‌شوند در حالی که در مرکز دادهٔ شما می‌مانند.
سطح یکپارچهٔ APIکلاس Viewer یکسان باز کردن، حاشیه‌نویسی و جستجوی PDFها را مدیریت می‌کند.

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


فعال‌سازی حاشیه‌نویسی و برجسته‌سازی در نمایشگر Doconut

Annotation Plugin به‌صورت خودکار زمانی که Modify PDF Online را فعال می‌کنید در دسترس است. جریان کاری معمولی شامل چهار گام منطقی است:

  1. ثبت میدلور Doconut – خط لولهٔ ASP.NET Core را پیکربندی کنید تا Doconut بتواند دارایی‌های ثابت خود (JavaScript، CSS، WebAssembly) را سرویس دهد و مجوز را اعمال کند.
  2. ایجاد یک نمونهٔ Viewer – در یک سرویس scoped یا کنترلر، شیء Viewer را نمونه‌سازی کنید و هر سرویس مورد نیاز مانند کش و دسترسی به HttpContext را پاس دهید.
  3. باز کردن PDF و دریافت توکن سند – متد باز کردن سند نمایشگر را فراخوانی کنید، مسیر فایل (یا جریان) و هر گزینهٔ رندرینگ (مثلاً وضوح تصویر) را ارائه دهید. این متد یک توکن یکتا برمی‌گرداند که سند مخصوص جلسه را شناسایی می‌کند.
  4. کار با مدیر حاشیه‌نویسی – مدیر حاشیه‌نویسی مربوط به صفحه‌ای که می‌خواهید تغییر دهید دریافت کنید، یک شیء برجسته یا کامنت اضافه کنید، سپس XML حاصل را با استفاده از متد ذخیرهٔ نمایشگر به سرور برگردانید.

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


افزودن جستجوی آنی و OCR با Search Plugin

یک PDF قابل جستجو برای هر پورتال دانش‑محور ضروری است. Search Plugin داکونات به‌صورت دست‑در‑دست با Modify PDF Online کار می‌کند. وقتی سندی باز می‌شود، نمایشگر به‌صورت خودکار لایهٔ متنی آن را ایندکس می‌کند. اگر فایل یک تصویر اسکن‌شده باشد، ابتدا موتور OCR سمت‑سرور اجرا می‌شود و تصویر رستر را به متن قابل جستجو تبدیل می‌کند.

معمولاً برای ارائهٔ قابلیت جستجو به کلاینت این کارها را انجام می‌دهید:

  1. فعال‌سازی OCR هنگام باز کردن سند – پرچم مناسب را در پیکربندی PDF تنظیم کنید تا موتور OCR صفحات اسکن‌شده را پردازش کند.
  2. افشای نقطهٔ انتهایی جستجو – یک متد API سبک‌وزن پیاده‌سازی کنید که توکن و رشتهٔ پرس‌وجو را دریافت می‌کند، درخواست را به روتین جستجوی نمایشگر می‌فرستد و شمارهٔ صفحات و مختصات برجسته‌های مطابق را برمی‌گرداند.
  3. نمایش نتایج در UI – نمایشگر به‌صورت خودکار مطابقت‌ها را برجسته می‌کند؛ فرانت‌اند می‌تواند کنترل‌های ناوبری (بعدی/قبلی) را بدون بارگذاری مجدد صفحه ارائه دهد.

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


ادغام Modify PDF Online در لایهٔ API امن

سازمان‌ها اغلب عملکردهای سندی را از طریق یک API RESTful که پشت احراز هویت، کنترل دسترسی مبتنی بر نقش و ثبت لاگ‌های حسابرسی قرار دارد، ارائه می‌دهند. طراحی داکونات این ادغام را ساده می‌کند: هر عملیات (باز کردن، حاشیه‌نویسی، جستجو، چاپ) یک فراخوانی متد واحد بر روی شیء Viewer است و کتابخانه به‌صورت بومی با IDistributedCache و IHttpContextAccessor کار می‌کند.

یک الگوی پیشنهادی این است که تمام تعاملات نمایشگر را در یک کلاس DocumentService محصور کنید. این سرویس مجوزهای فراخواننده را اعتبارسنجی می‌کند، اسناد را باز می‌کند، برجسته‌ها را اضافه می‌کند، جستجوهای فعال‑OCR را اجرا می‌کند و نتایج را برمی‌گرداند. کنترلرها سپس متدهای سرویس را فراخوانی می‌کنند، به‌طوری که کد کنترلر باریک و متمرکز بر نگرانی‌های HTTP باقی بماند.

نکات کلیدی برای پیاده‌سازی امن و مقیاس‌پذیر:

  • ذخیره‌سازی توکن به‌صورت کاربر‑محور – توکن سند را در یک کش امن (مثلاً Redis) مرتبط با جلسهٔ کاربر ذخیره کنید.
  • بررسی‌های دسترسی – قوانین کسب‌وکار را پیش از هر عملیات نمایشگر اعمال کنید.
  • نقطه‌های انتهایی بی‌حالت – هر درخواست توکن را شامل می‌شود، که امکان مقیاس‌پذیری افقی سرویس را فراهم می‌کند.
  • ثبت لاگ حسابرسی – اقدامات حاشیه‌نویسی و جستجو را برای گزارش‌گیری انطباقی ثبت کنید.

نتیجه‌گیری

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

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

#PDF#Document Viewer#.NET#Web Development#Enterprise#نمایشگر سند#توسعه وب#سازمان