Заполнение списка выбора в управляемой форме 1С: все способы и нюансы

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

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

1. Основные типы списков выбора в 1С и их назначение

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

• 📋 Поле выбора (ПолеВыбора) — классический выпадающий список с фиксированным набором значений. Подходит для небольших статических справочников (например, "Тип документа" или "Статус заказа").
• 🔍 Поле ввода с выбором (ПолеВводаСВыбором) — комбинированный элемент, позволяющий как выбирать из списка, так и вводить значение вручную. Часто используется для справочников с большим количеством элементов (контрагенты, номенклатура).
• 📊 Табличное поле с выбором — список, интегрированный в табличную часть формы. Требует особого подхода к заполнению, так как данные привязаны к строкам таблицы.
• 🔄 Динамический список — элемент, который подгружает данные "на лету" при изменении фильтров. Оптимален для работы с большими объёмами данных (например, остатки товаров по складам).

Выбор типа списка зависит от объёма данных, частоты обновления и требований к интерфейсу. Например, для справочника "Страны" (где значения меняются редко и их немного) подойдёт простое ПолеВыбора, а для справочника "Номенклатура" с тысячами позиций лучше использовать ПолеВводаСВыбором с динамической подгрузкой.

2. Статическое заполнение списка: когда и как использовать

Статическое заполнение подходит для списков с фиксированным набором значений, которые не меняются в процессе работы программы. Типичные примеры:

• 📌 Список месяцев или дней недели
• 📌 Статусы документов ("Черновик", "Проведён", "Отменён")
• 📌 Типы операций ("Приход", "Расход", "Перемещение")

Для такого заполнения используется метод Добавить() или свойство СписокВыбора в модуле формы. Пример кода для заполнения списка статусов:

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

Если значения списка могут меняться (например, при добавлении нового статуса), лучше использовать динамическое заполнение.

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

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

Рассмотрим два основных подхода:

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

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

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

   Процедура ЗаполнитьСписокНоменклатуры()
   Список = Справочники.Номенклатура.Выбрать();
   ЭлементыФормы.Номенклатура.СписокВыбора.Очистить();
   Пока Список.Следующий() Цикл
   ЭлементыФормы.Номенклатура.СписокВыбора.Добавить(
   Список.Наименование,
   Список.Ссылка
   );
   КонецЦикла;
   КонецПроцедуры

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

4. Заполнение списка с учётом прав доступа и ролей

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

• 🔐 Роли 1С — ограничивают доступ к объектам на уровне конфигурации.
• 🔐 RLS (Record Level Security) — ограничения на уровне записей (например, по подразделению).
• 🔐 Дополнительные отборы — программная фильтрация данных в запросе.

Пример кода с учётом RLS для справочника "Контрагенты":

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

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

Запрос.УстановитьПараметр("Подразделение", ПараметрыСеанса.ТекущееПодразделение);
Запрос.Текст = Запрос.Текст + "
|  И Справочник.Контрагенты.Подразделение = &Подразделение";

Результат = Запрос.Выполнить();
// Далее стандартное заполнение списка
..
КонецПроцедуры

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

5. Динамическое обновление списка при изменении других элементов формы

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

Пример: обновление списка номенклатуры при изменении группы товаров:

Процедура ГруппаТоваровПриИзменении(Элемент)
ТекущаяГруппа = ЭлементыФормы.ГруппаТоваров.Значение;

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

Запрос.УстановитьПараметр("Группа", ТекущаяГруппа);
Результат = Запрос.Выполнить();

ЭлементыФормы.Номенклатура.СписокВыбора.Очистить();
ЭлементыФормы.Номенклатура.Значение = Неопределено;

Пока Результат.Следующий() Цикл
ЭлементыФормы.Номенклатура.СписокВыбора.Добавить(
Результат.Наименование,
Результат.Ссылка
);
КонецЦикла;
КонецПроцедуры

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

