Как отладить заполнение табличной части в 1С

Табличная часть — самое «хрупкое» место документа в 1С: строки либо не появляются вовсе, либо дублируются, либо заполняются не теми значениями. Причина почти всегда находится в одном из трёх мест: в источнике данных (запрос возвращает не то), в логике обхода (строки добавляются не тогда и не туда) или в событиях формы, которые молча перезаписывают результат.

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

Подготовка: включить отладку и найти нужную процедуру

Сначала убедитесь, что отладка вообще разрешена. В конфигураторе откройте «Сервис → Параметры» и проверьте настройки отладки, а для серверного режима убедитесь, что сервер 1С запущен с ключом отладки (для агента сервера — параметр -debug). Без этого точки останова на серверном коде просто не сработают, и вы будете искать ошибку там, где её «не видно».

Далее найдите процедуру, которая заполняет табличную часть. Типовые места: обработчик команды «Заполнить» в модуле формы документа, процедура ОбработкаЗаполнения в модуле объекта, обработчики ПриИзменении ключевых реквизитов (контрагент, договор, склад) и процедуры подбора. Быстрый способ — глобальный поиск (Ctrl+Shift+F) по имени табличной части, например Товары или Объект.Товары.

Проверка источника данных: запрос возвращает то, что нужно

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

Если запрос пуст, проверьте параметры: откройте «Вычислить выражение» (Shift+F9) и посмотрите каждый параметр запроса — организация, дата, склад, ссылка на документ-основание. Типичная ситуация: в параметр передаётся пустая ссылка или дата без времени, и отбор отсекает все записи. Также проверьте виртуальные таблицы: остатки на дату документа могут быть нулевыми просто потому, что документ проводится «задним числом».

Для сложных запросов удобно скопировать текст запроса в консоль запросов (внешнюю обработку) и выполнить его с теми же параметрами отдельно. Это отделяет проблему «запрос неверен» от проблемы «код обработки результата неверен» — два разных класса ошибок, которые лечатся по-разному.

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

Пошаговая отладка цикла заполнения строк

Когда запрос возвращает данные, но табличная часть всё равно заполняется неправильно, переходите к циклу. Поставьте точку останова на строке НоваяСтрока = Объект.Товары.Добавить() и проходите итерации по F10 (шаг через) или F11 (шаг внутрь). На каждой итерации проверяйте значения полей выборки и то, что реально попало в новую строку после заполнения.

Обращайте внимание на условия внутри цикла: конструкции вида Если Выборка.Количество > 0 Тогда или фильтрация по признаку могут молча пропускать часть строк. Если строка в табличной части «потерялась», почти всегда найдётся условие, которое её отсекло. Полезно временно добавить счётчик пропущенных строк и вывести его после цикла — так вы увидите масштаб потерь.

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

1. 1
   Включите отладку и поставьте точку останова в начале процедуры заполнения
2. 2
   Воспроизведите действие пользователя: нажмите кнопку заполнения или измените реквизит-триггер
3. 3
   Проверьте результат запроса-источника: РезультатЗапроса.Пустой() и параметры запроса
4. 4
   Пройдите цикл по шагам, сверяя значения выборки и значения, попавшие в строку
5. 5
   После цикла проверьте Объект.Товары.Количество() и содержимое первой и последней строки
6. 6
   Снимите точки останова и повторите сценарий дважды, чтобы исключить задвоение строк

Отладка на форме: события, которые перезаписывают результат

Даже если серверная процедура заполнила строки корректно, на форме результат может измениться. Обработчики ПриИзменении номенклатуры, количества или цены часто содержат пересчёт сумм, подстановку ставки НДС или единицы измерения. Если они срабатывают программно при заполнении, итоговые значения в строке отличаются от тех, что вернул запрос.

Проверить это просто: поставьте точку останова в обработчике изменения и посмотрите стек вызовов (Ctrl+Alt+C). Если обработчик вызывается из процедуры заполнения, а не от действия пользователя, — значит, пересчёт выполняется дважды или с другими исходными данными. В типовых конфигурациях для управляемых форм программное заполнение часто оформляют так, чтобы обработчики изменения вызывались явно и в нужном порядке; проверьте, соблюдён ли этот порядок.

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

Типовые ошибки и как их распознать

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

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

Когда отладчика недостаточно: журнал регистрации и замеры

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

Для проблем производительности (табличная часть заполняется минутами) используйте замер производительности в конфигураторе: он покажет, какая строка кода съедает время. Частый виновник — запрос внутри цикла по строкам вместо одного запроса с последующим поиском в выгруженной таблице значений.

Итоговая проверка и границы самостоятельной работы

Завершайте отладку контрольным прогоном: заполнение на пустом документе, повторное заполнение, заполнение с другими параметрами (другая организация, склад, дата), проведение документа и проверка движений. Только совокупность этих проверок подтверждает, что причина найдена, а не замаскирована.

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

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