Как добавить параметр в отчет 1С: Настройка отборов и полей ввода

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

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

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

Анализ типа отчета и выбор метода реализации

Первым шагом на пути к успешной модификации является идентификация архитектуры отчета. В современных конфигурациях, таких как 1С:Бухгалтерия предприятия 3.0 или 1С:Управление торговлей, подавляющее большинство отчетов построено на базе Системы Компоновки Данных (СКД). Это гибкий инструмент, позволяющий описывать логику выборки декларативно, без написания сложного программного кода.

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

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

Для проверки типа отчета откройте его свойства в конфигураторе. Если в поле «Макет» указан тип «Компоновка макета», вы имеете дело с СКД. Если же макет имеет тип «Табличный документ» или «Поле компоновки данных» отсутствует, скорее всего, логика отчета прописана программно. Выбор правильного пути сэкономит вам часы отладки в дальнейшем.

Добавление параметра в отчет на базе СКД

Работа с Системой Компоновки Данных начинается с открытия макета компоновки. В дереве метаданных найдите нужный отчет, раскройте его и дважды кликните по элементу «Макет». Перед вами откроется редактор, где в левой части расположено дерево структуры отчета, а в нижней части — вкладки свойств.

Перейдите на вкладку Параметры. Именно здесь определяется список полей, которые пользователь увидит в форме настройки отчета перед его формированием. Чтобы добавить новый критерий, нажмите кнопку «Добавить» (зеленый плюс) и выберите тип параметра. Чаще всего используются типы «Дата», «Строка», «Число» или ссылки на конкретные справочники, например, Справочник.Номенклатура.

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

Ключевым моментом является привязка созданного параметра к тексту запроса. Перейдите на вкладку Запрос. В тексте запроса вы должны использовать имя вашего параметра, заключенное в знак амперсанда. Синтаксис выглядит следующим образом: &ИмяПараметра. Система автоматически подставит значение, выбранное пользователем, в момент выполнения запроса.

ВЫБРАТЬ
Номенклатура.Ссылка КАК Номенклатура,
Номенклатура.Наименование КАК Наименование
ИЗ
Справочник.Номенклатура КАК Номенклатура
ГДЕ
Номенклатура.ВидНоменклатуры = &ВидНоменклатуры

Если параметр не используется в тексте запроса напрямую, а служит для отбора уже сформированных данных, его можно задействовать в настройках отчета. Для этого в структуре отчета (вкладка «Настройки») нужно добавить отбор, где в поле «Поле» выбрать ваш параметр, а в условии указать необходимое сравнение.

Настройка отборов и условий фильтрации

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

Для настройки откройте вкладку «Настройки» в макете СКД. Вы увидите структуру, состоящую из элементов «Отчет», «Группировки» и «Поля». Чтобы применить параметр как фильтр, найдите нужный уровень (обычно это корневой элемент «Отчет») и в нижней панели перейдите на подвкладку «Отборы».

• 🔍 Нажмите кнопку добавления отбора и в колонке «Поле» выберите созданный ранее параметр из списка доступных полей.
• ⚙️ В колонке «Условие» выберите оператор сравнения: «Равно», «В списке», «Между» или «Заполнено».
• 📝 В колонке «Значение» можно указать константу или связать с другим параметром, если требуется сложная логика.

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

Тип параметра	Рекомендуемое условие	Особенности использования
Дата	Между / Равно	Требует указания точного времени или использования функции НачалоДня
Справочник	В списке / Равно	Позволяет выбирать несколько элементов через многострочное поле ввода
Булево	Равно	Идеально для флажков типа «Показывать только активные»
Число	Больше / Меньше	Используется для фильтрации по суммам или количеству

Программное добавление параметров в модуле объекта

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

Для реализации этого подхода необходимо обработать событие ПриСозданииНаСервере или ПередГенерациейМакетаКомпоновкиДанных. В коде вы обращаетесь к объекту КомпоновщикНастроек и манипулируете коллекцией его параметров. Это требует уверенного владения встроенным языком 1С.

