Добавление отбора в динамический список 1С: способы, примеры и нюансы

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

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

1. Что такое динамический список и зачем нужен отбор

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

• 🐢 Замедлению интерфейса при работе с большими объемами данных (10 000+ строк)
• 🔍 Затрудненному поиску нужной информации среди ненужных записей
• 📉 Повышенной нагрузке на сервер SQL при частых запросах
• 👥 Нарушению разграничения прав доступа (пользователи видят лишние данные)

Отборы решают эти проблемы, позволяя:

• 🎯 Фильтровать данные по критериям (даты, статусы, контрагенты)
• 🔒 Ограничивать доступ к конфиденциальной информации
• ⚡ Ускорять загрузку форм за счет уменьшения объема выборки
• 📊 Строить аналитические отчеты на основе отфильтрованных данных

2. Способ 1: Добавление отбора через конструктор запроса

Самый визуальный и наименее трудоемкий метод — использование встроенного конструктора. Он подходит для типовых конфигураций (УТ 11, БП 3.0, ЗУП 3.1), где не требуется сложная логика фильтрации. Пошаговая инструкция:

1. Откройте конфигуратор и найдите нужный динамический список в дереве объектов (обычно в ветке Общие → ДинамическиеСписки).
2. Дважды кликните на список, чтобы открыть его свойства.
3. Перейдите на вкладку Запрос и нажмите кнопку Конструктор запроса.
4. В открывшемся окне найдите раздел Отбор (обычно в нижней части интерфейса).
5. Добавьте новое условие, выбрав поле из выпадающего списка (например, ДатаДокумента), оператор (=, >, В) и значение.
6. Для динамических значений (текущая дата, параметр сеанса) используйте кнопку П (параметр) и укажите имя переменной.

Пример настройки отбора по дате документа и статусу:

ВЫБРАТЬ
ДокументСсылка КАК Ссылка,
ДокументДата КАК Дата,
ДокументСумма КАК Сумма
ИЗ
Документ.ЗаказПокупателя КАК Документ
ГДЕ
Документ.Дата МЕЖДУ &НачалоПериода И &КонецПериода
И Документ.Статус = ЗНАЧЕНИЕ(Перечисление.СтатусыДокументов.Подтвержден)

Указаны все необходимые поля в разделе "Выборка"|

Параметры отбора имеют осмысленные имена (не Param1, Param2)|

Для дат используются параметры типа "Дата", а не строки|

Проведена тестовая выборка с разными значениями параметров-->

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

⚠️ Внимание: Если в отборе используются параметры с типом Строка для сравнения с полями типа Число или Дата, платформа не выдаст ошибку при сохранении, но запрос будет возвращать пустой результат. Всегда проверяйте соответствие типов!

3. Способ 2: Программное добавление отбора на встроенном языке

Когда требуется динамическая фильтрация (например, в зависимости от прав пользователя или текущего документа), приходится писать код. Рассмотрим два подхода: через свойство Отбор и через модификацию текста запроса.

Метод 1: Использование свойства Отбор

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

// Получаем динамический список по имени
ДинамическийСписок = ЭлементыФормы.СписокДокументов.ДинамическийСписок;

// Очищаем существующие отборы (если нужно)
ДинамическийСписок.Отбор.Очистить();

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

// Применяем отбор и обновляем список
ДинамическийСписок.ПрименитьОтбор();
ДинамическийСписок.Обновить();

Метод 2: Модификация текста запроса

Для сложных сценариев (например, когда нужно добавить JOIN или подзапрос в условие) придется править текст запроса напрямую:

ТекстЗапроса = ДинамическийСписок.Запрос.Текст;

