Добавление возможности просмотра документов в бизнес‑приложение требует большего, чем просто размещение PDF в iframe. Файлы Office, чертежи CAD, файлы электронной почты и изображения нуждаются в разных возможностях рендеринга, при этом приложение всё равно должно контролировать аутентификацию, хранение, авторизацию и удержание данных.
Doconut — это SDK просмотра документов для .NET, предназначенный для встраивания рендеринга и взаимодействия с документами в веб‑приложениях. Вместо того чтобы предлагать непроверенный рецепт исходного кода, это руководство объясняет решения по интеграции, которые ваша команда должна принять, и описывает стандартные компоненты .NET, которые обычно окружают SDK.
Почему встроенный просмотр отличается от загрузки файла
Точка загрузки передаёт оригинальный файл и оставляет опыт просмотра внешнему программному обеспечению. Встроенный просмотр сохраняет пользователя внутри вашего продукта и может предоставить единое место для навигации, поиска, обзора и других включённых функций.
Создание слоя рендеринга самостоятельно сложно, потому что каждый формат имеет свои правила:
- PDF‑файлы могут содержать встроенные шрифты, аннотации, формы и очень большие наборы страниц.
- Файлы Word, Excel и PowerPoint требуют тщательной работы с макетом и шрифтами.
- Чертежи CAD нуждаются в точном масштабировании, слоях и детальном зуме.
- Форматы электронной почты и изображений вводят вложения, метаданные, цвет и вопросы разрешения.
Специальный SDK позволяет команде приложения сосредоточиться на контроле доступа, рабочих процессах и пользовательском опыте, вместо поддержки отдельного рендерера для каждого поддерживаемого формата.
Шаг 1: Подтвердите требуемые форматы и функции
Начните с реального инвентаря файлов, которые открывают ваши пользователи. Разделите обязательные форматы от случайных и зафиксируйте представительные образцы для тестирования.
Ваш контрольный список может включать:
- PDF и XPS документы
- Текстовые документы
- Таблицы
- Презентации
- Чертежи CAD
- Файлы электронной почты
- Распространённые форматы изображений
Затем определите функции, важные для каждого рабочего процесса. Просмотр, поиск по тексту, аннотации, печать и конвертация — это разные возможности, которые могут требовать различных компонентов Doconut или лицензий.
Изучите текущий объём продукта на проверенной странице просмотра Doconut, прежде чем фиксировать формат или функцию. Возможности продукта могут изменяться, поэтому ваши приёмочные тесты должны оставаться окончательным источником истины для документов, которые действительно используют ваши клиенты.
Шаг 2: Выберите, откуда документы попадают в приложение
ASP.NET‑приложение может получать документы из нескольких контролируемых источников:
- Загрузка, обработанная как
IFormFileв ASP.NET Core - Защищённое расположение файлов
- База данных или репозиторий управления документами
- Объектное хранилище, к которому обращается сервер
- Внутренний сервис, возвращающий
Stream
Рабочий процесс просмотра должен использовать серверно‑авторизованную ссылку на документ. Не размещайте учётные данные хранилища, неограниченные пути к файлам или постоянные публичные URL‑адреса в разметке клиентской части.
Если пользователи загружают файлы, проверяйте их перед рендерингом. Проверяйте размер файла, расширение, сигнатуру и любые бизнес‑специфические ограничения. Сохраняйте сгенерированный сервером идентификатор, а не полагайтесь на оригинальное имя файла как на путь.
Шаг 3: Определите аутентификацию и авторизацию
Приложение — а не пользовательский интерфейс просмотрщика — должно решать, кто имеет право открыть документ.
В ASP.NET Core стандартные механизмы, такие как middleware аутентификации, атрибут [Authorize], политики, претензии и авторизация на основе ресурсов, могут защищать конечную точку, запускающую сеанс просмотра. Решение об авторизации должно учитывать как текущего пользователя, так и запрашиваемый документ.
Безопасный поток запросов выглядит так:
- Пользователь запрашивает документ, используя идентификатор уровня приложения.
- Сервер аутентифицирует пользователя.
- Сервер проверяет, может ли пользователь получить доступ к конкретному документу.
- Сервер определяет защищённое место хранения.
- Просмотрщик получает только информацию, необходимую для этой авторизованной сессии.
Никогда не полагайтесь на скрытие кнопки панели инструментов как механизм авторизации. Проверки доступа на стороне сервера остаются обязательными, даже если элементы управления загрузкой или печатью не отображаются.
Шаг 4: Добавьте Doconut через официальные ресурсы интеграции
Используйте текущий пакет и инструкции по настройке, предоставленные Doconut. Проверенная страница загрузки Doconut даёт доступ к ресурсам NuGet, документации, примерам и демо‑версии.
Точная настройка может зависеть от:
- Типа вашего ASP.NET или .NET приложения
- Выбранного продукта Doconut и плагинов
- Версии Doconut
- Вашей лицензии
- Форматов документов и функций, которые вы включаете
- Конфигурации вашего Windows‑сервера
Следуйте документации, соответствующей установленному релизу. Избегайте копирования фрагментов инициализации из несвязанных блог‑постов, потому что пространства имён, конфигурация, пути к ресурсам и API могут изменяться между версиями.
Шаг 5: Создайте отдельный слой просмотра
Разместите просмотр документов за небольшим сервисом приложения, а не вызывайте функции SDK по всему коду контроллеров и UI‑компонентов.
Этот сервис может отвечать за:
- Разрешение авторизованного идентификатора документа
- Открытие документа как контролируемого
Stream, когда это необходимо - Предоставление требуемой конфигурации просмотра
- Освобождение файлов и потоков
- Преобразование технических сбоев в безопасные ошибки приложения
- Запись операционных метрик без логирования содержимого документов
Такой граница упрощает обновления и снижает риск раскрытия деталей хранилища в слое представления. Она также даёт тестам чёткое место для подмены безопасной реализации.
Шаг 6: Спроектируйте страницу просмотрщика
Просмотрщик должен иметь достаточно места, чтобы быть полезным. Узкая карточка, окружённая несвязанными элементами управления, делает работу с большими таблицами и чертежами CAD неудобной.
Планируйте страницу вокруг:
- Стабильной высоты просмотрщика
- Ясных состояний загрузки, пустоты и ошибки
- Краткого заголовка документа
- Управления, доступного с клавиатуры
- Макета, который не скрывает важные элементы управления просмотрщиком
- Явного способа вернуться к родительскому рабочему процессу
Тестируйте с длинными именами файлов, большим числом страниц, широкими таблицами, детальными чертежами и документами, которые не удаётся отобразить. Состояние ошибки не должно раскрывать пути к серверу, трассировки исключений или URL‑адреса хранилища.
Шаг 7: Управляйте файлами и временными данными
Определите политику удержания до развертывания. Рассмотрите оригинальный файл, временные данные рендеринга, кэши, экспорты, аннотации и журналы отдельно.
Полезные меры предосторожности включают:
- Выделенный временный каталог с ограниченными правами доступа
- Уникальные имена, генерируемые сервером
- Очистку после завершённых и неудачных сессий
- Плановый процесс для удалённых «заброшенных» временных файлов
- Квоты хранилища и мониторинг
- Шифрование «на диске», если это требует ваша политика безопасности
Сделайте очистку наблюдаемой. Если удаление происходит тихо, временные файлы могут накапливаться и стать как операционной, так и безопасностной проблемой.
Шаг 8: Настройте производственные меры защиты
Рендеринг документов может потреблять CPU, память и временное дисковое пространство. Защитите приложение явными ограничениями:
- Максимальный размер загрузки
- Максимальное количество одновременных задач рендеринга
- Тайм‑ауты запросов и обработки
- Ограничения очереди, когда рендеринг выполняется асинхронно
- Квоты временного хранилища
- Проверки работоспособности и структурированный мониторинг ошибок
Для больших или непредсказуемых нагрузок изолируйте рендеринг от процессов, чувствительных к задержкам. Измеряйте с документами, похожими на реальные, а не только с небольшими тестовыми файлами.
Шаг 9: Протестируйте полный рабочий процесс
Успешный интеграционный тест должен охватывать больше, чем «показалась первая страница».
Тестируйте:
- Каждый требуемый формат файла
- Маленькие, большие, многостраничные и повреждённые файлы
- Документы с редкими шрифтами
- Защищённые паролем файлы, если ваш процесс их поддерживает
- Авторизованных и неавторизованных пользователей
- Одновременные сеансы просмотра
- Перезапуски приложения и прерванные запросы
- Очистку после успеха и неудачи
- Функции просмотрщика, включённые в выбранную конфигурацию продукта
Храните версионированную коллекцию очищенных тестовых документов. Пере‑запускайте её при обновлении Doconut, .NET, Windows Server, инфраструктуры хранилища или сопутствующих зависимостей.
Чек‑лист безопасности
Перед выпуском убедитесь, что:
- Каждый запрос просмотра требует аутентификации, где это необходимо.
- Для конкретного документа проверяется авторизация.
- Ввод, контролируемый пользователем, не может стать неограниченным серверным путём к файлу.
- Учётные данные хранилища никогда не попадают к клиенту.
- Ограничения загрузки и проверка включены.
- Временные файлы имеют ограниченный доступ и проверенную политику очистки.
- Журналы исключают содержимое документов, секреты и чувствительные URL‑адреса.
- Сообщения об ошибках, показываемые пользователям, отфильтрованы.
- Управление просмотрщиком может поддерживать ваш бизнес‑процесс, но не может предотвратить каждый способ захвата информации после того, как она стала видимой уполномоченному пользователю. Используйте их вместе с контролем доступа и соответствующей политикой защиты информации.
Где Doconut вписывается
Doconut предоставляет возможность просмотра документов внутри .NET‑приложения, в то время как ваше приложение остаётся ответственным за идентификацию, авторизацию, хранение файлов, удержание, аудит и окружающий рабочий процесс.
Такое разделение обязанностей даёт командам .NET практический путь поддержки бизнес‑документов без создания множества движков рендеринга с нуля. Оно также сохраняет детали интеграции, специфичные для продукта, привязанными к официальной документации версии, которую вы развёртываете.
Изучите SDK просмотра документов Doconut для .NET, а затем используйте официальные ресурсы загрузки и документации для оценки его с вашими собственными документами.
Заключение
Надёжный встроенный просмотрщик документов начинается с чётких требований к форматам и безопасного серверного потока документов. Проверяйте ввод, авторизуйте каждый запрос, изолируйте доступ к SDK за сервисом приложения, планируйте очистку временных файлов и тестируйте с реалистичными документами.
При наличии этих основ Doconut может обеспечить слой просмотра для вашего веб‑приложения на Windows‑based .NET, пока ваша команда сохраняет контроль над архитектурой приложения и жизненным циклом документов.