ONLYOFFICE Document Builder: автоматизация DOCX, XLSX, PPTX и PDF из кода

ONLYOFFICE Document Builder — кроссплатформенный SDK и CLI Ascensio System SIA для программного создания, изменения и конвертации документов без графического редактора. Он рассчитан на автоматические процессы: генерацию DOCX из данных, серверные отчёты и выпуск PDF. На 14 сентября 2026 года актуальная публичная версия — 9.4.0 от 20 мая 2026 года.

ПараметрАктуальное состояние
ТипSDK, библиотека и CLI для автоматизации документов
РазработчикAscensio System SIA, проект ONLYOFFICE
Актуальная версия9.4.0, релиз 20 мая 2026 года
ПлатформыWindows, Linux, macOS; пакеты для нескольких архитектур
Основные моделиDOCX, XLSX, PPTX и PDF, плюс более широкий набор форматов импорта и экспорта
Способы использованияJavaScript-сценарии CLI, Builder Framework, HTTP API в составе ONLYOFFICE Docs
Языки интеграцииPython, C++, COM, Java, .NET; серверные примеры также охватывают другие стеки
Графический интерфейсНет: работа ведётся из терминала, IDE или приложения-интегратора
ЛицензированиеИсходный репозиторий AGPL-3.0; бесплатная сборка создаёт файлы с водяным знаком, коммерческая лицензия снимает ограничение
Облако и аккаунтЛокальный SDK не требует облачного редактора; HTTP-вариант зависит от развернутого ONLYOFFICE Docs

Скачать ONLYOFFICE Document Builder

Бесплатно
В реестре российского ПО
Чистая установка

Новейшая версия для Виндовс, macOS и Линукс. Удобный редактор PDF под российские реалии.

⬇ Скачать PDF Commander бесплатно

⬇ Скачать ONLYOFFICE Document Builder

Безопасный путь получения начинается с официальной документации ONLYOFFICE API и репозитория ONLYOFFICE/DocumentBuilder. Страница установки ведёт на публичные release-assets GitHub и перечисляет архивы для Windows, Linux и macOS. Это важное отличие от ONLYOFFICE Desktop Editors: загрузка Builder не должна вести к установщику настольного офисного пакета, потому что у SDK другой состав и другой сценарий запуска.

На Windows доступны SDK-архивы x64 и x86 в ZIP. Для Linux официальная инструкция предлагает архивы x86_64 и aarch64 в формате TAR.XZ. Для macOS предусмотрены x86_64 и arm64. Пользователям Python дополнительно документирован пакет document-builder, который устанавливается через pip. На момент проверки актуальный публичный релиз — 9.4.0; при автоматизированной загрузке разумно привязываться либо к явно выбранной версии, либо к официальному latest-release, а не к зеркалам.

Обязательная регистрация для публичных GitHub-архивов и Python-пакета в инструкции не указана. Коммерческая лицензия нужна для снятия водяного знака бесплатной сборки и предлагается в составе ONLYOFFICE Docs Developer.

Что такое ONLYOFFICE Document Builder

ONLYOFFICE позиционирует Document Builder как Office и PDF SDK для серверных, мобильных и настольных приложений. Его задача — создавать, открывать, менять и преобразовывать документы программно. В основе сценариев используется Office API: тот же объектный подход к документам, таблицам и презентациям, который применяется в экосистеме ONLYOFFICE для макросов и расширений.

Разработчик — Ascensio System SIA. Builder не следует смешивать с ONLYOFFICE Docs, Docs Developer, Desktop Editors или DocSpace: это отдельный компонент автоматизации, используемый через SDK/CLI либо как сервис внутри Docs.

Продукт активно поддерживается. Версия 9.4.0 опубликована в официальном репозитории в мае 2026 года, а журнал изменений показывает последовательные обновления веток 8.x и 9.x, включая исправления безопасности и изменения языковых обвязок. Поэтому относить Builder к снятым с поддержки утилитам или к историческому API нельзя.

Builder не требует Microsoft Office или LibreOffice как внешнего движка. Это упрощает серверную автоматизацию, но не превращает SDK в визуальный редактор.

