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

Другое · 8 мин

Обход табличного документа в 1С: строки, столбцы и области

Как обойти табличный документ в 1С: перебор строк, столбцов и областей, проверка границ, типичные ошибки и безопасные приёмы работы с ТабличнымДокументом.

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

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

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

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

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

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

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

Основные способы обхода табличного документа

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

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

Примерный порядок действий при обходе

// Примерная логика, уточняйте точные методы в синтакс-помощнике платформы
Высота = ТабличныйДокумент.Высота;
Ширина = ТабличныйДокумент.Ширина;

Для Строка = 1 По Высота Цикл
Для Колонка = 1 По Ширина Цикл
ТабличныйДокумент.ВыбратьЯчейку(Строка, Колонка);
Значение = ТабличныйДокумент.ТекущиеДанные;
// обработка значения
КонецЦикла;
КонецЦикла;

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

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

Проверка границ, пустых ячеек и областей

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

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

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

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

Высота и ширина области перед циклом
Норма

Соответствуют ожидаемому количеству строк и столбцов

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

Нулевые или заведомо завышенные значения

Содержимое ячеек в процессе обхода
Норма

Значения читаются без ошибок, пустые ячейки обрабатываются

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

Ошибка при выборе ячейки или пропуск строк

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

Совпадает с числом выведенных записей

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

Меньше ожидаемого, часть данных не обойдена

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

Ограничения, риски и типичные ошибки

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

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

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

Типичные ошибки
01
Обход табличного документа до завершения вывода приводит к пропуску строк
02
Попытка изменить ячейки напрямую в процессе обхода может нарушить печатную форму
03
Игнорирование пустых и объединённых ячеек искажает подсчёт данных

Как выбрать подходящий вариант обхода

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

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

Итог

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

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

Часто задаваемые вопросы

Чем табличный документ отличается от таблицы значений?

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

Можно ли менять значения ячеек во время обхода?

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

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

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

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

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