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

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

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

1. Основные типы списков выбора в управляемых формах

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

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

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

2. Статическое заполнение: простейшие способы

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

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

1. Через свойство СписокВыбора:

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

   Здесь первый параметр метода Добавить() — это отображаемое значение, а второй — внутреннее представление (может совпадать).

2. Через коллекцию ЗначениеСписка:

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

   Этот способ удобен, если список формируется динамически в другом месте кода.

Обратите внимание: при статическом заполнении данные хранятся в памяти формы. Если список большой (более 100 элементов), это может замедлить работу интерфейса. В таких случаях лучше использовать динамическое заполнение, о котором пойдёт речь дальше.

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

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

Базовый алгоритм динамического заполнения:

• 🔄 Получить данные из источника (запрос, выборка из справочника).
• 📥 Преобразовать данные в формат, понятный элементу формы.
• 🖥️ Загрузить данные в список выбора с учётом фильтров и прав доступа.

Пример заполнения списка номенклатуры с учётом остатков:

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

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

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

Возврат Список;
КонецПроцедуры

&НаКлиенте
Процедура ЗаполнитьСписокНоменклатуры(Элемент)
Список = ЗаполнитьСписокНоменклатурыНаСервере(Элемент);
Элемент.СписокВыбора = Список;
КонецПроцедуры

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

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

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

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

Элемент.СписокВыбора = Новый ДинамическийСписок("Справочник.Контрагенты");
Элемент.Отображение = ОтображениеСписка.Иерархический; // Если нужен иерархический просмотр

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

5. Работа с иерархическими списками и группами

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

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

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

Результат = Запрос.Выполнить();
Список = Новый ДинамическийСписок;
Список.ИмяПоляЗначения = "Ссылка";
Список.ИмяПоляОтображения = "Наименование";
Список.ИмяПоляГруппы = "ЭтотУзел";
Список.ИсточникДанных = Результат;

Возврат Список;
КонецФункции

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

При работе с иерархией также полезно использовать метод РазвернутьВсеГруппы() или СвернутьВсеГруппы() для управления отображением:

Элемент.СписокВыбора.РазвернутьВсеГруппы();

Указано поле-группа в динамическом списке|Установлено иерархическое отображение|Данные отсортированы по полному наименованию|Проверены права доступа к группам

-->

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

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

• ❌ Список не обновляется после изменения данных
  🔹 Причина: Кэширование формы или отсутствие привязки к событию обновления.
  🔹 Решение: Используйте событие ПриИзменении или ПриАктивизацииСтроки для перезаполнения списка. Также можно сбросить кэш: Элемент.СписокВыбора = Неопределено;
• ❌ В списке отображаются удалённые элементы
  🔹 Причина: В запросе не учтена пометка удаления.
  🔹 Решение: Добавьте условие НЕ ПометкаУдаления в запрос.
• ❌ Медленная работа при выборе значения
  🔹 Причина: Отсутствует индекс по полю поиска или загружаются все колонки справочника.
  🔹 Решение: Оптимизируйте запрос, выбирая только необходимые поля, и добавьте индексы в метаданных.
• ❌ Не работает поиск по списку
  🔹 Причина: Не указано поле для отображения в динамическом списке.
  🔹 Решение: Установите свойство ИмяПоляОтображения.

Ещё одна частая проблема — несоответствие типов данных. Например, если в список выбора загружаются ссылки на справочник, а в коде пытаетесь сравнить их со строковыми значениями. Всегда проверяйте типы с помощью функции ТипЗнч():

Если ТипЗнч(Элемент.Значение) <> Тип("СправочникСсылка.Контрагенты") Тогда
Сообщить("Некорректный тип данных!");
КонецЕсли;

7. Расширенные возможности: фильтрация и поиск

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

Способ 1: Использование события ПриВводеСтроки

&НаКлиенте
Процедура СписокНоменклатурыПриВводеСтроки(Элемент, Текст, СтандартнаяОбработка)
Если СтрДлина(Текст) >= 3 Тогда
Фильтр = Новый Структура("Наименование", "%" + Текст + "%");
Элемент.СписокВыбора.ПараметрыПоиска = Фильтр;
КонецЕсли;
КонецПроцедуры

Способ 2: Динамический запрос с фильтром

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

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

Возврат Результат.Выгрузить();
КонецФункции

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

Элемент.Подсказка = "Для поиска начните ввод названия. Enter — выбрать, Esc — отмена";

Также полезно настроить автоматическое развёртывание списка при фокусировке:

&НаКлиенте
Процедура СписокПриАктивизацииЭлемента(Элемент)
Элемент.ОткрытьВыбор();
КонецПроцедуры

8. Безопасность и права доступа

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

• 🔐 Роли и права — настройка в конфигураторе ограничений на чтение/изменение данных.
• 🛡️ Параметры сеанса — фильтрация данных по текущему пользователю или его подразделению.
• 🔍 Дополнительные отборы — программное ограничение выборки в запросах.

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

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

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

Результат = Запрос.Выполнить();
Возврат Результат.Выгрузить();
КонецФункции

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

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

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

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

Элемент.СписокВыбора = Неопределено;

Запрос.Текст =
"ВЫБРАТЬ
|   Вид.Наименование КАК Вид,
|   Объект.Ссылка КАК Ссылка,
|   Объект.Наименование КАК Наименование
|ИЗ
|   (ВЫБРАТЬ
|       ""Номенклатура"" КАК Вид,
|       Номенклатура.Ссылка,
|       Номенклатура.Наименование
|   ИЗ
|       Справочник.Номенклатура КАК Номенклатура
|   ОБЪЕДИНИТЬ ВСЕ
|   ВЫБРАТЬ
|       ""Контрагенты"",
|       Контрагенты.Ссылка,
|       Контрагенты.Наименование
|   ИЗ
|       Справочник.Контрагенты КАК Контрагенты) КАК Объект";

&НаКлиенте
Процедура ЭлементПриИзменении(Элемент)
Сообщить("Текущее значение: " + Элемент.Значение + " (Тип: " + ТипЗнч(Элемент.Значение) + ")");
КонецПроцедуры

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

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

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

Возврат Список;
КонецФункции

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