Обзор Telerik Document Processing: создание, конвертация и обработка документов в.NET
Telerik Document Processing — коммерческий набор UI-независимых .NET-библиотек Progress для программного создания, импорта, изменения и экспорта документов. Это SDK, а не настольный PDF-редактор: библиотеку подключают к приложению или серверной службе, и документ обрабатывается кодом без установленного Microsoft Office или Adobe Acrobat. На 11 сентября 2026 года последняя публичная версия — 2026.3.826 от 26 августа 2026 года.
| Параметр | Актуальные сведения |
|---|---|
| Разработчик и бренд | Progress Software, линейка Telerik |
| Тип продукта | Коммерческие UI-независимые библиотеки для .NET |
| Актуальная версия | 2026.3.826, 26 августа 2026 года |
| Целевые среды | .NET Framework 4.6.2–4.8, современный .NET 8–10, .NET Standard 2.0; есть Windows-ориентированное и кроссплатформенное семейства пакетов |
| Распространение | NuGet-пакеты и загрузки в аккаунте Telerik; библиотеки входят в ряд Telerik UI и DevCraft-продуктов |
| Пробный режим | 30-дневная пробная лицензия; пробные сборки функциональны, но добавляют сообщение об оценочной версии в создаваемые документы |
Скачать Telerik Document Processing
Новейшая версия для Виндовс, macOS и Линукс. Удобный редактор PDF под российские реалии.
Для нового проекта безопасный и наиболее прямой путь — брать пакеты из официальной поставки Progress. С Q2 2026 документация рекомендует NuGet.org как обычный источник для новых установок, поэтому для типичного проекта не нужно настраивать отдельный Telerik NuGet feed. Базовая схема начинается с пакета Telerik.Licensing, затем добавляется Telerik.Documents.Core и только те библиотеки, которые действительно нужны: Telerik.Documents.Fixed для PDF, Telerik.Documents.Flow для потоковых документов, Telerik.Documents.Spreadsheet для электронных таблиц или Telerik.Documents.SpreadsheetStreaming для потоковой генерации больших таблиц.
Альтернативный официальный канал — Downloads в аккаунте Telerik: там доступны актуальные и предыдущие сборки, NuGet-пакеты и, при соответствующих правах, дополнительные файлы продукта. Для пробного доступа нужен Telerik-аккаунт и 30-дневная trial-лицензия.
При выборе пакетов важно не смешивать два семейства. Для современных кроссплатформенных приложений, ASP.NET Core, Blazor, сервисов и сценариев Linux/macOS Progress рекомендует имена Telerik.Documents.*. Для .NET Framework и Windows-ориентированных проектов существует семейство Telerik.Windows.Documents.*. Все пакеты Document Processing внутри одного проекта следует держать на одной версии: смешивание, например, Core одной ветки и Fixed другой создаёт ненужный риск несовместимости и ошибок лицензирования.
Что такое Telerik Document Processing
Официальное название продукта — Telerik Document Processing Libraries, часто сокращаемое до Telerik Document Processing или DPL. Разработчик — Progress Software Corporation, которой принадлежит бренд Telerik. Назначение пакета — программное создание, импорт, изменение, конвертация и экспорт документов внутри .NET-приложений. Библиотеки UI-independent: они не требуют визуального компонента и одинаково применимы в серверном API, фоновой задаче, консольной утилите, веб-приложении или пользовательском интерфейсе, который разработчик строит отдельно.
В актуальной документации ядро представлено пятью библиотеками. RadPdfProcessing работает с фиксированной моделью PDF; RadWordsProcessing — с потоковыми документами наподобие Word; RadSpreadProcessing — с рабочими книгами и таблицами; RadSpreadStreamProcessing — с потоковым созданием больших XLSX и CSV; RadZipLibrary — с ZIP-архивами. В 2026 году поверх этого набора развиваются AI Connector и Agent Tools, которые дают специализированные операции для документных агентов, но они не превращают SDK в отдельный чат-сервис и не заменяют базовые библиотеки.
С точки зрения жизненного цикла продукт активен. В 2026 году выходили релизы 2026.1, 2026.2 и 2026.3, а 26 августа опубликована версия 2026.3.826 с изменениями и исправлениями PdfProcessing. Это не архивная линейка и не снятая с поддержки программа. При этом отдельные старые статьи о Trial/Developer DLL и прежнем механизме лицензий относятся к исторической схеме: начиная с релизов 2025 года Progress применяет ключ лицензии и пакет Telerik.Licensing, поэтому описывать старые Trial/Dev DLL как текущую основную модель неверно.
Основные функции Telerik Document Processing
PDF: создание, импорт, формы, подписи и защита
RadPdfProcessing создаёт PDF с нуля, импортирует существующие PDF и экспортирует изменённую модель обратно. API охватывает текст, изображения, геометрию, страницы, закладки, аннотации, вложенные файлы и интерактивные AcroForm-поля. Формы можно заполнять и затем «сплющивать»: визуальное значение остаётся на странице, а интерактивное поле удаляется, что полезно при подготовке финального экземпляра договора или анкеты.
Для цифровых подписей библиотека работает с X.509-сертификатами, умеет добавлять поле подписи, подписывать существующее поле и проверять подписи. В актуальной документации также описано множественное подписание через PdfStreamSigner и поддержка сервера меток времени. Для .NET Standard и современного .NET цифровая подпись требует System.Security.Cryptography.Pkcs версии 6 или новее. Управление центрами сертификации и выдача сертификата не входят в задачу DPL: приложение должно получить корректный сертификат и закрытый ключ отдельно.
Защита PDF включает импорт RC4 V2, AES-128 и AES-256 и экспорт с RC4 V2 или AES-256. Пароль и разрешения позволяют ограничить открытие и отдельные действия с документом. Для архивных и доступных документов предусмотрены режимы соответствия PDF/A и PDF/UA в PdfProcessing, но соответствие нельзя считать автоматическим свойством любого результата: структура исходных данных и выбранный путь конвертации влияют на семантику.
Word-подобные документы и конвертация
RadWordsProcessing оперирует собственной потоковой моделью документа: секциями, абзацами, фрагментами текста, таблицами, изображениями, стилями и другими структурными объектами. Она создаёт и изменяет DOCX, RTF, HTML, TXT и Markdown, а DOC и DOT импортирует. Экспорт потокового документа в PDF подключается отдельным формат-провайдером. Установка Microsoft Word или Office на клиенте или сервере для этих операций не требуется.
Электронные таблицы и вычисления
RadSpreadProcessing создаёт и редактирует книги, листы, ячейки, стили, диапазоны, формулы и другие элементы электронной таблицы без установленного Excel. Основные рабочие форматы — XLSX, XLS, XLSM, CSV и TXT; PDF доступен как экспорт. Для JSON в актуальном перечне пакетов предусмотрен экспорт, но не импорт. Для XLSM важно ограничение: макросы могут сохраняться при импортно-экспортном цикле, однако библиотека не исполняет и не изменяет VBA-макросы.
Потоковая генерация больших XLSX и CSV
RadSpreadStreamProcessing решает другую задачу: последовательное формирование очень больших таблиц с меньшим объёмом удерживаемых в памяти объектов. Progress позиционирует библиотеку для XLSX и CSV с объёмом вплоть до более миллиона строк. Выигрыш достигается ценой модели доступа: потоковый API ориентирован на последовательное создание данных, поэтому это не замена RadSpreadProcessing, когда нужно свободно ходить по существующей книге, менять произвольные ячейки и сложные объекты.
OCR для сканированных изображений
OCR встроен в контур PdfProcessing через OcrFormatProvider. Типовой результат — распознать изображение страницы и получить RadFixedPage, который затем помещается в PDF, превращая скан в документ с поисковым текстом. Стандартная реализация использует Tesseract и официально поддерживается на Windows и Linux; для других сред можно реализовать собственный OCR-провайдер. Progress рекомендует входные изображения около 300 DPI для лучших результатов.
AI Document Insights и Agent Tools
В актуальной ветке есть GenAI-powered Document Insights для PDF, Word-подобных документов и таблиц, а также Agent Tools для операций над PDF, spreadsheet и конвертацией. Эти функции требуют отдельных пакетов AIConnector/AI.Tools и выбранного AI-провайдера. Официальные примеры предусматривают Azure OpenAI, прямой OpenAI и Ollama. Если используется облачный провайдер, политика передачи содержимого определяется уже выбранной AI-службой и архитектурой приложения; при Ollama модель может работать локально.
Интерфейс и удобство использования
У Telerik Document Processing нет собственной рабочей области в привычном смысле: отсутствуют панели инструментов, дерево страниц и диалог «Сохранить как». Пользователь продукта — разработчик, а «интерфейсом» служат классы .NET, формат-провайдеры, NuGet-пакеты, IntelliSense, документация и набор онлайн-демо. Поэтому оценка удобства зависит не от дизайна кнопок, а от того, насколько предсказуемо API разделяет документную модель, импорт, редактирование и экспорт.
Логика достаточно последовательна. Для PDF приложение импортирует поток в RadFixedDocument, меняет объектную модель и экспортирует её провайдером. Для Word-подобных файлов используется RadFlowDocument, для таблиц — Workbook, а для больших выгрузок — отдельный потоковый writer. Такое разделение помогает не тащить в проект лишнюю модель, но требует понять разницу между Fixed, Flow, Spreadsheet и Streaming. Ошибка выбора особенно заметна в таблицах: SpreadProcessing даёт богатую модель, тогда как SpreadStreamProcessing сознательно ограничивает произвольный доступ ради памяти и скорости генерации.
Порог входа выше, чем у настольного конвертера, потому что без C# или VB.NET продукт практически не имеет самостоятельной ценности. В то же время готовые NuGet-пакеты и небольшие примеры позволяют быстро собрать минимальный сценарий. Для команды, уже работающей с Telerik UI, дополнительный плюс состоит в общей экосистеме лицензирования и поддержки. Для проекта, которому нужна только одна кнопка «DOCX в PDF» без собственного приложения, SDK создаёт лишний инженерный слой.
Поддерживаемые форматы и совместимость
| Библиотека | Импорт и редактирование | Экспорт | Существенные ограничения |
|---|---|---|---|
| RadPdfProcessing | PDF; изображения через OCR как источник страницы | PDF, текст, изображения в поддерживаемом сценарии | XFA сохраняется как пакет данных, но полноценного XFA-движка, рендеринга и авторинга нет |
| RadWordsProcessing | DOCX, RTF, HTML, TXT, Markdown; DOC и DOT — импорт | DOCX, RTF, HTML, TXT, Markdown, PDF | DOC и DOT не указаны как форматы экспорта |
| RadSpreadProcessing | XLSX, XLS, XLSM, CSV, TXT | XLSX, XLS, XLSM, CSV, TXT, PDF, JSON | JSON — только экспорт; VBA в XLSM сохраняется, но не выполняется и не редактируется |
| RadSpreadStreamProcessing | Ориентирован на потоковое создание, не на полноценное редактирование существующей книги | XLSX, CSV | Последовательная модель доступа вместо богатого объектного редактирования |
| RadZipLibrary | ZIP | ZIP | С Q2 2025 другие библиотеки больше не используют её как внутреннюю зависимость и опираются на System.IO.Compression |
Для PDF-интерактивных форм основная поддерживаемая модель — AcroForm. Актуальная документация от сентября 2026 года уточняет работу с XFA: пакет XFA можно импортировать, инспектировать как сырые данные и при настройке сохранить при экспорте, но библиотека не предоставляет полноценную объектную модель XFA, не выполняет XFA-скрипты, не пересчитывает динамическую разметку и не редактирует XFA как семантическую форму. Если бизнес-процесс зависит от старых динамических XFA, это нужно считать ограничением совместимости, а не обычным PDF-сценарием.
С доступностью также есть нюансы. У PdfProcessing есть инструменты для тегированных PDF и PDF/UA, но официальный VPAT показывает, что семантика зависит от пути. Прямое построение PDF через PdfProcessing предоставляет значительно больше контроля, тогда как конвертация из WordsProcessing может терять часть семантики таблиц и ссылок, а PDF из SpreadProcessing не эквивалентен полноценному доступному табличному документу. Для юридически значимого требования WCAG/PDF/UA итоговый файл нужно проверять специализированным валидатором.
Производительность и стабильность
Progress не публикует в основной документации универсального показателя «страниц в секунду» или фиксированного потребления памяти, поэтому корректно сравнивать архитектурные свойства, а не выдуманные цифры. Для массового экспорта таблиц самым явным механизмом оптимизации является RadSpreadStreamProcessing: он спроектирован для больших XLSX/CSV и минимизации памяти за счёт потоковой записи. Для полнофункционального редактирования Workbook приходится платить более высокой ценой объектной модели.
Публичный журнал релизов показывает регулярные сервисные обновления в течение 2026 года, поэтому обновлять DPL лучше вместе с регрессионным набором собственных PDF, DOCX и XLSX. Исправления затрагивают разные подсистемы, а отсутствие универсального эталона документа делает такую проверку надёжнее абстрактного номера версии.
На практике крупный файл следует оценивать по типу содержимого. Миллион простых строк CSV и книга с формулами, изображениями, условным форматированием и внешними связями создают совершенно разную нагрузку. То же относится к PDF: сотни страниц текста отличаются от файла с тяжёлыми векторными путями и шрифтами. Поэтому системные минимумы Progress нельзя использовать как расчёт production-сервера; ресурсы подбираются по реальным документам, степени параллелизма и выбранной библиотеке.
Хронология развития и поддержки
Q1 2025: в актуальной схеме появляется новый механизм лицензирования через ключ и Telerik.Licensing; в этот же период PdfProcessing получает OCR. Старые инструкции, основанные на разделении Trial и Developer DLL, относятся к прежней модели.
Q2 2026: актуальные пакеты Document Processing становятся доступны на NuGet.org, который Progress рекомендует как основной источник для новых проектов.
Q3 2026: текущая документация фиксирует поддержку .NET 10, а 26 августа выходит 2026.3.826 — последний публичный релиз на дату обзора.
Roadmap Progress также предупреждает о планируемом прекращении поддержки .NET 8 и .NET 9 в ноябре 2026 года вслед за жизненным циклом Microsoft и о переходе к .NET 10/11. Для нового долгоживущего сервиса это аргумент не начинать миграцию на DPL с устаревающей целевой платформы, даже если она ещё поддерживается в сентябре 2026 года.
Лицензирование и версии
Telerik Document Processing — коммерческий продукт. Он лицензируется не как отдельная бесплатная библиотека, а в соответствии с Telerik-продуктом или DevCraft-набором, через который получены пакеты. Официальный перечень включает, в частности, UI for ASP.NET Core, ASP.NET MVC, ASP.NET AJAX, Blazor, .NET MAUI, WPF и WinForms, а также DevCraft. Пакеты можно использовать без визуальных компонентов, но право использования всё равно определяется приобретённой лицензией.
Для новых покупок на текущей странице Progress основной моделью является годовая подписка на разработчика. Самый дешёвый из отображаемых путей через подходящий индивидуальный Telerik UI-продукт начинается с 749 долларов за разработчика в год с Lite Support; DevCraft UI указан по 1149 долларов за разработчика в год. Это не следует читать как отдельный «ценник Telerik Document Processing»: DPL входит в соответствующий набор. Корпоративные условия, налоги и предложения для нескольких разработчиков могут отличаться.
Пробный период заявлен как 30 дней и даёт доступ к полной функциональности и технической поддержке. Документация по ограничениям trial уточняет, что пробные пакеты добавляют copyright-сообщение в создаваемые документы: в PDF и потоковых форматах оно появляется сверху, а в XLSX — на отдельном листе. После окончания 30-дневного trial ключ считается истёкшим; сборка и запуск сопровождаются предупреждениями и визуальными индикаторами лицензирования. Поэтому пробный режим подходит для технической оценки, но не для выпуска чистых production-документов.
Карта критических зависимостей
| Зависимость | Когда нужна | Что произойдёт при ошибке |
|---|---|---|
| Telerik.Licensing и действующий ключ | Для trial и коммерческого использования актуальных выпусков | Предупреждения сборки, водяные знаки или иные индикаторы невалидной лицензии |
| Единая версия Telerik.Documents.* | Всегда в одном проекте | Риск несовместимости API и зависимостей |
| SkiaSharp и NativeAssets | Кроссплатформенная обработка изображений, часть PDF-экспорта и рендеринга | Ошибка обработки изображения или невозможность экспорта конкретного содержимого |
| Tesseract, Leptonica и tessdata | Стандартный OCR | OCR не запускается либо не распознаёт выбранный язык |
| Font provider и доступные шрифты | Кроссплатформенный PDF-экспорт с нестандартными шрифтами | Подстановка шрифта, изменение метрик или сбой формирования результата |
| AI-провайдер | Только Document Insights и Agent Tools | Обычная работа PDF/Word/Excel остаётся возможной, но AI-сценарий недоступен |
Для приватности особенно важно разделять базовую обработку и AI. Обычные операции выполняются библиотеками внутри приложения и не требуют Adobe, Office или облачного конвертера. Лицензия валидируется офлайн. Передача содержимого наружу появляется только тогда, когда архитектура сама подключает внешнюю службу — например, OpenAI или Azure OpenAI для Document Insights. При локальном Ollama можно построить AI-контур без передачи документа в публичный LLM API, хотя безопасность такой конфигурации всё равно зависит от окружения приложения.
Системные требования
.NET и Windows-ветка
Официальная страница системных требований указывает .NET Framework 4.6.2–4.8 и .NET 8–10 для Windows. В списке сред разработки присутствуют Visual Studio вплоть до 2026. Для Windows перечислены как современные, так и старые версии ОС, совместимые с поддерживаемыми .NET Framework-сценариями; для нового проекта разумно ориентироваться не на исторический минимум ОС, а на жизненный цикл выбранного .NET и корпоративную политику безопасности.
Кроссплатформенная ветка
Пакеты Telerik.Documents.* имеют вариант .NET Standard 2.0 и документированы для .NET 8, .NET 9 и .NET 10, включая Linux/macOS workloads, ASP.NET Core, Blazor, службы и консольные приложения. Конкретный хост должен поддерживать выбранный .NET runtime. Если проект использует изображения, OCR или другие нативные возможности, дополнительно проверяются NativeAssets SkiaSharp и нативные библиотеки Tesseract для целевой ОС.
Формальный минимум оборудования
Progress указывает процессор x86/x64 1 ГГц, минимум 512 МБ RAM, рекомендуемый 1 ГБ и до 4,5 ГБ диска. Эти цифры следует воспринимать как формальный минимум среды установки, а не как sizing production-сервиса. Реальное потребление зависит от размера документов, сложности графики, количества формул, числа одновременно обрабатываемых задач и выбранной модели — объектной или потоковой.
Преимущества и недостатки Telerik Document Processing
Плюсы и минусы
• Обработка без Office и Acrobat. Документы создаются и меняются внутри .NET-процесса, что устраняет зависимость от настольной автоматизации.
• Единый набор для PDF, Word-подобных файлов и таблиц. Один стек закрывает типовые серверные задачи с PDF, DOCX, XLSX, CSV и сопутствующими форматами.
• Кроссплатформенная современная ветка. Есть пакеты Telerik.Documents.* для .NET Standard и современного .NET, включая серверные Linux/macOS-сценарии.
• Специализированный потоковый экспорт таблиц. SpreadStreamProcessing рассчитан на большие XLSX/CSV с меньшей памятью, чем полноценная объектная книга.
• PDF-функции уровня SDK. AcroForm, подписи, шифрование, PDF/A, PDF/UA, аннотации, закладки и работа со страницами доступны программно.
• OCR с заменяемым провайдером. Стандартный Tesseract подходит для Windows/Linux, а интерфейс позволяет подменить движок.
Минусы
• Это не готовое приложение. Без разработки на .NET нет интерфейса для открытия, ручного редактирования или конвертации файлов.
• Коммерческая лицензия. Бесплатной production-редакции нет; trial маркирует создаваемые документы.
• Форматы поддерживаются несимметрично. DOC/DOT — импорт, JSON — экспорт, PDF из WordsProcessing/SpreadProcessing — в основном экспортный путь.
• XFA поддерживается ограниченно. Сырые XFA-пакеты можно сохранить, но полноценного движка XFA, скриптов и динамической разметки нет.
• Кроссплатформенность требует настройки нативных зависимостей. SkiaSharp, NativeAssets, шрифты и Tesseract нужно корректно разворачивать под ОС.
Сравнение с аналогами
| Решение | Тип | Word/Excel | Лицензирование | Когда выбирать | |
|---|---|---|---|---|---|
| Telerik Document Processing | .NET SDK | Создание, импорт, редактирование, формы, подписи, OCR | DOCX/RTF/HTML/TXT/Markdown и XLSX/XLS/XLSM/CSV | Коммерческая лицензия Telerik, trial 30 дней | Когда .NET-проекту нужен единый серверный стек и уже используется Telerik |
| Syncfusion Document SDK | .NET SDK | Широкая PDF-библиотека, OCR, подписи, конвертация | Word, Excel и дополнительно PowerPoint/Markdown | Коммерческая; есть Community License для соответствующих малых организаций | Когда важны PowerPoint, Markdown или более широкий единый Document SDK |
| Aspose.Total for .NET | Набор .NET API | Aspose.PDF | Aspose.Words, Aspose.Cells и другие библиотеки семейства | Коммерческая, есть оценочный режим | Когда нужно очень широкое покрытие форматов за пределами PDF/Word/Excel |
| iText Core | PDF SDK для .NET и Java | Глубокая программная работа с PDF | Не является единым Word/Excel SDK | Двойная модель AGPL или коммерческая | Когда задача сосредоточена именно на PDF и приемлема модель iText |
| Sumatra PDF | Настольный просмотрщик Windows | Быстрый просмотр, навигация, печать и базовые действия чтения | Не серверный SDK для DOCX/XLSX | Бесплатное открытое ПО | Когда документ нужно открыть человеку, а не генерировать или конвертировать кодом |
С Sumatra PDF прямое сравнение корректно только на уровне конечного результата. Telerik DPL создаёт и преобразует файлы внутри приложения, а Sumatra PDF их показывает пользователю. Если задача — просто читать PDF на Windows, писать собственный интерфейс вокруг SDK бессмысленно: готовый просмотрщик проще. Если приложение должно автоматически выпускать тысячи персонализированных PDF или XLSX на сервере, Sumatra PDF уже не решает эту задачу.
Аналогично настольные редакторы закрывают иной класс потребностей. Для ручного редактирования PDF без программирования логичнее смотреть на Adobe Acrobat Pro или PDF-XChange Editor. Если основной процесс — распознавание сканов оператором, уместнее отдельный OCR-продукт уровня ABBYY FineReader. Для пользовательской работы с DOCX вместо разработки SDK можно рассмотреть LibreOffice Writer, а для локального набора PDF-утилит на Windows — PDF24 Creator.
Паспорт обратимости операций
| Операция | Что сохраняется | Что может стать необратимым | Как контролировать |
|---|---|---|---|
| Импорт PDF и повторный экспорт | Поддерживаемые страницы, контент, формы, закладки, вложения и другие распознанные объекты | Неподдерживаемые или нестандартные конструкции; XFA не становится редактируемой моделью | Хранить исходник и сравнивать структуру/визуальный результат в целевом viewer |
| Flatten AcroForm | Видимые значения полей | Интерактивность полей удаляется | Сохранять незаплющенный оригинал до финального утверждения |
| DOCX/HTML/RTF в PDF | Визуальная структура в пределах поддерживаемой модели | PDF не восстанавливает исходную редактируемую потоковую семантику один к одному | Считать DOCX/HTML мастер-файлом, PDF — публикационным результатом |
| XLSX в PDF | Отрисованный вид листов | Формулы и редактируемые ячейки превращаются в фиксированное представление | Хранить XLSX как источник данных |
| OCR скана | Изображение страницы можно оставить вместе с распознанным текстом | Ошибки распознавания становятся частью поискового слоя, если их не валидировать | Проверять выборку терминов, чисел и имён после OCR |
| XLSM import/export | Макросы могут сохраняться в файле | SDK не выполняет и не редактирует VBA | Тестировать файл в целевом Excel-клиенте и не считать DPL макро-движком |
Инструкция по установке
Новый кроссплатформенный проект .NET
1. Создайте проект на поддерживаемом современном .NET; для нового внедрения в сентябре 2026 года рационально целиться в .NET 10.
2. Добавьте из NuGet пакеты Telerik.Licensing и Telerik.Documents.Core, затем нужный модуль: Fixed для PDF, Flow для DOCX/RTF/HTML/TXT/Markdown, Spreadsheet для книг или SpreadsheetStreaming для потокового XLSX/CSV.
3. Зафиксируйте одинаковую версию всех пакетов Telerik.Documents.*; для актуальной ветки это 2026.3.826.
4. Поместите telerik-license.txt в %AppData%/Telerik на Windows, ~/.telerik на macOS/Linux либо в корень проекта. Для CI/CD используйте deployment key или переменную TELERIK_LICENSE и не коммитьте секрет.
5. Восстановите зависимости, соберите проект и экспортируйте минимальный тестовый документ. В журнале сборки не должно быть предупреждений лицензирования, а результат должен открываться независимым приложением.
Windows-проект на .NET Framework
Для существующего .NET Framework-проекта используйте семейство Telerik.Windows.Documents.* и Telerik.Licensing. Подбирайте Core и форматные модули одной версии. Ручное подключение DLL поддерживается для старых проектов, но при возможности предпочтителен NuGet.
Дополнительная установка для OCR и изображений
Для OCR добавьте пакет формат-провайдера OCR и Telerik.Documents.TesseractOcr, разверните tessdata и языковые traineddata. На Linux установите Tesseract/Leptonica и проверьте имена нативных библиотек. Для кроссплатформенного PDF-экспорта с PNG, другими форматами изображений или изменённым качеством добавьте Telerik.Documents.ImageUtils, SkiaSharp и подходящий SkiaSharp.NativeAssets.*. Для Blazor WebAssembly требования отличаются, поэтому стандартный Tesseract нельзя считать автоматически доступным.
Первый запуск и проверка лицензии
Отдельного первого запуска у SDK нет: запускается ваше приложение. Контроль — успешная сборка без TKL-предупреждений, отсутствие trial-метки при коммерческой лицензии и корректное открытие созданного файла.
Безопасное удаление
Для удаления уберите PackageReference на Telerik.Documents.* или Telerik.Windows.Documents.*, а Telerik.Licensing удаляйте только если его не используют другие Telerik-компоненты. После восстановления зависимостей удалите обращения к API и пересоберите проект. Файл лицензии из пользовательского профиля автоматически не стирайте: он может быть нужен другим проектам. Уже созданные PDF, DOCX и XLSX остаются обычными файлами.
Практические кейсы
Серверная генерация PDF-счёта
Цель. Сформировать PDF-счёт в ASP.NET Core. Подготовка. Подключить Fixed, Core, Licensing и доступные шрифты. Шаги. Создать RadFixedDocument, добавить страницы, текст, таблицу и изображения, затем экспортировать новый поток. Проверка. Открыть файл независимым viewer и сверить суммы, шрифты и страницы. Ограничение. Для сложной автоматической вёрстки удобнее flow-модель с последующим экспортом в PDF.
Конвертация DOCX-шаблона в PDF
Цель. Выпустить неизменяемую копию договора. Подготовка. Подключить WordsProcessing, PDF-провайдер и нужные шрифты. Шаги. Импортировать DOCX в RadFlowDocument, заменить значения в шаблоне и экспортировать PDF. Проверка. Сверить переносы, таблицы, колонтитулы и шрифты. Ограничение. Обратный PDF→DOCX не является симметричной штатной операцией этого пути.
Выгрузка большого реестра в XLSX
Цель. Выгрузить большой набор строк без полной книги в памяти. Подготовка. Подключить SpreadsheetStreaming и определить колонки. Шаги. Последовательно записать строки и ячейки, применить необходимые стили и завершить поток. Проверка. Открыть XLSX и сверить число строк, типы дат и чисел. Ограничение. Для произвольного редактирования существующей книги нужен RadSpreadProcessing.
Создание поискового PDF из сканов
Цель. Добавить текстовый слой к сканам. Подготовка. Windows или Linux, OCR-пакеты, Tesseract/Leptonica и tessdata нужного языка; Progress рекомендует около 300 DPI. Шаги. Настроить TesseractOcrProvider, распознать изображение через OcrFormatProvider, добавить RadFixedPage в документ и экспортировать PDF. Проверка. Найти контрольные слова и сверить скопированный текст со сканом. Ограничение. Значимые номера, суммы и имена требуют отдельной валидации.
Контроль перед сохранением и передачей
• Проверить, что выбран формат-провайдер с поддерживаемым направлением: импорт, экспорт или оба.
• Убедиться, что все Telerik-пакеты имеют одну версию и сборка не выдаёт предупреждений лицензии.
• Проверить доступность шрифтов и изображений именно в production-среде, а не только на машине разработчика.
• Для XLSM убедиться, что бизнес-процесс не рассчитывает на выполнение макросов внутри DPL.
• Для OCR проверить выборку распознанных чисел, имён и терминов, а не только наличие текстового слоя.
• Хранить исходный файл отдельно, если экспорт делает операцию необратимой с точки зрения редактирования.
Часто задаваемые вопросы
Можно ли использовать один ключ в нескольких сборочных конвейерах?
Личный ключ можно использовать в нескольких сборках и средах одного лицензированного разработчика, но у каждого разработчика должен быть свой ключ. Для CI/CD Progress рекомендует deployment key в секрет-хранилище.
Что имеет приоритет: TELERIK_LICENSE или telerik-license.txt?
Если одновременно заданы TELERIK_LICENSE и telerik-license.txt, приоритет имеет переменная окружения. При диагностике это важно: старый секрет CI может перекрыть свежий файл.
Где подключать Telerik.Licensing в решении с отдельной class library?
В схеме «корневое приложение → class library → Telerik» пакет Telerik.Licensing нужно добавить и в корневое приложение: лицензирование не переносится туда транзитивно автоматически.
Что будет с уже развернутым приложением после окончания подписки?
Уже развернутое приложение с подписочной лицензией продолжает работать. При новой сборке с истёкшим ключом появляются предупреждения и визуальные индикаторы, поэтому ключ обновляют перед релизом.
Что произойдёт, если экспортировать документ в уже заполненный Stream?
Актуальная ветка DPL автоматически очищает выходной Stream перед экспортом. Вызывающий код всё равно отвечает за жизненный цикл потока, его позицию и сохранение результата.
Нужен ли Telerik Document Processing получателю готового файла?
Нет. Экспортированные PDF, DOCX, XLSX и другие стандартные файлы открываются совместимыми приложениями; Telerik нужен системе, которая их создаёт или обрабатывает.
Вывод
Telerik Document Processing подходит прежде всего командам .NET, которым нужно встроить в собственный продукт создание, импорт, изменение и конвертацию документов без Office и Acrobat. Самые сильные сценарии — серверная генерация PDF и DOCX, работа с XLSX, массовый потоковый экспорт таблиц, AcroForm и цифровые подписи, OCR на Windows/Linux и интеграция с уже используемой экосистемой Telerik.
Продукт менее удачен, если требуется готовая настольная программа для оператора, полностью бесплатное коммерческое использование, исполнение VBA, полноценная работа со старыми XFA-формами или максимально широкое семейство форматов за пределами PDF/Word/Excel. В этих случаях разумнее выбирать соответственно настольный PDF-редактор, открытый просмотрщик, специализированный OCR-инструмент, Syncfusion/Aspose для более широкого документного стека или iText для глубоко PDF-центричного SDK.