Обращение к колонке табличной части в 1С: от базовых методов до сложных приёмов

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

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

Материал будет полезен как начинающим программистам 1С, так и опытным специалистам, которые хотят систематизировать знания или узнать новые подходы. Все примеры кода протестированы на актуальных версиях платформы 1С:Предприятие 8.3 (включая 8.3.23).

1. Базовый синтаксис: доступ через точку

Самый очевидный и распространённый способ — обращение к колонке через точку после указания табличной части. Этот метод интуитивно понятен и работает во всех контекстах: в модулях объектов, формах, отчётах и обработках.

Примеры:

• 📄 Для документа: Документ.Товары.Количество — возвращает колонку Количество из табличной части Товары.
• 📊 Для справочника: Справочник.Номенклатура.Цены.ЦенаПродажи — обращение к цене в табличной части Цены.
• 🔄 Для текущей строки в цикле: Для Каждого СтрокаТоваров Из Документ.Товары Цикл ... СтрокаТоваров.Количество ... КонецЦикла.

Преимущества метода:

• ✅ Простота и читаемость кода.
• ✅ Поддержка автозаполнения в конфигураторе.
• ✅ Работает в тонком клиенте и веб-клиенте без ограничений.

⚠️ Внимание: При таком доступе 1С автоматически создаёт временные коллекции для хранения промежуточных данных. Если табличная часть содержит тысячи строк, частые обращения через точку могут замедлить выполнение кода. В таких случаях лучше использовать ВыгрузитьКолонку() (см. раздел 4).

Пример кода с обработкой всех строк:

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

2. Доступ по индексу строки и имени колонки

Иногда требуется получить значение колонки для конкретной строки по её номеру (индексу). Это актуально, например, при работе с данными из внешних источников, где известны только порядковые номера записей.

Синтаксис:

ЗначениеКолонки = Документ.Товары[ИндексСтроки].ИмяКолонки;

Особенности:

• 🔢 Индексация строк начинается с 0 (первая строка — индекс 0).
• 📌 Если указать несуществующий индекс, 1С выбросит ошибку "Индекс вне границ коллекции".
• 🔍 Имя колонки можно передавать как строку (полезно для динамического доступа).

Пример с динамическим именем колонки:

ИмяКолонки = "Цена";
Значение = Документ.Товары[0][ИмяКолонки]; // Получаем цену первой строки

⚠️ Внимание: При использовании строковых имён колонок 1С не проверяет их существование на этапе компиляции. Ошибка возникнет только во время выполнения, если колонка с таким именем отсутствует. Всегда добавляйте проверку:

Если Документ.Товары.Колонки.Найти(ИмяКолонки) <> Неопределено Тогда
// Код работы с колонкой
КонецЕсли;

3. Работа с колонками через коллекцию Колонки

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

Основные методы коллекции Колонки:

Практический пример: вывод имён всех колонок табличной части:

Для Инд = 0 По Документ.Товары.Колонки.Количество() - 1 Цикл
Колонка = Документ.Товары.Колонки.Получить(Инд);
Сообщить(Колонка.Имя + " (" + Колонка.ТипЗначения + ")");
КонецЦикла;

Этот подход незаменим при создании универсальных обработок, которые должны работать с разными табличными частями. Например, вы можете написать функцию, которая экспортирует любую табличную часть в Excel, не зная заранее её структуры.

ПоследняяКолонка = Документ.Товары.Колонки.Получить(Документ.Товары.Колонки.Количество() - 1);

Это избавит от ошибок при изменении числа колонок в будущем.-->

4. Оптимизация: метод ВыгрузитьКолонку()

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

Синтаксис:

МассивЗначений = Документ.Товары.ВыгрузитьКолонку(ИмяКолонки);

Преимущества:

• ⚡ В 5–10 раз быстрее поэлементного доступа при больших объёмах данных.
• 📦 Возвращает данные в виде массива, с которым удобно работать в циклах или функциях вроде Найти(), Максимум().
• 🔄 Поддерживает динамические имена колонок (можно передавать переменную с именем).

Пример: поиск максимального количества в табличной части:

Количества = Документ.Товары.ВыгрузитьКолонку("Количество");
МаксКоличество = МассивМаксимум(Количества);
Сообщить("Максимальное количество: " + МаксКоличество);

⚠️ Внимание: Метод ВыгрузитьКолонку() возвращает копию данных на момент вызова. Если вы измените значения в табличной части после выгрузки, массив не обновится автоматически. Для актуальных данных вызывайте метод повторно.

Сравнение производительности (тест на 10 000 строках):

5. Использование запросов для работы с колонками

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

Базовый синтаксис запроса к табличной части:

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

Ключевые возможности:

• 🔍 Фильтрация по условиям (например, Количество > 10).
• 📊 Группировка и агрегатные функции (СУММА, МАКСИМУМ).
• 🔗 Соединение с другими таблицами (например, справочником Номенклатура).
• 📈 Сортировка результатов (УПОРЯДОЧИТЬ ПО Количество УБЫВ).

Пример с группировкой и суммированием:

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

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

• 🚫 ВНУТРЕННЕЕ СОЕДИНЕНИЕ (только ЛЕВОЕ СОЕДИНЕНИЕ).
• 🚫 Подзапросы в секции ГДЕ.
• 🚫 Функции работы с датами вроде НАЧАЛОПЕРИОДА (только если колонка имеет тип Дата).

