Работа с библиотекой Document Viewer – поддержка PDF, Office и CAD форматов с встроенными аннотациями, поиском и печатью: Практическое руководство

Библиотека Document Viewer в Doconut позволяет рендерить PDF, Office и CAD файлы, аннотировать их, выполнять поиск по содержимому и печатать — всё из одного .NET компонента.
Если вы создаёте портал, ориентированный на документы, систему управления юридическими делами или инструмент для обзора инженерных чертежей, вам нужен просмотрщик, который работает так, как ожидают пользователи: мгновенно, безопасно и без внешних сервисов. Doconut предоставляет такой опыт на‑premise, внутри вашего ASP.NET или .NET Core приложения, при этом поддерживая чистоту кода и небольшой размер развертывания.

В этом практическом руководстве мы пройдём через основной рабочий процесс Document Viewer Library, покажем, как его внедрить, и продемонстрируем три столпа, делающие его незаменимым — аннотации, поиск (включая OCR) и контролируемая печать. К концу вы получите готовый к запуску прототип и чёткое представление о том, как Doconut может стать основой любой документ‑ориентированной корпоративной решения.

---

Развёртывание в Windows и варианты бесплатного пробного периода

Библиотека Doconut работает на .NET 6 и полностью поддерживается в Windows‑средах. Независимо от того, размещаете ли вы приложение в Azure, AWS или на‑premise, она обеспечивает согласованную рендеринг‑ и аннотацию‑производительность.

Чтобы быстро начать, Doconut предлагает бесплатный пробный период, включающий полный доступ к движку аннотаций, поиску с поддержкой OCR и функциям контролируемой печати. Зарегистрируйтесь на официальном сайте, скачайте пробную лицензию и следуйте шагам интеграции ниже, чтобы увидеть библиотеку в действии за считанные минуты.

---

Почему Document Viewer Library меняет правила игры для .NET‑предприятий

Предприятия, работающие с контрактами, инженерными схемами или кадровыми документами, сталкиваются с тремя постоянными проблемами:

1. Разнообразие форматов — PDF, Word, Excel и CAD‑чертежи сосуществуют в одном репозитории.
2. Совместный обзор — бизнес‑пользователи должны выделять, комментировать или ставить штампы в документе, не покидая приложение.
3. Регулируемый доступ — печать должна быть аудируемой, а текст — доступным даже для отсканированных изображений.

Document Viewer Library от Doconut решает все три задачи с помощью единого серверного .NET компонента, поддерживающего более 33 типов файлов — включая DOCX, XLSX, PPTX, DWG и DXF — «из коробки». Библиотека рендерит каждый формат нативно, обходя необходимость в Microsoft Office, Acrobat или внешних сервисах конвертации. Поскольку рендеринг происходит на сервере, вы сохраняете чувствительные данные за вашим файрволом, что критично для здравоохранения, юридических и финансовых сфер.

Встроенный движок аннотаций позволяет добавлять выделения, свободные рисунки или штампы одобрения непосредственно на канвас просмотрщика. Аннотации хранятся в лёгком XML, что упрощает их сохранение в базе данных или системе контроля версий. Плагин поиска обеспечивает мгновенный поиск текста в любом открытом документе; если источник — отсканированное изображение, OCR‑движок извлекает поисковые строки «на лету». Наконец, функция контролируемой печати даёт возможность ограничивать диапазоны страниц, добавлять водяные знаки или вести журналы печати — всё через один вызов API.

В совокупности эти возможности позволяют заменить запутанный стек сторонних просмотрщиков, JavaScript‑плагинов и внешних сервисов конвертации на единую поддерживаемую библиотеку, масштабируемую от нескольких пользователей до корпоративных развертываний.

---

Встраивание просмотрщика: пошаговая интеграция в ASP.NET Core

Ниже приведено краткое описание шагов, необходимых для интеграции Document Viewer Library от Doconut в приложение ASP.NET Core:

1. Зарегистрировать middleware Doconut — сконфигурировать middleware UseDoconut для обработки внутреннего эндпоинта изображений (DocImage.axd). Этот эндпоинт передаёт отрисованные страницы в виде PNG‑тайлов, сохраняя отзывчивость UI даже для больших CAD‑файлов.
2. Загрузить лицензию — предоставить файл лицензии Doconut (например, DoconutLicense.xml) либо как файл на диске, либо как поток. Библиотека автоматически считывает лицензию при создании первого экземпляра просмотрщика.
3. Создать экземпляр просмотрщика — инстанцировать класс Viewer, передав необходимые сервисы, такие как распределённый кэш или IHttpContextAccessor.
4. Настроить параметры рендеринга — создать объект конфигурации (например, PdfConfig) для управления поведением рендеринга по умолчанию, извлечением гиперссылок и разрешением растровых изображений для CAD‑чертежей.
5. Открыть документ — вызвать метод OpenDocument с путём к файлу (или потоком) и ранее определённой конфигурацией. Метод возвращает безопасный токен, который JavaScript‑фронтенд использует для запроса изображений страниц, аннотаций и результатов поиска.

Эти шаги создают серверный просмотрщик для Windows‑сред, работающий на .NET 6. Токен‑ориентированный подход сохраняет клиент лёгким: фронтенд нуждается лишь в ссылке на компонент Doconut, размещённый по адресу https://doconut.app.