Основные функции ONLYOFFICE Document Builder

Создание и изменение структуры документа

Через Office API можно создавать текстовые документы, электронные таблицы и презентации, обращаться к их объектам и формировать содержимое из кода. Документация описывает программный доступ к абзацам, таблицам, изображениям, диаграммам, фигурам и другим элементам. Для прикладного разработчика это означает возможность не просто подставить строку в готовый шаблон, а строить структуру отчёта, задавать форматирование, вставлять данные и затем сохранять итог в нужном формате.

Объектная модель предназначена и для изменения существующих файлов: Builder открывает документ, после чего сценарий может извлекать, копировать, заменять, объединять или разделять содержимое средствами API. При этом уровень детализации высокий: разработчик работает не с «печатным» PDF-потоком как с картинкой, а с объектами соответствующего редактора там, где формат допускает такую модель.

Шаблоны и данные из внешней системы

Типовой сценарий — открыть подготовленный DOCX или XLSX, получить данные из приложения или базы и записать их в нужные места. Сам Builder не является CRM, ERP или СУБД и не забирает данные автоматически: интеграционный код должен получить их самостоятельно и передать в сценарий. Для CLI поддерживаются аргументы в JSON, доступные через глобальный объект Argument, поэтому один и тот же шаблон можно запускать с разными наборами входных значений.

Так строятся счета, договоры, акты и регулярные отчёты: шаблон стабилен, данные меняются. Контролировать нужно не только успешный вызов API, но и реально открывающийся итоговый файл.

Конвертация и серверный рендеринг

Конвертация — одна из центральных возможностей Builder. Официальный обзор заявляет более 25 поддерживаемых форматов импорта и экспорта и приводит примеры преобразования DOCX в PDF или JPEG, а также PDF в форматы семейства Word. Отдельно поддерживается рендеринг документа целиком или выбранных страниц, листов и слайдов в PDF или XPS.

Практический конвейер может сохранять и редактируемый Office-файл, и фиксированную PDF-копию. В списке форматов есть PDF/A, но для архивного регламента итог лучше проверять профильным валидатором.

Три режима интеграции

CLI. JavaScript-файл запускается исполняемым файлом Builder. В типичном сценарии вызываются CreateFile или OpenFile, затем операции Office API, после чего SaveFile и CloseFile. Это самый простой путь для пакетных задач, cron/job-очередей и прототипов.

Builder Framework. Библиотека встраивается в приложение. Официально документированы Python, C++, COM, Java и .NET. Базовый класс CDocBuilder управляет файлом и контекстом, а CDocBuilderContext и CDocBuilderValue позволяют передавать данные между нативным кодом и JavaScript-объектами Office API.

Document Builder API. Если уже установлен ONLYOFFICE Docs, генерацию можно вызвать HTTP POST-запросом к пути docbuilder. Сервер получает URL JavaScript-сценария, выполняет его и возвращает URL созданных файлов. Доступен синхронный и асинхронный режим; во втором случае клиент получает ключ и опрашивает сервис до завершения.

Работа с несколькими файлами и временным документом

В одном CLI-сценарии основной Builder работает с одним файлом за раз: перед открытием следующего нужно сохранить и закрыть текущий. Для задач сравнения, mail merge и операций, где нужен дополнительный источник, объект builderJS предоставляет OpenTmpFile. Это не отменяет правила об основном документе, но позволяет использовать временный файл, не переключая основной контекст.

Интерфейс и удобство использования

У Document Builder нет самостоятельного графического интерфейса, поэтому оценивать его как PDF-редактор по расположению панелей некорректно. Рабочая зона разработчика — терминал, IDE, система сборки и документация API. Навигация фактически строится вокруг трёх уровней: методов CDocBuilder, JavaScript Office API и объектной модели конкретного типа документа.

Для CLI схема проста: открыть или создать файл, выполнить команды, сохранить и закрыть. Объект builder использует построчный парсер и требует специальной обёртки для JavaScript-переменных; builderJS принимает их напрямую, что удобнее в динамических сценариях.

