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