1С: как получить строки, отобранные отбором

Задача получить строки, которые пользователь видит после применения отбора, возникает в 1С постоянно: при печати выделенных документов, групповой обработке, выгрузке данных. Проблема в том, что отбор в динамическом списке, в табличной части или в запросе — это три разных механизма, и код для каждого случая свой. Ошибка выбора механизма приводит к тому, что обработка либо берёт лишние строки, либо не видит результат отбора вообще.

Ниже разобраны основные сценарии: чтение установленного отбора из динамического списка формы, получение строк табличного поля с учётом отбора, формирование запроса с теми же условиями и перебор результата. Примеры приведены на встроенном языке 1С и подходят для управляемых форм типовых конфигураций (УТ, ERP, БП), а также самописных решений.

Важно понимать с самого начала: платформа не хранит «готовый список отобранных строк» где-то отдельно. Отбор — это условие, которое применяется к данным при чтении. Поэтому правильный подход почти всегда сводится к тому, чтобы взять параметры отбора и повторно выполнить выборку с этими условиями на сервере.

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

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

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

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

Читаем установленный отбор программно

Первый шаг — получить элементы отбора, которые реально действуют на список. Для формы списка с основным реквизитом Список типа «ДинамическийСписок» доступ к настройкам выглядит так:

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

Обратите внимание на проверку Использование: элементы отбора могут существовать, но быть отключёнными, и учитывать их в выборке нельзя. Также отбор может содержать вложенные группы (ГруппаЭлементовОтбораКомпоновкиДанных) с условиями И/ИЛИ — для корректной обработки их нужно обходить рекурсивно.

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

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

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

Вариант 1: запрос с параметрами

Подходит, когда отбор простой и поля известны заранее. Условия из отбора превращаются в параметры запроса:

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

Вариант 2: СКД с настройками списка

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

Схема = Новый СхемаКомпоновкиДанных;
Источник = Схема.ИсточникиДанных.Добавить();
Источник.Имя = "ИсточникДанных1";
Источник.ТипИсточникаДанных = "Local";
Набор = Схема.НаборыДанных.Добавить(Тип("НаборДанныхЗапросСхемыКомпоновкиДанных"));
Набор.Запрос = Список.ТекстЗапроса; // запрос динамического списка
Набор.АвтоЗаполнениеДоступныхПолей = Истина;

КомпоновщикМакета = Новый КомпоновщикМакетаКомпоновкиДанных;
Макет = КомпоновщикМакета.Выполнить(Схема,
Список.КомпоновщикНастроек.ПолучитьНастройки());

ПроцессорКомпоновки = Новый ПроцессорКомпоновкиДанных;
ПроцессорКомпоновки.Инициализировать(Макет);
Результат = Новый ТаблицаЗначений;
ПроцессорВывода = Новый ПроцессорВыводаРезультатаКомпоновкиДанныхВКоллекциюЗначений;
ПроцессорВывода.УстановитьОбъект(Результат);
ПроцессорВывода.Вывести(ПроцессорКомпоновки);

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

Выборка = Запрос.Выполнить().Выбрать();
Пока Выборка.Следующий() Цикл
    ОбработатьСтроку(Выборка.Ссылка);
КонецЦикла;

Отбор строк в табличной части и таблице значений

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

ОтборСтрок = Новый Структура;
ОтборСтрок.Вставить("Склад", ВыбранныйСклад);
ОтборСтрок.Вставить("Отгружено", Ложь);

НайденныеСтроки = Объект.Товары.НайтиСтроки(ОтборСтрок);
Для Каждого СтрокаТовара Из НайденныеСтроки Цикл
// работаем со строкой
КонецЦикла;

Метод возвращает массив строк, полностью совпадающих по всем полям структуры (условия соединяются по И). Значения сравниваются на строгое равенство — никаких «содержит» и «больше/меньше» здесь нет. Для нестрогих условий придётся перебирать коллекцию в цикле с собственной проверкой.

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

Выделенные строки vs отобранные строки

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

Для Каждого Идентификатор Из Элементы.Список.ВыделенныеСтроки Цикл
ТекущиеДанные = Список.НайтиПоИдентификатору(Идентификатор);
// для динамического списка идентификатор часто сразу является ссылкой
КонецЦикла;

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

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

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

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

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

Типичные ошибки при работе с отобранными строками

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

Вторая ошибка — игнорирование флага Использование у элементов отбора. Отключённые пользователем условия попадают в запрос, и выборка получается уже, чем на экране. Третья ошибка — потеря фиксированного отбора: обработка берёт только пользовательские настройки и захватывает, например, помеченные на удаление объекты.

Четвёртая группа ошибок связана с типами: отбор по строковому представлению вместо ссылки, сравнение дат без учёта времени (конец периода в 00:00:00 отсекает весь последний день), передача в НайтиСтроки() значения другого типа — строка не найдётся даже при визуальном совпадении.

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

После реализации логики убедитесь, что программная выборка совпадает с тем, что видит пользователь. Простейший способ — сравнить количество строк: выведите Выборка.Количество() или размер массива НайтиСтроки() в сообщение и сверьте с ожидаемым числом по списку.

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

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