Установка значения параметра динамического списка в 1С: полное руководство с примерами

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

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

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

Что такое параметры динамического списка и зачем они нужны

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

Основные типы параметров, с которыми приходится работать:

• 🔹 Параметры отбора — фильтруют данные по заданным условиям (например, только документы за текущий месяц).
• 🔹 Параметры виртуальных таблиц — управляют тем, какие поля и как будут выводиться (актуально для списков, построенных на виртуальных таблицах).
• 🔹 Параметры связей — обеспечивают взаимодействие между несколькими динамическими списками на одной форме (например, выбор элемента в одном списке фильтрует второй).
• 🔹 Параметры сортировки — определяют порядок отображения данных (по дате, по наименованию и т.д.).

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

Способы установки параметров: от конструктора до кода

Установить значение параметра динамического списка в 1С можно несколькими способами. Выбор метода зависит от задачи:

1. Через конструктор формы — самый простой способ, подходит для статических параметров, которые не меняются во время работы.
2. Через свойства объекта в конфигураторе — позволяет гибко настраивать параметры, но требует ручного ввода значений.
3. Программно, через 1С:Скрипт — единственный вариант для динамического изменения параметров в зависимости от действий пользователя.

Рассмотрим каждый способ подробнее.

1. Установка параметров в конструкторе формы

Если параметр списка не меняется в процессе работы (например, всегда фильтрует данные по текущему пользователю), его можно задать в конструкторе:

1. Откройте форму в Конфигураторе.
2. Выделите динамический список и перейдите на вкладку Данные.
3. В разделе Параметры добавьте новый параметр и укажите его значение (например, ТекущийПользователь = &ТекущийПользователь).

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

2. Настройка через свойства объекта

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

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

Пример: если нужно фильтровать список документов по дате, можно создать параметр ДатаНачала и связать его с полем ввода на форме.

3. Программная установка параметров

Для динамического изменения параметров (например, при выборе элемента в другом списке) используется 1С:Скрипт. Основные методы:

• 📝 УстановитьПараметр — устанавливает значение одного параметра.
• 📝 Параметры.Добавить — добавляет новый параметр в коллекцию.
• 📝 Обновить — применяет изменения и перезагружает данные списка.

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

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

Работа с параметрами отбора: фильтрация данных

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

Чтобы установить параметр отбора программно, используйте следующий синтаксис:

// Установка отбора по полю"Контрагент"
ДинамическийСписок.Параметры.Отбор.Контрагент.Установить(ВыбранныйКонтрагент);

// Установка сложного отбора (диапазон дат)
ДинамическийСписок.Параметры.Отбор.Дата.Установить(НачалоПериода, КонецПериода);

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

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

Допустим, на форме есть поле выбора организации, и при его изменении должен фильтроваться список документов. Код обработчика события ПриИзменении:

Процедура ОрганизацияПриИзменении(Элемент)
Если ЗначениеЗаполнено(Элемент.Значение) Тогда
ДинамическийСписокДокументов.Параметры.Отбор.Организация.Установить(Элемент.Значение);
ДинамическийСписокДокументов.Обновить;
Иначе
ДинамическийСписокДокументов.Параметры.Отбор.Организация.Очистить;
ДинамическийСписокДокументов.Обновить;
КонецЕсли;
КонецПроцедуры

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

• ❌ Несовпадение имен — параметр отбора назван иначе, чем поле в источнике данных.
• ❌ Забыли вызвать Обновить — изменения не применяются, пока список не перезагружен.
• ❌ Некорректные типы данных — например, передача строки вместо даты.

Параметры виртуальных таблиц: управление полями и группировками

Если динамический список построен на основе виртуальной таблицы (например, Документ.ПоступлениеТоваровУслуг), то помимо отборов можно настраивать параметры, влияющие на структуру данных. К ним относятся:

