Другое · 8 мин
Как обойти справочник 1С в цикле
Разбор способов перебора справочника 1С в цикле: выборка по условию, фильтрация строк, чтение и запись реквизитов, типичные ошибки и способы проверки результата.
Справочник в 1С обычно содержит элементы и группы, а доступ к данным в конфигурации осуществляется через объект менеджера справочника. Когда нужно обработать все записи или подмножество записей, применяется цикл по выборке. Это базовая операция для отчётов, обмена данными, заполнения реквизитов и массовой корректировки.
Выбор способа обхода зависит от объёма данных, необходимости фильтрации и того, планируется ли только чтение или также изменение записей. Для небольших выборок подходит прямой перебор методом Выбрать(), а для больших массивов часто эффективнее запрос или выгрузка в таблицу значений.
Ниже рассмотрены основные сценарии, условия корректной работы и признаки, при которых стоит остановиться и перепроверить алгоритм.
H2: Когда обход справочника нужен и какой вариант выбрать
Обход справочника оправдан, когда нужно применить одно действие к каждой записи: проверить заполнение обязательных реквизитов, скопировать значения в другой справочник, сформировать выгрузку или пересчитать зависимые показатели. Если задача заключается в поиске одной записи по коду или наименованию, прямой цикл по всему справочнику избыточен.
При выборе способа учитывайте, нужно ли обрабатывать только элементы или также группы, требуется ли учитывать пометку на удаление и какая глубина иерархии важна. Некоторые обходы по умолчанию включают папки, другие позволяют ограничиться только элементами справочника.
Если данные используются только для чтения, безопаснее работать с выборкой или таблицей значений без изменения исходных объектов. При планируемой записи изменений лучше сначала собрать список ссылок, а затем в отдельном цикле открывать объекты на редактирование.
H2: Обход через метод Выбрать()
Классический вариант перебора справочника в языке 1С выглядит как получение выборки через менеджер справочника и выполнение цикла с методом Следующий. На каждой итерации текущая строка выборки предоставляет доступ к реквизитам записи без отдельного открытия объекта на редактирование.
Выборка = Справочник.Номенклатура.Выбрать();
Пока Выборка.Следующий() Цикл
Если Выборка.ПометкаУдаления Тогда
Продолжить;
КонецЕсли;
Сообщить(Выборка.Наименование);
КонецЦикла;
Метод Выбрать() может принимать параметры отбора, которые ограничивают количество возвращаемых строк ещё на этапе получения выборки. Это снижает объём передаваемых данных и ускоряет обход, особенно в справочниках с большим числом записей.
- 1Получить выборку менеджера справочника с нужным отбором
- 2Запустить цикл Пока Выборка.Следующий() Цикл
- 3На каждой итерации проверить пометку на удаление и принадлежность к элементам
- 4Прочитать или записать реквизиты текущей строки
- 5Завершить цикл и проверить результат на контрольной выборке
H2: Фильтрация и порядок обхода
Отбор в методе Выбрать() задаётся через структуру параметров или отдельные аргументы, в зависимости от платформы и конфигурации. Можно ограничить обход записями после определённого кода, по значению реквизита, по родительской группе или по признаку активности. Чем точнее отбор, тем меньше лишних итераций.
Порядок обхода не гарантируется автоматически, если не указано явно. Для обработки в алфавитном порядке, по коду или по дате изменения используйте сортировку на уровне запроса или загрузите данные в таблицу значений с последующей сортировкой перед циклом.
Группы и элементы справочника могут требовать разной обработки. Если в цикле попадаются папки, доступ к некоторым реквизитам элементов может быть недоступен или вести себя иначе. Явная проверка вида записи помогает избежать ошибок при чтении свойств, характерных только для элементов.
H2: Чтение и изменение реквизитов в цикле
Чтение реквизитов из строки выборки обычно не требует открытия объекта справочника и работает быстро. Если нужно изменить данные, строка выборки сама по себе не является редактируемым объектом: необходимо получить ссылку на запись и открыть объект через Справочник.Имя.ПолучитьОбъект(Ссылка).
Изменение объектов прямо внутри обхода той же выборки может привести к неопределённому поведению или пропуску записей. Безопаснее сохранить ссылки на подлежащие корректировке записи в отдельный массив или таблицу значений, завершить обход, а затем пройти по собранным ссылкам и выполнить запись.
При массовой записи учитывайте права доступа, блокировки и необходимость проведения обязательных реквизитов. Ошибка в одной записи не должна прерывать весь обход без фиксации: лучше собирать список необработанных записей и возвращаться к ним после завершения основного цикла.
Сравнение вариантов обхода
Подходит для простых отборов и небольших справочников, ограничена в сортировке и соединении с другими данными.
Удобен для сложных фильтров, соединений и повторной обработки, требует больше памяти при больших выборках.
Необходим для изменения реквизитов, медленнее чтения из выборки и требует осторожности при записи.
H2: Альтернативы: запрос и выгрузка в таблицу значений
Для больших справочников прямой метод Выбрать() может быть неудобен из-за отсутствия гибкой сортировки и сложности соединения с данными из других таблиц. Запрос позволяет отобрать записи по сложным условиям, соединить справочник с регистрами или документами и получить готовый набор для цикла.
Выгрузка результата запроса в таблицу значений даёт возможность многократного прохода по данным, сортировки и фильтрации без повторного обращения к базе. Это удобно, когда одна и та же выборка используется в нескольких отчётах или этапах обработки.
Минусом выгрузки может быть потребление памяти при очень больших выборках. В таких случаях целесообразно обрабатывать данные порциями или использовать постраничную выборку, если платформа и конфигурация это поддерживают.
H2: Проверка результата и границы безопасной работы
После завершения цикла полезно сравнить количество обработанных записей с ожидаемым числом отобранных строк. Если обработка должна была затронуть все активные элементы, а в результате пропущены записи, причина может быть в отборе, сортировке или условии продолжения цикла.
Как проверить результат
Совпадает с числом отобранных активных записей
Меньше ожидаемого без объяснения пропусков
Пустой список ошибок или все ошибки задокументированы
Есть необработанные ссылки без причины
Реквизиты обновлены, связанные объекты не повреждены
Появились блокировки, ошибки целостности или отсутствие прав
При записи изменений рекомендуется вести журнал успешно обработанных и ошибочных ссылок. Это позволяет повторно запустить обработку только для неудачных записей вместо полного повторного обхода всего справочника.
Независимая работа допустима для чтения и стандартной корректировки реквизитов в рамках своих прав. Если затрагиваются межсвязанные справочники, проводки, закрытые периоды или объекты с ограниченным доступом, целесообразно согласовать изменения с администратором системы и проверить их на копии базы.
Что важно запомнить
Выбирайте способ обхода под задачу, фильтруйте выборку, не меняйте объекты внутри той же выборки и проверяйте результат после цикла.
Нужно ли открывать каждый объект через ПолучитьОбъект() при чтении?
Нет, для чтения реквизитов достаточно строки выборки справочника. Открытие объекта требуется, когда планируется изменение данных или вызов методов самого объекта.
Как обработать только элементы, исключая группы?
Используйте проверку вида записи или отбор по признаку элемента на каждой итерации, чтобы не пытаться читать реквизиты, доступные только у элементов справочника.
Можно ли удалять записи справочника прямо в цикле обхода?
Не рекомендуется, так как удаление может изменить состав выборки и привести к пропуску или повторной обработке записей. Безопаснее собрать ссылки на удаление, а затем выполнить их в отдельном цикле.
Что делать, если обход работает медленно?
Сузьте отбор, выгрузите данные в таблицу значений с нужной сортировкой или обрабатывайте выборку порциями вместо попытки загрузить весь большой справочник сразу.