Программное заполнение макетов в 1С: от простых шаблонов до сложных отчётов

Заполнение макетов в 1С:Предприятие — одна из самых востребованных задач при разработке отчётов, печатных форм и пользовательских интерфейсов. Ручное заполнение данных утомительно и чревато ошибками, особенно когда речь идёт о сотнях строк в табличных документах или динамически формируемых бланках. Автоматизация этого процесса экономит время, снижает риск ошибок и позволяет гибко адаптировать вывод данных под меняющиеся требования бизнеса.

В этой статье разберём все доступные способы программного заполнения макетов: от базовых методов работы с табличными документами до продвинутых техник с использованием внешних компонент и REST API. Особое внимание уделим типичным ошибкам, которые приводят к падению производительности или искажению данных, а также оптимизации кода для работы с большими объёмами информации.

Если вы только начинаете осваивать программирование в 1С, начните с первых двух разделов — там разобраны простейшие примеры, которые можно сразу применить на практике. Опытные разработчики найдут полезными разделы про динамическое формирование макетов и интеграцию с внешними системами.

1. Основы работы с макетами в 1С: типы и структура

В 1С:Предприятие 8 макеты делятся на три основных типа, каждый из которых имеет свои особенности заполнения:

• 📄 Табличные документы — используются для создания отчётов, печатных форм (например, счётов или накладных). Поддерживают ячейки, области, рисунки и графики.
• 📝 Текстовые документы — применяются для генерации писем, договоров или любых текстов с подстановкой переменных (например, ФИО клиента или суммы заказа).
• 🖼️ Двоичные данные — хранят изображения, шаблоны Excel/Word или другие файлы, которые можно динамически модифицировать.

Структура макета определяется в Конфигураторе (раздел Общие → Макеты). Каждый макет имеет:

• 🔹 Имя — уникальный идентификатор для обращения из кода (например, МакетПечатнойФормы).
• 🔹 Тип — табличный документ, текстовый документ или двоичные данные.
• 🔹 Содержимое — визуальный редактор для таблиц или текстовый редактор для шаблонов.

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

⚠️ Внимание: При работе с макетами в 1С:Управление торговлей или 1С:ERP учитывайте, что некоторые печатные формы (например, ТОРГ-12 или счёт-фактура) могут иметь жёстко заданную структуру. Изменение их макетов через код может привести к ошибкам при проверке электронных документов.

2. Простое заполнение табличного макета: пошаговая инструкция

Начнём с самого распространённого сценария — заполнения табличного документа данными из базы. Предположим, нам нужно сгенерировать отчёт по остаткам товаров на складе.

Шаг 1. Получаем макет в коде:

Макет = Документы.ОтчетПоОстаткам.НайтиМакет("ОсновнойМакет");
ТабличныйДокумент = Новый ТабличныйДокумент;
ТабличныйДокумент.ПрочитатьМакет(Макет);

Шаг 2. Заполняем область макета данными. Например, выведем список номенклатуры и остатки:

Запрос = Новый Запрос;
Запрос.Текст =
"ВЫБРАТЬ
|   Номенклатура.Наименование КАК Товар,
|   СУММА(ОстаткиТоваров.КоличествоОстаток) КАК Остаток
|ИЗ
|   Документ.ОстаткиТоваров КАК ОстаткиТоваров
|ЛЕВОЕ СОЕДИНЕНИЕ РегистрСведений.Номенклатура КАК Номенклатура
|   ПО ОстаткиТоваров.Номенклатура = Номенклатура.Ссылка
|ГДЕ
|   ОстаткиТоваров.Склад = &Склад
|СГРУППИРОВАТЬ ПО
|   Номенклатура.Наименование";

Запрос.УстановитьПараметр("Склад", Склад);
РезультатЗапроса = Запрос.Выполнить();
Выборка = РезультатЗапроса.Выбрать();

НомерСтроки = 1;
Пока Выборка.Следующий() Цикл
ТабличныйДокумент.Область("Данные" + НомерСтроки).Заполнить(Выборка);
НомерСтроки = НомерСтроки + 1;
КонецЦикла;

Шаг 3. Выводим результат пользователю:

ТабличныйДокумент.Показать("Остатки товаров на складе");

Если в макете заданы именованные области (например, Заголовок, Данные1, Итоги), их можно заполнять отдельно. Это упрощает поддержку кода при изменении структуры макета.

3. Динамическое формирование макетов: когда стандартных шаблонов недостаточно

