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

Другое · 7 мин

Как проверить, что табличная часть не пуста в 1С

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

Табличная часть в 1С — это набор строк реквизита объекта, например номенклатуры в документе или строк в отчёте. Проверка на пустоту означает определение, есть ли в этом наборе хотя бы одна строка, а не просто существование реквизита в метаданных.

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

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

Что считать пустой табличной частью

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

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

Проверка в модуле объекта

В модуле объекта табличная часть доступна как свойство объекта, например Объект.НазваниеТабличнойЧасти. Наиболее распространённая проверка выглядит так:

Если Объект.НазваниеТабличнойЧасти.Количество() = 0 Тогда

// табличная часть пуста

КонецЕсли;

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

Проверка перед сохранением или проведением

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

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

Проверка в управляемой форме

В форме табличная часть обычно представлена элементом управления. Доступ к строке можно получить через значение элемента:

Если Элементы.НазваниеТабличнойЧасти.Значение.Количество() = 0 Тогда

// в форме нет строк

КонецЕсли;

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

Реквизит существуетТабличная часть есть в метаданных

Убедитесь, что реквизит добавлен в объект перед проверкой строк

Количество строк равно нулюТабличная часть пуста

Проверяйте свойство Количество() табличной части

Элемент формы пустВ интерфейсе нет строк

Проверяйте значение элемента управления, а не только объект

Отличие строки и выделенной строки

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

Когда проверять и где вставлять код

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

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

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

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

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

-->

Порядок действий
  1. 1
    Убедитесь, что реквизит табличной части существует в объекте
  2. 2
    Добавьте проверку Количество() = 0 перед сохранением или проведением
  3. 3
    Выведите понятное сообщение, если строк нет
  4. 4
    Проверьте поведение на копии базы с пустой и заполненной табличной частью

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

Альтернативы и проверка результата

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

Типичные ошибки
01
Проверка существования реквизита вместо количества строк
02
Проверка только в форме без контроля при записи
03
Блокировка сохранения для допустимых пустых табличных частей

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

Сравнение способов проверки

Проверка в модуле объекта подходит для серверной логики и записи, а проверка в форме — для оперативного информирования пользователя. Используйте оба способа вместе, если нужно и заблокировать некорректную запись, и предупредить заранее.

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

Итог

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

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

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

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

Можно ли использовать проверку только в форме?

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

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

Убедитесь, что вы обращаетесь к актуальному объекту и правильному реквизиту табличной части. Проверьте, не перекрывает ли стандартный модуль вашу логику, и протестируйте на копии базы.

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

Безопасно в пределах собственных модулей и после тестирования на копии информационной базы. Не правьте типовую конфигурацию и платформу без понимания последствий и резервной копии.