Как заполнить параметры макета в 1С: пошаговая инструкция 2026

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

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

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

Что такое параметры макета в 1С и зачем они нужны

Параметры макета — это набор переменных, которые передаются в макет перед его обработкой. Они позволяют:

📄 Динамически формировать документы — например, подставлять текущую дату, номер документа или данные контрагента.
🔄 Переиспользовать один макет для разных сценариев (например, один шаблон счёта для всех клиентов).
🛠️ Упрощать поддержку кода — изменяя параметры, а не сам макет.
📊 Фильтровать данные в отчётах (например, выводить продажи только за определённый период).

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

Важно понимать, что параметры макета — это не то же самое, что параметры отчёта или обработки. Они работают на уровне Системы компоновки данных (СКД) или текстового документа, а не на уровне прикладного решения. Это означает, что их настройка требует знания как языка 1С:Предприятие, так и особенностей конкретного макета (например, .mxl или .ert).

Типы данных параметров макета: что можно передавать

Платформа 1С:Предприятие 8.3

поддерживает несколько типов данных для параметров макета. Их выбор зависит от того, какие значения вы планируете передавать и как они будут использоваться в макете. Основные типы:

Тип данных	Описание	Пример использования	Особенности
`Строка`	Текстовые значения, включая числа в текстовом формате.	Название организации, адрес, комментарий.	Максимальная длина — 2 Гб (ограничение платформы).
`Число`	Целые и дробные числа.	Сумма документа, количество товаров.	Поддерживаются форматы с разделителями (например, `1 000,50`).
`Дата`	Даты и время.	Дата создания документа, период отчёта.	Формат зависит от региональных настроек системы.
`Булево`	Логические значения (`Истина`/`Ложь`).	Флаг "Печатать печать", "Показывать скидку".	В макете часто используется для условного отображения блоков.
`Ссылка`	Ссылки на объекты метаданных (документы, справочники).	Ссылка на контрагента или номенклатуру.	Требует проверки на существование объекта.

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

В версиях платформы 8.3.20+ появилась поддержка передачи параметров типа "ДвоичныеДанные", что позволяет встраивать изображения или файлы прямо в макет без предварительной загрузки на диск. Это полезно для генерации документов с логотипами или подписями.

⚠️ Внимание: При передаче ссылок на объекты метаданных (например, СправочникСсылка.Контрагенты) убедитесь, что объект существует в базе. Иначе при формировании макета возникнет ошибка "Объект не найден".

Как заполнить параметры макета в коде: пошаговая инструкция

Заполнение параметров макета происходит в два этапа: объявление параметров в макете и передача значений из кода. Рассмотрим оба процесса на примере печати счёта на оплату.

1. Объявление параметров в макете

Если вы используете текстовый макет (например, .ert для печатных форм), параметры объявляются в специальном разделе. Для макетов Системы компоновки данных (СКД) параметры настраиваются в схеме компоновки.

Пример объявления параметров в текстовом макете:

&Параметры Организация, НомерДокумента, ДатаДокумента, Контрагент, СуммаДокумента
&КонецПараметров

Для СКД параметры добавляются через конструктор схемы компоновки данных в разделе Параметры. Здесь можно указать тип данных, значение по умолчанию и даже связать параметр с полем справочника.

2. Передача параметров из кода

В модуле объекта (например, в обработке печати документа) параметры передаются с помощью метода УстановитьПараметр. Пример для печати счёта:

Макет = Документы.СчетНаОплату.ПечатнаяФорма(); Макет.УстановитьПараметр("Организация", Объект.Организация); Макет.УстановитьПараметр("НомерДокумента", Объект.Номер); Макет.УстановитьПараметр("ДатаДокумента", Объект.Дата); Макет.УстановитьПараметр("Контрагент", Объект.Контрагент); Макет.УстановитьПараметр("СуммаДокумента", Объект.СуммаДокумента); // Получение результата Результат = Макет.Получить();
Результат.Показать();

