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