Как добавить колонку в ТЗ 1С: пошаговая инструкция для новичков

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

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

Все примеры кода протестированы на платформе 1С:Предприятие 8.3.22 (актуальной на момент написания статьи), но подходят и для более ранних версий (начиная с 8.2). Если вы работаете с управляемыми формами или обычными формами — найдёте решения для обоих случаев.

1. Базовый способ: метод `Колонки.Добавить()`

Самый простой и универсальный метод — использование встроенного свойства Колонки таблицы значений. Он подходит для статического добавления колонок на этапе инициализации ТЗ или в обработчиках событий.

Синтаксис метода:

ТаблицаЗначений.Колонки.Добавить(ИмяКолонки[, ТипЗначения[, Заголовок[, Ширина]]]);

Где:

🔹 ИмяКолонки — уникальный идентификатор колонки (обязательный параметр).
🔹 ТипЗначения — тип данных (Тип("Число"), Тип("Строка") и т.д.). Если не указан, будет Тип("Произвольный").
🔹 Заголовок — отображаемое имя колонки (по умолчанию = ИмяКолонки).
🔹 Ширина — ширина колонки в символах (только для визуального отображения).

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

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

⚠️ Внимание: Если не указать тип данных явно, 1С присвоит колонке тип Произвольный. Это может привести к ошибкам при сортировке или фильтрации, особенно если в колонке смешаны числа и строки.

Убедиться, что колонка с таким именем не существует|Проверить совместимость типа данных с будущим содержимым|Указать ширину колонки для удобства отображения (если нужно)|Добавить заголовок, если имя колонки неинформативно-->

2. Динамическое добавление колонок в существующую ТЗ

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

Если колонка добавляется после заполнения ТЗ, все существующие строки получат значение Неопределённо.
При добавлении колонки с именем, которое уже существует, возникнет ошибка Колонка с именем '...' уже существует.

Пример безопасного динамического добавления:

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

// Использование:
ДобавитьКолонкуБезопасно(ТЗ, "Скидка", Тип("Число"), "Скидка, %");

Для заполнения новой колонки данными можно использовать цикл или метод ЗаполнитьЗначения():

Для Каждого Строка Из ТЗ Цикл
Строка.Скидка = РассчитатьСкидку(Строка.Цена, Строка.Количество);
КонецЦикла;

Что будет, если добавить колонку с существующим именем?

При попытке добавить колонку с именем, которое уже есть в ТЗ, 1С выбросит исключение: {ОбщийМодуль.МодульОбщегоНазначения.Модуль(12)}: Колонка с именем 'Цена' уже существует. Чтобы избежать этого, всегда проверяйте наличие колонки через метод ТЗ.Колонки.Найти() или ТЗ.Колонки.Индекс() (вернёт -1, если колонки нет).

3. Добавление колонок через конструктор ТЗ в конфигураторе

Если вы работаете в конфигураторе 1С (например, создаёте обработку или отчёт), можно добавить колонки визуально — без написания кода. Этот способ удобен для быстрого прототипирования или когда нужно сразу задать формат отображения данных.

Пошаговая инструкция:

Откройте окно редактирования таблицы значений (например, в обработке перейдите на закладку Реквизиты → выберите ТЗ → нажмите Изменить).
В окне Редактирование таблицы значений нажмите кнопку Добавить (или Insert).
Заполните свойства колонки:
- 📌 Имя — внутренний идентификатор (латиницей, без пробелов).
- 📌 Заголовок — отображаемое имя.
- 📌 Тип — выберите из списка (Число, Строка, Дата и т.д.).
- 📌 Длина — для строковых типов.
- 📌 Точность — для числовых типов (количество знаков после запятой).

Нажмите ОК — колонка появится в ТЗ.

Преимущества визуального метода:

🎨 Можно сразу настроить условное оформление (цвета ячеек в зависимости от значений).
🔄 Легко изменить порядок колонок перетаскиванием.
📊 Автоматически генерируется код инициализации ТЗ.

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

4. Работа с типами данных колонок: нюансы и ошибки

Неправильный выбор типа данных для колонки — частая причина ошибок при работе с ТЗ. Рассмотрим ключевые моменты:

Тип данных	Пример объявления	Типичные ошибки	Когда использовать
`Число`	`Тип("Число", 10, 2)`	Потеря точности при сложении чисел с разной точностью	Цены, количества, проценты
`Строка`	`Тип("Строка", 100)`	Переполнение при превышении длины	Наименования, комментарии
`Дата`	`Тип("Дата")`	Ошибки привода типа при работе с пустыми датами	Даты документов, сроки
`Ссылка`	`Тип("СправочникСсылка.Номенклатура")`	Ошибка `Неверный тип значения` при присваивании	Ссылки на справочники, документы

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

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

Для работы со ссылками на объекты метаданных (справочники, документы) всегда указывайте полный тип:

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

💡

Если колонка должна хранить ссылки на разные типы объектов (например, и справочники, и документы), используйте тип Произвольный или создайте составной тип через Новый ОписаниеТипов("СправочникСсылка., ДокументСсылка.").

5. Продвинутые приёмы: добавление колонок с вычисляемыми значениями

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

📟 Обработчик события ПриИзменении (для управляемых форм).
🔄 Функцию-заполнитель, которая вызывается при выводе данных.
📊 Виртуальные колонки (в отчётах на СКД).

Пример с обработчиком ПриИзменении:

Процедура ТЗКонтрагентыПриИзменении(Элемент, Колонка, Значение) Если Колонка = "Сумма" Или Колонка = "Количество" Тогда Элемент.Строка.Итого = Элемент.Строка.Сумма * Элемент.Строка.Количество; КонецЕсли;

