Как получить колонки табличной части в 1С

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

Основной инструмент — свойство Колонки объекта табличной части, которое возвращает коллекцию КолонкиТабличнойЧасти. У каждого элемента этой коллекции есть имя, тип значения, заголовок и ширина. Дополнительно структуру можно получить через метаданные объекта — этот способ работает даже без открытия самого документа.

Как получить колонки через свойство Колонки табличной части

Самый прямой способ — обратиться к свойству Колонки у табличной части конкретного объекта. Это работает в модуле объекта, в модуле формы (на сервере) и в любом серверном коде, где доступна ссылка на объект:

ДокументОбъект = СсылкаНаДокумент.ПолучитьОбъект();
КолонкиТЧ = ДокументОбъект.Товары.Колонки;

Для Каждого Колонка Из КолонкиТЧ Цикл
Сообщить(Колонка.Имя + " | " + Колонка.ТипЗначения + " | " + Колонка.Заголовок);
КонецЦикла;

Каждый элемент коллекции имеет полезные свойства: Имя — идентификатор реквизита, ТипЗначения — описание типов колонки, Заголовок — представление для пользователя, Ширина — ширина по умолчанию. Для программной обработки чаще всего нужны именно Имя и ТипЗначения.

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

Как получить колонки через метаданные без открытия объекта

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

МетаТЧ = Метаданные.Документы.РеализацияТоваровУслуг.ТабличныеЧасти.Товары;

Для Каждого Реквизит Из МетаТЧ.Реквизиты Цикл
Сообщить(Реквизит.Имя + " | " + Реквизит.Тип + " | " + Реквизит.Синоним);
КонецЦикла;

Здесь коллекция называется Реквизиты, а не «Колонки» — это типичный источник путаницы. Кроме явно описанных реквизитов, у каждой строки табличной части есть стандартный реквизит НомерСтроки, который в коллекцию Реквизиты не входит. Учитывайте это при универсальных обходах.

Если имя документа или табличной части известно только в виде строки (например, приходит параметром), используйте индексный доступ: Метаданные.Документы[ИмяДокумента].ТабличныеЧасти[ИмяТЧ]. Перед обращением проверяйте существование через Метаданные.Документы.Найти(ИмяДокумента), иначе получите ошибку обращения к несуществующему элементу.

МетаТЧ = Метаданные.Документы[ИмяДокумента].ТабличныеЧасти[ИмяТабличнойЧасти];
Для Каждого Реквизит Из МетаТЧ.Реквизиты Цикл
    // Реквизит.Имя, Реквизит.Тип, Реквизит.Синоним
КонецЦикла;

Как получить колонки табличной части на управляемой форме

На управляемой форме табличная часть обычно представлена реквизитом формы типа ДанныеФормыКоллекция. У такого реквизита нет прямого свойства «Колонки», поэтому структуру получают одним из двух способов.

Первый способ — преобразовать данные формы в объект и прочитать колонки:

ТаблицаЗначений = РеквизитФормыВЗначение("Объект").Товары.Выгрузить();
Для Каждого Колонка Из ТаблицаЗначений.Колонки Цикл
Сообщить(Колонка.Имя);
КонецЦикла;

Второй способ — обойти колонки элемента формы «Таблица». У элемента ТаблицаФормы есть коллекция ПодчиненныеЭлементы, где каждый элемент-потомок соответствует видимой колонке. Через свойство ПутьКДанным элемента можно извлечь имя реквизита: оно стоит после последней точки в пути вида Объект.Товары.Номенклатура.

Как получить колонки таблицы значений и результата запроса

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

Запрос = Новый Запрос("ВЫБРАТЬ * ИЗ Документ.РеализацияТоваровУслуг.Товары");
РезультатТЗ = Запрос.Выполнить().Выгрузить();

Для Каждого Колонка Из РезультатТЗ.Колонки Цикл
Сообщить(Колонка.Имя + " | " + Колонка.ТипЗначения);
КонецЦикла;

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

1. 1
   Определите контекст: есть объект, есть форма или только имя метаданных
2. 2
   Если есть объект — используйте Объект.ИмяТЧ.Колонки
3. 3
   Если объекта нет — читайте Метаданные...ТабличныеЧасти.ИмяТЧ.Реквизиты
4. 4
   Если данные в таблице значений — обойдите ТЗ.Колонки
5. 5
   Проверьте результат: выведите имена и типы колонок в сообщения или журнал

Как получить только имена колонок списком или массивом

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

ИменаКолонок = Новый Массив;
Для Каждого Колонка Из ТаблицаЗначений.Колонки Цикл
ИменаКолонок.Добавить(Колонка.Имя);
КонецЦикла;
СтрокаКолонок = СтрСоединить(ИменаКолонок, ", ");

Для колонок табличной части объекта есть короткий путь: метод ВыгрузитьКолонки() без параметров возвращает пустую таблицу значений со всеми колонками, а ВыгрузитьКолонки("Номенклатура, Количество") — только с перечисленными. Это удобно, когда нужна структура без данных.

Типичные ошибки и ограничения

Первая распространённая ошибка — попытка получить колонки у табличной части через точку от ссылки: Ссылка.Товары.Колонки не сработает, потому что у ссылки нет данных объекта. Нужно сначала получить объект методом ПолучитьОбъект() или читать структуру через метаданные.

Вторая ошибка — смешение коллекций Реквизиты (метаданные) и Колонки (данные). Их свойства похожи, но не идентичны: у реквизита метаданных есть Тип и Синоним, у колонки — ТипЗначения и Заголовок. Копирование кода между контекстами без правки имён свойств приводит к ошибкам исполнения.

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

Как проверить результат и убедиться в корректности

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

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

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

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