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

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

Главная сложность для начинающего разработчика — понять, что табличная часть не является «полем» документа. Это полноценная таблица со своими реквизитами и служебными полями (Ссылка, НомерСтроки, КлючСтроки). Поэтому обращение Документ.РеализацияТоваровУслуг.Товары.Номенклатура в списке полей выборки из шапки документа вызовет ошибку — нужно либо выбирать из табличной части напрямую, либо соединять две таблицы.

Базовый синтаксис обращения к табличной части

Имя табличной части формируется по шаблону ТипОбъекта.ИмяОбъекта.ИмяТабличнойЧасти. Например, для табличной части «Товары» документа «ПоступлениеТоваровУслуг» источник данных выглядит так: Документ.ПоступлениеТоваровУслуг.Товары. Для справочника — аналогично: Справочник.Контрагенты.КонтактнаяИнформация.

Простейший запрос к табличной части выглядит так:

ВЫБРАТЬ
	Товары.Ссылка КАК Документ,
	Товары.Номенклатура КАК Номенклатура,
	Товары.Количество КАК Количество,
	Товары.Сумма КАК Сумма
ИЗ
	Документ.РеализацияТоваровУслуг.Товары КАК Товары
ГДЕ
	Товары.Ссылка = &Ссылка

Псевдоним таблицы (в примере — Товары) задавать не обязательно, но настоятельно рекомендуется: без него обращение к полям идёт через полное имя таблицы, что делает текст запроса громоздким и трудным для сопровождения.

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

Соединение шапки документа с табличной частью

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

ВЫБРАТЬ
	Реализация.Ссылка КАК Документ,
	Реализация.Контрагент КАК Контрагент,
	Товары.Номенклатура КАК Номенклатура,
	Товары.Количество КАК Количество
ИЗ
	Документ.РеализацияТоваровУслуг КАК Реализация
		ВНУТРЕННЕЕ СОЕДИНЕНИЕ Документ.РеализацияТоваровУслуг.Товары КАК Товары
		ПО Реализация.Ссылка = Товары.Ссылка
ГДЕ
	Реализация.Проведен
	И Реализация.Дата МЕЖДУ &НачалоПериода И &КонецПериода

Обратите внимание на условие Реализация.Проведен: по умолчанию запрос видит и помеченные на удаление, и непроведённые документы. Если этого не учесть, в отчёт попадут «мусорные» строки, и итоги разойдутся с данными регистров.

Итоги и обход результата по группировкам

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

1. 1
   Сформируйте запрос с соединением шапки и табличной части
2. 2
   Добавьте в конец запроса: ИТОГИ ПО Реализация.Ссылка
3. 3
   Выполните запрос и обойдите результат методом Выбрать(ОбходРезультатаЗапроса.ПоГруппировкам)
4. 4
   Для каждой строки группировки вызовите вложенную Выбрать() — получите строки табличной части
5. 5
   Проверьте, что количество вложенных строк совпадает с числом строк в документе

Пример обхода в коде модуля:

ВыборкаДокументы = РезультатЗапроса.Выбрать(ОбходРезультатаЗапроса.ПоГруппировкам);
Пока ВыборкаДокументы.Следующий() Цикл
	ВыборкаСтроки = ВыборкаДокументы.Выбрать();
	Пока ВыборкаСтроки.Следующий() Цикл
		// Обработка строки табличной части
	КонецЦикла;
КонецЦикла;

Альтернатива — выгрузить результат в таблицу значений методом Выгрузить(ОбходРезультатаЗапроса.ПоГруппировкам): тогда строки табличной части окажутся в колонке-коллекции «Строки», что удобно для дальнейшей программной обработки.

Группировка и агрегирование данных табличной части

Для аналитических задач табличную часть группируют по нужным измерениям с агрегатными функциями СУММА, КОЛИЧЕСТВО, МАКСИМУМ. Например, продажи по номенклатуре за период:

ВЫБРАТЬ
	Товары.Номенклатура КАК Номенклатура,
	СУММА(Товары.Количество) КАК Количество,
	СУММА(Товары.Сумма) КАК Сумма
ИЗ
	Документ.РеализацияТоваровУслуг.Товары КАК Товары
ГДЕ
	Товары.Ссылка.Проведен
	И Товары.Ссылка.Дата МЕЖДУ &НачалоПериода И &КонецПериода
СГРУППИРОВАТЬ ПО
	Товары.Номенклатура

Конструкция КОЛИЧЕСТВО(РАЗЛИЧНЫЕ Товары.Ссылка) позволяет посчитать, в скольких документах встречается позиция — полезно при анализе ассортимента. Учтите, что обычное КОЛИЧЕСТВО посчитает строки, а не документы.

Виртуальная таблица или табличная часть: что выбрать

Часто те же данные доступны и через регистры (например, продажи — через регистр накопления «Продажи»). Выбор источника влияет и на скорость, и на корректность результата.

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

Типичные ошибки при работе с табличными частями

Особенности и ограничения

У табличных частей есть служебное поле НомерСтроки — по нему можно упорядочить результат в том же порядке, в каком строки идут в документе: УПОРЯДОЧИТЬ ПО Товары.Ссылка, Товары.НомерСтроки. Без явного упорядочивания порядок строк не гарантирован.

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

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

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