Простая генерация осваивается по примерам быстро, но шаблон с секциями, диаграммами, формулами и точным форматированием требует знания Office API и структуры документа.

Язык интерфейса неприменим: GUI нет, а методы и параметры API именуются по-английски. Для корректного рендеринга текста нужные шрифты должны присутствовать в среде выполнения.

Поддерживаемые форматы и совместимость

Официальная таблица Document Builder перечисляет широкий набор кодов форматов. Их удобно разделить по назначению, потому что за одним словом «поддержка» скрываются разные сценарии — создание, открытие, конвертация и сохранение.

ГруппаФорматы из актуальной документации
Текстовые документыDOCX, DOC, ODT, RTF, TXT, DOTX, OTT, HTML
ФормыFORM / OFORM PDF
ПрезентацииPPTX, PPT, ODP, PPSX, POTX, OTP
Электронные таблицыXLSX, XLS, ODS, CSV, XLTX, OTS
Фиксированная разметкаPDF, DJVU, XPS, PDF/A
Растровый выводJPG, PNG, BMP

Основной акцент сделан на DOCX, XLSX, PPTX и PDF. Наличие формата в таблице не гарантирует идеальный round-trip для сложного файла, поэтому критичные образцы нужно проверять после конвертации.

По платформам актуальная установка охватывает Windows, Linux и macOS. Для Linux и macOS официальные архивы разделены по x86_64 и ARM64/aarch64, для Windows опубликованы x86 и x64. В Builder Framework языковая совместимость шире: Python, C++, COM, Java и .NET, однако готовая .NET-интеграция в актуальной инструкции отмечена как доступная только на Windows. Это уточнение важнее общей фразы «.NET кроссплатформенный».

HTTP Document Builder API совместим с архитектурой, где установлен ONLYOFFICE Docs. Здесь появляется сетевое ограничение: URL сценария должен быть абсолютным, а если внутри такого сценария используется OpenFile, Document Server должен иметь возможность скачать входной файл по абсолютному URL. Локальный путь на машине клиента для серверного API не подходит.

Для читателя, которому нужна ручная работа с PDF, программный SDK будет избыточен. На сайте есть отдельные материалы про PDF-XChange Editor и Adobe Acrobat Pro: это пользовательские редакторы, тогда как Builder рассчитан на код и автоматические процессы.

Производительность и стабильность

Вендор описывает Document Builder как библиотеку, пригодную для массовой серверной генерации, и утверждает, что разные документы можно обрабатывать в разных потоках. Ключевое ограничение сформулировано однозначно: один конкретный документ должен обслуживаться только одним потоком одновременно. Это позволяет распараллеливать независимые задания, но не даёт права нескольким потокам совместно менять один и тот же объект документа.

Вендор приводит оценки вплоть до тысяч документов за минуты, но это не универсальный benchmark. Реальная пропускная способность зависит от файлов и параллелизма, поэтому серверную ёмкость нужно измерять на собственных образцах.

Актуальная страница установки Document Builder не публикует отдельные минимальные значения CPU, RAM и диска. Поэтому переносить сюда системные требования ONLYOFFICE Document Server — например, объём памяти для сотен одновременных веб-редакторов — неверно. Builder и Document Server имеют разную архитектуру и разный профиль нагрузки.

Стабильность лучше оценивать не только по скорости. Журнал изменений показывает, что проект регулярно получает исправления: в ветке 8.3 исправлялись ошибки сохранения и загрузки библиотек, в 8.2 появились оптимизации вычислений для Linux, а в 9.2.0 закрывалась уязвимость, позволявшая получать доступ к системным файлам через native-функции. Для серверной эксплуатации это аргумент в пользу обновления, а не фиксации на старой ветке без необходимости.

Для массовой очереди безопаснее хранить входные данные, писать результат во временное имя, проверять его и только затем публиковать. Это упрощает повтор задания после сбоя.

Лицензирование и версии

