Добавляем столбец в табличную часть 1С: полное руководство

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

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

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

Подготовка к изменению конфигурации

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

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

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

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

Поиск нужного объекта и табличной части

Навигация по дереву метаданных — первый шаг к успеху. Вам необходимо найти объект, в котором требуется добавить столбец. Чаще всего это документы (например, Реализация товаров и услуг) или справочники (например, Номенклатура). Раскройте ветку нужного типа объекта в дереве конфигурации.

Найдите конкретный объект метаданных по имени или синониму. Дважды кликните по нему, чтобы открыть форму редактирования. Внутри формы объекта вы увидите несколько вкладок: Данные, Формы, Модули. Нас интересует вкладка Данные, где описана структура хранения информации.

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

Создание нового реквизита табличной части

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

Задайте корректное имя новому реквизиту. Имя должно быть уникальным в пределах табличной части, не содержать пробелов и специальных символов, кроме подчеркивания. Рекомендуется использовать латиницу, например, ВесНетто или ПроцентСкидки. Синоним заполняется автоматически, но его можно отредактировать для понятности пользователю.

Самый важный этап — выбор типа данных. Нажмите на поле Тип и вызовите конструктор типов. Выберите подходящий вариант: Число для количественных показателей, Строка для текстовых комментариев или СправочникСсылка для выбора значений из других списков. Настройте длину и точность числа, если это необходимо.

Имя: ДопКомментарий
Синоним: Дополнительный комментарий
Тип: Строка
Длина: 150

После настройки свойств сохраните изменения в объекте метаданных, нажав Ctrl+S. Новый реквизит теперь существует в структуре базы данных, но пользователи еще не увидят его на экране. Для этого требуется доработка формы.

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

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

В редакторе форм найдите элемент Таблица, соответствующий вашей табличной части. Он обычно имеет имя вроде Товары или ТабличноеПоле1. Раскройте этот элемент в дереве элементов формы. Внутри вы увидите список полей, которые сейчас отображаются.

Нажмите правой кнопкой мыши на поле Товары и выберите Добавить элемент -> Поле. В свойствах нового поля в параметре Поле выберите из списка тот реквизит, который вы создали ранее. Система автоматически подставит заголовок колонки согласно синониму реквизита.

Можно также перетащить нужный реквизит из панели доступных полей прямо в таблицу на макете формы. После размещения колонки настройте её ширину и выравнивание в свойствах элемента формы. Это улучшит восприятие информации пользователем.

Настройка свойств и поведения колонки

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

Для числовых полей важно настроить формат вывода. В свойствах поля формы найдите параметр Формат. Например, для денег используйте строку ЧЦ=15; ЧДЦ=2, чтобы отображать два знака после запятой. Для дат можно настроить отображение только времени или только числа.

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

Параметр	Описание	Пример значения
Видимость	Управляет отображением колонки	Истина / Ложь
ТолькоПросмотр	Запрещает редактирование ячейки	Истина
ГоризонтальноеПоложение	Выравнивание текста в ячейке	Центр, Право, Лево
Ширина	Фиксированная ширина колонки в символах	10, 15, 20

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

Что делать, если поле не добавляется в таблицу формы?

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

Программное заполнение и автоматизация

Часто новый столбец нужен не для ручного ввода, а для автоматических расчетов. В этом случае необходимо написать код в модуле объекта. Откройте модуль документа и найдите обработчик события ПриЗаписи или ОбработкаПроведения.

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

Для каждого СтрокаТовара Из ДокументОбъект.Товары Цикл
СтрокаТовара.Сумма = СтрокаТовара.Количество * СтрокаТовара.Цена;
КонецЦикла;

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

Обновление конфигурации базы данных

После внесения всех изменений в конфигураторе необходимо обновить саму базу данных. Нажмите клавишу F7 или выберите в меню Конфигурация -> Обновить конфигурацию базы данных. Система проанализирует изменения и предложит выполнить реструктуризацию.

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

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

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

Можно ли добавить столбец в типовой конфигурации без снятия с поддержки?

В типовых конфигурациях (Бухгалтерия, УТ, ЗУП), находящихся на поддержке, прямое изменение объектов запрещено. Для добавления столбца необходимо создать расширение конфигурации. В расширении вы добавляете новый реквизит в табличную часть и расширяете форму, добавляя туда поле. Это безопасный способ доработки, который не нарушает условия поддержки 1С.

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

Наиболее вероятная причина — отсутствие обновления конфигурации базы данных после изменения метаданных. Вы изменили структуру в конфигураторе, но не нажали F7. Вторая причина — поле на форме имеет признак "Только просмотр" и не заполняется программно. Проверьте модуль объекта на наличие кода, который перезаписывает это поле нулем или пустым значением при проведении.

Как удалить добавленный столбец, если он больше не нужен?

Удаление реквизита из табличной части возможно только в режиме конфигуратора. Найдите реквизит в структуре объекта, нажмите Delete и обновите конфигурацию базы данных. Будьте осторожны: все данные, хранившиеся в этом столбце, будут безвозвратно удалены из всех документов и справочников. Предварительно сделайте выгрузку этих данных, если они важны.

Влияет ли добавление колонки на скорость работы программы?

Добавление одного-двух реквизитов в табличную часть практически не влияет на производительность системы. Однако, если вы добавляете поля с типом "Хранение картинки" или большие текстовые блоки в документы, где тысячи строк, это может увеличить размер файла базы и замедлить выборки. Для обычных числовых и строковых полей влияние пренебрежимо мало.