Иногда требуется создавать макеты "на лету" — например, когда структура отчёта зависит от прав пользователя или настроек системы. В таких случаях помогают методы ДобавитьОбласть(), ОбъединитьЯчейки() и работа с стилями.

Пример: формируем таблицу с динамическим количеством колонок в зависимости от выбранных показателей:

ТабличныйДокумент = Новый ТабличныйДокумент;

// Добавляем заголовки колонок
Показатели = Новый Массив;
Показатели.Добавить("Наименование");
Показатели.Добавить("Количество");
Показатели.Добавить("Сумма");

Для Каждого Показатель Из Показатели Цикл
ТабличныйДокумент.Область(1, Показатели.Найти(Показатель) + 1).Текст = Показатель;
ТабличныйДокумент.Область(1, Показатели.Найти(Показатель) + 1).Стиль = "Заголовок";
КонецЦикла;

// Заполняем данными
НомерСтроки = 2;
Для Каждого Товар Из СписокТоваров Цикл
ТабличныйДокумент.Область(НомерСтроки, 1).Текст = Товар.Наименование;
ТабличныйДокумент.Область(НомерСтроки, 2).Текст = Товар.Количество;
ТабличныйДокумент.Область(НомерСтроки, 3).Текст = Товар.Сумма;
НомерСтроки = НомерСтроки + 1;
КонецЦикла;

Для сложных макетов удобно использовать вложенные области. Например, можно создать область Шапка для заголовка отчёта, Тело для данных и Подвал для итогов. Это позволит гибко управлять видимостью блоков:

ТабличныйДокумент.Область("Шапка").Видимость = (ПоказыватьШапку = Истина);
ТабличныйДокумент.Область("Подвал").Видимость = (ЕстьИтоги = Истина);

Критическая особенность: При динамическом формировании макетов с большим количеством строк (более 1000) обязательно используйте метод ОтключитьОтрисовку() перед заполнением и ВключитьОтрисовку() после. Это ускорит работу в 5–10 раз:

ТабличныйДокумент.ОтключитьОтрисовку();
// ... код заполнения ...
ТабличныйДокумент.ВключитьОтрисовку();

4. Работа с текстовыми макетами: подстановка переменных и форматирование

Текстовые макеты применяются для генерации писем, договоров, актов и других документов, где требуется подстановка динамических данных в заранее подготовленный шаблон. Например, шаблон письма клиенту может выглядеть так:

Уважаемый [ФИО]!

Сообщаем, что ваш заказ №[НомерЗаказа] от [Дата] на сумму [Сумма] руб. отправлен.

С уважением,
[Подпись]

Для подстановки переменных используйте метод Заменить() или регулярные выражения:

ТекстШаблона = Макеты.ПисьмоКлиенту.ПолучитьТекст();
ТекстШаблона = СтрЗаменить(ТекстШаблона, "[ФИО]", Клиент.ФИО);
ТекстШаблона = СтрЗаменить(ТекстШаблона, "[НомерЗаказа]", Заказ.Номер);
ТекстШаблона = СтрЗаменить(ТекстШаблона, "[Дата]", Формат(Заказ.Дата, "ДФ=dd.MM.yyyy"));
ТекстШаблона = СтрЗаменить(ТекстШаблона, "[Сумма]", Формат(Заказ.Сумма, "ЧДЦ=2; ЧРД=."));
ТекстШаблона = СтрЗаменить(ТекстШаблона, "[Подпись]", Пользователь.Подпись);

Для сложных шаблонов с условной логикой (например, разные блоки текста для физических и юридических лиц) удобно использовать внешние обработки или XDTO-пакеты. Альтернативный подход — хранение шаблонов в HTML с последующим рендерингом через ПолеHTMLДокумента.

⚠️ Внимание: При генерации юридически значимых документов (договоров, актов) всегда проверяйте итоговый текст на наличие некорректных подстановок. Например, если в шаблоне осталась необработанная переменная [Дата], документ может быть признан недействительным.

5. Заполнение макетов через внешние файлы: Excel, Word и PDF

Если требуется сгенерировать отчёт в формате Excel, Word или PDF, можно использовать следующие подходы:

1. Экспорт в Excel через ЗначениеВФайл():

ТабличныйДокумент.Записать("C:\Temp\Отчет.xlsx", ТипФайлаТабличногоДокумента.XLSX);

2. Работа с COM-объектами (только для Windows):

Excel = Новый COMОбъект("Excel.Application");
Книга = Excel.Workbooks.Add();
Лист = Книга.Worksheets(1);

