Добавление колонок в таблицу формы 1С: 5 способов с примерами кода

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

Эта статья охватывает все актуальные способы добавления колонок — от визуального редактирования в конфигураторе до программного создания через код. Мы разберём нюансы работы с управляемыми и обычными формами, покажем как связать колонки с данными справочников и документов, а также предостережём от типичных ошибок, которые приводят к потере данных или сбоям в работе системы.

Особое внимание уделим трем критическим моментам:

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

1. Добавление колонки через конфигуратор (визуальный способ)

Самый простой метод — использовать встроенный редактор форм в конфигураторе. Он подходит для большинства задач и не требует знания программирования. Рассмотрим процесс на примере добавления колонки в табличную часть документа "Заказ клиента".

Откройте конфигуратор в режиме 1С:Предприятие, найдите нужный документ в дереве объектов (раздел Объекты → Документы). Дважды кликните на форму документа — откроется редактор. Если форма ещё не создана, её нужно создать через контекстное меню (Создать форму).

• 🔧 Перейдите на вкладку Элементы в верхней панели редактора.
• 📋 В дереве элементов найдите табличное поле (обычно называется ТабличнаяЧасть1 или аналогично).
• ➕ Кликните правой кнопкой по таблице и выберите Добавить колонку.
• ⚙️ В свойствах новой колонки укажите:
  • Имя — идентификатор (например, КоличествоУпаковок)
  • Заголовок — отображаемое название (например, "Кол-во упаковок")
  • Тип значения — выберите Число, Строка или другой подходящий тип
  • Источник данных — свяжите с реквизитом табличной части (если он уже существует)

Если реквизит в табличной части ещё не создан, сначала добавьте его в структуру документа (Объекты → Документы → [ВашДокумент] → Табличные части). Без этого колонка будет "пустой" — она отобразится в форме, но не будет сохранять данные.

Создан реквизит в табличной части документа|Колонка связана с источником данных|Указан корректный тип значения|Задан понятный заголовок для пользователей|Проверены права доступа на новый реквизит-->

⚠️ Внимание: Если вы добавляете колонку в типовую конфигурацию (например, 1С:Бухгалтерия 3.0 или 1С:УТ 11), после обновления платформы ваши изменения могут быть утеряны. Чтобы этого избежать, используйте расширения конфигурации или механизм Подписки на события.

2. Программное добавление колонки в управляемой форме

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

Пример кода для добавления колонки СкидкаПостоянногоКлиента в таблицу документа "РеализацияТоваровУслуг":

&Процедура ДокументОбъект_ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)
// Проверяем, что форма открыта для редактирования
Если НЕ ЗначениеЗаполнено(Объект.Ссылка) Тогда
Возврат;
КонецЕсли;

// Получаем табличное поле по имени
ТаблицаТовары = ЭлементыФормы.Товары;

// Создаём новую колонку
НоваяКолонка = ТаблицаТовары.Колонки.Добавить();
НоваяКолонка.Имя = "СкидкаПостоянногоКлиента";
НоваяКолонка.Заголовок = "Скидка (пост. клиент)";
НоваяКолонка.ТипЗначения = Новый Тип("Число");
НоваяКолонка.Ширина = 80;

// Связываем с данными (если реквизит существует)
Если Объект.Товары.Колонки.Найти("СкидкаПостоянногоКлиента") <> Неопределено Тогда
НоваяКолонка.ИсточникДанных = Новый ИсточникДанныхКолонкиТаблицы(Объект.Товары, "СкидкаПостоянногоКлиента");
КонецЕсли;
КонецПроцедуры

Ключевые моменты этого подхода:

• 🔄 Колонка создаётся динамически при открытии формы, поэтому изменения не сохранятся после закрытия.
• 🔒 Для постоянного добавления колонки нужно модифицировать сам документ (добавить реквизит в табличную часть).
• ⚡ Если колонка должна отображаться только для определённых ролей, добавьте проверку:

  Если Пользователь.Имя = "Администратор" Тогда
  // Код добавления колонки
  КонецЕсли;

ТаблицаТовары.Колонки.Вставить(3, "НоваяКолонка"); // Вставит после 3-й колонки

3. Работа с обычными формами (8.2 и ранее)

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

Алгоритм добавления колонки в обычной форме:

1. Откройте форму в конфигураторе (Объекты → [ВашОбъект] → Формы).
2. Найдите табличное поле (элемент типа ТаблицаФормы).
3. В палитре свойств таблицы перейдите на вкладку Колонки.
4. Нажмите Добавить и настройте параметры колонки (имя, заголовок, тип).
5. Свяжите колонку с данными через свойство ПутьКДанным (например, "Товары.Количество").

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

