Работа с 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 построена на том же движке рендеринга, который обеспечивает Doconut’s Document Viewer Library, гарантируя пиксельную точность для PDF, файлов Office и чертежей CAD. Поскольку функция находится внутри просмотрщика, вы можете добавлять, редактировать и сохранять аннотации без дополнительных плагинов или внешних сервисов.
Ключевые преимущества для старших разработчиков и архитекторов
| Преимущество | Что это значит для вашего решения |
|---|---|
| HTML5/JavaScript UI | Просмотрщик работает в браузере без необходимости использования ActiveX или проприетарных PDF‑плагинов. |
| Controlled printing | Вы можете включать или отключать печать в зависимости от роли пользователя непосредственно из интерфейса просмотрщика. |
| Server‑side OCR | Отсканированные изображения превращаются в поисковый текст, оставаясь внутри вашего дата‑центра. |
| Unified API surface | Класс Viewer обрабатывает открытие, аннотирование и поиск PDF. |
Централизуя эти возможности, вы уменьшаете объём пользовательского кода, который нужно писать, поддерживать и проверять — важный фактор для регулируемых отраслей, таких как здравоохранение, финансы и юридические технологии.
Включение аннотаций и выделений в просмотрщике Doconut
Плагин аннотаций автоматически доступен при включении Modify PDF Online. Типичный рабочий процесс состоит из четырёх логических шагов:
- Зарегистрировать middleware Doconut — настроить конвейер ASP.NET Core, чтобы Doconut мог обслуживать свои статические ресурсы (JavaScript, CSS, WebAssembly) и обеспечивать лицензирование.
- Создать экземпляр
Viewer— в scoped‑службе или контроллере создать объектViewer, передавая необходимые сервисы, такие как кэширование и доступ к HTTP‑контексту. - Открыть PDF и получить токен документа — вызвать метод открытия документа в просмотрщике, указав путь к файлу (или поток) и любые параметры рендеринга (например, разрешение изображения). Метод возвращает уникальный токен, идентифицирующий документ конкретной сессии.
- Работать с менеджером аннотаций — получить менеджер аннотаций для нужной страницы, добавить объект выделения или комментария, затем сохранить полученный XML на сервер с помощью метода сохранения просмотрщика.
Фронтенд просто загружает просмотрщик с токеном и включает встроенную панель аннотаций. Пользователи могут добавлять комментарии, рисовать фигуры или ставить штампы, и каждое взаимодействие отправляется обратно к тому же API‑конечному пункту, упрощая и делая поток данных аудируемым.
Добавление мгновенного поиска и 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 непосредственно в браузере.