---

Встроенные аннотации для рабочих процессов в реальном времени

Аннотации превращают пассивный просмотрщик в совместное рабочее пространство. Менеджер аннотаций Doconut работает на уровне страниц и хранит всё в XML, что позволяет легко версионировать, аудитировать или объединять изменения в базе данных.

Типичный рабочий процесс аннотаций

1. Получить менеджер аннотаций для текущей страницы, вызвав метод GetAnnotationManager просмотрщика, передав размеры страницы.
2. Создать объект аннотации (например, штамп‑изображение, выделение или свободный рисунок) и задать его позицию, размер и визуальные свойства.
3. Добавить аннотацию в менеджер.
4. Сохранить XML аннотации через GetAnnotationXml и записать его в хранилище.
5. При повторном открытии документа загрузить сохранённый XML обратно в просмотрщик с помощью LoadAnnotationXML.

Сценарии для предприятий

• Legal Tech — юристы ставят штамп «Подпись» на контракт, затем отправляют XML в сервис управления делами для аудита.
• Engineering Review — дизайнеры добавляют красные линии непосредственно на страницу DWG; XML аннотации хранится рядом с историей ревизий.
• HR & Recruitment — рекрутеры выделяют ключевые разделы резюме, добавляют комментарии и отправляют аннотированную версию в профиль кандидата.

Поскольку данные аннотаций находятся на сервере, вы сохраняете полный контроль над тем, кто может редактировать, просматривать и печатать. API преднамеренно минимален: нужны только методы получения менеджера, добавления и загрузки, а дополнительные UI‑фичи (undo/redo, кастомные инструменты) можно построить поверх без привлечения лишних зависимостей.

---

Мгновенный поиск и OCR: делаем каждый документ находящимся

Документальное хранилище ценно только тогда, когда пользователи могут за секунды найти нужную информацию. Плагин поиска Doconut предоставляет мгновенный полнотекстовый поиск по любому открытому файлу. Для PDF‑файлов только с растром или отсканированных CAD‑чертежей встроенный OCR‑движок извлекает текст по запросу, превращая изображения в поисковый контент без отдельного предобработающего шага.

Типичный рабочий процесс поиска

1. Вызвать метод поиска просмотрщика (exposed by the Search Plugin) с нужным ключевым словом.
2. Получить список совпадающих номеров страниц и координат каждого совпадения.
3. Для каждого совпадения получить менеджер аннотаций страницы и добавить временную выделяющую аннотацию, показывающую пользователю место появления термина.

Когда пользователь открывает отсканированный PDF‑счёт, просмотрщик автоматически запускает OCR для каждой страницы при её рендеринге. Извлечённый текст индексируется в памяти, делая последующие поиски мгновенными. Такой подход устраняет необходимость в отдельном OCR‑сервисе, снижает задержки и гарантирует, что поисковый текст никогда не покидает вашу защищённую среду.

Преимущества для предприятий

• Клиентские порталы могут выводить релевантные пункты из контракта одним нажатием клавиши.
• Финансовые аналитические инструменты позволяют аналитикам находить строку расходов в десятках отсканированных выписок.
• Системы медицинских записей становятся поисковыми по названиям препаратов в отсканированных врачебных заметках, повышая безопасность пациентов.

Всё это достигается без третьих сторон, сохраняя стек лёгким и поверхность соответствия минимальной.

---

Контролируемая печать из просмотрщика — безопасность встречает удобство

Печать часто является самым уязвимым звеном в безопасности документов. Функция контролируемой печати Doconut даёт вам возможность решать что, когда и как печатать, при этом предоставляя привычный диалог печати браузера.

Типичный рабочий процесс печати

1. Определить объект PrintConfig, задающий параметры, такие как ограничения диапазона страниц, водяные знаки и необходимость логировать каждый запрос печати.
2. Передать конфигурацию вместе с токеном документа в метод Print просмотрщика.
3. Просмотрщик рендерит выбранные страницы на сервере, накладывает водяные знаки и передаёт печатаемый PDF обратно в браузер клиента.
4. Автоматически создаётся запись аудита, позволяющая администраторам отслеживать, кто и когда что печатал.

Обрабатывая печать на сервере, Doconut гарантирует, что оригинальный документ никогда не покидает защищённую среду, а вы сохраняете полную видимость активности печати — критически важное требование для регулируемых отраслей.

---

Заключение

Document Viewer Library от Doconut предоставляет .NET‑командам единственный, безопасный и многофункциональный компонент для рендеринга PDF, Office‑файлов и CAD‑чертежей, обогащённый аннотациями, поиском с OCR и контролируемой печатью. Благодаря серверной обработке, встроенному конвертеру и поддержке более 33 форматов, вы можете избавиться от дорогостоящих сторонних решений и держать чувствительные данные под прямым контролем.

Готовы модернизировать корпоративный документооборот? Начните бесплатный пробный период Doconut уже сегодня, скачайте библиотеку и следуйте описанным выше шагам интеграции, чтобы добавить мощные возможности просмотра, аннотирования и поиска в ваше .NET приложение за считанные минуты.