Робота з бібліотекою переглядача документів – підтримка форматів PDF, Office та CAD з вбудованими анотаціями, пошуком і друком: Практичний посібник

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

У цьому практичному посібнику ми розглянемо основний робочий процес бібліотеки Document Viewer, покажемо, як її вбудувати, і продемонструємо три стовпи, які роблять її незамінною — анотації, пошук (включно з OCR) та контрольований друк. Після завершення у вас буде готовий прототип і чітке уявлення про те, як Doconut може стати основою будь‑якого документозалежного корпоративного рішення.

Безпечний корпоративний переглядач документів, що відображає файли PDF, Office та CAD з інструментами анотації та друку

Розгортання у Windows та варіанти безкоштовної пробної версії

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

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

Чому бібліотека Document Viewer — це революція для .NET‑підприємств

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

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

Бібліотека Document Viewer від 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:

Зареєструйте middleware Doconut – налаштуйте middleware UseDoconut для обробки внутрішнього endpoint‑а зображень‑тайлів (DocImage.axd). Цей endpoint передає відрендерені сторінки у вигляді PNG‑тайлів, зберігаючи інтерфейс швидким навіть для великих CAD‑файлів.
Завантажте ліцензію – вкажіть файл ліцензії Doconut (наприклад, DoconutLicense.xml) як файл на диску або як потік. Бібліотека автоматично читає ліцензію під час створення першого екземпляра переглядача.
Створіть екземпляр переглядача – інстанціюйте клас Viewer, передаючи необхідні сервіси, такі як розподілений кеш або IHttpContextAccessor.
Налаштуйте параметри рендерингу – створіть об’єкт конфігурації (наприклад, PdfConfig) для управління поведінкою рендерингу за замовчуванням, витягом гіперпосилань та роздільною здатністю растрових зображень CAD‑креслень.
Відкрийте документ – викличте метод OpenDocument з шляхом до файлу (або потоком) та раніше визначеною конфігурацією. Метод повертає захищений токен, який JavaScript‑фронтенд використовує для запиту зображень сторінок, анотацій та результатів пошуку.

Ці кроки створюють серверний переглядач для Windows‑середовищ на .NET 6. Підхід на основі токену зберігає клієнтську частину легковаговою: фронтенд потребує лише підключення компонента переглядача Doconut, розміщеного за адресою https://doconut.app.

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

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

Типовий робочий процес анотації

Отримайте менеджер анотацій для поточної сторінки, викликавши GetAnnotationManager і передавши розміри сторінки.
Створіть об’єкт анотації (наприклад, штамп‑зображення, підсвічування або вільний малюнок) і задайте його позицію, розмір та візуальні властивості.
Додайте анотацію до менеджера.
Отримайте XML‑дані анотації за допомогою GetAnnotationXml і збережіть їх у сховищі.
При повторному відкритті документа завантажте збережений XML у переглядач за допомогою LoadAnnotationXML.

Сценарії для підприємств

Legal Tech – Юристи розміщують штамп «Підпис» у контракті, а XML передається у сервіс управління справами для аудиту.
Engineering Review – Дизайнери додають червоні правки безпосередньо на сторінці DWG; XML‑анотація зберігається разом із історією ревізій.
HR & Recruitment – Рекрутери підсвічують ключові розділи резюме, додають коментарі та надсилають анотовану версію до профілю кандидата.

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

Миттєвий пошук та OCR: робимо кожен документ доступним

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

Типовий робочий процес пошуку

Викличте метод пошуку переглядача (через Search Plugin), передавши потрібне ключове слово.
Отримайте список номерів сторінок і координат кожного збігу.
Для кожного збігу отримайте менеджер анотацій сторінки та додайте тимчасову підсвічування, щоб показати користувачу, де розташований термін.

Коли користувач відкриває сканований PDF‑рахунок, переглядач автоматично запускає OCR для кожної сторінки під час рендерингу. Витягнутий текст індексується в пам’яті, що робить подальші пошуки миттєвими. Такий підхід усуває потребу у зовнішньому OCR‑сервісі, знижує затримки і гарантує, що пошуковий текст ніколи не залишає вашого захищеного середовища.

Переваги для підприємств

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

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

Контрольований друк з переглядача – безпека та зручність

Друк часто є найслабшою ланкою в безпеці документів. Функція контрольованого друку Doconut дає вам можливість визначати що, коли і як можна надрукувати документ, залишаючись при цьому у знайомому браузерному діалоговому вікні друку.

Типовий робочий процес друку

Створіть об’єкт PrintConfig, у якому вкажіть параметри, такі як обмеження діапазону сторінок, водяні знаки та чи вести журнал кожного запиту на друк.
Передайте конфігурацію разом із токеном документа у метод Print переглядача.
Переглядач рендерить обрані сторінки на сервері, накладає водяні знаки та передає готовий PDF назад у браузер клієнта.
Автоматично створюється запис аудиту, що дозволяє адміністраторам відстежувати, хто, що і коли друкував.

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

Висновок

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

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