• 📊 Поля — какие колонки будут отображаться.
• 📊 Группировки — как данные будут сгруппированы (по дате, по контрагенту и т.д.).
• 📊 Параметры запроса — дополнительные условия, передаваемые в запрос к базе.

Для работы с этими параметрами используется коллекция ПараметрыВиртуальнойТаблицы. Пример:

// Установка группировки по полю"Контрагент"
ДинамическийСписок.ПараметрыВиртуальнойТаблицы.Группировки.Добавить("Контрагент");

// Добавление поля"СуммаДокумента" в список выводимых полей
ДинамическийСписок.ПараметрыВиртуальнойТаблицы.Поля.Добавить("СуммаДокумента");

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

Таблица: сравнение параметров виртуальных таблиц и обычных отборов

Динамическая связь между списками: как передавать параметры

Частая задача — сделать так, чтобы выбор элемента в одном динамическом списке автоматически фильтровал данные в другом. Например, при выборе контрагента в первом списке во втором отображаются только его документы.

Для этого используются события и программная передача параметров. Алгоритм следующий:

1. Создайте обработчик события ПриИзменении для первого списка.
2. В обработчике получите выбранное значение (например, ВыбранныйКонтрагент).
3. Установите это значение как параметр отбора для второго списка.
4. Вызовите Обновить для второго списка.

Пример кода:

Процедура КонтрагентыПриИзменении(Элемент)
Если НЕ Элемент.Значение = Неопределено Тогда
СписокДокументов.Параметры.Отбор.Контрагент.Установить(Элемент.Значение);
СписокДокументов.Обновить;
Иначе
СписокДокументов.Параметры.Отбор.Контрагент.Очистить;
СписокДокументов.Обновить;
КонецЕсли;
КонецПроцедуры

Если связь работает некорректно, проверьте:

• 🔍 Совпадают ли имена параметров отбора в обоих списках.
• 🔍 Правильно ли передается значение (например, не передается Неопределено вместо объекта).
• 🔍 Нет ли циклических ссылок (когда изменение одного списка вызывает обновление другого, а тот в свою очередь — первого).

Имена параметров отбора совпадают|Значения передаются корректно (не Неопределено)|Нет циклических обновлений|Метод Обновить вызван после изменения параметров-->

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

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

1. Параметры не применяются

Если вы установили параметр, но список не обновляется:

• ✅ Убедитесь, что вызван метод Обновить.
• ✅ Проверьте, что имя параметра совпадает с именем поля в источнике данных.
• ✅ Убедитесь, что параметр добавлен в коллекцию Параметры (иногда разработчики забывают это сделать).

2. Ошибка"Поле не найдено"

Эта ошибка возникает, если:

• Параметр отбора ссылается на несуществующее поле в источнике данных.
• Имя поля написано с ошибкой (например, Контрагент вместо КонтрагентСсылка).
• Источник данных изменился, но код не обновлен.

Решение: проверьте структуру источника данных в Конфигураторе и сравните с именами параметров в коде.

3. Медленная работа списка после изменения параметров

Если после установки параметров список стал работать медленно:

• 🐢 Проверьте, не добавили ли вы сложные группировки или вычисляемые поля.
• 🐢 Убедитесь, что по полям отбора есть индексы в базе данных.
• 🐢 Попробуйте ограничить количество выбираемых данных (например, добавить отбор по дате).

4. Параметры сбрасываются при открытии формы

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

• 🔄 Проверьте, не пересоздается ли список при открытии (например, в обработчике ПриОткрытии).
• 🔄 Убедитесь, что параметры устанавливаются после инициализации списка.
• 🔄 Если параметры зависят от других элементов формы, проверьте порядок их загрузки.

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

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

Пример 1: Фильтрация списка номенклатуры по складу

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

Решение:

Процедура СкладПриИзменении(Элемент)
Если ЗначениеЗаполнено(Элемент.Значение) Тогда
СписокНоменклатуры.Параметры.Отбор.Склад.Установить(Элемент.Значение);
Иначе
СписокНоменклатуры.Параметры.Отбор.Склад.Очистить;
КонецЕсли;
СписокНоменклатуры.Обновить;
КонецПроцедуры

