Расширение генератора документов

Как вывести любые данные в генераторе документов Битрикс

Генератор документов в «1С-Битрикс» — мощный инструмент, но до недавнего времени он был ограничен стандартными сущностями. Если вам нужно было вывести в документе нестандартные данные — например, список товаров из пользовательского свойства, результаты опроса или произвольные записи из инфоблока — приходилось изобретать костыли. Расширение генератора документов решает эту проблему раз и навсегда. Оно добавляет возможность подключать собственные сущности к механизму генерации, причём данные отображаются в виде аккуратной таблицы через встроенный итератор. Никакого ручного копирования строк, никаких массивов в шаблонах — всё работает «из коробки».

Табличный вывод через итератор: просто и наглядно

Главная «фишка» модуля — итератор. Это не просто абстрактное понятие, а конкретный механизм, который перебирает элементы вашей сущности и выводит их построчно. Представьте, что у вас есть каталог дополнительных услуг или список сотрудников отдела. Без расширения вам пришлось бы вручную формировать HTML-таблицу внутри шаблона документа. С модулем достаточно указать, какую сущность использовать, и итератор сам разложит данные по строкам и колонкам. Таблица формируется динамически, подстраиваясь под количество записей. Это особенно удобно для массовых документов: счета, акты, коммерческие предложения — везде, где нужен повторяющийся блок с данными.

Реальная экономия времени разработчика

Любой, кто настраивал генератор документов под нестандартные задачи, знает, сколько времени уходит на «допиливание» функционала. Нужно писать кастомные обработчики, лезть в ядро, проверять совместимость с обновлениями. Расширение берёт эту работу на себя. Вам не нужно создавать сложные конструкции — модуль уже умеет принимать любые сущности и превращать их в табличный вид. Это значит, что вместо часов программирования вы тратите 10–15 минут на настройку. Для агентств и студий, которые часто делают типовые решения для клиентов, это прямой путь к снижению себестоимости проекта.

Гибкость без лишнего кода

Многие думают, что кастомные сущности в генераторе — это сложно. На самом деле, модуль работает по принципу «подключил и забыл». Вы берёте любую свою сущность (например, элементы справочника или записи из HL-блока), передаёте её в генератор, и она автоматически раскладывается по колонкам. При этом вы сохраняете полный контроль над структурой таблицы: можете задать порядок полей, настроить форматирование, добавить итоговые строки. Итератор не просто выводит данные — он умеет обрабатывать их внутри цикла: суммировать, фильтровать, группировать. Всё это без единой строчки кастомного PHP-кода в шаблоне документа.

Почему это выгодно для бизнеса

Когда документы формируются автоматически и без ошибок, бизнес работает быстрее. Клиент получает акт или счёт через минуту после заказа, а не через час. Расширение генератора документов позволяет подключать любые данные, которые хранятся в системе — от остатков на складе до персональных скидок. Табличный вывод через итератор делает документы читаемыми и профессиональными. Вы больше не привязаны к стандартным полям заказов или лидов. Хотите вывести в договоре полную историю взаимодействия с клиентом? Пожалуйста. Нужно распечатать спецификацию с нестандартными характеристиками? Легко. Модуль даёт свободу, которая раньше была доступна только через дорогую кастомизацию.

Как это работает на практике

Всё, что нужно сделать — установить модуль и указать в настройках генератора, какую сущность использовать. Итератор сам определит структуру данных и построит таблицу. Если у вас есть, например, список дополнительных услуг с ценами и сроками, они появятся в документе как полноценная таблица с колонками «Наименование», «Цена», «Срок». При этом вы можете комбинировать стандартные поля документа (номер, дата) с кастомными таблицами. Результат — документ, который выглядит так, будто его верстал дизайнер, а формируется он за секунду. Никаких лишних телодвижений, никакого программирования — только чистый, готовый к печати результат.