КонецПроцедуры

Для отчётов на системе компоновки данных (СКД) вычисляемые колонки добавляются в настройках схемы. Пример вычисляемого поля:

Поле = Новый ПолеВычисляемое("ПроцентВыполнения",
Новый ОписаниеТипов("Число", 10, 2));
Поле.Выражение = "Выполнено / План * 100";

Важно: вычисляемые колонки не хранят данные в ТЗ, а рассчитываются при каждом обращении. Это может повлиять на производительность при работе с большими таблицами.

💡

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

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

Даже опытные разработчики 1С сталкиваются с ошибками при работе с колонками ТЗ. Разберём самые распространённые:

Ошибка	Причина	Решение
`Колонка с именем 'X' уже существует`	Повторное добавление колонки с тем же именем	Проверять существование через `ТЗ.Колонки.Найти()`
`Ошибка приведения типа`	Попытка присвоить значение несовместимого типа	Явно указывать тип колонки или использовать `ЗначениеЗаполнено()`
`Индекс вне границ массива`	Обращение к несуществующей колонке по индексу	Использовать имена колонок вместо индексов
Пустые значения в числовых колонках	`Неопределённо` вместо `0`	Инициализировать колонку значением по умолчанию

Пример обработки ошибки приведения типа:

Попытка
ТЗ.Колонки.Добавить("СуммаНДС", Тип("Число"));
Для Каждого Строка Из ТЗ Цикл
Строка.СуммаНДС = Строка.Сумма * 0.2; // Может выдать ошибку, если Сумма = Неопределённо
КонецЦикла;
Исключение
Сообщить("Ошибка: " + ОписаниеОшибки());
// Альтернативный код с проверкой
Для Каждого Строка Из ТЗ Цикл
Если ЗначениеЗаполнено(Строка.Сумма) Тогда
Строка.СуммаНДС = Строка.Сумма * 0.2;
Иначе
Строка.СуммаНДС = 0;
КонецЕсли;
КонецЦикла;
КонецПопытки;

Для отладки полезно выводить структуру ТЗ в отладочное окно:

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

7. Оптимизация работы с колонками в больших таблицах

При работе с ТЗ, содержащими тысячи строк, добавление колонок может замедлить выполнение кода. Рекомендации по оптимизации:

🚀 Добавляйте все колонки заранее (до заполнения ТЗ данными).
🔄 Используйте пакетное заполнение через ЗагрузитьКолонку():

Данные = Новый Массив;
Для Инд = 1 По ТЗ.Количество() Цикл
Данные.Добавить(РассчитатьЗначение(ТЗ[Инд-1]));
КонецЦикла;
ТЗ.ЗагрузитьКолонку(Данные, "НоваяКолонка");

🗑 Удаляйте ненужные колонки после использования:

ТЗ.Колонки.Удалить(ТЗ.Колонки.Найти("ВременнаяКолонка"));

📉 Избегайте вычисляемых колонок в циклах — рассчитывайте значения заранее.

Для чрезвычайно больших ТЗ (100 000+ строк) рассмотрите альтернативы:

📂 Использование временных таблиц базы данных.
📄 Применение запросов 1С вместо ТЗ.
🔗 Потоковая обработка данных без полной загрузки в память.

💡

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

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

Как переименовать существующую колонку в ТЗ?

В 1С нет прямого метода переименования колонки. Нужно:

Добавить новую колонку с нужным именем.
Скопировать данные из старой колонки в новую.
Удалить старую колонку.

ТЗ.Колонки.Добавить("НовоеИмя", ТЗ.Колонки.Найти("СтароеИмя").ТипЗначения);
Для Каждого Строка Из ТЗ Цикл
Строка.НовоеИмя = Строка.СтароеИмя;
КонецЦикла;
ТЗ.Колонки.Удалить(ТЗ.Колонки.Найти("СтароеИмя"));

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

Да, для этого используйте типы ДокументСсылка.ИмяДокумента или СправочникСсылка.ИмяСправочника. Пример:

ТЗ.Колонки.Добавить("ДокументПоступления", Тип("ДокументСсылка.ПоступлениеТоваровУслуг"),

"Документ поступления");

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

Строка.ДокументПоступления = Документы.ПоступлениеТоваровУслуг.НайтиПоНомеру("ПТ-000123");

Как сделать колонку обязательной для заполнения?

В самой ТЗ нет механизма обязательных колонок, но можно:

🔴 Добавить проверку при записи данных:

Если НЕ ЗначениеЗаполнено(Строка.ОбязательнаяКолонка) Тогда
Предупреждение("Заполните обязательное поле!", 60);
Возврат Ложь;
КонецЕсли;

📋 Использовать условное оформление в форме для визуального выделения пустых ячеек.

Как скопировать структуру колонок из одной ТЗ в другую?

Используйте метод СкопироватьКолонки() или цикл по коллекции колонок:

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

КонецЦикла;

Чтобы скопировать и данные, используйте НоваяТЗ.Загрузить(ИсточникТЗ.Выгрузить()).

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

Возможные причины и решения:

🔄 Форма не обновлена — вызовите ЭлементыФормы.Таблица.Обновить().
👁 Колонка скрыта в настройках таблицы — проверьте свойство Видимость.
📏 Ширина колонки = 0 — установите ширину явно.
🔄 В управляемых формах может потребоваться переоткрыть форму.

Как добавить колонку в таблицу значений (ТЗ) 1С: 5 способов с примерами

1. Базовый способ: метод Колонки.Добавить()