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

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

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

Защищённый корпоративный просмотрщик документов, отображающий файлы PDF, Office и CAD с инструментами аннотации и печати

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

Doconut’s library runs on .NET 6 and is fully supported in Windows environments. Whether you host your app in Azure, AWS, or on‑premise, it delivers consistent rendering and annotation performance.

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

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

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

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

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

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

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

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

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

Register the Doconut middleware – configure the UseDoconut middleware to handle the internal image‑tile endpoint (DocImage.axd). This endpoint streams rendered pages as PNG tiles, keeping the UI responsive even for large CAD files.
Load the license – provide the Doconut license file (e.g., DoconutLicense.xml) either as a file on disk or as a stream. The library reads the license automatically during the first viewer instance creation.
Create a viewer instance – instantiate the Viewer class, passing in any required services such as a distributed cache or HTTP context accessor.
Configure rendering options – set up a configuration object (for example, PdfConfig) to control default rendering behaviour, hyperlink extraction, and raster resolution for CAD drawings.
Open a document – call the OpenDocument method with the file path (or stream) and the previously defined configuration. The method returns a secure token that the JavaScript front‑end uses to request page images, annotations, and search results.

These steps result in a server‑side viewer for Windows environments running .NET 6. The token‑based approach keeps the client lightweight: the front‑end only needs to reference the Doconut viewer component hosted at https://doconut.app.

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

Annotations turn a passive viewer into a collaborative workspace. Doconut’s annotation manager operates on a per‑page basis and stores everything as XML, which means you can easily version, audit, or merge changes in a database.

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

Retrieve the annotation manager for the current page by calling the viewer’s GetAnnotationManager method, supplying the page dimensions.
Create an annotation object (e.g., an image stamp, highlight, or free‑hand drawing) and set its position, size, and visual properties.
Add the annotation to the manager.
Persist the annotation XML using GetAnnotationXml and store it in your data store.
When the document is re‑opened, load the saved XML back into the viewer with LoadAnnotationXML.

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

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

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

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

A document repository is only valuable when users can locate the information they need in seconds. Doconut’s search plugin offers instant, full‑text search across any opened file. For raster‑only PDFs or scanned CAD drawings, the built‑in OCR engine extracts text on demand, turning images into searchable content without a separate preprocessing step.

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

Call the viewer’s search method (exposed by the Search Plugin) with the desired keyword.
Receive a list of matching page numbers and the coordinates of each match.
For each match, obtain the page’s annotation manager and add a temporary highlight annotation to show the user where the term appears.

When a user opens a scanned PDF of an invoice, the viewer automatically runs OCR on each page as it is rendered. The extracted text is indexed in memory, making subsequent searches instantaneous. This approach eliminates the need for a separate OCR service, reduces latency, and guarantees that the searchable text never leaves your secure environment.

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

Customer portals могут выводить релевантные пункты контракта одним нажатием клавиши.
Financial reporting tools позволяют аналитикам находить строку расходов в десятках отсканированных выписок.
Healthcare record systems становятся поисковыми по названиям медикаментов в отсканированных врачебных заметках, повышая безопасность пациентов.

All of this is achieved with zero third‑party dependencies, keeping the stack lightweight and the compliance surface small.

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

Printing is often the weakest link in document security. Doconut’s controlled printing feature gives you the authority to decide what, when, and how a document can be printed, while still providing a familiar browser‑based print dialog.

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

Define a PrintConfig object that specifies options such as page‑range limits, watermarks, and whether to log each print request.
Pass the configuration together with the document token to the viewer’s Print method.
The viewer renders the selected pages on the server, applies any watermarks, and streams the printable PDF back to the client’s browser.
An audit entry is created automatically, allowing administrators to track who printed what and when.

By handling printing on the server, Doconut ensures that the original document never leaves your protected environment, and you retain full visibility into print activity—a critical requirement for regulated industries.

Заключение

Doconut’s Document Viewer Library gives .NET teams a single, secure, and feature‑rich component for rendering PDFs, Office files, and CAD drawings, enriching them with annotations, OCR‑enabled search, and controlled printing. With server‑side processing, built‑in conversion, and support for over 33 file formats, you can eliminate costly third‑party dependencies and keep sensitive data under your direct control.

Ready to modernise your enterprise document workflow? Start your free trial of Doconut today, download the library, and follow the integration steps outlined above to bring powerful viewing, annotation, and search capabilities to your .NET application in minutes.