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

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

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

1. Базовая передача параметров через свойства динамического списка

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

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

• ✅ Плюсы: не требует программирования, настраивается визуально
• ⚠️ Минусы: параметры жёстко привязаны к форме, сложно динамически менять
• 🔧 Когда использовать: для простых фильтров, которые редко изменяются

Пример кода для установки параметра перед открытием формы:

Процедура ПриОткрытии()
НачалоПериода = НачалоДня(ТекущаяДата());
КонецПериода = КонецДня(ТекущаяДата() + 30);
КонецПроцедуры

2. Программная передача параметров через метод УстановитьПараметр()

Для динамического управления отборами используйте метод УстановитьПараметр(). Этот подход даёт полный контроль над передачей значений и позволяет менять параметры "на лету" без перезагрузки формы.

Основной синтаксис метода:

ДинамическийСписок.УстановитьПараметр("ИмяПараметра", Значение);

Важные нюансы работы с методом:

• 📌 Имя параметра должно точно совпадать с именем в запросе динамического списка (с учётом регистра!)
• 🔄 После изменения параметров обязательно вызовите Обновить() для применения фильтров
• ⚡ Для сложных типов (массивы, структуры) используйте Новый Структура() или Новый Массив()

Практический пример с передачей массива значений:

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

ДинамическийСписок1.УстановитьПараметр("Отборы", ПараметрыОтбора);
ДинамическийСписок1.Обновить();

3. Передача параметров через текст запроса динамического списка

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

Алгоритм работы:

1. Получите текущий текст запроса через ДинамическийСписок.ТекстЗапроса
2. Измените его программно, добавив нужные параметры
3. Установите модифицированный запрос обратно через ДинамическийСписок.УстановитьТекстЗапроса()
4. Обновите список

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

ТекстЗапроса = ДинамическийСписок1.ТекстЗапроса;
Если НЕ СтрНайти(ТекстЗапроса, "ГДЕ") > 0 Тогда
ТекстЗапроса = ТекстЗапроса + " ГДЕ Дата >= &НачалоПериода";
Иначе
ТекстЗапроса = СтрЗаменить(ТекстЗапроса, "ГДЕ", "ГДЕ Дата >= &НачалоПериода И");
КонецЕсли;

ДинамическийСписок1.УстановитьТекстЗапроса(ТекстЗапроса);
ДинамическийСписок1.УстановитьПараметр("НачалоПериода", НачалоДня(ТекущаяДата()));
ДинамическийСписок1.Обновить();

4. Использование временных таблиц для сложных параметров

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

Преимущества подхода:

• ⚡ Производительность: нет ограничений на объём передаваемых данных
• 🔗 Гибкость: можно передавать сложные структуры данных
• 🔄 Динамичность: таблицы создаются и наполняются "на лету"

Пошаговый алгоритм реализации:

// 1. Создаём временную таблицу
Запрос = Новый Запрос;
Запрос.Текст =
"ВЫБРАТЬ
|   Товары.Ссылка КАК Ссылка
|ПОМЕСТИТЬ ВТТовары
|ИЗ
|   Справочник.Номенклатура КАК Товары
|ГДЕ
|   Товары.ПометкаУдаления = ЛОЖЬ";

// 2. Выполняем запрос для создания временной таблицы
Запрос.Выполнить();

// 3. Модифицируем основной запрос динамического списка
ОсновнойЗапрос = ДинамическийСписок1.ТекстЗапроса;
ОсновнойЗапрос = СтрЗаменить(ОсновнойЗапрос,
"ГДЕ",
"ГДЕ Ссылка В (ВЫБРАТЬ Ссылка ИЗ ВТТовары) И");

ДинамическийСписок1.УстановитьТекстЗапроса(ОсновнойЗапрос);
ДинамическийСписок1.Обновить();

Убедиться в наличии прав на создание временных таблиц|Проверить ограничения сервера 1С на объём временных данных|Очищать временные таблицы после использования|Тестировать производительность с реальными объёмами данных-->

5. Передача параметров через обработку события ПриФормированииДинамическогоСписка

Один из самых гибких способов — использование события ПриФормированииДинамическогоСписка. Это позволяет вмешаться в процесс формирования списка на этапе выполнения запроса и динамически изменить параметры.

Особенности метода:

• 🔧 Работает перед выполнением основного запроса
• 📊 Имеет доступ ко всем параметрам запроса через ЭлементыФормы.ИмяСписка.ПараметрыЗапроса
• 🔄 Позволяет модифицировать не только параметры, но и сам текст запроса

Пример реализации:

Процедура ДинамическийСписок1ПриФормированииДинамическогоСписка(Элемент, СтандартнаяОбработка)
// Модифицируем параметры перед выполнением запроса
Элемент.ПараметрыЗапроса.Установить("ТекущийПользователь", ПользователиИнформационнойБазы.ТекущийПользователь());

// Можно изменить и сам запрос
Если НЕ ЗначениеЗаполнено(Элемент.ПараметрыЗапроса.Получить("ДатаНачала")) Тогда
ТекстЗапроса = Элемент.ТекстЗапроса;
ТекстЗапроса = СтрЗаменить(ТекстЗапроса, "ГДЕ", "ГДЕ Дата >= НачалоДня(&ТекущаяДата) И");
Элемент.УстановитьТекстЗапроса(ТекстЗапроса);
Элемент.ПараметрыЗапроса.Установить("ТекущаяДата", ТекущаяДата());
КонецЕсли;
КонецПроцедуры

6. Передача параметров между формами через реквизиты

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

Схема передачи:

1. Создайте реквизит формы с нужным типом данных
2. Передайте значение реквизита при открытии формы
3. Используйте значение реквизита в событии ПриСозданииНаСервере или ПриОткрытии

Пример передачи параметров между формами:

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

// В форме выбора (модуль объекта)
Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)
Если Параметры.Свойство("Контрагент") Тогда
ДинамическийСписок1.УстановитьПараметр("ТекущийКонтрагент", Параметры.Контрагент);
ДинамическийСписок1.УстановитьПараметр("ДатаОтбора", Параметры.ДатаНачала);
ДинамическийСписок1.Обновить();
КонецЕсли;
КонецПроцедуры

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

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

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

Типичные ошибки и их решения

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

• 🚨 Ошибка: Параметры не применяются после вызова Обновить()
  Решение: Проверьте регистр имён параметров — они должны точно совпадать с именами в запросе
• ⚠️ Ошибка: "Поле не найдено" при использовании временных таблиц
  Решение: Убедитесь, что временная таблица создана ДО её использования в основном запросе
• ❌ Ошибка: Зависание интерфейса при передаче больших массивов
  Решение: Разбивайте данные на пакеты по 500-1000 элементов или используйте временные таблицы

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

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

FAQ: Частые вопросы по передаче параметров в динамические списки

&НаСервере
Процедура УстановитьФильтр(Значение)
ДинамическийСписокСервер.УстановитьПараметр("Фильтр", Значение);
ДинамическийСписокСервер.Обновить();
КонецПроцедуры