У Document Builder есть два слоя лицензирования, которые легко спутать. Публичный репозиторий ONLYOFFICE/DocumentBuilder содержит лицензию GNU AGPL v3. Одновременно официальная инструкция по установке прямо предупреждает, что бесплатная версия Document Builder добавляет водяной знак во все сгенерированные документы. Для снятия этого ограничения требуется коммерческая лицензия.

Коммерчески Document Builder включён в ONLYOFFICE Docs Developer. Это не означает, что покупатель получает только Builder: пакет Developer содержит веб-редакторы, сервис конвертации и другие компоненты. На странице цен 14 сентября 2026 года конфигуратор показывал 3500 долларов для отображаемой development-конфигурации, но стоимость зависит от назначения, серверов, брендинга, масштабирования и уровня поддержки. Поэтому корректнее считать цену Builder частью лицензии Docs Developer, а не объявлять 3500 долларов фиксированной ценой отдельного SDK.

В Docs Developer режим Development Server рассчитан на один сервер и 20 одновременных соединений; обновления и поддержка включены на год. Production-лицензии Single Server и Cluster имеют другие лимиты и сроки. Эти параметры относятся ко всему Docs Developer, а не только к Builder.

У Docs Developer есть 30-дневный trial для оценки интеграции. Это не то же самое, что бесплатная сборка отдельного Builder, для которой документирован водяной знак.

Публичный SDK можно запускать локально без обязательного облака ONLYOFFICE. Сеть нужна, если сценарий использует удалённые ресурсы или выбран HTTP Document Builder API на вашем сервере ONLYOFFICE Docs.

Карта критических зависимостей

ЗависимостьКогда нужнаЧто произойдёт при проблеме
Архив SDK нужной архитектурыЛюбой локальный CLI/Framework-сценарийПрограмма не запустится или библиотека не загрузится
Python 3.10–3.12 и pipPython-интеграцияПакет не установится или не импортируется
JDK 8+Java-интеграцияНельзя собрать или запустить Java-пример
Visual Studio или GCCСборка C++-примеровНе создастся нативное приложение-интегратор
.NET SDK и WindowsГотовая .NET-интеграция из официального пакетаПример не собирается в поддерживаемой конфигурации
Шрифты и доступ к временной папкеРендеринг и промежуточная обработкаВозможны замены шрифтов или ошибки записи
Коммерческая лицензияВывод без водяного знака в официальной бесплатной сборкеСозданный файл будет маркирован
ONLYOFFICE Docs и сетьHTTP Document Builder APIСервис недоступен или не может скачать сценарий/входной файл

Для CLI не нужны все перечисленные SDK сразу: зависимости определяются выбранным языком. HTTP-вариант, наоборот, требует ONLYOFFICE Docs и сетевую доступность ресурсов.

Системные требования

Для Document Builder корректнее говорить не о единой цифре RAM, а о подтверждённых платформах, архитектурах и инструментах разработки. Отдельные минимумы CPU, оперативной памяти и диска в актуальной инструкции Builder не указаны.

Windows

Официально доступны x86 и x64 SDK-архивы. Для Python требуется Python 3.10–3.12 и pip; исполняемый файл python.exe должен быть доступен через PATH. C++-интеграция предполагает Visual Studio. Для Java нужен JDK 8 или новее. .NET-сценарии требуют .NET SDK, причём готовая .NET-интеграция Document Builder в текущей документации обозначена как доступная только на Windows.

Linux

Публикуются архивы x86_64 и aarch64. Для Python действуют те же версии 3.10–3.12 и pip3. Для C++ указан GCC не ниже 4.2.1 для 32- и 64-битных x86-сборок и GCC не ниже 8 для 64-бит ARM. Java требует JDK 8+. Для .NET отдельной готовой интеграции Linux в официальной инструкции сейчас нет.

macOS

Предусмотрены x86_64 и arm64 SDK-архивы. Python 3 и pip можно установить системным способом или через Homebrew; диапазон Python для интеграции — 3.10–3.12. Для C++ указан GCC 4.2.1 или новее, для Java — JDK 8+. Готовая .NET-интеграция для macOS не заявлена.

