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

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

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

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

Структура табличной части и основные понятия

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

Важно различать понятия "строка табличной части" и "колонка". Строка — это элемент коллекции, а колонка — это свойство этого элемента. Например, в документе "Реализация товаров и услуг" строкой является конкретная позиция номенклатуры, а колонками будут "Номенклатура", "Количество" и "Цена".

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

Стоит отметить, что структура метаданных определяет типы данных в колонках. Если в конфигураторе для колонки "Сумма" указан тип Число, то при получении значения в коде вы получите именно числовое значение, а не строку. Это упрощает дальнейшие математические операции.

⚠️ Внимание: Не пытайтесь обращаться к несуществующим реквизитам динамически без проверки. Это вызовет ошибку выполнения. Всегда сверяйте имена полей с конфигуратором перед написанием кода.

Чтение данных в цикле "Для Каждого"

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

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

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

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

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

Доступ по индексу и метод Получить

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

Чтобы получить строку по номеру, можно использовать квадратные скобки или явный вызов метода. Это полезно, когда логика программы зависит от порядка следования элементов или нужно обратиться к предыдущей/следующей строке относительно текущей.

КоличествоСтрок = ДокументОбъект.Товары.Количество();
Для Индекс = 0 По КоличествоСтрок - 1 Цикл
СтрокаТЧ = ДокументОбъект.Товары[Индекс];
// Обработка строки
КонецЦикла;

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

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

В чем разница между [Индекс] и Получить(Индекс)?

Функционально они идентичны для чтения. Однако синтаксис с квадратными скобками является сахаром языка и internally вызывает метод получения. Явное использование метода может быть чуть более читаемым для тех, кто переходит с других языков программирования.

Использование запросов для выборки данных

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

В тексте запроса табличная часть указывается как виртуальная таблица. Имя таблицы формируется как имя документа плюс точка и имя табличной части. Это позволяет писать SQL-подобные конструкции прямо во встроенном языке.

Элемент запроса	Описание	Пример использования
Источник	Ссылка на ТЧ документа	Документ.РеализацияТоваровУслуг.Товары
Поле	Реквизит строки	Товары.Номенклатура
Условие	Отбор по значению	ГДЕ Товары.Количество > 0
Агрегация	Суммирование данных	СУММА(Товары.Сумма)

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

Особое внимание стоит уделить параметрам запроса. Передавать значения в текст запроса через конкатенацию строк опасно и неэффективно. Используйте метод УстановитьПараметр для безопасной подстановки значений, особенно если они содержат специальные символы или даты.

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

Работа с временными таблицами и буферами

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

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

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

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

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

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

Обработка иерархических табличных частей

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

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

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

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

Частые ошибки и способы их предотвращения

Разработчики часто сталкиваются с типовыми ошибками при работе с коллекциями. Одна из самых частых — попытка изменить коллекцию (удалить или добавить строку) во время перебора циклом Для Каждого. Это приводит к непредсказуемому поведению или ошибкам выполнения.

Если необходимо удалить строки по условию, лучше собрать индексы удаляемых строк в отдельный список, а затем удалить их в обратном порядке (от конца к началу). Либо использовать цикл с индексом, корректируя счетчик после удаления.

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

Что делать, если табличная часть пуста?

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

Как получить имя колонки динамически?

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

Можно ли изменить данные в ТЧ через запрос?

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

Почему медленно работает цикл по 10000 строк?

Частая причина — выполнение запросов внутри цикла. Каждый запрос — это обращение к СУБД. Если внутри цикла делается запрос, то при 10000 итераций будет 10000 запросов. Решение: выгрузить все необходимые данные одной выборкой перед циклом в таблицу значений или словарь.

Как скопировать одну табличную часть в другую?

Используйте метод СкопироватьКолонки и цикл. Сначала очистите целевую таблицу, затем скопируйте структуру колонок, и в цикле перенесите значения строк. Убедитесь, что имена и типы колонок в источнике и приемнике совместимы.