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

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

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

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

Проверка через ВысотаТаблицы и ШиринаТаблицы

Самый простой и быстрый способ — свойства ВысотаТаблицы и ШиринаТаблицы. Они возвращают количество строк и колонок, реально занятых в документе. Если в документ ничего не выводилось, оба значения равны нулю.

Функция ТабличныйДокументПуст(ТабДок)
Если ТабДок.ВысотаТаблицы = 0
Или ТабДок.ШиринаТаблицы = 0 Тогда
Возврат Истина;
КонецЕсли;
Возврат Ложь;
КонецФункции

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

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

Проверка наличия текста в документе

Когда документ содержит служебные области (шапку, рамки, подписи), проверяют не размеры, а содержимое ячеек. Универсальный вариант — перебор ячеек и анализ свойства Текст:

Функция ЕстьТекстВДокументе(ТабДок)
Для НомерСтроки = 1 По ТабДок.ВысотаТаблицы Цикл
Для НомерКолонки = 1 По ТабДок.ШиринаТаблицы Цикл
Область = ТабДок.Область(НомерСтроки, НомерКолонки);
Если Не ПустаяСтрока(Область.Текст) Тогда
Возврат Истина;
КонецЕсли;
КонецЦикла;
КонецЦикла;
Возврат Ложь;
КонецФункции

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

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

Поиск конкретного значения методом НайтиТекст

Если критерий «непустоты» — наличие определённых данных (например, строки с итогом, номера документа, наименования контрагента), удобнее метод НайтиТекст. Он ищет заданную строку в документе и возвращает область или Неопределено.

ОбластьПоиска = ТабДок.НайтиТекст("Итого");
Если ОбластьПоиска = Неопределено Тогда
// Документ не содержит итоговой строки — считаем пустым
КонецЕсли;

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

Проверка данных до формирования документа

На практике самый надёжный подход — вообще не проверять готовый табличный документ, а проверять источник данных до вывода. Если печатная форма строится по запросу или таблице значений, достаточно проверить Выборка.Количество(), РезультатЗапроса.Пустой() или ТаблицаЗначений.Количество() = 0.

РезультатЗапроса = Запрос.Выполнить();
Если РезультатЗапроса.Пустой() Тогда
Сообщить("Нет данных для формирования печатной формы");
Возврат;
КонецЕсли;

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

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

Проверка на тонком клиенте и в управляемых формах

В управляемых формах реквизит формы типа ТабличныйДокумент доступен на клиенте, и свойства ВысотаТаблицы и ШиринаТаблицы у него можно читать. Однако полноценная работа с табличным документом (вывод областей, макетов) выполняется на сервере.

Типовой шаблон: на сервере формируется документ, там же выполняется проверка на пустоту, и если документ пуст — на клиент возвращается признак с сообщением, а не пустой результат. Это уменьшает трафик и упрощает логику формы.

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

&НаСервере
Процедура СформироватьНаСервере()
	ТабДок = СформироватьПечатнуюФорму();
	Если ТабДок.ВысотаТаблицы = 0 Тогда
		ВызватьИсключение "Нет данных для печатной формы";
	КонецЕсли;
	РезультатДокумент = ТабДок;
КонецПроцедуры

Типичные ошибки при проверке

Частая ошибка — проверять только ВысотаТаблицы для документа, в который всегда выводится макет-заголовок. Проверка показывает «не пусто», пользователь открывает форму с одной шапкой и считает это сбоем программы.

Вторая ошибка — сравнение текста ячейки с пустой строкой через = "" вместо ПустаяСтрока(). Ячейка с пробелом пройдёт такую проверку как «заполненная», и документ с одними пробелами будет признан непустым.

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

Проверка результата и границы применения

Чтобы убедиться, что проверка работает правильно, протестируйте её на трёх наборах: полностью пустом документе, документе только с шапкой и документе с реальными данными. Результат должен быть «пуст», «пуст» (по критерию данных) и «не пуст» соответственно.

Учитывайте, что объединённые ячейки, картинки и диаграммы в табличном документе не содержат текста. Если «непустота» документа определяется наличием изображения или диаграммы, текстовые проверки не помогут — ориентируйтесь на размеры документа или на данные-источники.

Для регламентных операций (автоматическая рассылка отчётов, формирование пакета документов) сочетайте оба уровня: проверку данных до формирования и контрольную проверку готового документа. Это защищает от ситуации, когда данные есть, но из-за ошибки в макете в документ ничего не вывелось.

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