Работа с интерфейсом пользователя в конфигурациях на платформе 1С:Предприятие невозможна без использования стандартных элементов управления, среди которых поле ввода особенно выделяется своей универсальностью. Часто возникает ситуация, когда пользователю необходимо выбрать значение из справочника, но отображать весь список справочника нецелесообразно или даже опасно с точки зрения логики работы программы. Например, в документе "Заказ покупателя" при выборе номенклатуры нет смысла показывать услуги или товары, снятые с производства. Именно в таких случаях перед разработчиком встает задача грамотно ограничить список выбора.
Механизмы платформы предоставляют несколько уровней контроля над содержимым выпадающего списка. От простых свойств метаданных до сложных алгоритмов, реализуемых в коде событий формы. Понимание различий между статическими настройками и динамической фильтрацией является ключевым навыком для создания удобного и функционального интерфейса. В этой статье мы детально разберем основные способы реализации этого функционала.
Базовые настройки свойства "Список выбора"
Самый простой и часто используемый способ ограничения — это настройка свойств объекта метаданных на этапе разработки конфигурации. Если логика отбора данных неизменна на протяжении всего жизненного цикла системы, нет смысла усложнять код лишними проверками. Достаточно обратиться к окну свойств элемента формы или поля ввода.
Внутри свойств элемента управления находится параметр Список выбора. При нажатии на кнопку выбора открывается конструктор, где можно вручную задать набор доступных значений. Это может быть перечисление, фиксированный список строк или ссылка на конкретный справочник. Однако, если речь идет о больших объемах данных, ручной ввод становится неэффективным.
Более продвинутым вариантом в свойствах является использование Тип значения с ограничением по виду. Вы можете указать, что в поле допустимы только значения определенного справочника, например, "Контрагенты". Платформа автоматически подставит этот справочник в качестве источника данных. Важно отметить, что такая настройка является глобальной для данного элемента формы.
⚠️ Внимание: Изменение свойства "Список выбора" в конфигураторе повлияет на все формы, где используется данный элемент метаданных, если свойство не переопределено конкретно для формы. Проверяйте влияние изменений на смежные объекты.
Для более гибкой настройки непосредственно в свойствах формы существует возможность задания начального отбора. Это позволяет сузить круг отображаемых элементов без написания программного кода. Например, можно сразу установить отбор по признаку "ЭтоГруппа = Ложь", чтобы пользователь не выбирал папки вместо элементов списка.
Используйте свойство "Режим выбора" для управления поведением поля. Если установить значение "Не выбирать", поле будет работать только как текстовый ввод, что полезно для поисковых строк.
Динамическая фильтрация через событие ПриНачалеВыбора
Когда требования к списку выбора меняются в зависимости от действий пользователя или данных, заполненных в других полях формы, статических настроек становится недостаточно. Здесь на сцену выходит событие ПриНачалеВыбора. Это событие срабатывает в момент, когда пользователь нажимает кнопку открытия списка или клавишу F4.
В обработчике этого события у разработчика есть полный доступ к объекту СтруктураОтбора. Это специальный объект, который позволяет программно формировать условия фильтрации данных перед их выводом в окно выбора. Вы можете добавлять условия, основанные на текущей дате, значении другого поля или правах доступа пользователя.
Рассмотрим типичный сценарий: в документе необходимо выбрать склад, но список должен содержать только те склады, которые относятся к организации, указанной в шапке документа. Код будет выглядеть следующим образом:
Процедура СкладПриНачалеВыбора(Элемент, ДанныеВыбора, СтандартнаяОбработка)
СтруктураОтбора = ДанныеВыбора.ПолучитьСтруктуруОтбора();
СтруктураОтбора.Вставить("Организация", Объект.Организация);
ДанныеВыбора.УстановитьОтбор(СтруктураОтбора);
КонецПроцедуры
Использование СтруктурыОтбора гарантирует, что платформа сама оптимизирует запрос к базе данных. Вам не нужно вручную писать запросы или обрабатывать коллекции значений. Это значительно повышает производительность приложения при работе с большими таблицами.
Использование параметра связи для зависимых полей
Одним из самых элегантных решений для связанных полей является механизм Параметра связи. Этот подход позволяет декларативно настроить зависимость одного поля выбора от другого без написания процедур обработки событий. Это особенно актуально для иерархических справочников или связанных сущностей.
Суть метода заключается в том, что в свойствах зависимого поля выбора указывается имя другого элемента формы. Значение этого элемента автоматически передается как параметр в запрос формирования списка выбора. Платформа сама подставляет это значение в условие отбора.
Например, у вас есть поле "ВидНоменклатуры" и поле "Номенклатура". Вы хотите, чтобы при выборе вида номенклатуры список товаров автоматически фильтровался. Для этого в свойствах поля "Номенклатура" в параметре Параметр связи нужно указать имя элемента "ВидНоменклатуры".
- 🔗 Поле-источник должно быть заполнено пользователем до открытия списка выбора.
- ⚙️ В справочнике-приемнике должно быть предусмотрено соответствующее поле для отбора.
- 🚀 Метод работает быстрее, чем ручная обработка событий, так как оптимизирован на уровне платформы.
Если параметр связи не настроен корректно, список выбора может оказаться пустым или, наоборот, содержать лишние данные. Всегда проверяйте соответствие типов данных в связующих полях. Несоответствие типа "СправочникСсылка.ВидыНоменклатуры" и "Строка" приведет к игнорированию параметра.
⚠️ Внимание: Параметр связи работает только если поле-источник имеет значение. Если пользователь еще не выбрал вид номенклатуры, список товаров может не открыться или показать всё подряд, в зависимости от настроек справочника.
Настройка отборов через QTO (Быстрые отборы)
Для сложных сценариев, когда стандартных механизмов недостаточно или требуется изменить логику работы самого окна выбора, используется механизм QTO (Quick Trade Off / Быстрые отборы). Это мощный инструмент, позволяющий переопределять поведение поля выбора через специальные объекты конфигурации.
QTO позволяет не просто фильтровать данные, но и изменять состав полей в списке выбора, добавлять вычисляемые колонки или менять порядок сортировки. Это достигается за счет создания специального обработчика, который перехватывает формирование запроса для окна выбора.
Чтобы использовать этот метод, необходимо создать объект "Быстрый отбор" в дереве конфигурации. В нем прописывается логика формирования запроса. Затем в свойствах поля формы указывается имя этого быстрого отбора. Это дает максимальную гибкость, но требует высокой квалификации разработчика.
| Метод | Сложность внедрения | Гибкость | Производительность |
|---|---|---|---|
| Свойства формы | Низкая | Низкая | Высокая |
| ПриНачалеВыбора | Средняя | Высокая | Высокая |
| Параметр связи | Низкая | Средняя | Очень высокая |
| QTO | Высокая | Максимальная | Зависит от запроса |
Использование QTO оправдано в типовых конфигурациях или когда требуется унифицировать поведение поля выбора на множестве форм. В простых самописных решениях этот метод часто является избыточным и усложняет поддержку кода.
Тонкости работы QTO
Объект быстрого отбора может использовать временные таблицы для предварительной обработки данных перед выводом в форму выбора. Это полезно, если нужно отфильтровать данные по сложному алгоритму, который трудно выразить одним условием WHERE.
Ограничение выбора с помощью ДИНАМИЧЕСКИХ СПИСКОВ
В современных версиях платформы 1С:Предприятие 8.3 и выше широко применяются динамические списки. Они позволяют управлять составом элементов формы программно, что открывает новые возможности для ограничения выбора. В отличие от статических элементов, содержимое динамического списка может меняться "на лету".
Для реализации ограничения в динамическом списке используется метод УстановитьОтбор объекта списка. Это позволяет применять сложные условия, включающие логические операции "И", "ИЛИ", а также вложенные отборы. Такой подход часто используется в формах списка документов или сложных отчетов.
Пример кода для установки отбора в динамическом списке:
ЭлементыФормы.СписокНоменклатуры.Отбор.ВариантОтбора.Поле = "Владелец";
ЭлементыФормы.СписокНоменклатуры.Отбор.ВариантОтбора.ВидСравнения = ВидСравнения.Равно;
ЭлементыФормы.СписокНоменклатуры.Отбор.ВариантОтбора.Значение = ТекущийПользователь;
Важно понимать разницу между отбором в поле ввода и отбором в списке формы. Поле ввода ограничивает выбор одного значения, в то время как динамический список фильтрует набор строк в таблице. Принципы формирования условий при этом схожи, но объекты управления различаются.
☑️ Проверка настройки динамического списка
Частые ошибки и производительность при фильтрации
Неправильная реализация ограничения списка выбора может привести к серьезным проблемам с производительностью системы. Самая распространенная ошибка — попытка выгрузить весь справочник в объект типа Массив или ТаблицаЗначений и фильтровать его уже в памяти клиента. Этот подход категорически неверен для больших баз данных.
Всегда стремитесь к тому, чтобы фильтрация происходила на стороне сервера базы данных. Использование СтруктурыОтбора и параметров связи гарантирует, что в сеть будут переданы только те данные, которые действительно нужны пользователю. Это экономит трафик и ускоряет работу интерфейса.
Еще одной ошибкой является игнорирование прав доступа. Даже если вы программно ограничили список, пользователь с полными правами может увидеть лишние данные, если не настроены RLS (Record Level Security). Ограничение в форме — это лишь удобство интерфейса, а не защита данных.
⚠️ Внимание: Избегайте выполнения тяжелых запросов внутри цикла или при каждом нажатии клавиши в поле ввода. Используйте события открытия формы или изменения ключевых полей для инициализации отборов.
Также стоит помнить о кэшировании. Если список выбора зависит от редко меняющихся данных, можно использовать механизмы кэширования запросов. Однако при частом изменении условий отбора кэш может стать источником устаревшей информации, поэтому его использование требует осторожности.
Главный принцип оптимизации: фильтруйте данные как можно раньше, желательно на уровне СУБД, используя стандартные механизмы платформы 1С, а не программную обработку коллекций.
Заключение
Грамотное ограничение списка выбора в 1С — это баланс между удобством пользователя и производительностью системы. Начинать всегда следует с простых средств: свойств формы и параметров связи. Только если они не покрывают требования задачи, следует переходить к программированию событий и использованию QTO.
Правильно настроенные поля ввода снижают количество ошибок при вводе данных и ускоряют работу операторов. Пользователь не тратит время на поиск нужного элемента в огромном списке, а сразу видит релевантные варианты. Это напрямую влияет на эффективность бизнес-процессов.
Помните, что интерфейс программы — это лицо вашей конфигурации. Уделяйте внимание деталям, таким как отборы и подсказки, и ваши пользователи скажут вам спасибо. Регулярно анализируйте логику работы форм и оптимизируйте её по мере роста базы данных.
Для отладки отборов используйте режим "Отладка" и наблюдайте за текстом запроса, который формируется платформой. Это поможет понять, почему некоторые элементы не попадают в список выбора.
Как ограничить выбор только элементами без групп?
Для этого в событии ПриНачалеВыбора необходимо добавить в структуру отбора условие по полю "ЭтоГруппа". Установите значение Ложь. Пример: СтруктураОтбора.Вставить("ЭтоГруппа", Ложь);. Это скроет все папки из списка.
Можно ли изменить список выбора после его открытия?
Нет, изменение структуры отбора возможно только до открытия окна выбора, в событии ПриНачалеВыбора. После того как окно отображено, динамически изменить состав элементов без закрытия и повторного открытия нельзя.
Что делать, если параметр связи не срабатывает?
Проверьте точное соответствие имен полей в настройках параметра связи. Убедитесь, что тип данных в поле-источнике совпадает с типом поля отбора в справочнике. Также проверьте, заполнено ли значение в источнике в момент открытия списка.
Как запретить выбор значения, но оставить ввод текста?
Установите свойство РежимВыбора в значение НеВыбирать. В этом случае кнопка открытия списка станет неактивной, но пользователь сможет вводить данные вручную. Это полезно для полей поиска по артикулу.