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

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

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

Ниже разобраны все рабочие способы с примерами кода, типичными ошибками и способами проверки результата.

Отбор через настройку списка в конфигураторе

Самый простой способ — задать отбор ещё на этапе разработки. Откройте форму списка в конфигураторе, выделите реквизит формы типа «ДинамическийСписок» (обычно называется «Список») и в палитре свойств найдите строку «Настройка списка». Нажмите «Открыть» — появится окно настройки, построенное на системе компоновки данных.

Перейдите на закладку «Отбор», перетащите нужное поле из списка доступных полей в таблицу отбора, выберите вид сравнения («Равно», «В списке», «Не равно» и т.д.) и укажите значение. После сохранения список всегда будет показывать только записи, удовлетворяющие условию. Например, в списке документов «Реализация товаров» можно сразу отобрать только проведённые: поле «Проведен», вид сравнения «Равно», значение «Истина».

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

Программный отбор через КомпоновщикНастроек

Когда значение отбора зависит от параметров открытия формы или реквизитов на форме, отбор устанавливают кодом. Динамический список хранит настройки в свойстве КомпоновщикНастроек, а элементы отбора — в коллекции Настройки.Отбор.Элементы.

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

Ключевые свойства элемента отбора:

• ЛевоеЗначение — поле данных, по которому фильтруем. Задаётся объектом ПолеКомпоновкиДанных с именем поля из запроса списка.
• ВидСравнения — оператор: Равно, НеРавно, ВСписке, ВИерархии, Содержит, БольшеИлиРавно и другие.
• ПравоеЗначение — само значение отбора. Тип должен совпадать с типом поля, иначе отбор молча не сработает.
• Использование — без установки в Истина отбор добавлен, но не применяется. Частая причина «не работающего» кода.
• РежимОтображения — «Недоступный» скрывает отбор от пользователя, «БыстрыйДоступ» выводит его в шапку списка.

Изменение отбора при изменении реквизита формы

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

&НаСервере
Процедура УстановитьОтборПоКонтрагенту()
    ЭлементыОтбора = Список.КомпоновщикНастроек.Настройки.Отбор.Элементы;
    // Удаляем старый отбор по этому полю
    КУдалению = Новый Массив;
    Для Каждого Эл Из ЭлементыОтбора Цикл
        Если Эл.ЛевоеЗначение = Новый ПолеКомпоновкиДанных("Контрагент") Тогда
            КУдалению.Добавить(Эл);
        КонецЕсли;
    КонецЦикла;
    Для Каждого Эл Из КУдалению Цикл
        ЭлементыОтбора.Удалить(Эл);
    КонецЦикла;
    // Добавляем актуальный, если значение заполнено
    Если ЗначениеЗаполнено(ОтборКонтрагент) Тогда
        Эл = ЭлементыОтбора.Добавить(Тип("ЭлементОтбораКомпоновкиДанных"));
        Эл.ЛевоеЗначение = Новый ПолеКомпоновкиДанных("Контрагент");
        Эл.ВидСравнения = ВидСравненияКомпоновкиДанных.Равно;
        Эл.ПравоеЗначение = ОтборКонтрагент;
        Эл.Использование = Истина;
    КонецЕсли;
КонецПроцедуры

Отбор через параметры произвольного запроса

Если список построен на произвольном запросе (свойство «ПроизвольныйЗапрос» = Истина), часто удобнее фильтровать не через настройки компоновки, а через параметры запроса. В тексте запроса добавьте условие с параметром, например:

ВЫБРАТЬ
    РеализацияТоваров.Ссылка,
    РеализацияТоваров.Контрагент,
    РеализацияТоваров.СуммаДокумента
ИЗ
    Документ.РеализацияТоваровУслуг КАК РеализацияТоваров
ГДЕ
    РеализацияТоваров.Склад = &Склад

Затем в коде формы установите значение параметра:

Список.Параметры.УстановитьЗначениеПараметра("Склад", Параметры.Склад);

Фиксированные настройки и отбор, который нельзя снять

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

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

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

Отдельно стоит упомянуть отбор по периоду. Для списков документов платформа предоставляет стандартную настройку периода, и добавлять вручную отбор по полю «Дата» обычно не нужно — используйте свойство списка или стандартную команду установки интервала.

Проверка результата

После установки отбора проверьте список в режиме предприятия: количество записей должно уменьшиться, а все отображаемые строки — соответствовать условию. Полезно открыть настройку списка через «Ещё — Настроить список» и убедиться, что ваш отбор присутствует (или отсутствует, если задан режим «Недоступный»).

Отбор в режиме предприятия без доработки

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

Частые вопросы