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

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

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

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

Базовый перебор через метод Выбрать()

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

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

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

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

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

Перебор с отбором и порядком

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

Отбор = Новый Структура;
Отбор.Вставить("СтавкаНДС", Перечисления.СтавкиНДС.НДС20);

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

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

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

Перебор элементов запросом

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

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

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

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

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

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

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

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

// Вызов: ОбойтиДерево(Справочники.Подразделения.ПустаяСсылка(), 0);

Альтернатива рекурсии — запрос с итогами по иерархии или обход результата запроса методом Выбрать(ОбходРезультатаЗапроса.ПоГруппировкамСИерархией). Такой подход быстрее на больших деревьях, так как вся структура выгружается одним обращением к базе.

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

1. 1
   Определите тип иерархии справочника в конфигураторе: иерархия групп и элементов или иерархия элементов
2. 2
   Напишите рекурсивную процедуру с параметром Родитель или запрос с иерархическим обходом
3. 3
   Внутри цикла отсекайте группы проверкой ЭтоГруппа, если они не нужны
4. 4
   Проверьте результат на тестовой копии базы: порядок вывода и полнота охвата всех веток

Безопасное изменение элементов при переборе

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

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

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

Проверка результата и типичные ошибки

После выполнения обхода убедитесь, что обработано ожидаемое количество элементов. Простой способ — счётчик внутри цикла и сравнение его с количеством элементов по запросу ВЫБРАТЬ КОЛИЧЕСТВО(*) с теми же условиями. Расхождение означает, что часть элементов отфильтрована неявно: пометкой удаления, условием по группам или ошибкой в отборе.

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

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

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