Інтеграція SDK переглядача документів з хмарним сховищем та платформами співпраці

Інтеграція SDK переглядача документів з хмарним сховищем та платформами співпраці дозволяє надавати безшовні, безпечні та пошукові документи безпосередньо з вашого .NET застосунку. За допомогою Doconut — універсального переглядача документів для .NET бек‑ендів — ви можете рендерити PDF, файли Office, креслення CAD та зображення в рідному режимі, додавати пошук на основі OCR, вмикати анотації в реальному часі та керувати друком, при цьому зберігаючи дані у вибраній вами хмарі або локальному середовищі. Цей посібник показує старшим розробникам та архітекторам програмного забезпечення, як підключити Doconut до Azure Blob, Amazon S3 або Google Cloud Storage, а також як надати переглядач через спільні портали, такі як Microsoft Teams, SharePoint або кастомні робочі простори на базі React.

Чому хмарно‑нативний перегляд документів важливий для сучасних .NET додатків

Крос‑платформенна консистентність з одним .NET ядром

Компанії відходять від інструментів лише для настільних комп’ютерів і впроваджують веб‑перше досвід, який працює на Windows. Серверний рушій рендерингу Doconut працює на .NET 6 та новіших версіях, забезпечуючи однаковий піксель‑точний результат незалежно від операційної системи. Оскільки переглядач працює з потоками, ви можете отримати файл з будь‑якого хмарного бакету, передати його безпосередньо до компонента переглядача Doconut і повернути відрендерені сторінки або мініатюри клієнту, не записуючи файл на диск.

Зменшення затримки та пропускної здатності

Коли документ зберігається в Azure Blob Storage, завантаження всього файлу на клієнт лише для перегляду першої сторінки створює зайву затримку. Doconut підтримує генерацію мініатюр за запитом, дозволяючи спочатку запросити попередній перегляд низької роздільної здатності, а повний рендер сторінки отримувати лише коли користувач прокручує. Такий підхід особливо корисний для великих креслень CAD (DWG, DXF), які можуть важити сотні мегабайт.

Безпека як пріоритет у процесингу

Уся важка обробка залишається на сервері. Використовуючи можливості server‑side processing Doconut, ви зберігаєте конфіденційні PDF, юридичні контракти або медичні записи у вашій приватній VNet або за корпоративним брандмауером. Жоден сторонній SaaS не викликається, і переглядач ніколи не передає необроблені байти до браузерного рушія — лише плитки зображень або HTML‑фрагменти, які ви генеруєте у бек‑ендi.

Підключення Doconut до популярних хмарних сховищ

Загальний підхід до інтеграції

Отримайте потік документа – Використайте SDK вашого обраного хмарного провайдера (Azure Blob, Amazon S3, Google Cloud Storage), щоб завантажити файл у об’єкт Stream.
Передайте потік до Doconut – Переглядач Doconut приймає потік разом з необов’язковими параметрами рендерингу. Це усуває потребу у тимчасових файлах на веб‑сервері.
Згенеруйте токен переглядача – Doconut повертає токен, який унікально ідентифікує відкритий документ для поточної сесії. Токен можна повернути на фронтенд у вигляді JSON та використовувати для подальших запитів рендерингу сторінок або анотацій.
Рендеринг сторінок за запитом – Фронтенд викликає endpoint Doconut з токеном та потрібним номером сторінки; Doconut повертає потік зображення або HTML‑фрагмента.

Оскільки робочий процес базується лише на потоках, заміна коду Azure на Amazon S3 або Google Cloud Storage вимагає лише зміни виклику cloud‑SDK, який створює потік; решта конвеєра Doconut залишається ідентичною.

Обробка мульти‑тенантного сховища

У SaaS DMS кожен орендар може мати окремий бакет або префікс. Оскільки Doconut працює з потоками, ви можете визначити правильний бакет під час виконання, відкрити документ і зберегти токен у межах прав поточного користувача. Внутрішнє кешування Doconut (IDistributedCache) можна налаштувати на використання Redis або Azure Cache for Redis, забезпечуючи, що повторні запити до тієї ж сторінки обслуговуються з пам’яті, а не повторно рендеряться.

Включення анотацій у реальному часі та OCR у спільних робочих процесах

Плагін анотації: перетворення статичного переглядача у центр огляду

Doconut постачається з Annotation Plugin, який дозволяє користувачам виділяти текст, додавати нотатки‑стикери або малювати вільні форми. Після відкриття документа ви отримуєте менеджер анотацій з переглядача, додаєте або змінюєте об’єкти анотацій і зберігаєте стан анотацій у вигляді XML. Зберігання XML разом із записом документа забезпечує версіоновану історію оглядів, а завантаження XML при наступних відкриттях відновлює точний візуальний стан.

Пошук на основі OCR для сканованих PDF

