Как добавить колонку в таблицу 1С

Вопрос «как добавить колонку в таблицу» в 1С возникает в нескольких разных ситуациях, и способ решения зависит от того, о какой таблице идёт речь. Чаще всего требуется добавить реквизит в табличную часть документа или справочника через конфигуратор. Реже — программно добавить колонку в таблицу значений, вывести дополнительное поле в динамический список или отчёт на СКД.

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

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

Определите, с какой таблицей вы работаете

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

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

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

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

Нажмите кнопку добавления реквизита (зелёный плюс на панели или пункт контекстного меню «Добавить»). Задайте имя реквизита — оно должно быть уникальным в рамках табличной части и начинаться с буквы. Выберите тип: строка с указанием длины, число с точностью, дата, булево или ссылка на справочник. Для строк обязательно задайте длину, иначе получите неограниченную строку, которая замедляет работу и не поддерживается в ряде операций запроса.

После добавления реквизита обновите конфигурацию базы данных: меню «Конфигурация → Обновить конфигурацию базы данных» или клавиша F7. Платформа выполнит реструктуризацию — добавит физическую колонку в таблицу базы данных. В больших базах с миллионами строк это может занять заметное время.

1. 1
   Сделайте резервную копию базы (Файл → Сохранить копию или выгрузка в dt)
2. 2
   Откройте конфигуратор и найдите документ или справочник в дереве конфигурации
3. 3
   Раскройте ветку «Табличные части», выберите нужную табличную часть
4. 4
   Добавьте реквизит: задайте имя, тип, длину или точность
5. 5
   Нажмите F7 и подтвердите реструктуризацию
6. 6
   Добавьте реквизит на форму документа, чтобы колонка стала видна пользователям
7. 7
   Проверьте: откройте документ в режиме Предприятия и заполните новую колонку

Вывод колонки на форму документа

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

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

Добавление колонки в таблицу значений программно

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

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

Если таблица значений получена запросом (метод Выгрузить() у результата запроса), колонки создаются автоматически по полям запроса. Дополнительную колонку можно добавить тем же методом Колонки.Добавить() после выгрузки, а затем заполнить её в цикле по строкам. Учтите: добавление колонки в большую таблицу само по себе быстрое, но заполнение значений в цикле — основная нагрузка.

Помните, что таблица значений живёт в памяти. Если её нужно показать пользователю на форме, создайте реквизит формы типа «ТаблицаЗначений» с соответствующими колонками и загрузите данные через ЗначениеВРеквизитФормы().

Колонка в динамическом списке и в отчёте

Для динамического списка (таблица формы списка документов или справочника) колонка появляется из запроса. Если список работает в автоматическом режиме, платформа сама выводит основные реквизиты; чтобы добавить своё поле, включите у списка флаг «Произвольный запрос» и допишите нужное поле в текст запроса. После этого поле станет доступно в настройках списка, и пользователь сможет вывести его через «Ещё → Изменить форму» или настройку списка.

В отчётах на СКД колонка добавляется либо в запрос набора данных (если это новое поле из базы), либо как вычисляемое поле (если значение рассчитывается из других полей). Затем поле включается в настройках отчёта на закладке «Выбранные поля». Пользователь типового отчёта может добавить уже существующее в схеме поле самостоятельно через «Настройки → Расширенная» без изменения конфигурации.

Изменение типовой конфигурации и расширения

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

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

Проверка результата и типичные ошибки

После добавления колонки проверьте три вещи: колонка видна пользователю на форме, введённое значение сохраняется после записи и повторного открытия объекта, значение доступно в запросе или в полях отчёта. Если колонка есть в конфигураторе, но не видна пользователю — почти всегда проблема в форме: реквизит не добавлен в элементы формы или у элемента снята видимость.

Частые вопросы