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

Другое · 7 мин

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

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

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

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

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

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

h2: Когда использовать выборку Выбрать()

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

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

h2: Обход через запрос и таблицу значений

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

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

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

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

h2: Особенности серверного и клиентского кода

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

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

h2: Проверка результата и контрольные признаки

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

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

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

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

Совпадает с числом записей по отбору

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

Меньше ожидаемого или есть пропуски

Наличие ошибок в журнале
Норма

Ошибок нет

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

Есть отказы по правам или блокировкам

Также полезно сохранить журнал обработки с идентификаторами элементов и результатом операции. При массовом изменении данных ведите резервную копию или тестируйте сценарий на копии информационной базы перед запуске в рабочей среде.

h2: Типичные ошибки и ограничения

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

Типичные ошибки
01
Обход без отбора по активности приводит к попаданию удалённых элементов в выборку
02
Изменение справочника внутри той же выборки может нарушить обход и привести к потере записей

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

h2: Сравнение способов обхода

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

Сравнение вариантов

Выборка Выбрать()

Подходит для простых клиентских сценариев и небольших справочников; ограничение — производительность на больших объёмах

Запрос с выгрузкой в таблицу значений

Эффективен для больших данных и отборов; ограничение — сложность прямой записи изменений в справочник

Серверный обход

Уменьшает нагрузку на клиент и подходит для фоновых заданий; ограничение — требует серверного контекста

h2: Альтернативы и когда обращаться к разработчику

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

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

Итог

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

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

Нужно ли включать помеченные на удаление элементы в обход?

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

Можно ли обходить справочник напрямую из клиентской формы?

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

Что делать, если количество обработанных элементов не совпадает с ожидаемым?

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

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

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