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

Работа с динамическими списками в платформе 1С:Предприятие часто возникает при разработке пользовательских отчетов и обработок. Гибкость механизма компоновки данных (СКД) позволяет выводить информацию в зависимости от введенных значений, но начинающие разработчики нередко сталкиваются с трудностями при настройке новых параметров.

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

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

Подготовка и анализ текущей схемы

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

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

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

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

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

Создание нового параметра в макете компоновки

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

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

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

• 📅 Для выбора дат используйте тип Дата с возможностью указания периода.
• 🏢 Для выбора организаций или контрагентов выбирайте соответствующие типы справочников.
• 🔢 Для фильтрации по суммам или количеству подойдет тип Число.
• 📝 Для произвольного текстового поиска используйте тип Строка с неограниченной длиной.

Не забудьте заполнить поле "Заголовок". Это то название, которое увидит пользователь в форме настроек отчета. Хороший заголовок должен быть кратким, но исчерпывающим, чтобы у пользователя не возникало вопросов о том, что именно нужно ввести.

Настройка отборов и связей с данными

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

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

Ключевой момент — поле "Значение". Здесь вы должны указать имя созданного ранее параметра. Синтаксически это выглядит как &ИмяПараметра. Платформа автоматически подставит значение, введенное пользователем, в момент формирования запроса. Если параметр допускает пустое значение, настройте условие "Доступно если" или используйте логическое "ИЛИ" для обработки случая, когда фильтр не задан.

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

В приведенном выше примере кода видно, как параметр &ВидНоменклатуры используется в конструкции ГДЕ. Это стандартный паттерн для динамических списков. Однако, если логика сложнее, может потребоваться использование временных таблиц или вложенных запросов.

Работа со сложными условиями и таблицей типов

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

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

Задача фильтрации	Вид сравнения	Особенности настройки
Выбор конкретного периода	В интервале	Требует два параметра: ДатаНачала и ДатаОкончания
Поиск по части названия	Начинается с	Удобно для быстрого поиска в больших справочниках
Исключение определенных элементов	Не равно	Часто используется для скрытия служебных записей
Фильтрация по иерархии	В группе	Автоматически включает всех потомков выбранного элемента

Особое внимание стоит уделить параметрам с типом "Список значений". При использовании вида сравнения "В списке" платформа автоматически генерирует SQL-код, который корректно обрабатывает множественный выбор. Вам не нужно писать циклы или сложные конструкции — СКД сделает это за вас.

Если вам необходимо реализовать логику, где параметр может быть не задан (то есть выводятся все данные), используйте конструкцию в запросе вида (&Параметр ЕСТЬ NULL ИЛИ Поле = &Параметр). Это универсальный прием, позволяющий сделать фильтр опциональным без создания дополнительных переключателей в интерфейсе.

⚠️ Внимание: При использовании опциональных параметров с конструкцией "ЕСТЬ NULL" убедитесь, что индексы в базе данных построены корректно, иначе производительность выборки на больших объемах данных может критически упасть.

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

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

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

// Получаем текущие настройки
НастройкиКомпоновки = Отчет.КомпоновщикНастроекКомпоновкиДанных.Настройки;

// Находим параметр по имени
ЭлементНастройки = НастройкиКомпоновки.Параметры.Найти("Период");

// Устанавливаем значение
Если ЭлементНастройки <> Неопределено Тогда
ЭлементНастройки.Значение = ТекущаяДата();
КонецЕсли;

// Применяем изменения
Отчет.КомпоновщикНастроекКомпоновкиДанных.Настройки = НастройкиКомпоновки;

Такой подход часто используется в 1С для реализации сценариев "Отчет за сегодня" или "Отчет по текущему документу". Вы можете автоматически подставлять ссылку на текущий документ в параметр отбора, чтобы пользователь сразу видел нужные данные.

Как сбросить параметры программно?

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

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

Оптимизация и решение частых проблем

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

Используйте панель производительности в режиме предприятия или инструмент "Технология" для анализа времени выполнения запроса. Если вы видите, что основное время тратится на сканирование таблиц, пересмотрите логику отбора. Возможно, стоит добавить вычисляемое поле в запрос или изменить структуру временных таблиц.

• 🚀 Проверяйте планы выполнения запросов при добавлении новых условий.
• 🔍 Убедитесь, что поля, участвующие в отборе, имеют индексы в конфигурации базы данных.
• ⚙️ Избегайте использования функций от полей в левой части условия сравнения (например, ГОД(Дата) = &Год), это отключает использование индексов.

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

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

Вопросы и ответы (FAQ)

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

Для этого в тексте запроса используйте конструкцию (&Параметр ЕСТЬ NULL ИЛИ Поле = &Параметр). Также в свойствах параметра в макете компоновки данных можно разрешить использование пустого значения и настроить отбор с условием "Доступно если параметр заполнен".

Почему параметр не передается в запрос, хотя он создан?

Скорее всего, вы забыли указать имя параметра в отборе набора данных. Проверьте, что в поле "Значение" условия отбора написано имя с амперсандом (например, &МойПараметр), и что оно точно совпадает с именем в списке параметров.

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

Да, это возможно. Вы можете добавить несколько строк в отбор набора данных, и в каждой из них в поле "Значение" указать один и тот же параметр. Логика будет работать как "И" (если поля в одном уровне вложенности отбора) или "ИЛИ" (при правильной группировке).

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

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

Что делать, если при выборе параметра отчет выдает ошибку "Тип значения неверный"?

Проверьте соответствие типа параметра в макете и типа поля в запросе. Например, нельзя сравнивать поле типа Число с параметром типа Строка без явного преобразования. Также убедитесь, что для ссылочных типов выбрана правильная ссылка на объект метаданных.