Как добавить колонку в таблицу 1С: 3 рабочих способа с примерами

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

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

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

1. Подготовка: что нужно знать перед добавлением колонки

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

• 🔹 Тип клиента: в управляемых формах (8.3+) и обычных формах (8.2) процесс отличается. Уточните версию платформы в Справка → О программе.
• 🔹 Режим работы: изменения в конфигураторе требуют перезапуска пользовательского сеанса. Если база используется активно, планируйте работы на нерабочее время.
• 🔹 Тип таблицы: это табличная часть документа, справочника или регистр? От этого зависит, где искать настройки (например, для регистров колонки настраиваются в Регистры сведений).

Важно: если вы работаете с распределенной базой данных (РИБ), добавление колонки потребует синхронизации изменений во всех узлах. В этом случае лучше использовать объектную модель через код — так проще контролировать процесс.

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

Для проверки текущей структуры таблицы используйте запрос:

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

2. Способ 1: Добавление колонки через конфигуратор

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

1. Откройте конфигуратор (Файл → Конфигуратор или через ярлык запуска с ключом /Config).

2. В дереве метаданных найдите объект, где нужна колонка. Например: Справочники → Номенклатура → Табличные части → ДополнительныеРеквизиты.

3. Кликните правой кнопкой по табличной части → Добавить реквизит.

4. Заполните свойства:

   • 📌 Имя: ВесБрутто (латиницей, без пробелов)
   • 📌 Синоним: "Вес брутто, кг" (отображается пользователям)
   • 📌 Тип: Число(10,3) (для веса с тремя знаками после запятой)

После обновления колонка появится в пользовательском режиме, но может потребоваться настройка видимости в формах. Для этого:

6. Откройте форму объекта (например, форму элемента справочника Номенклатура).

7. Найдите таблицу с нужной табличной частью → кликните по ней правой кнопкой → Изменить форму.

8. В палитре свойств таблицы добавьте новую колонку через Колонки → Добавить и свяжите её с созданным реквизитом.

Имя реквизита без пробелов и кириллицы|

Тип данных соответствует хранимой информации|

Синоним заполнен (отображается пользователям)|

Права доступа настроены для ролей|

Форма обновлена и колонка видна в предварительном просмотре-->

Если колонка не появилась после обновления, проверьте:

• 🔍 Права доступа: в ролях пользователей может быть запрет на просмотр новых реквизитов (Администрирование → Пользователи → Роли).
• 🔍 Кэш метаданных: очистите его через Сервис → Очистить кэш.
• 🔍 Режим совместимости: в старых базах (до 8.3.6) может потребоваться ручная правка форм.

3. Способ 2: Программное добавление колонки (для разработчиков)

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

• 🔹 Массового добавления колонок в похожие объекты.
• 🔹 Динамического создания реквизитов по условию (например, при обновлении конфигурации).
• 🔹 Работы с внешними обработками, где нет доступа к конфигуратору.

Пример кода для добавления колонки ДатаПоступления в табличную часть документа "ПоступлениеТоваров":

// Получаем объект метаданных
МетаДанные = Метаданные.Документы.ПоступлениеТоваров.ТабличныеЧасти.Товары;

// Создаем новый реквизит
НовыйРеквизит = МетаДанные.Реквизиты.Добавить();
НовыйРеквизит.Имя = "ДатаПоступления";
НовыйРеквизит.Синоним = "Дата поступления";
НовыйРеквизит.Тип = Новый ОписаниеТипов("Дата");

// Обновляем конфигурацию
Метаданные.Записать();
КонфигурацияБазы.Обновить();

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

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

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

ПланОбмена = Метаданные.ПланыОбмена.ОсновнойПланОбмена;
ПланОбмена.Объекты.Добавить(Метаданные.Документы.ПоступлениеТоваров);

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

• 🔹 Гибкость: можно добавлять колонки по условию (например, только для определенных типов документов).
• 🔹 Автоматизация: подходит для массовых изменений в больших конфигурациях.
• 🔹 Контроль версий: код можно сохранить в системе контроля версий (Git, SVN).

Процедура ПередЗаписью(Отказ)
Если НЕ ЗначениеЗаполнено(Объект.Товары.ДатаПоступления) Тогда
Сообщить("Укажите дату поступления для всех позиций!");
Отказ = Истина;
КонецЕсли;
КонецПроцедуры

-->

4. Способ 3: Добавление колонки в динамическом списке

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

• 📊 Отчетов с расчетными полями (например, "Сумма с НДС").
• 📊 Списков документов, где нужно показать данные из связанных справочников.
• 📊 Временных таблиц в обработках.

Пример добавления колонки "ПолноеНаименование" в динамический список справочника Номенклатура:

// В модуле формы списка справочника
Процедура ПриСозданииНаСервере(Отказ)
Список = ЭлементыФормы.Список;
НоваяКолонка = Список.Колонки.Добавить("ПолноеНаименование");
НоваяКолонка.Заголовок = "Полное наименование";
НоваяКолонка.ПутьКДанным = "Объект.ПолноеНаименование";
КонецПроцедуры

Для расчетных полей (например, "СуммаСоСкидкой") используйте обработчик ПриАктивизацииСтроки:

Процедура СписокПриАктивизацииСтроки(Элемент, Строки)
Для Каждого Строка Из Строки Цикл
Строка.СуммаСоСкидкой = Строка.Цена  Строка.Количество  (1 - Строка.Скидка/100);
КонецЦикла;
КонецПроцедуры

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

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