Процедура ПриОткрытии()
Таблица = ЭлементыФормы.Товары;
НоваяКолонка = Таблица.Колонки.Добавить();
НоваяКолонка.Имя = "ВесБрутто";
НоваяКолонка.Заголовок = "Вес брутто (кг)";
НоваяКолонка.ТипЗначения = Тип("Число");
НоваяКолонка.ПутьКДанным = "Товары.ВесБрутто";
НоваяКолонка.Ширина = 100;
КонецПроцедуры

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

4. Связь колонки с данными: типичные ошибки

Добавленная колонка может не работать по трём основным причинам:

1. Отсутствует реквизит в табличной части — колонка отображается, но не сохраняет данные.
2. Неверный путь к данным — в свойстве ИсточникДанных или ПутьКДанным указана несуществующая ссылка.
3. Конфликт типов — тип значения колонки не совпадает с типом реквизита (например, колонка типа Строка, а реквизит — Число).

Разберём решения для каждого случая:

Частая ошибка начинающих разработчиков — попытка связать колонку с виртуальным реквизитом, который не хранится в базе. Например, если вы добавили колонку СуммаНДС, но не создали формулу для её расчёта, она будет всегда пустой. В таких случаях используйте обработчик ПриИзменении для динамического заполнения:

Процедура ТоварыКоличествоПриИзменении(Элемент)
ТекущаяСтрока = Элементы.Товары.ТекущиеДанные;
ТекущаяСтрока.СуммаНДС = ТекущаяСтрока.Сумма * 0.2; // Пример расчёта
КонецПроцедуры

5. Добавление колонок в динамических списках

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

Чтобы добавить колонку в динамический список:

1. Откройте форму с динамическим списком в конфигураторе.
2. Найдите элемент типа ДинамическийСписок (обычно называется Список или ОсновнойСписок).
3. В свойствах списка перейдите на вкладку Колонки.
4. Добавьте новую колонку и настройте её параметры:
   • Поле — укажите поле из запроса (например, "Документ.СуммаДокумента")
   • Заголовок — название для отображения
   • Тип — должен совпадать с типом поля в запросе

Если нужной колонки нет в исходном запросе, его придётся модифицировать. Например, для добавления колонки ДниПросрочки в список документов "Заказы покупателей" измените текст запроса:

ВЫБРАТЬ
Заказ.Ссылка КАК Ссылка,
Заказ.Дата КАК Дата,
Заказ.СуммаДокумента КАК Сумма,
ВЫРАЗИТЬ(ТекущаяДата() - Заказ.Дата КАК ЧислоДней) КАК ДниПросрочки
ИЗ
Документ.ЗаказПокупателя КАК Заказ
ГДЕ
Заказ.ПометкаУдаления = ЛОЖЬ

⚠️ Внимание: Изменение запросов в типовых конфигурациях может привести к ошибкам при обновлении. Рекомендуется использовать расширения отчётов или создавать внешние обработки с собственными запросами.

Как узнать текущий текст запроса динамического списка?

Откройте форму в конфигураторе → выделите элемент ДинамическийСписок → в палитре свойств найдите свойство Запрос → нажмите на кнопку открытия (...) рядом с полем. Откроется окно с текстом запроса, который можно редактировать.

6. Оптимизация отображения: ширина, порядок, условное оформление

Добавленная колонка может "сломать" внешний вид формы, если не настроить её параметры отображения. Основные настройки:

• 📏 Ширина: по умолчанию новая колонка получает ширину 100 пикселей. Для числовых полей (цена, количество) обычно хватает 60–80 px, для текстовых (наименование) — 150–200 px.
• 🔢 Порядок: колонки отображаются в порядке добавления. Чтобы изменить порядок, используйте метод Переместить():

  ТаблицаТовары.Колонки.Переместить(ИндексКолонки, НовыйИндекс);

• 🎨 Условное оформление: можно выделять ячейки цветом в зависимости от значения. Например, красным для отрицательных чисел:

  Колонка.УсловноеОформление.ДобавитьУсловие();
  Условие = Колонка.УсловноеОформление.Условия[0];
  Условие.Выражение = "Значение < 0";
  Условие.ЦветТекста = ВебЦвет.Красный;

• 🔒 Редактируемость: если колонка должна быть только для чтения, установите свойство Редактируемая = Ложь.

Пример настройки ширины и порядка колонок в управляемой форме:

&Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)
Таблица = ЭлементыФормы.Товары;

// Настраиваем ширину колонок
Таблица.Колонки.Найти("Цена").Ширина = 80;
Таблица.Колонки.Найти("Количество").Ширина = 60;
Таблица.Колонки.Найти("Сумма").Ширина = 100;

// Перемещаем колонку "Скидка" после "Цена"
КолонкаСкидка = Таблица.Колонки.Найти("Скидка");
Таблица.Колонки.Переместить(КолонкаСкидка.Индекс, 3); // 3 — позиция после "Цена"
КонецПроцедуры

💡

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

7. Совместимость с обновлениями и расширения конфигурации

Одна из самых болезненных проблем при добавлении колонок в типовые конфигурации — конфликты при обновлении. Если вы модифицировали форму напрямую, новый релиз 1С может перезаписать ваши изменения. Чтобы этого избежать, используйте:

• 🔧 Расширения конфигурации (рекомендуемый способ для 8.3.6+): позволяют добавлять колонки без изменения исходного кода.
• 📦 Внешние обработки: создайте отдельную форму с нужными колонками и открывайте её вместо стандартной.
• 🔄 Подписки на события: динамически добавляйте колонки через код в обработчиках ПриОткрытии.

Пример добавления колонки через расширение конфигурации:

1. Создайте новое расширение (Файл → Новое расширение).
2. В дереве расширения найдите нужный документ и его форму.
3. Добавьте новую колонку в таблицу (аналогично визуальному способу, но изменения будут в расширении, а не в основной конфигурации).
4. Сохраните и подключите расширение в информационной базе (Администрирование → Печатные формы, отчёты и обработки → Расширения конфигурации).

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

• ✅ Сохраняются при обновлении типовой конфигурации.
• ✅ Можно отключать/включать без изменения основной конфигурации.
• ✅ Поддерживают контроль версий (удобно для командной разработки).

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

Если Строка(Платформа.Версия) >= "8.3.6" Тогда
// Код для новых версий
Иначе
// Альтернативный код для старых версий
КонецЕсли;

8. Практический пример: добавление колонки "Срок годности" в документ "Поступление товаров"

Рассмотрим полный цикл добавления колонки на примере документа "ПоступлениеТоваровУслуг" в конфигурации 1С:Управление торговлей 11.

Шаг 1. Добавление реквизита в табличную часть

1. Откройте конфигуратор, найдите документ ПоступлениеТоваровУслуг.
2. Перейдите на вкладку Табличные части → выберите Товары.
3. Добавьте новый реквизит:
   • Имя: СрокГодности
   • Тип: Дата
   • Синоним: "Срок годности"

Шаг 2. Настройка формы документа

1. Откройте форму документа (Объекты → ПоступлениеТоваровУслуг → Формы → ФормаДокумента).
2. Найдите табличное поле Товары.
3. Добавьте новую колонку со свойствами:
   • Имя: СрокГодности
   • Заголовок: "Срок годности"
   • Тип значения: Дата
   • Источник данных: свяжите с реквизитом Товары.СрокГодности
   • Ширина: 100

Шаг 3. Программная логика (опционально)

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

&Процедура ТоварыНоменклатураПриИзменении(Элемент)
ТекущаяСтрока = Элементы.Товары.ТекущиеДанные;

// Получаем срок годности из справочника номенклатуры
Если ЗначениеЗаполнено(ТекущаяСтрока.Номенклатура) Тогда
СрокГодности = ТекущаяСтрока.Номенклатура.СрокГодности;
Если СрокГодности <> '00010101' Тогда // Проверяем, что дата не пустая
ТекущаяСтрока.СрокГодности = ТекущаяДата() + СрокГодности;
КонецЕсли;
КонецЕсли;
КонецПроцедуры

Шаг 4. Настройка прав доступа

Чтобы колонка была видна пользователям, проверьте права в ролях:

1. Откройте Администрирование → Настройка прав пользователей.
2. Выберите роль (например, Менеджер по закупкам).
3. Найдите документ ПоступлениеТоваровУслуг и проверьте права на реквизит Товары.СрокГодности (должно быть Чтение и изменение).

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

Процедура ПриОткрытии()
Если НЕ Пользователь.Имя = "ИвановИИ" Тогда
ЭлементыФормы.Товары.Колонки.Удалить("СрокГодности");
КонецЕсли;
КонецПроцедуры

? (Товары.СрокГодности <> '00010101', Формат(Товары.СрокГодности, "ДФ=dd.MM.yyyy"), "")