Робота з Modify PDF Online – анотування, виділення та перетворення PDF у пошукові безпосередньо у веб‑додатку: Практичний посібник
Якщо вам потрібно надати користувачам можливість анотувати, виділяти та шукати вміст PDF без виходу з браузера, Doconut’s Modify PDF Online забезпечує саме це. Він вбудовує повнофункціональний переглядач PDF безпосередньо у ваш .NET веб‑додаток і надає сервер‑бічний API для розмітки та пошуку за допомогою OCR — все в одному безпечному компоненті.
У наступних розділах ми розглянемо загальну архітектуру, логічні кроки, необхідні для включення анотування, виділення та пошуку OCR, а також кращі практики створення готового до використання у підприємствах рішення.
Чому Modify PDF Online — це прорив для корпоративних .NET‑додатків
Корпоративні рішення, орієнтовані на документи — будь‑то DMS, CRM‑портал або платформа юридичного огляду — мають задовольнити три суперечливі вимоги:
- Користувацький досвід – рецензенти очікують плавний, браузер‑орієнтований інтерфейс, який відчувається як настільний редактор PDF.
- Безпека та відповідність – документи часто містять конфіденційну інформацію, яку не можна передавати стороннім сервісам.
- Масштабованість – один виклик API може обслуговувати сотні одночасних користувачів у різних регіонах.
Doconut задовольняє всі три вимоги одним бібліотекою, що працює на сервері (тому документ ніколи не залишає вашу інфраструктуру), одночасно доставляючи відрендерений вміст у підтримувані веб‑браузери. Можливість Modify PDF Online базується на тому ж рушії рендерингу, який живить бібліотеку Document Viewer від Doconut, гарантуючи піксель‑точну відповідність для PDF, Office‑файлів та CAD‑чертежів. Оскільки функція живе всередині переглядача, ви можете додавати, редагувати та зберігати анотації без додаткових плагінів чи зовнішніх сервісів.
Ключові переваги для старших розробників та архітекторів
| Перевага | Що це означає для вашого рішення |
|---|---|
| HTML5/JavaScript інтерфейс | Переглядач працює в браузері без потреби в ActiveX чи пропрієтарних PDF‑плагінах. |
| Контрольоване друкування | Ви можете вмикати або вимикати друк для окремих ролей користувачів безпосередньо з інтерфейсу переглядача. |
| OCR на сервері | Скановані зображення перетворюються у пошуковий текст, залишаючись у вашому дата‑центрі. |
| Уніфікований API | Одна і та сама класа Viewer обробляє відкриття, анотування та пошук PDF. |
Централізуючи ці можливості, ви зменшуєте обсяг кастомного коду, який потрібно писати, підтримувати та аудитувати — важливий фактор для регульованих галузей, таких як охорона здоров’я, фінанси та юридичні технології.
Включення анотацій та виділення у переглядачі Doconut
Annotation Plugin автоматично доступний, коли ви вмикаєте Modify PDF Online. Типовий робочий процес складається з чотирьох логічних кроків:
- Зареєструвати middleware Doconut – Налаштуйте конвеєр ASP.NET Core так, щоб Doconut міг обслуговувати свої статичні ресурси (JavaScript, CSS, WebAssembly) та контролювати ліцензування.
- Створити екземпляр
Viewer– У scoped‑службі або контролері створіть об’єктViewer, передаючи необхідні сервіси, такі як кешування та доступ до HTTP‑контексту. - Відкрити PDF та отримати токен документа – Викличте метод відкриття документа переглядача, передавши шлях до файлу (або потік) і параметри рендерингу (наприклад, роздільна здатність зображення). Метод повертає унікальний токен, що ідентифікує сесію‑специфічний документ.
- Працювати з менеджером анотацій – Отримайте менеджер анотацій для потрібної сторінки, додайте об’єкт виділення або коментар, а потім збережіть отриманий XML назад на сервер за допомогою методу збереження переглядача.
Фронтенд просто завантажує переглядач з токеном і активує вбудовану панель інструментів анотацій. Користувачі можуть додавати коментарі, малювати форми або ставити штампи, і кожна взаємодія надсилається назад до того ж API‑endpoint, забезпечуючи простий та аудиту‑здатний потік даних.
Додавання миттєвого пошуку та OCR за допомогою Search Plugin
Пошуковий PDF є обов’язковим для будь‑якого порталу, орієнтованого на знання. Search Plugin від Doconut працює в парі з Modify PDF Online. Коли документ відкривається, переглядач автоматично індексує його текстовий шар. Якщо файл — скановане зображення, спочатку запускається сервер‑бічний OCR‑двигун, який перетворює растрове зображення у пошуковий текст.
Щоб надати функціональність пошуку клієнту, зазвичай виконується наступне:
- Увімкнути OCR під час відкриття документа – Встановіть відповідний прапорець у конфігурації PDF, щоб OCR‑двигун обробив скановані сторінки.
- Створити endpoint пошуку – Реалізуйте легкий API‑метод, який приймає токен і рядок запиту, передає запит до пошукової процедури переглядача та повертає номери сторінок і координати виділення, що відповідають запиту.
- Відобразити результати в UI – Переглядач автоматично підсвічує збіги; фронтенд може надати елементи навігації (наступний/попередній) без повного перезавантаження сторінки.
Оскільки анотації зберігаються у форматі XML, пошукові виділення накладаються чисто поверх існуючої розмітки, надаючи рецензентам повний контекст під час додавання коментарів.
Інтеграція Modify PDF Online у безпечний API‑шар
Підприємства часто надають функціональність роботи з документами через REST‑API, що працює за аутентифікацією, ролями та аудит‑логуванням. Дизайн Doconut робить таку інтеграцію простою: кожна операція (відкриття, анотування, пошук, друк) — це один виклик методу на об’єкті Viewer, а бібліотека нативно працює з IDistributedCache та IHttpContextAccessor.
Рекомендований підхід — інкапсулювати всі взаємодії з переглядачем у класі DocumentService. Сервіс перевіряє дозволи викликаючого, відкриває документи, додає виділення, запускає OCR‑пошук і повертає результати. Контролери лише викликають методи сервісу, залишаючись тонкими та орієнтованими на HTTP‑аспекти.
Ключові моменти безпечної, масштабованої реалізації:
- Зберігання токену на користувача – Токен документа зберігається у безпечному кеші (наприклад, Redis), прив’язаному до сесії користувача.
- Перевірка дозволів – Перед будь‑якою операцією переглядача виконується бізнес‑логіка доступу.
- Stateless‑endpoint’и – Кожен запит містить токен, що дозволяє горизонтальне масштабування сервісу.
- Аудит‑логування – Фіксуйте дії анотування та пошуку для звітності відповідності.
Висновок
Doconut’s Modify PDF Online надає повний сервер‑бічний стек модифікації PDF, що включає анотування, виділення та пошук за допомогою OCR — без залучення сторонніх сервісів. Дотримуючись наведених шаблонів, ви зможете забезпечити безпечний, високопродуктивний досвід перегляду та рецензування PDF, який масштабується під потреби великих підприємств.
Готові додати потужне редагування PDF у ваш .NET веб‑додаток? Спробуйте Doconut сьогодні і переконайтеся, як швидко можна увімкнути анотування, виділення та пошукові можливості PDF безпосередньо у браузері.