Для CLI языковые SDK не нужны, если интеграция их не использует. Диск под временные файлы, результаты и шрифты рассчитывается по рабочей нагрузке.

Паспорт обратимости операций

У SDK нет пользовательской кнопки Undo, поэтому обратимость обеспечивает сам процесс: сохраняйте исходник, пишите результат под новым именем и заменяйте оригинал только после проверки.

ОперацияЧто сохранять для откатаКонтроль
Заполнение шаблонаИсходный шаблон и входной JSONСравнить обязательные поля и структуру
DOCX/XLSX/PPTX → PDFРедактируемый исходникОткрыть PDF, проверить страницы, шрифты и изображения
Преобразование между офисными форматамиПервичный файл до конверсииПроверить стили, формулы, диаграммы и разрывы страниц
Пакетная генерацияВерсию сценария и входные данные каждого заданияХеш или размер результата, журнал ошибок, выборочная визуальная проверка

Успешный SaveFile не гарантирует одинаковый вид во всех программах. Критичные документы следует проверять в целевом приложении и повторно прогонять после обновления Builder.

Преимущества и недостатки ONLYOFFICE Document Builder

Плюсы и минусы

• Программная генерация DOCX, XLSX, PPTX и PDF без запуска полноценного офисного приложения.

• Единая Office API-модель для разных типов документов и богатый доступ к структуре содержимого.

• CLI, нативный Framework и HTTP-вариант дают выбор между локальным скриптом, встраиваемой библиотекой и серверным сервисом.

• Официальные сборки для Windows, Linux и macOS, включая ARM64 на Linux и macOS.

• Поддержка более 25 форматов импорта/экспорта и рендеринга в PDF/XPS.

• Допускается параллельная обработка разных документов при соблюдении правила «один поток — один документ».

• Не требует Microsoft Office или LibreOffice как внешнего движка.

• Публичный исходный код и активный журнал релизов упрощают аудит изменений.

Минусы

• Нет пользовательского GUI: продукт не подходит человеку, который хочет вручную открыть и поправить PDF.

• Бесплатная официальная версия добавляет водяной знак во все создаваемые документы.

• Коммерческое лицензирование привязано к более широкому пакету ONLYOFFICE Docs Developer, а не оформлено как простая публичная цена «за один SDK».

• Освоение сложной генерации требует знания Office API, JavaScript и структуры документов.

• Готовая .NET-интеграция по актуальной документации ограничена Windows.

• Вендор не публикует отдельную таблицу минимальных CPU/RAM для Builder, поэтому серверную ёмкость приходится определять нагрузочным тестом.

• При конвертации сложных документов необходим регрессионный контроль совместимости, особенно для старых форматов и нестандартных элементов.

Сравнение с аналогами

ИнструментМодель работыСильная сторонаОсновное ограничение относительно Builder
ONLYOFFICE Document BuilderSDK/CLI/APIГенерация и изменение Office-документов плюс рендеринг/конвертацияВ бесплатной сборке водяной знак, нет GUI
LibreOffice SDK / UNOAPI поверх установленного LibreOfficeОткрытая автоматизация полного офисного пакета, много языковых привязокSDK работает поверх существующей установки LibreOffice и её процесса
Apache POIJava-библиотекиЧистая Java-работа с OOXML/OLE2, особенно сильна для ExcelНет полноценного офисного движка рендеринга; поддержка Word/PowerPoint неоднородна
GotenbergHTTP-сервис в контейнереУдобная серверная конвертация Office/HTML в PDFОриентирован на конвертацию, а не на детальное построение Office DOM
Sumatra PDFНастольный просмотрщикБыстрое локальное чтение PDF и ряда других форматовНе создаёт документы из кода и не является SDK автоматизации

LibreOffice SDK подходит, если допустимо развернуть сам LibreOffice и управлять им через UNO. См. обзор LibreOffice. Builder выигрывает тем, что не требует отдельного стороннего офисного приложения.

Apache POI логичен для Java-проектов без требования к полноценному офисному рендерингу; сам проект предупреждает о неполной поддержке части Word-сценариев. Builder даёт более единообразную модель для нескольких типов документов.

