Как получить колонки табличной части 1С: методы и объекты

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

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

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

Получение описания структуры через объекты метаданных

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

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

Рассмотрим пример получения коллекции реквизитов для табличной части "Товары" документа "РеализацияТоваровУслуг". Код ниже демонстрирует, как безопасно пройти по всем полям и вывести их имена. Обратите внимание, что мы работаем с описанием типа, а не с самими значениями.

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

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

⚠️ Внимание: Свойство Реквизиты возвращает только поля, непосредственно объявленные в табличной части. Системные поля, такие как НомерСтроки, не входят в эту коллекцию и должны обрабатываться отдельно, если они требуются для вашей логики.

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

Разница между Имя и Идентификатор

Поле "Имя" возвращает имя, которое используется в запросах и коде (например, "Номенклатура"), а свойство, содержащее уникальный внутренний идентификатор GUID, обычно используется для глубокой синхронизации конфигураций и в объектах обмена данными.

Анализ структуры через объект ТаблицаЗначений

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

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

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

ТЗ = Новый ТаблицаЗначений;
ТЗ.Колонки.Добавить("Номенклатура", ТипОписанияТипов("СправочникСсылка.Номенклатура"));
ТЗ.Колонки.Добавить("Количество", ТипОписанияТипов("Число"));

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

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

Использование отражения (Reflection) для универсального доступа

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

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

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

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

Получение имен полей через объект Запрос

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

Метод Выполнить() возвращает объект ВыборкаИзРезультатаЗапроса, у которого есть свойство Колонки. Перебор этой коллекции дает исчерпывающую информацию о всех полях результата, включая вычисляемые поля и поля из присоединенных таблиц. Это особенно полезно, когда табличная часть связана с другими справочниками, и вам нужны имена полей из этих связанных сущностей.

Преимущество этого метода заключается в том, что вы видите именно тот набор данных, который придет из базы данных, с учетом всех соединений и условий. Имена полей в результате запроса могут отличаться от имен реквизитов в конфигурации из-за использования псевдонимов или агрегатных функций, таких как СУММА или КОЛИЧЕСТВО.

Метод получения	Источник данных	Наличие системных полей	Производительность
Метаданные	Конфигурация	Нет (только реквизиты)	Высокая
ТаблицаЗначений	Память (переменная)	Зависит от наполнения	Очень высокая
Объект Запроса	Результат выборки	Зависит от текста запроса	Средняя (требует компиляции)

⚠️ Внимание: При использовании запросов помните, что имена полей в результате могут содержать префиксы таблиц (например, Товары.Номенклатура), если вы не использовали явные псевдонимы в секции ВЫБРАТЬ.

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

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

Для Каждого Колонка Из Выборка.Колонки Цикл
Сообщить(Колонка.Имя);
КонецЦикла;

Работа с системными и служебными полями

При анализе табличных частей важно различать пользовательские реквизиты и системные поля. Стандартные табличные части в 1С всегда содержат скрытые или явные служебные колонки, такие как НомерСтроки, Ссылка (в некоторых контекстах), ВерсияДанных. Эти поля не всегда отображаются в списке реквизитов метаданных, но присутствуют в реальных выборках и объектах данных.

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

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

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

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

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

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

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

⚠️ Внимание: Интерфейс и точные названия свойств объектов метаданных могут незначительно отличаться в разных версиях платформы 1С (например, 8.2, 8.3, 8.3.10+). Всегда проверяйте синтаксис в справке по вашей конкретной версии платформы.

При работе с динамически создаваемыми отчетами или обработками, которые должны работать в различных конфигурациях (БП, УТ, ЗУП), используйте проверки на существование табличной части перед попыткой получить её реквизиты. Метод ТабличныеЧасти.Найти() вернет Неопределено, если табличной части с таким именем нет, и попытка обратиться к свойству Реквизиты вызовет ошибку выполнения.

Частые вопросы по работе с табличными частями

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

Для получения количества колонок нужно сначала получить саму коллекцию реквизитов или колонок, а затем обратиться к свойству Количество(). Например: Метаданные.Документы.Реализация.ТабличныеЧасти.Товары.Реквизиты.Количество(). Если вы работаете с Таблицей Значений, то: ТЗ.Колонки.Количество().

Можно ли добавить новую колонку в табличную часть документа программно?

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

Как узнать тип данных конкретной колонки?

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

В чем разница между свойствами Имя и Синоним у колонки?

Свойство Имя возвращает техническое имя поля, которое используется в коде и запросах (латиница, без пробелов). Свойство Синоним возвращает понятное пользователю название на текущем языке интерфейса (например, "Номенклатура" вместо "НоменклатураСсылка"). Для программного доступа всегда используйте Имя.

Почему при получении колонок запроса я вижу дублирующие имена?

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