// Заполняем данные
Лист.Cells(1, 1).Value = "Товар";
Лист.Cells(1, 2).Value = "Количество";

НомерСтроки = 2;
Для Каждого Товар Из СписокТоваров Цикл
Лист.Cells(НомерСтроки, 1).Value = Товар.Наименование;
Лист.Cells(НомерСтроки, 2).Value = Товар.Количество;
НомерСтроки = НомерСтроки + 1;
КонецЦикла;

// Сохраняем файл
Книга.SaveAs("C:\Temp\Отчет.xlsx");
Excel.Quit();

3. Использование библиотеки OneScript.Excel (кроссплатформенное решение):

ПутьКБиблиотеке = "C:\OneScript\lib\Excel.dll";
Excel = Новый ДинамическийСписок(ПутьКБиблиотеке);

Документ = Excel.Create();
Лист = Документ.AddSheet("Остатки");
Лист.SetCell(1, 1, "Товар");
Лист.SetCell(1, 2, "Количество");

Документ.Save("C:\Temp\Отчет.xlsx");

Если НЕ Кэш.СодержитКлюч("ОстаткиТоваров_" + Склад.УникальныйИдентификатор) Тогда
Кэш.Добавить("ОстаткиТоваров_" + Склад.УникальныйИдентификатор, РезультатЗапроса);
КонецЕсли;

ФоновоеЗадание = ФоновыеЗадания.СоздатьФоновоеЗадание(
"ФормированиеОтчета",
Новый Структура("Склад, ДатаНачала, ДатаОкончания", Склад, ДатаНачала, ДатаОкончания)
);

ТабличныйДокумент.Область("A1:Z1000").Стиль = "Основной";

ТекстовыйДокумент.Записать("C:\Temp\Отчет.txt", КодировкаТекста.UTF8);

HTTPСоединение = Новый HTTPСоединение("api.example.com");
HTTPЗапрос = Новый HTTPЗапрос("/v1/orders?date=" + ТекущаяДата());
Ответ = HTTPСоединение.Получить(HTTPЗапрос);
Данные = JSON.Прочитать(Ответ.ПолучитьТекст());

Для Каждого Заказ Из Данные.Заказы Цикл
ТабличныйДокумент.НоваяСтрока();
ТабличныйДокумент.ТекущаяСтрока.Номер = Заказ.Номер;
ТабличныйДокумент.ТекущаяСтрока.Сумма = Заказ.Сумма;
КонецЦикла;

Письмо = Новый ПочтаMail;
Письмо.Адресат = "client@example.com";
Письмо.Тема = "Ваш заказ №" + НомерЗаказа;
Письмо.Текст = "Во вложении счёт на оплату.";
Письмо.Вложения.Добавить("C:\Temp\Счет_" + НомерЗаказа + ".pdf");
Письмо.Отправить();

ТекстСообщения = "Сформирован отчёт по остаткам на " + ТекущаяДата();
HTTPЗапрос = Новый HTTPЗапрос("https://api.telegram.org/bot[TOKEN]/sendMessage");
HTTPЗапрос.Заголовки.Вставить("Content-Type", "application/json");
HTTPЗапрос.УстановитьТекст(
JSON.Записать(
Новый Структура(
"chat_id, text",
"[CHAT_ID]",
ТекстСообщения
)
)
);
Ответ = Новый HTTPСоединение("api.telegram.org").Получить(HTTPЗапрос);

ВременнаяТаблица = Новый ТаблицаЗначений;
ВременнаяТаблица.Колонки.Добавить("Товар");
ВременнаяТаблица.Колонки.Добавить("Количество");

// Заполняем таблицу данными
Для Каждого Товар Из СписокТоваров Цикл
НоваяСтрока = ВременнаяТаблица.Добавить();
НоваяСтрока.Товар = Товар.Наименование;
НоваяСтрока.Количество = Товар.Количество;
КонецЦикла;

// Заполняем макет
ТабличныйДокумент.Область("Данные").Заполнить(ВременнаяТаблица);

ПутьКФайлу = "C:\Mакеты\Отчет.xlsx";
ТабличныйДокумент = Новый ТабличныйДокумент;
ТабличныйДокумент.Прочитать(ПутьКФайлу, ТипФайлаТабличногоДокумента.XLSX);

ТабличныйДокумент.Записать("C:\Temp\Отчет.pdf", ТипФайлаТабличногоДокумента.PDF);

Сообщить(РезультатЗапроса.Колонки.ВыгрузитьКолонки());