Gotenberg удобнее для готовой HTTP-конвертации в PDF, но не заменяет объектную модель Builder для детального построения Office-документов из данных.

Sumatra PDF находится в другой категории. Если нужно после генерации быстро открыть PDF на рабочем месте, лёгкий просмотрщик уместен как средство контроля результата. Но как альтернатива Document Builder он не подходит: Sumatra PDF не предназначена для серверной генерации, программной модификации DOCX/XLSX/PPTX или работы через SDK. Если задача вообще не требует автоматизации, а нужен только просмотр, Builder будет избыточен. Для пользовательской PDF-обработки также разумно посмотреть PDF24 Creator, а для лёгкого чтения — Foxit Reader.

Хронология развития и поддержки

В 7.1 появилась ARM64-сборка Linux и методы форм. В 8.1 исправлена проблема безопасности при выполнении сценариев, а в 8.2 добавлены Linux-оптимизации и новые методы API.

В 8.3.2 обновлён способ поставки Python-библиотек и исправлены платформенные ошибки. В 9.2.0 закрыта уязвимость доступа к системным файлам через native-функции. Текущий релиз 9.4.0 опубликован 20 мая 2026 года.

Обновления стоит пропускать через регрессионный набор документов и фиксировать точную версию Builder вместе со сценариями и зависимостями.

Инструкция по установке

Windows: архив SDK и первый запуск

1. Откройте актуальную страницу Installing Document Builder в официальной документации ONLYOFFICE API и выберите архив x64 или x86 под архитектуру приложения.

2. Скачайте ZIP из официального release-раздела ONLYOFFICE/DocumentBuilder и распакуйте его в каталог, доступный приложению без прав администратора на запись в системные папки.

3. Создайте UTF-8 JavaScript-файл сценария. Минимальная схема: CreateFile, команды Office API, SaveFile, CloseFile.

4. Запустите сценарий командой docbuilder.exe mydocument.js либо полным путём к исполняемому файлу.

5. Проверьте, что ожидаемый файл появился, открывается целевым приложением и содержит ожидаемые данные. В бесплатной версии наличие водяного знака является штатным лицензионным ограничением.

Linux: x86_64 или aarch64

1. Определите архитектуру командой uname -m.

2. Скачайте официальный TAR.XZ: x86_64 для стандартной 64-битной Intel/AMD-среды либо aarch64 для ARM64.

3. Распакуйте архив командой tar с поддержкой xz в отдельный каталог приложения. Официальный пример использует локальный каталог builder, поэтому системная установка в /opt не обязательна.

4. Создайте UTF-8 сценарий и запустите documentbuilder mydocument.js, при необходимости указав полный путь к бинарному файлу.

5. Для сервиса задайте рабочий и временный каталоги с понятными правами доступа и не запускайте процесс с избыточными привилегиями.

macOS: Intel и Apple Silicon

1. Выберите x86_64 для Intel Mac или arm64 для Apple Silicon.

2. Скачайте официальный TAR.XZ релиза и распакуйте его в каталог проекта или приложения.

3. Запускайте CLI командой documentbuilder mydocument.js с полным путём, если каталог SDK не добавлен в окружение.

4. Проверьте создание тестового DOCX и PDF до подключения Builder к рабочему сервису.

Python: библиотека через pip

1. Убедитесь, что используется Python 3.10, 3.11 или 3.12 и доступен pip/pip3.

2. Установите официально документированный пакет командой pip3 install document-builder; на Windows обычно используется pip.

3. Создайте CDocBuilder, сформируйте документ через контекст Office API, сохраните файл и закройте его.

4. Зафиксируйте версию Python-пакета в зависимостях проекта после проверки совместимости.

Перед удалением архивной поставки проверьте ссылки сервисов и скриптов на каталог SDK; Python-зависимость удаляйте штатным менеджером пакетов. Шаблоны и данные храните отдельно от SDK.

Практические кейсы

Генерация персонального договора из данных CRM