Пример 2: Динамический список с группировкой по месяцам

Задача: создать список документов, сгруппированный по месяцам, с возможностью развернуть детализацию по каждому месяцу.

Решение:

// Установка группировки по месяцу
СписокДокументов.ПараметрыВиртуальнойТаблицы.Группировки.Добавить("ПериодМесяц");

// Настройка отображения группировки
СписокДокументов.Группировка = Истина;

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

Задача: при открытии формы со списком документов из другой формы передать текущий отбор по контрагенту.

Решение:

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

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

Пример 4: Динамический список с параметром"Только актуальные"

Задача: добавить флажок на форму, который будет фильтровать список, показывая только актуальные записи (например, не помеченные на удаление).

Решение:

Процедура ТолькоАктуальныеПриИзменении(Элемент)
Если Элемент.Значение Тогда
СписокДанных.Параметры.Отбор.ПометкаУдаления.Установить(Ложь);
Иначе
СписокДанных.Параметры.Отбор.ПометкаУдаления.Очистить;
КонецЕсли;
СписокДанных.Обновить;
КонецПроцедуры

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

Неправильная работа с параметрами динамических списков может значительно замедлить работу 1С, особенно в больших базах. Вот несколько советов по оптимизации:

1. Ограничивайте количество данных

Всегда добавляйте отбор по дате или другому ограничивающему полю, даже если пользователь может его сбросить. Например:

// Отбор по умолчанию: последний год
ДинамическийСписок.Параметры.Отбор.Дата.Установить(НачалоГода(ТекущаяДата), ТекущаяДата);

2. Используйте индексы

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

1. Откройте Конфигуратор.
2. Перейдите в меню Администрирование → Тестирование и исправление → Планы запросов.
3. Проанализируйте, по каким полям чаще всего идут отборы, и добавьте индексы при необходимости.

3. Избегайте сложных вычисляемых полей

Если в динамическом списке нужно показать вычисляемое поле (например, сумму с НДС), лучше:

• 📉 Вынести вычисление в отдельное поле в базе (если возможно).
• 📉 Использовать ПолеВыбора с предварительным расчетом.
• 📉 Ограничить количество вычисляемых полей.

4. Кэшируйте часто используемые параметры

Если параметры списка редко меняются, можно кэшировать их значения, чтобы избежать повторных обращений к базе. Пример:

Перем мТекущийКонтрагент;

Процедура УстановитьКонтрагента(Контрагент)
Если мТекущийКонтрагент <> Контрагент Тогда
мТекущийКонтрагент = Контрагент;
СписокДокументов.Параметры.Отбор.Контрагент.Установить(Контрагент);
СписокДокументов.Обновить;
КонецЕсли;
КонецПроцедуры

5. Используйте асинхронную загрузку

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

СписокДокументов.АсинхроннаяЗагрузка = Истина;

FAQ: ответы на частые вопросы

Для Каждого Параметр Из ДинамическийСписок.Параметры Цикл
Сообщить(Параметр.Имя +":" + Параметр.Значение);
КонецЦикла;

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

СписокКонтрагентов = Новый СписокЗначений;
СписокКонтрагентов.Добавить(Контрагент1);
СписокКонтрагентов.Добавить(Контрагент2);

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

ДинамическийСписок.Параметры.Отбор.Очистить;
ДинамическийСписок.Обновить;

ДинамическийСписок.ИсточникДанных = Новый ИсточникДанныхСписок(Новый Запрос(
"ВЫБРАТЬ
| Номенклатура.Ссылка КАК Ссылка,
| Номенклатура.Наименование КАК Наименование
|ИЗ
| Справочник.Номенклатура КАК Номенклатура
|ГДЕ
| Номенклатура.ПометкаУдаления = ЛОЖЬ"
).Выполнить);

ДинамическийСписок.Обновить;