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

Другое · 8 мин

Скрытие колонки в табличном документе 1С

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

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

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

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

Что понимают под скрытием колонки в табличном документе

В табличном документе каждая колонка представлена объектом коллекции Колонки. У этого объекта есть логическое свойство Видимость. Если значение равно Истине, колонка отображается; если Ложь — колонка скрыта из вида, но остаётся в таблице. Скрытие не меняет порядок остальных колонок и не удаляет значения ячеек.

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

Где менять видимость колонки

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

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

Программное скрытие колонки

Типичный код выглядит так: обращение к коллекции Колонки табличного документа, выбор колонки по имени или индексу и присваиванию свойству Видимость значения Ложь. Для показа колонки используется значение Истина. Если требуется скрыть несколько колонок, удобно пройти по коллекции в цикле и проверить имена или индексы.

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

Порядок действий программно
  1. 1
    Откройте модуль отчёта, обработки или печатной формы, где формируется табличный документ.Найдите место, где табличный документ создаётся или заполняется колонками.Обратитесь к ТабличныйДокумент.Колонки.ИмяКолонки и присвойте свойству Видимость значение Ложь.Повторите вывод табличного документа на форму или откройте предварительный просмотр.Проверьте, что целевая колонка исчезла, а данные в остальных колонках остались.
"}

Сценарии: отчёты, обработки, печатные формы и динамические списки

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

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

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

Как проверить, что колонка скрыта

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

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

"}

Ограничения и риски при печати и экспорте

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

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

"}

Частые ошибки при скрытии колонок

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

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

Типичные ошибки
01
Путают колонку табличного документа и колонку табличной части формы.Меняют свойство в коде, но не выводят документ повторно.Обращаются к несуществующему имени или индексу колонки.Считают скрытие защитой данных и не проверяют экспорт и печать.
"}

Альтернативы скрытию колонки

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

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

Итог

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

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

"}
Можно ли скрыть колонку только для одного пользователя?

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

Удалятся ли данные при скрытии колонки?

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

Почему скрытая колонка всё равно может печататься?

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

В чём разница между табличным документом и табличной частью формы?

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