Цель. Получить DOCX и PDF с данными конкретного клиента без ручного копирования. Подготовка. Шаблон DOCX, идентификаторы полей в логике сценария и JSON с данными клиента. Шаги. Приложение получает данные из CRM, Builder открывает копию шаблона, сценарий заменяет нужные элементы и сохраняет сначала DOCX, затем PDF. Проверка. Сопоставить имя клиента, сумму, дату, реквизиты и число страниц с исходными данными. Ограничение. Builder не проверяет юридический смысл шаблона; контроль обязательных полей должен делать интеграционный код.

Пакетная конвертация Office-файлов в PDF

Цель. Подготовить фиксированные копии документов для публикации. Подготовка. Очередь входных файлов и отдельный каталог результатов. Шаги. Каждое задание открывает один файл, сохраняет PDF, закрывает его и только после этого переходит к следующему. Для параллельной обработки запускаются независимые задания так, чтобы один документ не обслуживался несколькими потоками. Проверка. Убедиться, что PDF открывается, количество страниц правдоподобно, изображения и шрифты отображаются корректно. Ограничение. Конвертация сложного legacy-файла требует визуального регрессионного контроля.

Серверный отчёт XLSX с формулами и диаграммой

Цель. Сформировать электронную таблицу из данных аналитической системы. Подготовка. Массив данных, правила форматирования, формулы и диапазоны диаграммы. Шаги. Создать XLSX, заполнить лист, задать формулы и оформление через Spreadsheet API, добавить диаграмму и сохранить файл. При необходимости сделать PDF-копию. Проверка. Открыть XLSX в целевом офисном приложении и проверить формулы, диапазоны и подписи. Ограничение. Логику расчёта нельзя считать проверенной только по факту успешного сохранения.

Удалённая генерация через ONLYOFFICE Docs

Цель. Вызывать генератор из веб-приложения без локальной установки SDK на каждом клиенте. Подготовка. Работающий ONLYOFFICE Docs, доступный по сети JavaScript-сценарий и при необходимости доступные по абсолютным URL входные документы. Шаги. Клиент отправляет POST на endpoint docbuilder с URL сценария. В синхронном режиме ждёт ответ; в асинхронном получает key и опрашивает сервис до end=true. Проверка. Скачать возвращённый файл и проверить его до передачи пользователю. Ограничение. Локальный путь клиента сервер не увидит; ресурс должен быть доступен Document Server.

Навигатор по сбоям

СимптомПервая проверкаВероятная причинаБезопасное действие
На выходе водяной знакПроверить тип лицензииЗапущена бесплатная версияНе пытаться удалять знак постобработкой; использовать соответствующую коммерческую лицензию
CLI не находит сценарийПолный путь и кодировка файлаНеверный рабочий каталог или имяЗапустить бинарник и сценарий с абсолютными путями
SaveFile не создаёт ожидаемый результатПуть вывода, права, свободное местоКаталог недоступен процессуПисать во временный каталог с подтверждёнными правами и логировать код ошибки
HTTP API не открывает источникURL доступен с хоста Document ServerПередан локальный путь или закрытый URLПредоставить абсолютный доступный URL либо изменить архитектуру передачи
Редкий сбой под нагрузкойНе используют ли два потока один документНарушена модель потокобезопасностиОдин документ закрепить за одним worker; распараллеливать только независимые задания
После обновления изменился рендерингСравнить версию Builder и тестовые документыИзменился движок или форматная совместимостьПрогнать регрессионный набор и при необходимости временно откатить пакет приложения

Контроль перед сохранением и передачей

• Сохранять первую версию результата под новым именем, не поверх единственного исходника.

• Проверять ненулевой размер файла и успешное открытие в целевом приложении.

• Для PDF сравнивать ожидаемое число страниц и выборочно просматривать страницы с таблицами, изображениями и нестандартными шрифтами.

• Для XLSX проверять ключевые формулы, диапазоны, даты и числовые форматы.

• Для DOCX проверять разрывы страниц, колонтитулы, таблицы и переносы строк на контрольных образцах.