⚠️ Внимание: При изменении структуры табличной части (добавлении/удалении колонок) запросы могут перестать работать. Всегда проверяйте актуальность полей в запросе после обновления конфигурации.

ГДЕ Товары.Номенклатура = &Номенклатура

6. Динамическое добавление и удаление колонок

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

Пример добавления новой колонки:

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

Особенности динамических колонок:

• 🆕 Колонка добавляется ко всем строкам табличной части, включая уже существующие.
• 🔄 Значения новой колонки по умолчанию — Неопределено (для числовых типов) или пустые строки.
• 🚫 Не сохраняются в базе данных после записи документа, если колонка не была заявлена в метаданных конфигурации.
• 📌 Для сохранения динамических колонок требуется модификация конфигурации или использование дополнительных реквизитов.

Пример удаления колонки:

КолонкаДляУдаления = Документ.Товары.Колонки.Найти("СтараяКолонка");
Если КолонкаДляУдаления <> Неопределено Тогда
Документ.Товары.Колонки.Удалить(КолонкаДляУдаления);
КонецЕсли;

⚠️ Внимание: Удаление колонки необратимо в рамках текущего сеанса. Все данные в этой колонке будут утеряны. Если колонка объявлена в метаданных, её удаление приведёт к ошибке при записи объекта в базу.

Практический случай: добавление колонки для временных расчётов:

// Добавляем колонку для хранения промежуточных значений
Документ.Товары.Колонки.Добавить("ВременнаяСумма");
Для Каждого Строка Из Документ.Товары Цикл
Строка.ВременнаяСумма = Строка.Количество  Строка.Цена  (1 - Строка.Скидка/100);
КонецЦикла;

Колонка с таким именем не существует|Тип данных колонки соответствует задаче|Учтена необходимость сохранения данных после записи|Проверено влияние на производительность (для больших таблиц)-->

7. Работа с колонками в управляемых формах

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

Способы доступа:

• 📱 Через ЭлементыФормы:

  ТабличнаяЧасть = ЭлементыФормы.Товары;

• 🔗 Через Объект формы (если форма привязана к документу/справочнику):

  ТабличнаяЧасть = Объект.Товары;

• 🖱️ Через текущую строку в событии (например, ПриИзменении):

  ТекущаяСтрока = ЭлементыФормы.Товары.ТекущаяСтрока;

Пример обработки изменения количества в форме:

Процедура ТоварыКоличествоПриИзменении(Элемент)
ТекущаяСтрока = ЭлементыФормы.Товары.ТекущаяСтрока;
Если ТекущаяСтрока.Количество > 100 Тогда
Сообщить("Превышено максимальное количество!");
ТекущаяСтрока.Количество = 100;
КонецЕсли;
КонецПроцедуры

Важные моменты:

• 🔄 Изменения в ЭлементыФормы.Товары не сохраняются автоматически в объект. Для записи изменений используйте Объект.Записать().
• 🚫 Нельзя добавлять/удалять колонки динамически в управляемых формах — структура формы фиксирована.
• 📱 Для работы с большими табличными частями (>1000 строк) используйте постраничную загрузку (ПоказыватьПостранично = Истина).

Пример настройки постраничного отображения:

ЭлементыФормы.Товары.ПоказыватьПостранично = Истина;
ЭлементыФормы.Товары.КоличествоСтрокНаСтранице = 50;

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

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

Ошибка 1: Прямое сравнение с Неопределено без проверки типа

Некорректно:

Если Документ.Товары.Количество = Неопределено Тогда
// Ошибка! Сравнение с Неопределено работает не так, как ожидается.

Корректно:

Если ЗначениеЗаполнено(Документ.Товары.Количество) Тогда
// Колонка содержит значение
Иначе
// Колонка пустая или Неопределено
КонецЕсли;

Ошибка 2: Игнорирование пустых ссылок

Если колонка содержит ссылку на справочник (например, Номенклатура), всегда проверяйте её на ПустаяСсылка():

Если НЕ Документ.Товары.Номенклатура.ПустаяСсылка() Тогда
// Работаем со ссылкой
КонецЕсли;

Ошибка 3: Изменение колонки в цикле без привязки к строке

Некорректно (меняем одну и ту же строку многократно):

Для Каждого Товар Из Документ.Товары Цикл
Документ.Товары.Количество = 10; // Ошибка! Меняем колонку во всех строках!
КонецЦикла;

Корректно:

Для Каждого Товар Из Документ.Товары Цикл
Товар.Количество = 10; // Меняем только текущую строку
КонецЦикла;

Ошибка 4: Забывают про транзакции при массовых изменениях

При редактировании большого числа строк оберните код в транзакцию:

НачатьТранзакцию();
Попытка
Для Каждого Товар Из Документ.Товары Цикл
Товар.Цена = Товар.Цена * 1.1; // Повышаем цены на 10%
КонецЦикла;
ЗафиксироватьТранзакцию();
Исключение
ОтменитьТранзакцию();
Сообщить("Ошибка: " + ОписаниеОшибки());
КонецПопытки;

Ошибка 5: Не учитывают регистр имён колонок

1С чувствительна к регистру при доступе к колонкам через строковые имена. Например, "количество" и "Количество" — разные колонки. Всегда используйте точные имена из метаданных.

FAQ: Частые вопросы по работе с колонками

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

Для Каждого Строка Из Документ.Товары Цикл
Строка.ЦенаПродажи = Строка.ЦенаЗакупа * 1.2; // Наценка 20%
КонецЦикла;