• 🛠 Используйте ОтключитьОбработкуСобытий() и ВключитьОбработкуСобытий() при массовом обновлении.
• 🛠 Кэшируйте результаты запросов в переменных модуля формы.
• 🛠 Для больших списков реализуйте ленивую загрузку (подгрузку при прокрутке).

Добавить условие на пустое значение родительского элемента|Использовать кэширование результатов запроса|Отключать обработку событий при массовом обновлении|Реализовать постраничную загрузку для больших списков-->

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

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

Особое внимание стоит уделить производительности. Если список загружается более 2-3 секунд, пользователи будут испытывать дискомфорт. В таких случаях:

• 🔧 Оптимизируйте запрос (используйте индексы, избегайте ВЫБРАТЬ РАЗРЕШЕННЫЕ без необходимости).
• 🔧 Реализуйте фоновое заполнение с индикатором прогресса.
• 🔧 Для часто используемых списков настройте кэширование на уровне сеанса.

7. Расширенные возможности: поиск, группировка, изображения

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

1. Поиск по первым символам

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

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

Запрос.УстановитьПараметр("Текст", "%" + Текст + "%");
Результат = Запрос.Выполнить();

ЭлементыФормы.Номенклатура.СписокВыбора.Очистить();
Пока Результат.Следующий() Цикл
ЭлементыФормы.Номенклатура.СписокВыбора.Добавить(
Результат.Наименование,
Результат.Ссылка
);
КонецЦикла;
КонецЕсли;
КонецПроцедуры

2. Группировка элементов

Для улучшения навигации можно сгруппировать элементы по категориям. Например, номенклатуру — по группам, контрагентов — по типам (поставщики/покупатели). Для этого используйте символ "|" в первом параметре метода Добавить():

ЭлементыФормы.Номенклатура.СписокВыбора.Добавить(
"Одежда|Футболка синяя",
СсылкаНаНоменклатуру
);

3. Отображение изображений

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

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

Пример:

ЭлементыФормы.Номенклатура.СписокВыбора.Добавить(
Результат.Наименование,
Результат.Ссылка,
Результат.Картинка,
Истина // Четвёртый параметр - признак картинки
);

8. Оптимизация для тонкого клиента и веб-клиента

При работе в тонком клиенте или веб-клиенте заполнение списков выбора требует особого подхода, так как:

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

Рекомендации по оптимизации:

Пример отложенного заполнения списка:

Процедура КонтрагентПриАктивизацииЭлемента(Элемент)
Если ЭлементыФормы.Контрагент.СписокВыбора.Количество() = 0 Тогда
ЗаполнитьСписокКонтрагентов();
КонецЕсли;
КонецПроцедуры

Для веб-клиента также актуально:

• 🔹 Использовать компрессию данных при передаче по сети.
• 🔹 Минимизировать количество одновременно открытых форм со списками.
• 🔹 Тестировать производительность на слабых каналах (например, с имитацией 3G через инструменты разработчика браузера).

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

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

Процедура ТипДокументаПриИзменении(Элемент)
ТекущийТип = ЭлементыФормы.ТипДокумента.Значение;
ЗаполнитьСписокСтатусов(ТекущийТип); // Процедура заполнения с фильтром по типу
КонецПроцедуры

ЭлементыФормы.Номенклатура.СписокВыбора.Добавить(
Результат.Наименование,
Результат.Ссылка,
,
,
Результат.Артикул, // Дополнительная колонка 1
Результат.Цена   // Дополнительная колонка 2
);

Процедура НоменклатураПриВводеСтроки(Элемент, Текст, СтандартнаяОбработка)
СтандартнаяОбработка = ЛОЖЬ; // Запрещаем ручной ввод
КонецПроцедуры

Если ни один из предложенных методов не решил вашу проблему, проверьте:

• 🔎 Права доступа пользователя к объектам, используемым в списке.
• 🔎 Транзакции — возможно, данные блокированы другой сессией.
• 🔎 Ошибки в журнале регистрации — иногда проблемы со списками связаны с ошибками на сервере.