Как программно указать тип и источник данных для табличного поля на обычной форме в 1С?

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

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

Основной способ программной установки типа и источников

Чтобы элементам формы задать тип и структуру колонок, в обычных формах используется комбинация свойства Значение у элемента табличного поля и метода СоздатьКолонки(). Проанализируем базовый пример кода:

ЭлементыФормы.ТабличноеПоле1.Значение = Построитель.Отбор;
ЭлементыФормы.ТабличноеПоле1.СоздатьКолонки();

При присвоении объекту свойства Значение табличное поле автоматически определяет необходимый тип данных (в данном случае Отбор) и перестраивает свою структуру. Вызов метода СоздатьКолонки() принудительно формирует визуальные колонки в соответствии с составом полей источника.

Критически важная особенность: область видимости переменной

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

Чтобы избежать этой проблемы, разберем по шагам правильный порядок инициализации:

1. Объявим переменную объекта на уровне модуля формы (в самой первой секции модуля): Перем Построитель;
2. В процедуре инициализации (например, ПриОткрытии) создадим объект, зададим его настройки и привяжем отбор к табличному полю:
   Скопировать код

   
   Процедура ПриОткрытии()
       Построитель = Новый ПостроительОтчета;
       Построитель.Текст = "ВЫБРАТЬ Номенклатура, Количество ИЗ Документ.РеализацияТоваровУслуг.Товары {ГДЕ Номенклатура.*}";
       Построитель.ЗаполнитьНастройки();
       
       ЭлементыФормы.ТабличноеПолеОтбора.Значение = Построитель.Отбор;
       ЭлементыФормы.ТабличноеПолеОтбора.СоздатьКолонки();
   КонецПроцедуры
   

Важно: Метод ЗаполнитьНастройки() обязателен до привязки к форме. Без его вызова коллекция Построитель.Отбор не будет содержать полей, и колонки не сформируются.

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

Рассмотрим дополнительные способы работы с динамическими источниками данных в табличном поле:

1. Использование Построителя Запроса: Если на форме требуется только фильтрация данных без формирования итоговых отчетов, вместо ПостроительОтчета можно применить ПостроительЗапроса. Порядок связывания остается аналогичным:
   Скопировать код

   
   Построитель = Новый ПостроительЗапроса;
   Построитель.ИсточникДанных = Новый ОписаниеИсточникаДанных(ТаблицаЗначенийИсточник);
   ЭлементыФормы.ТабличноеПоле1.Значение = Построитель.Отбор;
   ЭлементыФормы.ТабличноеПоле1.СоздатьКолонки();
   

2. Управление видимостью полей отбора: У расширения табличного поля, связанного с типом Отбор, доступно свойство НастройкаОтбора. С его помощью можно скрыть ненужные поля от пользователя: ЭлементыФормы.ТабличноеПоле1.НастройкаОтбора.Добавить("Склад", Ложь);
3. Работа с СКД: При использовании Компоновщика Настроек в обычных формах отбор связывается напрямую с настройками компоновщика:
   Скопировать код

   
   ЭлементыФормы.ТабличноеПоле1.Значение = КомпоновщикНастроек.Настройки.Отбор;
   ЭлементыФормы.ТабличноеПоле1.СоздатьКолонки();