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