Для СКД используется другой подход — параметры передаются в настройки компоновки:

Настройки = КомпоновщикНастроек.ПолучитьНастройкиПоУмолчанию(); Настройки.ПараметрыДанных.УстановитьПараметр("ДатаНачала", НачалоПериода); Настройки.ПараметрыДанных.УстановитьПараметр("ДатаОкончания", КонецПериода); КомпоновщикМакета = Новый КомпоновщикМакетаКомпоновкиДанных; КомпоновщикМакета.Инициализировать(СхемаКомпоновкиДанных, Настройки);
Результат = КомпоновщикМакета.Выполнить();

Имена параметров в коде и макете совпадают|Типы данных параметров соответствуют передаваемым значениям|Для ссылок проверено существование объекта|Для дат указан корректный формат|Массивы и структуры обработаны в макете-->

3. Особенности работы с динамическими параметрами

Иногда параметры макета нужно формировать динамически — например, передавать список товаров из документа. В этом случае удобно использовать структуры или таблицы значений:

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

В самом макете для вывода таблицы используется цикл. Например, в текстовом макете (.ert):

&НаКаждойСтроке(Товары) &Текст(НоваяСтрока.Наименование, ", ", НоваяСтрока.Количество, " шт., ", НоваяСтрока.Сумма)
&КонецЦикла

⚠️ Внимание: При передаче таблиц значений или массивов в макет убедитесь, что в макете предусмотрена обработка таких структур. Иначе параметр будет проигнорирован или вызовет ошибку.

💡
Если параметр макета не обновляется при изменении данных, проверьте, не кешируется ли макет в памяти. Используйте метод ОчиститьКеш() перед повторной установкой параметров.

Типичные ошибки при заполнении параметров и как их избежать

Даже опытные разработчики иногда сталкиваются с ошибками при работе с параметрами макета. Рассмотрим самые распространённые проблемы и способы их решения.

1. Ошибка "Параметр не найден"

Возникает, когда имя параметра в коде не совпадает с именем в макете. Причины:

🔤 Опечатка в имени параметра (например, ОрганизациЯ вместо Организация).

📝 Регистр букв имеет значение: контрагент и Контрагент — разные параметры.

🗃️ Параметр объявлен в другом разделе макета (например, в &Область вместо &Параметры).

Решение: проверьте имена параметров в макете и коде. Для текстового макета (.ert) откройте его в Конфигураторе и найдите раздел &Параметры.

2. Ошибка "Неверный тип данных"

Платформа строго контролирует типы данных параметров. Например, если в макете параметр объявлен как Дата, а вы передаёте строку "01.01.2026", возникнет ошибка.

Решение: преобразуйте данные к нужному типу перед передачей:

// Неправильно: Макет.УстановитьПараметр("ДатаДокумента", "01.01.2026"); // Правильно:
Макет.УстановитьПараметр("ДатаДокумента", Дата(2026, 1, 1));

3. Параметры не подставляются в макет

Если параметры передаются без ошибок, но не отображаются в результате, проверьте:

📋 Правильность синтаксиса в макете (например, для текстового макета должен быть указан &ПараметрИмя).

🔄 Порядок вызова методов: сначала УстановитьПараметр, затем Получить().

🖼️ Для макетов СКД — корректность схемы компоновки.

Пример правильного синтаксиса для текстового макета:

&ПараметрОрганизация
&Текст(Организация.Наименование)

4. Ошибки при работе со ссылками

Если параметр — это ссылка на объект (например, СправочникСсылка.Контрагенты), но объект удалён или не существует, возникнет ошибка "Объект не найден".

Решение: добавьте проверку перед передачей параметра:

Если НЕ Объект.Контрагент.Пустая() Тогда Макет.УстановитьПараметр("Контрагент", Объект.Контрагент); Иначе Макет.УстановитьПараметр("Контрагент", Неопределено);
КонецЕсли;

