Как вывести параметры СКД на форму отчёта в 1С 8.2

Вывод параметров системы компоновки данных на форму отчёта в 1С 8.2 — стандартная задача, которая решается двумя путями: через настройки пользователя (без программирования) и через программное размещение элементов на управляемой или обычной форме. Правильный выбор зависит от того, кто будет менять параметры — конечный пользователь или разработчик при открытии отчёта.

Ключевой момент, который часто упускают: параметр появляется на форме только тогда, когда у него включён флажок «Включать в пользовательские настройки» и задан режим редактирования «Быстрый доступ». Если параметр оставить во «внутренних» настройках, пользователь увидит его только через кнопку «Настройки».

Где в СКД задаются параметры и почему они не видны на форме

Параметры отчёта объявляются на закладке «Параметры» схемы компоновки данных. Здесь задаётся имя, тип, значение по умолчанию, а также флажки «Ограничение доступности» и «Включать в пользовательские настройки». Именно эти флажки определяют, сможет ли пользователь вообще увидеть и изменить параметр.

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

Ещё одна причина — параметр используется в запросе как выражение (например, &Период в виртуальной таблице), но в самой схеме не объявлен. Тогда СКД создаёт его автоматически с ограничением доступности, и вывести его на форму без снятия флажка нельзя.

Вывод параметров через пользовательские настройки без кода

Самый быстрый способ — не писать код вовсе. Откройте схему компоновки данных, перейдите на закладку «Настройки», выберите ветку «Отчет» и найдите группу «Параметры данных». В окне пользовательских настроек (кнопка с «звёздочкой» или отдельная закладка «Пользовательские настройки» в режиме конфигуратора) добавьте нужный параметр и установите режим редактирования «Быстрый доступ».

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

1. 1
   Откройте схему компоновки данных отчёта и проверьте параметр на закладке «Параметры»: снимите ограничение доступности, задайте тип и значение по умолчанию
2. 2
   Перейдите на закладку «Настройки», выделите корневой элемент «Отчет»
3. 3
   Откройте окно пользовательских настроек и добавьте параметр в список
4. 4
   Установите для параметра режим редактирования «Быстрый доступ»
5. 5
   Сохраните отчёт, откройте его в режиме 1С:Предприятие и проверьте, что поле параметра появилось на форме

Проверка результата

После сохранения откройте отчёт в пользовательском режиме. Поле параметра должно появиться в панели быстрых настроек, а изменение значения и нажатие «Сформировать» — менять результат отчёта. Если поле появилось, но отчёт не реагирует, проверьте, что параметр реально используется в запросе или в отборе.

Программный вывод параметров на форму

Когда требуется гибкое управление — например, заполнить параметры при открытии, скрыть часть из них или построить собственную форму — работают с объектом КомпоновщикНастроек. У отчёта, построенного на СКД, компоновщик доступен через реквизит формы «Отчет» и его свойство КомпоновщикНастроек.

Настройки делятся на основные (Настройки) и пользовательские (ПользовательскиеНастройки). Чтобы параметр стал видимым и редактируемым программно, его нужно найти в коллекции Элементы пользовательских настроек по идентификатору и установить свойства Использование и Значение.

Настройки = Отчет.КомпоновщикНастроек.Настройки;
Параметр = Настройки.ПараметрыДанных.НайтиЗначениеПараметра(
Новый ПараметрКомпоновкиДанных("НачалоПериода"));
Если Параметр <> Неопределено Тогда
Параметр.Использование = Истина;
Параметр.Значение = НачалоМесяца(ТекущаяДата());
КонецЕсли;

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

Для Каждого Элемент Из Отчет.КомпоновщикНастроек.ПользовательскиеНастройки.Элементы Цикл
	Если ТипЗнч(Элемент) = Тип("ЗначениеПараметраНастроекКомпоновкиДанных") Тогда
		Сообщить(Элемент.ИдентификаторПользовательскойНастройки);
	КонецЕсли;
КонецЦикла;

Особенности обычных и управляемых форм в 1С 8.2

В 1С 8.2 отчёт на СКД может работать как на обычной форме (толстый клиент), так и на управляемой (тонкий и веб-клиент). На управляемой форме панель быстрых настроек платформа строит автоматически на основе пользовательских настроек — вмешательство разработчика обычно не требуется.

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

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

Типичные ошибки и их устранение

Самая распространённая ошибка — параметр объявлен, но не включён в пользовательские настройки, а разработчик ищет его на форме. Вторая по частоте — параметр добавлен в пользовательские настройки, но с режимом «Обычный», и пользователь не находит его, потому что он доступен только через кнопку настроек.

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

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

После любых изменений в структуре параметров проверяйте отчёт под реальным пользователем, а не только под разработчиком. Платформа сохраняет пользовательские настройки в хранилище, и старая версия настроек может скрывать новые параметры. В этом случае помогает команда «Установить стандартные настройки» в окне настроек отчёта.

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

FAQ