⚠️ Внимание: При программном изменении параметров убедитесь, что имена добавляемых параметров строго соответствуют тем, что используются в тексте запроса макета. Регистр символов имеет значение: &Параметр и &параметр — это разные сущности для движка 1С.

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

Процедура ПередГенерациейМакетаКомпоновкиДанных(Отчет, КомпоновщикНастроек, НастройкиКомпоновкиДанных)

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

КонецПроцедуры

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

Как отладить параметр, который не работает?

Если параметр добавлен, но отчет выдает ошибку или не фильтрует данные, включите отладчик запросов. В конфигураторе перейдите в меню «Администрирование» -> «Монитор запросов». Там вы увидите сгенерированный текст запроса с подставленными значениями. Проверьте, корректно ли подставилось значение и нет ли синтаксических ошибок в условии WHERE.

Работа с параметрами в старых отчетах (Табличный документ)

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

В таких отчетах параметры обычно объявляются в форме отчета или в модуле объекта как переменные. Чтобы пользователь мог ввести значение, на форму отчета добавляется поле ввода, связанное с переменной. Затем эта переменная передается в текст запроса.

• 📂 Откройте форму отчета в конфигураторе и добавьте новое поле ввода.
• 🔗 Установите свойство «Данные» поля ввода в имя переменной, которая будет хранить значение.
• 💻 В модуле объекта, в процедуре формирования отчета, найдите объект Запрос.
• 🔧 Используйте метод УстановитьПараметр для передачи значения из переменной формы в запрос.

Код установки параметра в классическом отчете выглядит следующим образом: Запрос.УстановитьПараметр("ИмяПараметра", ЗначениеПеременной). Если параметр не установлен, запрос может завершиться ошибкой или вернуть все данные без фильтрации.

Частые ошибки и способы их устранения

Даже опытные разработчики иногда допускают досадные ошибки при работе с параметрами отчетов 1С. Самая распространенная проблема — несоответствие типов данных. Если в базе данных поле хранит число, а параметр отчета имеет тип «Строка», система компоновки данных попытается привести типы, что может привести к ошибке выполнения или некорректному отбору.

Еще одна частая ошибка связана с областью видимости параметров. В СКД параметр, объявленный в макете, виден только внутри этого макета. Если вы пытаетесь передать значение из внешней обработки во внутренний параметр отчета без правильной настройки связей, значение просто потеряется. Всегда проверяйте цепочку передачи данных: Форма -> ПараметрыОтчета -> ТекстЗапроса -> База Данных.

⚠️ Внимание: Интерфейсы и названия пунктов меню могут незначительно отличаться в зависимости от версии платформы 1С:Предприятие (8.2, 8.3, 8.3.20+) и конкретной конфигурации (Бухгалтерия, ЗУП, УТ). Всегда сверяйтесь с документацией к вашей конкретной версии ПО, если какой-то пункт не находится на привычном месте.

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

Советы по оптимизации и

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

Используйте предопределенные значения (варианты по умолчанию) для параметров даты. Например, параметр «Период» по умолчанию должен устанавливаться в «Текущий месяц» или «Текущий квартал». Это избавит пользователя от необходимости каждый раз вручную выбирать даты при запуске отчета.

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

Можно ли сделать параметр обязательным для заполнения?

Да, в системе компоновки данных (СКД) можно настроить обязательность параметра. Для этого в свойствах параметра на вкладке «Параметры» нужно установить флаг или использовать ограничение в структуре отбора. Однако, чаще всего это реализуется через проверку в модуле объекта перед формированием: если параметр пуст, выводить сообщение пользователю и прерывать выполнение.

Как передать параметр из одной обработки в другую?

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

Почему параметр не отображается на форме отчета?

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

Можно ли использовать один параметр для нескольких полей отбора?

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

Как скрыть параметр от пользователя, но использовать его в логике?

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