Как отладить ошибки с параметрами?

Для диагностики проблем используйте Сообщить() перед передачей параметров:
Сообщить("Передаём параметр Организация: " + Объект.Организация);
Также проверьте журнал регистрации (Администрирование → Журнал регистрации) на наличие ошибок при формировании макета.

Продвинутые техники: динамические макеты и параметры

Для сложных задач стандартных параметров макета может быть недостаточно. Рассмотрим несколько продвинутых приёмов.

1. Использование выражений в параметрах

В макетах СКД параметры могут быть не только статическими значениями, но и выражениями. Например, можно передать формулу для расчёта суммы:

Настройки.ПараметрыДанных.УстановитьПараметр( "ИтоговаяСумма", Новый ПараметрКомпоновкиДанных("ИтоговаяСумма", Тип("Число"), , "СуммаДокумента * (1 + СтавкаНДС/100)")
);

2. Передача бинарных данных (изображений, файлов)

Начиная с версии 8.3.20, в параметрах макета можно передавать двоичные данные. Это позволяет встраивать изображения (например, логотип компании) прямо в документ:

Логотип = Новый ДвоичныеДанные(ПутьКФайлуЛоготипа);
Макет.УстановитьПараметр("Логотип", Логотип);

В макете изображение выводится с помощью тега &Картинка:

&Картинка(Логотип, 100, 50)

3. Интеграция с внешними системами

Параметры макета можно формировать на основе данных из внешних источников (например, REST API или базы данных PostgreSQL). Пример получения курса валют и передачи его в макет:

HTTPСоединение = Новый HTTPСоединение("api.cbr.ru", 443, Истина); Запрос = Новый HTTPЗапрос("/daily_json.js"); Ответ = HTTPСоединение.Получить(Запрос); Данные = JSON.Прочитать(Ответ.ПолучитьТелоКакСтроку()); КурсДоллара = Данные.Valute.USD.Value;
Макет.УстановитьПараметр("КурсUSD", КурсДоллара);

⚠️ Внимание: При работе с внешними API учитывайте задержки сети. Если данные не успеют загрузиться, макет сформируется с пустыми параметрами. Используйте асинхронные запросы или кеширование.

4. Кеширование макетов с параметрами

Если макет формируется часто с одними и теми же параметрами, его можно кешировать для ускорения работы:

КлючКеша = ПолучениеКлючаКеша(Параметры); Если НЕ Кеш.Получить(КлючКеша, Результат) Тогда Макет.УстановитьПараметры(Параметры); Результат = Макет.Получить(); Кеш.Добавить(КлючКеша, Результат, 3600); // Кешируем на 1 час
КонецЕсли;

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

Оптимизация производительности при работе с параметрами

Неправильное использование параметров макета может замедлить работу системы, особенно при формировании большого количества документов. Рассмотрим способы оптимизации.

1. Минимизируйте количество параметров

Каждый параметр увеличивает нагрузку на процессор при формировании макета. Если возможно, объединяйте связанные данные в структуры или таблицы значений.

Пример:

// Вместо: Макет.УстановитьПараметр("КонтрагентНаименование", Контрагент.Наименование); Макет.УстановитьПараметр("КонтрагентИНН", Контрагент.ИНН); Макет.УстановитьПараметр("КонтрагентАдрес", Контрагент.Адрес); // Используйте структуру: ДанныеКонтрагента = Новый Структура; ДанныеКонтрагента.Вставить("Наименование", Контрагент.Наименование); ДанныеКонтрагента.Вставить("ИНН", Контрагент.ИНН); ДанныеКонтрагента.Вставить("Адрес", Контрагент.Адрес);
Макет.УстановитьПараметр("Контрагент", ДанныеКонтрагента);

2. Используйте кеширование

Если макет формируется многократно с одними и теми же параметрами (например, при печати типового договора), кешируйте результат:

