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

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

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

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

Способ 1. Перебор через Выбрать() — базовый вариант

Метод Выбрать() менеджера справочника возвращает выборку — последовательный курсор по элементам. Это самый простой способ, который подходит для обхода всех элементов или элементов по владельцу и родителю.

Выборка = Справочники.Номенклатура.Выбрать();
Пока Выборка.Следующий() Цикл
Сообщить(Выборка.Наименование + " — " + Выборка.Код);
КонецЦикла;

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

Метод принимает параметры: Родитель (для иерархических справочников), Владелец (для подчинённых) и Отбор — структуру с условиями по реквизитам. Важно: отбор через параметр выполняется на стороне СУБД, а фильтрация уже внутри цикла — в памяти, что медленнее.

Отбор = Новый Структура("ПометкаУдаления", Ложь);
Выборка = Справочники.Контрагенты.Выбрать(,, Отбор);
Пока Выборка.Следующий() Цикл
    Сообщить(Выборка.Ссылка);
КонецЦикла;

Способ 2. Перебор через запрос — для сложных отборов

Запрос — предпочтительный способ, когда нужен отбор по нескольким условиям, соединение с другими таблицами, сортировка или группировка. Весь анализ выполняется на сервере СУБД, в 1С возвращается только готовый результат.

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

У запроса есть и альтернативный вариант обхода — через Выгрузить() в таблицу значений с последующим циклом Для Каждого. Это удобно, если данные нужны многократно или требуется индексированный поиск по колонке.

Для иерархического обхода запрос позволяет использовать конструкцию ИТОГИ ПО и обход результата по группировкам — это единственный удобный способ получить дерево элементов одним обращением к базе.

Способ 3. Перебор с изменением элементов

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

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

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

Перебор иерархического справочника

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

Чтобы обойти элементы конкретной группы с учётом вложенности, в запросе используется условие Ссылка В ИЕРАРХИИ(&Группа). Это стандартный и быстрый способ выбрать всё поддерево.

Рекурсивный обход дерева

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

Процедура ОбойтиУровень(Родитель)
Выборка = Справочники.Номенклатура.Выбрать(Родитель);
Пока Выборка.Следующий() Цикл
Сообщить(Выборка.Наименование);
Если Выборка.ЭтоГруппа Тогда
ОбойтиУровень(Выборка.Ссылка);
КонецЕсли;
КонецЦикла;
КонецПроцедуры

Начальный вызов — ОбойтиУровень(Справочники.Номенклатура.ПустаяСсылка()). Учтите, что рекурсия делает отдельный запрос на каждый уровень каждой группы, поэтому на глубоких иерархиях запрос с ИТОГИ ПО ... ИЕРАРХИЯ работает заметно быстрее.

Отбор и фильтрация при переборе

Правило производительности простое: чем раньше применён фильтр, тем быстрее работает перебор. Иерархия условий по эффективности выглядит так: условие в запросе → параметр отбора в Выбрать() → проверка внутри цикла.

Отбор в Выбрать() поддерживает только равенство по реквизитам, поэтому условия вида «содержит подстроку» или «больше значения» доступны только в запросе. Пометку удаления почти всегда стоит исключать явно, иначе в обработку попадут неактуальные элементы.

Типичные ошибки и производительность

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

Вторая частая проблема — обращение к реквизитам через точку от ссылки внутри цикла в клиент-серверном варианте: каждое обращение может порождать отдельный запрос. Выбирайте все нужные поля сразу в запросе.

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

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

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

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