Программное добавление отборов в динамический список 1С: Практическое руководство

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

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

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

Архитектура динамического списка и объект отбора

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

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

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

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

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

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

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

Рассмотрим пример кода, который добавляет отбор по полю "ВидНоменклатуры" в динамический список формы. Код обычно размещается в модуле формы в процедуре ПриСозданииНаСервере.

Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)

// Получаем доступ к объекту динамического списка
ДинамическийСписок = Элементы.ТаблицаДокументов.Список;

// Создаем новый элемент отбора
ЭлементОтбора = ДинамическийСписок.Отборы.Добавить();

// Устанавливаем поле для сравнения
ЭлементОтбора.Поле = Новый ПолеКомпоновкиДанных("ВидНоменклатуры");

// Задаем тип сравнения (Равно)
ЭлементОтбора.ВидСравнения = ВидСравненияКомпоновкиДанных.Равно;

// Устанавливаем значение отбора
ЭлементОтбора.Значение = Справочники.ВидыНоменклатуры.НайтиПоНаименованию("Услуга");

КонецПроцедуры

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

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

Работа со сложными отборами и группировками

Реальные бизнес-задачи редко ограничиваются одним условием. Часто требуется выбрать документы, которые созданы в определенном периоде И имеют статус "Проведен", ИЛИ принадлежат конкретному контрагенту. Для таких случаев в платформе 1С предусмотрена иерархическая структура отборов с поддержкой группировок.

Каждый элемент отбора имеет свойство Использование, которое может принимать значения Отбор или Группировка. Если установлено значение "Группировка", то данный элемент становится контейнером для вложенных отборов. Это позволяет строить деревья условий, аналогичные тем, что используются в системе компоновки данных (СКД).

Свойство элемента	Тип значения	Описание назначения
Поле	ПолеКомпоновкиДанных	Имя поля или псевдоним, по которому производится фильтрация
ВидСравнения	ВидСравненияКомпоновкиДанных	Логический оператор (Равно, НеРавно, Больше, ВСтроке и т.д.)
Значение	Произвольный	Конкретное значение или параметр для сравнения
Использование	ИспользованиеОтбораКомпоновкиДанных	Определяет, является ли элемент листовым отбором или группой

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

Пример сложной логики

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

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

Очистка и управление существующими отборами

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

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

Процедура ОчиститьОтборПоПолю(ИмяПоля)

Для Каждого ЭлементОтбора Из ДинамическийСписок.Отборы Цикл

Если ЭлементОтбора.Поле.Имя = ИмяПоля Тогда
ДинамическийСписок.Отборы.Удалить(ЭлементОтбора);
Прервать;
КонецЕсли;

КонецЦикла;

КонецПроцедуры

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

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

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

Особенности отборов по периоду и составным типам

Фильтрация по датам является одной из самых частых задач в учетных системах. Для полей типа Дата или Период важно правильно задавать границы интервала. В 1С часто используется подход с двумя отдельными отборами: один на "Больше или Равно" (начало периода), другой на "Меньше" (конец периода).

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

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

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

Производительность и оптимизация выборок

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

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

⚠️ Внимание: Избегайте использования функций в левой части условия отбора (например, Лев(Поле, 5) = "Знач"). Это отключает использование индексов и резко замедляет работу.

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

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

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

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

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

Секрет стабильности

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

Проверка прав доступа также может влиять на видимость данных. Даже если отбор задан верно, пользователь может не видеть записи из-за ограничений РПП (Ролевая Модель Прав). Убедитесь, что у тестирующего пользователя есть права на чтение данных, попадающих под критерии вашего отбора.

Как добавить отбор, если поле является составным типом?

При работе с составными типами необходимо убедиться, что значение отбора соответствует одному из допустимых типов поля. Если поле может содержать СправочникСсылку или ДокументСсылку, передавайте в свойство Значение объект соответствующего типа. Если требуется отбор по нескольким типам, используйте группировку с оператором "ИЛИ" и создавайте отдельные отборы для каждого типа данных.

Почему отбор не применяется сразу после нажатия кнопки?

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

Можно ли использовать параметры СКД в отборах динамического списка?

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

Как отфильтровать список по текущему пользователю?

Для этого используйте предопределенное значение Пользователи.ТекущийПользователь или свойство ПользовательИнформационнойБазы(). Создайте отбор по полю "Автор" или "Ответственный", установите вид сравнения "Равно" и в качестве значения подставьте ссылку на текущего пользователя. Это стандартная практика для форм "Мои документы".

Влияет ли порядок добавления отборов на результат?

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