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

Имя табличной части в 1С требуется, когда код должен работать с разными документами универсально: построить запрос, скопировать строки, вывести печатную форму или заполнить данные программно. Обратиться к табличной части «в лоб» через точку (Документ.Товары) можно только тогда, когда имя известно заранее. Если же алгоритм пишется для произвольного объекта, имя приходится получать через метаданные.

Встроенный язык 1С даёт для этого два основных пути: коллекцию Метаданные.ТабличныеЧасти у объекта метаданных и коллекцию ТабличныеЧасти у конкретного объекта данных. Оба подхода возвращают имена в виде строк, которые затем используются через квадратные скобки: Объект["Товары"].

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

Через что получают имя табличной части

Табличная часть — составная часть объекта конфигурации (документа, справочника, плана счетов и т.д.), описанная в метаданных. У каждой табличной части есть имя, заданное разработчиком в конфигураторе, например «Товары», «Услуги», «Сотрудники». Именно это имя используется в запросах, обращениях к коллекциям строк и при программном заполнении.

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

Важно различать: метаданные описывают структуру (имена, реквизиты, типы), а объект данных хранит сами строки. Для получения имени достаточно метаданных; для чтения или изменения строк нужен объект данных.

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

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

ОбъектМетаданных = СсылкаНаДокумент.Метаданные();

Для Каждого ТабличнаяЧасть Из ОбъектМетаданных.ТабличныеЧасти Цикл
Сообщить("Имя табличной части: " + ТабличнаяЧасть.Имя);
КонецЦикла;

Здесь ТабличнаяЧасть.Имя — строка с именем, например «Товары». Кроме имени у элемента коллекции доступны Синоним (представление для пользователя) и коллекция Реквизиты, что удобно для построения универсальных выгрузок.

Если нужно проверить существование конкретной табличной части, используйте метод Найти:

Если ОбъектМетаданных.ТабличныеЧасти.Найти("Товары") <> Неопределено Тогда
// табличная часть "Товары" существует
КонецЕсли;

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

Перебор табличных частей у объекта данных

Если работа идёт с открытым объектом (через ПолучитьОбъект() или в модуле объекта через ЭтотОбъект), можно перебрать коллекцию ТабличныеЧасти самого объекта. Эта коллекция содержит сами табличные части с данными, а имя каждой получают через её метаданные:

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

Для Каждого ТабличнаяЧасть Из ДокументОбъект.Метаданные().ТабличныеЧасти Цикл
ИмяТЧ = ТабличнаяЧасть.Имя;
КоллекцияСтрок = ДокументОбъект[ИмяТЧ];
Сообщить(ИмяТЧ + ": строк — " + КоллекцияСтрок.Количество());
КонецЦикла;

Ключевой приём — обращение по строковому имени через квадратные скобки: ДокументОбъект[ИмяТЧ]. Это позволяет писать код, не привязанный к конкретной конфигурации.

В модуле объекта или формы документа аналогично работает обращение к ЭтотОбъект (в модуле объекта) или к реквизиту формы типа «ДанныеФормыСтруктура» — в последнем случае коллекцию табличных частей формы перебирают через Элементы формы или через метаданные объекта, связанного с формой.

Получение имени для таблицы значений и запроса

Когда табличная часть выгружена в таблицу значений

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

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

В тексте запроса табличная часть указывается через точку после имени документа: Документ.РеализацияТоваровУслуг.Товары. Чтобы собрать такой запрос динамически, имя табличной части подставляют строкой:

ИмяТЧ = СсылкаНаДокумент.Метаданные().ТабличныеЧасти[0].Имя;
ИмяДокумента = СсылкаНаДокумент.Метаданные().Имя;

ТекстЗапроса = "ВЫБРАТЬ * ИЗ Документ." + ИмяДокумента + "." + ИмяТЧ
+ " ГДЕ Ссылка = &Ссылка";

Такой подход применяют в универсальных отчётах и обработках сравнения данных. Учтите: обращение ТабличныеЧасти[0] берёт первую табличную часть по порядку в конфигураторе, что не всегда совпадает с нужной логически — надёжнее искать по имени через Найти().

Особенности для разных типов объектов

Не у всех объектов метаданных есть табличные части. Коллекция ТабличныеЧасти существует у документов, справочников, планов видов характеристик, планов счетов, планов видов расчёта, бизнес-процессов, задач и некоторых других объектов. У регистров, констант, перечислений табличных частей нет — обращение к свойству вызовет ошибку.

Чтобы код не падал, проверяйте наличие свойства через метаданные или тип объекта:

ОбъектМетаданных = Ссылка.Метаданные();

Если Метаданные.Документы.Содержит(ОбъектМетаданных)
Или Метаданные.Справочники.Содержит(ОбъектМетаданных) Тогда
// у объекта может быть коллекция ТабличныеЧасти
КонецЕсли;

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

Типичные ошибки и как их избежать

Самая частая ошибка — попытка обратиться к несуществующей табличной части по «жёстко» прописанному имени. В типовых конфигурациях имена отличаются: в одном документе «Товары», в другом «Запасы» или «Материалы». Перед обращением всегда проверяйте наличие через Найти().

Вторая ошибка — путаница между именем и синонимом. Синоним («Товары и услуги») предназначен для интерфейса и не работает в обращениях через квадратные скобки и в запросах. Использовать нужно только свойство Имя.

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

Проверка результата и практические рекомендации

После получения имени проверьте, что обращение по нему работает: выполните Объект[ИмяТЧ].Количество() в отладчике или через Сообщить(). Если возвращается число строк — имя корректно. Ошибка «Поле объекта не обнаружено» означает, что имя не совпадает с метаданными.

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

1. 1
   Получите объект метаданных: Ссылка.Метаданные()
2. 2
   Переберите коллекцию ТабличныеЧасти или найдите нужную через Найти(Имя)
3. 3
   Сохраните имя в строковую переменную
4. 4
   Обратитесь к данным через Объект[ИмяТЧ] или подставьте имя в текст запроса
5. 5
   Проверьте результат: количество строк или выполнение запроса без ошибок

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