Даже опытные разработчики сталкиваются с проблемами при добавлении колонок. Вот TOP-3 критических ошибки, которые приводят к потере данных или сбоям:

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

   // Пример проверки перед изменением типа на "Число"
   Запрос = Новый Запрос;
   Запрос.Текст = "ВЫБРАТЬ
   |   Товары.Вес КАК ТекущийВес
   |ИЗ
   |   Документ.ПоступлениеТоваров.Товары КАК Товары
   |ГДЕ
   |   НЕ Товары.Вес ПОДОБНО ''%[0-9]%''"; // Ищем нечисловые значения
   Результат = Запрос.Выполнить();

2. Необновленные формы: колонка добавлена в метаданные, но не отображается в форме. Проверьте:

   • 🔸 Связан ли реквизит с колонкой в свойствах таблицы (ПутьКДанным).
   • 🔸 Обновлена ли форма после изменений (Форма → Обновить).
   • 🔸 Нет ли конфликтов с расширениями (если используются).

// Пример настройки прав программно
Роль = Метаданные.Роли.Пользователь;
Права = Роль.Права;
Права.Добавить(Новый ПравоДоступа("Документ.ПоступлениеТоваров.Товары.Вес", ПравоДоступа.Чтение, ПравоДоступа.Изменение));

Другие распространенные проблемы:

• 🚨 Ошибка блокировки: при обновлении конфигурации в многопользовательском режиме. Решение: используйте Монопольный режим или выполните обновление ночью.
• 🚨 Потеря данных при изменении типа колонки. Всегда делайте резервную копию перед такими операциями.
• 🚨 Конфликты с обновлениями: если конфигурация поддерживается (например, 1С:Бухгалтерия), новые реквизиты могут исчезнуть после обновления. В таких случаях используйте расширения конфигурации.

6. Оптимизация: как ускорить работу с новыми колонками

Добавление колонок может замедлить работу системы, особенно в больших таблицах. Вот как этого избежать:

• 🔥 Индексирование: для колонок, по которым часто ищут данные, создавайте индексы:

  // Пример создания индекса программно
  Индекс = Метаданные.Документы.ПоступлениеТоваров.ТабличныеЧасти.Товары.Индексы.Добавить();
  Индекс.Имя = "ИндексПоАртикулу";
  Индекс.Поля.Добавить("Артикул");

• 🔥 Ленивая загрузка: для редко используемых колонок настройте отложенную загрузку в формах:

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

• 🔥 Архивирование старых данных: если таблица содержит миллионы строк, перенесите исторические данные в архивную таблицу.

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

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

// Основная таблица документов
Документ.ПоступлениеТоваров.Товары:
- Ссылка (Тип: Справочник.Номенклатура)
- Количество (Тип: Число)
- IDОписания (Тип: Число) // Ссылка на отдельную таблицу

// Отдельная таблица для описаний
РегистрСведений.ОписанияТоваров:
- ID (Тип: Число)
- ТекстОписания (Тип: Строка(Неограниченная))

7. Работа с расширениями конфигурации

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

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

1. Создайте новое расширение: Конфигурация → Расширения → Добавить.

2. В дереве расширения найдите объект для изменения (например, Документ.РеализацияТоваровУслуг.Формы.ФормаДокумента).

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

4. Настройте отображение колонки в форме расширения.

5. Подключите расширение к базе: Конфигурация → Расширения → Подключить.

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

• 🔹 Безопасность обновлений: изменения не затираются при обновлении типовой конфигурации.
• 🔹 Модульность: можно отключать/включать доработки без изменения основной конфигурации.
• 🔹 Контроль версий: расширения можно экспортировать и импортировать отдельно.

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

// В модуле расширения
Процедура ДобавитьКолонкуВФорму()
Форма = РасширенияФорм.ПолучитьФорму("Документ.РеализацияТоваровУслуг.ФормаДокумента");
ТаблицаТоваров = Форма.ЭлементыФормы.Товары;

// Добавляем колонку
НоваяКолонка = ТаблицаТоваров.Колонки.Добавить();
НоваяКолонка.Имя = "ВесНетто";
НоваяКолонка.Заголовок = "Вес нетто";
НоваяКолонка.ПутьКДанным = "Объект.Товары.ВесНетто";

// Настраиваем ширину и видимость
НоваяКолонка.Ширина = 100;
НоваяКолонка.Видимость = Истина;
КонецПроцедуры

⚠️ Внимание: В расширениях нельзя изменять типы данных существующих реквизитов — только добавлять новые. Для изменения типов потребуется полная доработка конфигурации.

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

Запрос = Новый Запрос;
Запрос.Текст = "ВЫБРАТЬ
|   Товары.Ссылка КАК Ссылка,
|   Товары.СтароеПоле КАК Источник
|ИЗ
|   Документ.ПоступлениеТоваров.Товары КАК Товары";

Результат = Запрос.Выполнить();
Выборка = Результат.Выбрать();

Пока Выборка.Следующий() Цикл
Док = Выборка.Ссылка.ПолучитьОбъект();
Для Каждого Строка Из Док.Товары Цикл
Если Строка.Ссылка = Выборка.Ссылка Тогда
Строка.НовоеПоле = Выборка.Источник;
КонецЕсли;
КонецЦикла;
Док.Записать();
КонецЦикла;

// Пакетная запись (ускоряет работу в 5-10 раз)
Объект = Документы.ПоступлениеТоваров.СоздатьМенеджерЗаписи();
Объект.ПакетнаяЗапись = Истина;

Для Каждого Док Из Документы.ПоступлениеТоваров.Выбрать() Цикл
Объект.Записать(Док);
КонецЦикла;