К статье
Практический материал

Другое · 6 мин

Как перебрать справочник в 1С: пошаговый разбор

Как перебрать справочник в 1С: циклы по элементам, отбор, выборка, проверка результата и типичные ошибки при работе со справочниками в конфигурации.

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

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

Когда перебор справочника нужен

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

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

Способы перебора в 1С

Цикл по всем элементам

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

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

Выборка с отбором

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

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

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

Проверьте итоговый счётчик после цикла

Отбор вернул нольУсловие слишком строгое или справочник пуст

Уберите лишние условия и повторите выборку

Встретилась группа вместо элементаПопытка записи в группу может вызвать ошибку

Проверяйте тип объекта перед изменением

Перебор с иерархией: группы и элементы

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

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

Типичные ошибки
01
Перебор всех элементов вместо отбора — лишняя нагрузка на базу
02
Изменение группы как элемента — ошибка записи или некорректные данные
03
Отсутствие проверки ссылки перед записью — работа с пустым объектом

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

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

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

Ограничения и безопасность

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

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

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

Альтернативы и частые ошибки

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

Частые ошибки: забыть про группы, не проверить наличие ссылки перед записью, использовать неактуальное состояние объекта после изменения и игнорировать блокировки при одновременной работе нескольких пользователей.

Контрольные точки

Как проверить результат

Количество обработанных записей
Норма

Совпадает с ожидаемым числом

Тревожный признак

Ноль или значительно меньше ожидаемого

Реквизиты после изменения
Норма

Значения обновлены корректно

Тревожный признак

Данные не изменились или изменились не те записи

Тип объекта в цикле
Норма

Обрабатываются только элементы

Тревожный признак

Попадаются группы вместо элементов

Как проверить, что перебор прошёл корректно

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

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

Итог

Что важно запомнить

Выбирайте способ перебора под задачу, используйте отбор для сокращения объёма, проверяйте тип объекта перед записью и тестируйте изменения на копии базы.

Нужно ли всегда перебирать весь справочник?

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

Можно ли менять группы в цикле по элементам?

Обычно нет. Группы и элементы — разные типы объектов справочника. Перед изменением записи стоит убедиться, что текущий объект является элементом, иначе операция может завершиться ошибкой.

Что делать, если перебор работает медленно?

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

Нужен ли резерв перед массовым перебором?

Да, если алгоритм изменяет данные. Резервная копия или тест на копии базы позволяет отменить нежелательные изменения, если условие отбора окажется слишком широким.