• Не публиковать документ, если в бесплатной сборке водяной знак неприемлем для бизнес-процесса.

• Записывать версию Builder и сценария в журнал задания, чтобы результат можно было воспроизвести.

Часто задаваемые вопросы

Это редактор PDF с графическим интерфейсом?

Нет. Document Builder — SDK и CLI. Он может работать с PDF и сохранять в PDF, но не предоставляет отдельное пользовательское окно для ручного редактирования. Для ручных задач лучше выбирать редактор или просмотрщик.

Нужен ли Microsoft Office или LibreOffice?

Нет. Одно из заявленных преимуществ Builder — отсутствие зависимости от сторонних офисных приложений. Это отличает его от автоматизации LibreOffice через UNO.

Можно ли работать полностью офлайн?

Локальный CLI/Framework может работать внутри вашей инфраструктуры, если сценарий не использует удалённые ресурсы. HTTP Document Builder API, напротив, требует сетевого взаимодействия с вашим ONLYOFFICE Docs и доступности URL сценария и входных файлов.

Нужна ли учётная запись ONLYOFFICE для скачивания?

Официальная установка ведёт к публичным GitHub-архивам и pip-пакету и не описывает обязательный аккаунт для их получения. Аккаунт или контакт с продажами нужен уже для коммерческой лицензии и соответствующих trial-сценариев.

Можно ли убрать водяной знак настройкой SaveFile?

Нет. В актуальной инструкции водяной знак указан как лицензионное ограничение бесплатной версии. Для его снятия требуется коммерческая лицензия; программный обход этого ограничения не является штатной функцией.

Есть ли поддержка OCR для сканов?

OCR не заявлен как базовая функция Document Builder. Поддержка PDF и изображений не означает автоматического распознавания текста на сканированных страницах. Если бизнес-процесс начинается со скана, OCR-этап следует проектировать отдельно.

Можно ли генерировать несколько документов одновременно?

Да, разные документы допускается обрабатывать в разных потоках. Один конкретный документ должен обслуживаться одним потоком. Это правило удобно реализовать очередью задач, где каждый worker владеет своим экземпляром документа.

Document Builder и ONLYOFFICE Docs Developer — одно и то же?

Нет. Document Builder — компонент автоматизации. Docs Developer — коммерческий комплект для разработчиков, включающий онлайн-редакторы, Document Builder, сервис конвертации и другие возможности. Коммерческая лицензия Builder предлагается в рамках этого пакета.

Можно ли использовать Builder только для PDF/A?

PDF/A присутствует в таблице поддерживаемых форматов, поэтому такой вывод возможен. Для юридически или архивно значимых процессов итоговый файл всё равно следует проверять профильным валидатором на соответствие требуемому стандарту организации.

Подойдёт ли Builder вместо Sumatra PDF?

Нет, задачи противоположны. Sumatra PDF нужна человеку для быстрого просмотра готовых документов, а Document Builder — приложению для их автоматического создания и преобразования. Эти продукты скорее дополняют друг друга на разных этапах процесса.

Вывод

ONLYOFFICE Document Builder подходит командам, которым нужно генерировать, менять и конвертировать DOCX, XLSX, PPTX и PDF без пользовательского офисного приложения. Сильные сценарии — шаблоны, серверные отчёты, пакетный рендеринг и интеграция в DMS, CRM или SaaS.

Продукт не подходит пользователю, который ищет визуальный PDF-редактор, и не является заменой Sumatra PDF как лёгкому просмотрщику. Для ручного редактирования разумнее выбрать GUI-программу; для простого преобразования в PDF может оказаться проще контейнерный Gotenberg; для Java-операций с OOXML без требования к полноценному рендерингу — Apache POI; для свободной автоматизации полного офисного пакета — LibreOffice UNO. Главный вопрос при выборе Builder — оправдывает ли богатая Office API-модель лицензионную и интеграционную сложность. Если да, это актуальный и активно поддерживаемый инструмент для документных конвейеров, а не устаревшая вспомогательная утилита.


Ваш адрес email не будет опубликован. Обязательные поля помечены *