Как открыть справочник с отбором в 1С

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

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

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

Использование свойства Отбор формы выбора

Самый распространенный и простой способ ограничить выбор элементов — это настройка свойства Отбор формы выбора непосредственно в конфигураторе или через код при создании динамической формы. Этот метод идеально подходит для ситуаций, когда пользователю нужно выбрать элемент из справочника, но допустимы только определенные записи, например, только те, у которых установлена галочка «Использовать».

При работе в режиме предприятия платформа автоматически применяет этот отбор при нажатии кнопки выбора (лупы) рядом с полем ввода. Однако, если требуется программно открыть форму списка с фильтрами, необходимо обращаться к свойству Отбор объекта формы.

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

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

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

Программный вызов формы списка справочника

Часто возникает необходимость открыть полноценную форму списка справочника с кнопками создания и редактирования, но сразу с примененными фильтрами. Для этого используется метод ПолучитьФорму или прямое создание формы через объект метаданных. Это дает разработчику полный контроль над поведением окна.

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

Ниже приведен пример процедуры, которая открывает список номенклатуры, показывая только товары определенной группы и с остатком больше нуля. Обратите внимание на использование метода Добавить для элементов отбора.

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

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

Работа с динамическими списками и СКД

В современных конфигурациях, таких как 1С:ERP или 1С:Управление торговлей, часто используются динамические списки, построенные на основе Системы Компоновки Данных (СКД). Работа с отборами в таких формах имеет свои особенности, так как структура данных может быть виртуальной.

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

⚠️ Внимание: При работе с динамическими списками изменение отбора после открытия формы может потребовать принудительного обновления данных через метод Обновить(), иначе пользователь увидит старый список.

Для установки отбора в форме с СКД часто используется объект ПараметрыКомпоновкиДанных. Вы можете программно заполнить этот объект перед открытием формы, передав необходимые значения фильтров. Это обеспечивает корректную работу механизмов оптимизации запросов платформы.

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

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

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

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

В таблице ниже приведены примеры условий отбора с разной степенью эффективности использования индексов базы данных:

Тип условия	Пример кода	Использование индекса
Прямое сравнение	Дата > ДатаВремя(2023,01,01)	Высокое
Функция в условии	Год(Дата) = 2023	Низкое (полный перебор)
Поиск по строке	Наименование LIKE "%Тест%"	Отсутствует
Сравнение с NULL	Комментарий ЕСТЬ NULL	Зависит от СУБД

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

Обработка событий формы и уточнение отборов

Иногда статического отбора, заданного при открытии, недостаточно. Может потребоваться динамическое изменение списка в зависимости от действий пользователя внутри самой формы. Для этого используются обработчики событий формы, такие как ПриСозданииНаСервере или ПередЗаписью.

В обработчике ПриСозданииНаСервере вы имеете доступ к объекту формы и можете модифицировать её отбор перед тем, как он будет отправлен клиенту. Это мощнейший инструмент для реализации сложной бизнес-логики, например, запрета выбора элементов, которые уже проведены в другом документе.

Рассмотрим сценарий, когда нужно запретить выбор номенклатуры, у которой установлена цена меньше минимально допустимой. Мы можем добавить программный отбор прямо в коде формы:

&НаСервере
Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)
Если Не Параметры.РежимРедактирования Тогда
ФормаСписка.Отбор.Элементы.Добавить("Цена", ВидСравнения.БольшеИлиРавно, МинимальнаяЦена);
КонецЕсли;
КонецПроцедуры

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

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

Типичные ошибки и способы их устранения

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

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

Также стоит помнить о контексте безопасности. Если пользователь не имеет прав на чтение определенных записей, отбор может сработать некорректно с точки зрения бизнес-логики, хотя с точки зрения СУБД все верно. Права доступа в 1С применяются поверх программных отборов.

Секреты отладки отборов

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

Часто задаваемые вопросы (FAQ)

Как сбросить отбор, установленный программно?

Для сброса отбора необходимо очистить коллекцию элементов отбора формы. Это делается вызовом метода Очистить() у объекта Форма.Отбор.Элементы. После очистки не забудьте вызвать метод обновления формы, чтобы отобразить полный список данных.

Можно ли использовать несколько условий отбора для одного поля?

Да, вы можете добавить несколько элементов отбора для одного и того же поля. Логика их соединения (И или ИЛИ) зависит от настроек группы отбора. По умолчанию элементы в одной группе соединяются логическим «И», но вы можете создавать вложенные группы для реализации сложной логики «ИЛИ».

Почему отбор не работает в управляемых формах?

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

Влияет ли отбор на производительность при открытии формы?

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

Как передать отбор из одной формы в другую?

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