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