КешМакетов = Новый Кеш; КлючКеша = "СчетНаОплату_" + Объект.УникальныйИдентификатор(); Если НЕ КешМакетов.Получить(КлючКеша, РезультатМакет) Тогда Макет = Документы.СчетНаОплату.ПечатнаяФорма(); Макет.УстановитьПараметры(Параметры); РезультатМакет = Макет.Получить(); КешМакетов.Добавить(КлючКеша, РезультатМакет, 3600); // Кеш на 1 час
КонецЕсли;

3. Оптимизируйте работу с большими данными

Если в параметрах передаются большие таблицы (например, список товаров на 1000 позиций), разбейте их на части или используйте постраничную обработку:

ТоварыЧасть1 = ПолучитьТоварыСтроки(1, 500); ТоварыЧасть2 = ПолучитьТоварыСтроки(501, 1000); Макет.УстановитьПараметр("Товары1", ТоварыЧасть1);
Макет.УстановитьПараметр("Товары2", ТоварыЧасть2);

4. Избегайте рекурсивных вызовов

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

Проблема Причина Решение

Медленное формирование макета Слишком много параметров или большие данные Объединяйте параметры в структуры, используйте кеширование

Ошибка "Переполнение стека" Рекурсивные вызовы макетов Ограничьте глубину вложенности или используйте альтернативные подходы

Параметры не обновляются Кеш макета не очищается Используйте ОчиститьКеш() перед повторным формированием

Примеры реальных задач с параметрами макета

Рассмотрим несколько практических сценариев, где параметры макета решают реальные бизнес-задачи.

1. Печать счёта на оплату с логотипом и реквизитами

Задача: сформировать счёт на оплату с динамическими данными (номер, дата, контрагент) и логотипом компании.

Решение:

// Получаем макет Макет = Документы.СчетНаОплату.ПечатнаяФорма(); // Устанавливаем параметры Макет.УстановитьПараметр("Организация", Объект.Организация.Наименование); Макет.УстановитьПараметр("ИНН", Объект.Организация.ИНН); Макет.УстановитьПараметр("Номер", Объект.Номер); Макет.УстановитьПараметр("Дата", Объект.Дата); Макет.УстановитьПараметр("Контрагент", Объект.Контрагент.Наименование); // Добавляем логотип Логотип = Новый ДвоичныеДанные(Объект.Организация.Логотип.Получить()); Макет.УстановитьПараметр("Логотип", Логотип); // Формируем результат Результат = Макет.Получить();
Результат.Показать();

2. Формирование отчёта по продажам с фильтром по периоду

Задача: создать отчёт по продажам, где период задаётся параметрами.

Решение для СКД:

СхемаКомпоновки = Отчеты.Продажи.ПолучитьСхемуКомпоновки(); Настройки = КомпоновщикНастроек.ПолучитьНастройкиПоУмолчанию(); // Устанавливаем параметры периода Настройки.ПараметрыДанных.УстановитьПараметр("ДатаНачала", НачалоМесяца(ТекущаяДата())); Настройки.ПараметрыДанных.УстановитьПараметр("ДатаОкончания", КонецМесяца(ТекущаяДата())); // Формируем отчёт КомпоновщикМакета = Новый КомпоновщикМакетаКомпоновкиДанных; КомпоновщикМакета.Инициализировать(СхемаКомпоновки, Настройки); Результат = КомпоновщикМакета.Выполнить();
Результат.Показать();

3. Генерация этикеток для товаров с штрихкодами

Задача: распечатать этикетки для партий товаров с уникальными штрихкодами.

Решение:

