Робота з бібліотекою переглядача документів – підтримка PDF, Office та CAD форматів з вбудованими анотаціями, пошуком та друком: Практичний посібник
Бібліотека Document Viewer у Doconut дозволяє рендерити PDF, Office та CAD‑файли, анотувати їх, шукати вміст і друкувати — все це з одного .NET‑компонента.
Якщо ви створюєте портал, орієнтований на документи, юридичну систему управління справами або інструмент перегляду інженерних креслень, вам потрібен переглядач, який працює так, як ваші користувачі: миттєво, безпечно і без зовнішніх сервісів. Doconut надає такий досвід у вашій власній інфраструктурі, всередині ASP.NET або .NET Core застосунку, зберігаючи кодову базу чистою та мінімізуючи розмір розгортання.
У цьому практичному посібнику ми пройдемо основний робочий процес бібліотеки Document Viewer, покажемо, як її вбудувати, і продемонструємо три стовпи, які роблять її незамінною — анотації, пошук (включаючи OCR) та контрольований друк. Після завершення у вас буде готовий прототип і чітке уявлення про те, як Doconut може стати основою будь‑якого документ‑інтенсивного корпоративного рішення.
Розгортання в Windows та варіанти безкоштовної пробної версії
Бібліотека Doconut працює на .NET 6 і повністю підтримується у Windows‑середовищах. Незалежно від того, розгортаєте ви застосунок в Azure, AWS чи у власному дата‑центрі, вона забезпечує стабільний рендеринг і продуктивність анотацій.
Щоб швидко розпочати, Doconut пропонує безкоштовну пробну версію, яка включає повний доступ до движка анотацій, пошуку з OCR та функцій контрольованого друку. Зареєструйтеся на офіційному сайті, завантажте пробну ліцензію та виконайте кроки інтеграції нижче, щоб побачити бібліотеку в дії за кілька хвилин.
Чому бібліотека переглядача документів – це революція для .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 від Doconut у застосунок ASP.NET Core:
- Реєстрація middleware Doconut — налаштуйте middleware
UseDoconutдля обробки внутрішнього endpoint‑аDocImage.axd, який передає відрендерені сторінки у вигляді 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) з потрібним ключовим словом.
- Отримайте список номерів сторінок і координат кожного збігу.
- Для кожного збігу отримайте менеджер анотацій сторінки і додайте тимчасову підсвічування, щоб показати користувачу, де розташовано термін.
Коли користувач відкриває сканований PDF‑рахунок, переглядач автоматично запускає OCR для кожної сторінки під час рендерингу. Видобутий текст індексується в пам’яті, що робить подальші пошуки миттєвими. Такий підхід усуває потребу у зовнішньому OCR‑сервісі, знижує затримки і гарантує, що пошуковий текст ніколи не залишає вашого захищеного середовища.
Переваги для підприємств
- Клієнтські портали можуть виводити релевантні пункти контракту одним натисканням клавіші.
- Фінансові інструменти дозволяють аналітикам знаходити рядок у десятках сканованих виписок.
- Системи медичних записів стають пошуковими за назвами препаратів у сканованих нотатках лікарів, підвищуючи безпеку пацієнтів.
Все це досягається без жодних сторонніх залежностей, що зберігає стек легким і мінімізує поверхню відповідності.
Контрольований друк з переглядача — безпека та зручність
Друк часто є найслабшою ланкою в безпеці документів. Функція контрольованого друку Doconut дає вам можливість вирішувати що, коли і як можна друкувати, залишаючи при цьому знайомий діалог друку в браузері.
Типовий робочий процес друку
- Створіть об’єкт
PrintConfig, у якому вкажіть параметри, такі як обмеження діапазону сторінок, водяні знаки та чи вести журнал кожного запиту на друк. - Передайте конфігурацію разом з токеном документа у метод
Printпереглядача. - Переглядач рендерить вибрані сторінки на сервері, накладає водяні знаки і передає готовий PDF назад у браузер клієнта.
- Автоматично створюється запис аудиту, що дозволяє адміністраторам відстежувати, хто що друкував і коли.
Обробка друку на сервері гарантує, що оригінальний документ ніколи не залишає вашого захищеного середовища, і ви зберігаєте повну видимість у діяльності друку — критично важливо для регульованих галузей.
Висновок
Бібліотека Document Viewer від Doconut надає .NET‑командам єдиний, безпечний і багатофункціональний компонент для рендерингу PDF, Office‑файлів і CAD‑креслень, збагачуючи їх анотаціями, пошуком з OCR та контрольованим друком. Завдяки серверній обробці, вбудованій конверсії та підтримці понад 33 форматів, ви можете усунути дорогі сторонні рішення і тримати конфіденційні дані під власним контролем.
Готові модернізувати корпоративний документообіг? Розпочніть безкоштовну пробну версію Doconut вже сьогодні, завантажте бібліотеку та слідуйте крокам інтеграції, наведеним вище, щоб за кілька хвилин додати потужний перегляд, анотації та пошук у ваш .NET‑застосунок.