Скановані контракти, квитанції або медичні зображення часто надходять у вигляді PDF лише з зображенням. Search Plugin Doconut автоматично запускає OCR на сервері, коли ви вмикаєте його в конфігурації переглядача. OCR‑двигун працює всередині серверного стеку, тому витягнутий текст ніколи не залишає вашого захищеного середовища. Після завершення OCR ви можете викликати API пошуку, щоб отримати відповідні номери сторінок та обмежувальні прямокутники, які UI може підсвітити. Оскільки OCR працює на сервері, ви також можете індексувати витягнутий текст у Azure Cognitive Search, Elasticsearch або будь‑який інший сервіс пошуку, щоб забезпечити миттєвий повнотекстовий пошук по всьому вашому сховищу.

Співпраця через спільні токени

У інтеграціях з Teams або SharePoint зазвичай генерується короткоживучий токен, який кодує ідентифікатор документа, дозволи користувача та мітку часу. Рядок токену Doconut, повернутий викликом OpenDocument, можна обгорнути в JWT або зберегти у кеші. Коли інший користувач натискає спільне посилання, той самий токен використовується для повторного ініціалізування переглядача, зберігаючи анотації та OCR‑шари для всіх учасників.

Безпечне серверне конвертування та контрольований друк з Doconut

Багато компаній потребують конвертувати вхідні файли Word, Excel або CAD у PDF для архівування або впровадити політику «друкувати лише після схвалення». Converter Plugin Doconut обробляє ці сценарії без потреби у Microsoft Office або сторонніх сервісах. Ви викликаєте API конвертації на сервері, передаючи шлях до вихідного файлу (або потік) та бажаний формат виводу. Конвертація виконується повністю на бек‑енді, створюючи PDF, який можна зберегти у вашому сховищі документів.

Після створення PDF ви можете ввімкнути Controlled Printing безпосередньо в інтерфейсі переглядача. Doconut надає метод для встановлення дозволів на друк для конкретного токену документа. Коли користувач натискає кнопку друку, Doconut перевіряє прапорець і або рендерить потік зображення для друку, або повертає дружнє повідомлення «друк вимкнено». Такий підхід усуває потребу у кастомному JavaScript для блокування діалогового вікна друку браузера.

Аудит друку

Оскільки запит на друк проходить через middleware Doconut, ви можете підключитися до конвеєра логування ASP.NET Core, щоб зафіксувати, хто що і коли друкував. Збережіть запис аудиту у таблиці SQL або передайте його в SIEM‑систему для звітності про відповідність — це критично для юридичних технологій або медичних рішень, де кожен доступ до документа має бути відстежуваним.

Кращі практики масштабування та продуктивності в крос‑платформенних середовищах

Використовуйте розподілене кешування – Внутрішнє кешування плиток сторінок Doconut може базуватись на Redis, Azure Cache або будь‑якій реалізації IDistributedCache. Додавайте хеш версії документа у ключі кешу, щоб уникнути подачі застарілих зображень після конвертації.
Використовуйте фонова завдання для масової конвертації – При підключенні великого архіву ставте в чергу завдання конвертації за допомогою Hangfire або Azure Functions. Клас переглядача Doconut працює з IHostedService воркерами, оскільки приймає потоки і повертає токени без потреби у HTTP‑контексті.
Налаштуйте роздільну здатність зображення під пристрій – Мобільні пристрої виграють від нижчого ImageResolution (150‑200 DPI), тоді як настільні робочі станції можуть запитувати 300 DPI для деталей CAD. Регулюйте роздільну здатність на основі рядка user‑agent або налаштування на клієнті.
Увімкніть ліниве завантаження анотацій – Зберігайте XML анотацій у окремій таблиці і завантажуйте його лише коли користувач відкриває панель анотацій. Це зменшує початкове навантаження і прискорює рендеринг першої сторінки.
Контролюйте використання пам’яті – Рендеринг високороздільних CAD‑сторінок може бути інтенсивним щодо пам’яті. Налаштуйте .NET GC на використання серверного режиму у продакшн (<gcServer enabled="true"/>) та встановіть розумний тайм‑аут, щоб запобігти неконтрольованим роботам рендерингу.
Використовуйте CDN для статичних ресурсів – JavaScript та CSS пакети переглядача є статичними. Подавайте їх через Azure CDN, CloudFront або Cloudflare, щоб скоротити час завантаження початкової сторінки на кілька мілісекунд, особливо для глобально розподілених команд.

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

Швидкий старт з безкоштовною пробною версією Doconut

Найшвидший спосіб оцінити Doconut — завантажити безкоштовну пробну версію з офіційного сайту, додати пакет NuGet до нового проєкту ASP.NET Core і слідувати посібнику швидкого старту. За кілька хвилин у вас буде функціональний переглядач, який може отримувати документи з Azure Blob, вмикати анотації, виконувати пошук на основі OCR та здійснювати безпечне серверне конвертування. Для покрокових інструкцій відвідайте документацію Doconut і почніть будувати ваш хмарно‑нативний досвід роботи з документами вже сьогодні.

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