Макет = Документы.ЭтикеткиТоваров.ПечатнаяФорма(); // Передаём таблицу товаров Товары = Новый ТаблицаЗначений; Для Каждого Товар Из Объект.Товары Цикл Строка = Товары.Добавить(); Строка.Наименование = Товар.Номенклатура.Наименование; Строка.Штрихкод = Товар.Номенклатура.Штрихкод; Строка.Количество = Товар.Количество; КонецЦикла; Макет.УстановитьПараметр("Товары", Товары); Макет.УстановитьПараметр("ДатаПечати", ТекущаяДата()); Результат = Макет.Получить();
Результат.Показать();

В макете этикеток используется цикл для вывода каждой позиции:

&НаКаждойСтроке(Товары) &Штрихкод(Строка.Штрихкод, 200, 50) &Текст(Строка.Наименование) &Текст("Кол-во: ", Строка.Количество)
&КонецЦикла

FAQ: Ответы на частые вопросы о параметрах макета в 1С

Можно ли передавать в параметры макета объекты (например, документ целиком)?

Нет, напрямую передавать объекты (например, ДокументОбъект.СчетНаОплату) нельзя. Параметры макета поддерживают только простые типы данных (Строка, Число, Дата и т.д.), ссылки на объекты метаданных (СправочникСсылка.Контрагенты) и структуры/массивы.

Решение: передавайте отдельные свойства объекта (например, Объект.Номер, Объект.Дата) или формируйте структуру с нужными данными.

Как передать в макет список значений (например, для выпадающего списка)?

Список значений (СписокЗначений) напрямую передать нельзя, но можно преобразовать его в Массив или ТаблицуЗначений:

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

В макете используйте цикл для обработки массива.

Почему параметры макета не обновляются при изменении данных?

Чаще всего это связано с кешированием макета. Платформа 1С:Предприятие может сохранять сформированный макет в памяти, и при повторном вызове возвращать кешированную версию.

Решения:

Используйте метод ОчиститьКеш() перед формированием макета.

Добавьте уникальный идентификатор в ключ кеша (например, текущее время).

Проверьте, не переопределён ли макет в расширении конфигурации.

Как передать в макет изображение из базы данных?

Начиная с версии 8.3.20, можно передавать двоичные данные (ДвоичныеДанные), включая изображения. Пример:

Изображение = Новый ДвоичныеДанные(Объект.Логотип.Получить()); Макет.УстановитьПараметр("Логотип", Изображ

Проблема	Причина	Решение
Медленное формирование макета	Слишком много параметров или большие данные	Объединяйте параметры в структуры, используйте кеширование
Ошибка "Переполнение стека"	Рекурсивные вызовы макетов	Ограничьте глубину вложенности или используйте альтернативные подходы
Параметры не обновляются	Кеш макета не очищается	Используйте `ОчиститьКеш()` перед повторным формированием

Заполнение параметров макета в 1С: от теории к практике

Что такое параметры макета в 1С и зачем они нужны

Типы данных параметров макета: что можно передавать

Как заполнить параметры макета в коде: пошаговая инструкция

1. Объявление параметров в макете

2. Передача параметров из кода

3. Особенности работы с динамическими параметрами

Типичные ошибки при заполнении параметров и как их избежать

1. Ошибка "Параметр не найден"

2. Ошибка "Неверный тип данных"

3. Параметры не подставляются в макет

4. Ошибки при работе со ссылками

Продвинутые техники: динамические макеты и параметры

1. Использование выражений в параметрах

2. Передача бинарных данных (изображений, файлов)

3. Интеграция с внешними системами

4. Кеширование макетов с параметрами

Оптимизация производительности при работе с параметрами

1. Минимизируйте количество параметров

2. Используйте кеширование

3. Оптимизируйте работу с большими данными

4. Избегайте рекурсивных вызовов

Примеры реальных задач с параметрами макета

1. Печать счёта на оплату с логотипом и реквизитами

2. Формирование отчёта по продажам с фильтром по периоду

3. Генерация этикеток для товаров с штрихкодами

FAQ: Ответы на частые вопросы о параметрах макета в 1С

📖 Читайте также