// Добавляем условие по статусу документа
Если НЕ СтроковоеНайти(ТекстЗапроса, "ГДЕ") Тогда
ТекстЗапроса = СтроковоеЗаменить(ТекстЗапроса, "ИЗ", "ИЗ
|ГДЕ
|    Документ.Статус = &Статус");
Иначе
ТекстЗапроса = СтроковоеЗаменить(ТекстЗапроса, "ГДЕ", "ГДЕ
|    Документ.Статус = &Статус
|    И");
КонецЕсли;

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

// Обновляем запрос
ДинамическийСписок.ОбновитьЗапрос();
ДинамическийСписок.Обновить();

Преимущество программного метода — гибкость. Например, можно:

• 🔄 Динамически менять отборы в зависимости от ролей пользователя
• 📅 Привязывать фильтры к текущей дате или периоду в документе
• 🔗 Связывать отборы нескольких динамических списков на одной форме

⚠️ Внимание: При программной модификации текста запроса легко нарушить синтаксис SQL. Всегда проверяйте итоговый запрос через ДинамическийСписок.Запрос.Текст перед выполнением. Особенно опасно добавлять условия в середину существующего запроса — это может сломать логику JOIN-ов.

4. Способ 3: Отборы через расширения конфигурации

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

• 🏢 Типовых конфигураций (где нельзя редактировать исходный код)
• 🔄 Обновляемых решений (отборы не слетают при обновлении)
• 👥 Мультитенантных систем (разные отборы для разных арендаторов)

Алгоритм добавления:

1. Создайте новое расширение через Конфигуратор → Файл → Новое расширение.
2. В дереве расширения найдите раздел Динамические списки и добавьте новый элемент.
3. Укажите имя целевого динамического списка из основной конфигурации.
4. На вкладке Отбор добавьте нужные условия (аналогично конструктору).
5. Для программных отборов используйте модуль расширения с обработчиками событий ПриСозданииНаСервере или ПередЗапросом.

Пример кода в модуле расширения для динамического отбора по текущему пользователю:

Процедура СписокДокументовПередЗапросом(ДинамическийСписок, Запрос) Экспорт

// Добавляем отбор по подразделению пользователя
Если НЕ Запрос.ТекстСодержитСтроку("ОтборПоПодразделению") Тогда
ТекстОтбора = "
|ГДЕ
|    Документ.Подразделение В (
|        ВЫБРАТЬ
|            ПодразделениеКод КАК Подразделение
|        ИЗ
|            Справочник.Подразделения КАК Подразделение
|        ГДЕ
|            Подразделение.Родитель = &ТекущееПодразделение
|    )";

Запрос.Текст = СтроковоеЗаменить(Запрос.Текст, "ИЗ", "ИЗ" + ТекстОтбора);
Запрос.УстановитьПараметр("ТекущееПодразделение", ПользователиИнформационнойБазы.ТекущийПользователь().Подразделение);
КонецЕсли;

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

Преимущества расширений:

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

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

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

1. Отбор не применяется

Симптомы: Запрос выполняется, но данные не фильтруются.

• 🔹 Причина 1: Не вызван метод ПрименитьОтбор() или Обновить().
• 🔹 Причина 2: Отбор добавлен в неверное место запроса (например, после ГРУППИРОВКА).
• 🔹 Причина 3: Используются несовместимые типы данных (сравнение строки с числом).

2. Падение производительности

Симптомы: Форма открывается медленно (более 5 секунд), высокий CPU Load на сервере.

• 🔹 Причина 1: Отбор по неиндексированному полю (например, по полному наименованию контрагента вместо кода).
• 🔹 Причина 2: Слишком сложное условие с подзапросами или функциями (ПОДСТРОКА, ВЫРАЗИТЬ).
• 🔹 Причина 3: Отбор применяется к большому динамическому списку (100 000+ строк) без ограничения по дате.

3. Ошибки привязки параметров

Симптомы: Запрос возвращает пустой результат или ошибку Несоответствие типов.

• 🔹 Причина 1: Параметр не установлен перед выполнением запроса (УстановитьПараметр не вызван).
• 🔹 Причина 2: Неверный тип параметра (например, передается Строка вместо Дата).
• 🔹 Причина 3: В тексте запроса опечатка в имени параметра (регистрозависимо!).

Для диагностики используйте отладочный код:

// Проверяем установленные параметры
Для Каждого Параметр Из Запрос.Параметры Цикл
Сообщить(Строка(Параметр.Имя) + " = " + Параметр.Значение);
КонецЦикла;

- Правильности расстановки скобок в сложных условиях

- Соответствию типов в сравнениях

- Наличию всех требуемых JOIN-ов для полей в отборе-->

6. Оптимизация отборов для больших баз данных

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

1. Используйте индексированные поля: Отбор по Код или Ссылка работает в сотни раз быстрее, чем по Наименование или ПолноеНаименование.
2. Ограничивайте период: Всегда добавляйте отбор по дате, даже если он не важен для бизнес-логики. Например:

   ГДЕ Документ.Дата >= Дата(2020, 1, 1)

3. Избегайте функций в отборах: Замените НАЧИНАЕТСЯС(Наименование, "А") на Наименование >= "А" И Наименование < "Б".
4. Разбивайте сложные запросы: Для отчетов с 10+ JOIN-ами лучше использовать временные таблицы.
5. Кэшируйте результаты: Для статических отборов (например, "активные контрагенты") храните список ID в регистре сведений и фильтруйте по нему.

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

ВЫБРАТЬ
НоменклатураСсылка КАК Ссылка,
НоменклатураАртикул КАК Артикул
ИЗ
Справочник.Номенклатура КАК Номенклатура
ГДЕ
Номенклатура.ПометкаУдаления = ЛОЖЬ
И Номенклатура.Родитель = &Группа
И Номенклатура.Артикул СОДЕРЖИТ "ART-"  // Используем префикс для ускорения поиска
УПОРЯДОЧИТЬ ПО
Артикул
ИНДЕКСИРОВАТЬ ПО
Ссылка  // Явное указание индекса (работает в 8.3.20+)

Для анализа производительности используйте:

• 📊 План запроса в конфигураторе (Запрос.Выполнить().ПланЗапроса())
• 🔍 Технологический журнал (настройка через Администрирование → Поддержка и обслуживание)
• ⚡ SQL Profiler (для анализа запросов на уровне СУБД)

7. Продвинутые сценарии: динамические отборы

Иногда отборы нужно менять "на лету" в зависимости от контекста. Рассмотрим три нетривиальных случая:

1. Отбор по текущему документу

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

Процедура ПриОткрытии(Отказ)

// Получаем текущий документ
ТекущийДокумент = ЭтотОбъект.Объект;

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

ДинамическийСписок.ПрименитьОтбор();

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

2. Отборы с привязкой к ролям

Можно скрывать данные в зависимости от прав пользователя:

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

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

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

3. Каскадные отборы

Когда выбор в одном списке влияет на другой (например, выбор организации фильтрует список складов):

Процедура ОрганизацияПриИзменении(Элемент)

// Получаем выбранную организацию
ВыбраннаяОрганизация = Элемент.Значение;

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

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

ДинамическийСписокСкладов.ПрименитьОтбор();

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

Для реализации таких сценариев полезно использовать:

• 🔗 События форм: ПриИзменении, ПриАктивизацииСтроки
• 📥 Параметры сеанса: Хранение текущих фильтров в ПараметрыСеанса
• 🔄 Механизм подписки на события: Для связи между разными формами

FAQ: Частые вопросы по отборам в динамических списках

Отбор.ВидСравнения = ВидСравнения.В;
Отбор.ПравоеЗначение = Новый Массив();
Отбор.ПравоеЗначение.Добавить(Справочники.Контрагенты.НайтиПоНаименованию("ООО Ромашка"));
Отбор.ПравоеЗначение.Добавить(Справочники.Контрагенты.НайтиПоНаименованию("ИП Иванов"));

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

ГДЕ Документ.Дата >= &ДатаНачала И Документ.Дата < &ДатаОкончания

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

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