К статье
Практический материал

Другое · 7 мин

Добавление поля в табличную часть 1С

Как добавить реквизит в табличную часть объекта 1С: порядок действий, формы, проверка результата, ограничения и типичные ошибки при самостоятельной настройке.

Табличная часть в 1С используется там, где одному основному объекту соответствует несколько связанных строк: строки документа, номенклатура справочника, движения регистра и т. п. Поле в такой части не является обычным реквизитом формы: оно должно существовать в метаданных объекта, а затем быть отображено на форме. Без добавления атрибута в саму табличную часть колонка на форме останется только визуальным элементом без сохранения данных.

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

В конфигураторе откройте нужный объект конфигурации и найдите раздел «Табличные части». Каждая табличная часть имеет собственный набор реквизитов, независимый от реквизитов самого объекта. Новое поле создаётся именно внутри выбранной табличной части, а не в главной форме документа или справочника.

При создании атрибута укажите имя, тип данных и, при необходимости, длину или точность. Имя должно соответствовать правилам именования 1С и не дублировать существующие реквизиты этой табличной части. После сохранения изменения становятся частью метаданных объекта, но ещё не отображаются у пользователей.

Поле есть на форме, но не сохраняетсяАтрибут отсутствует в табличной части объекта

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

Колонка не добавляется в таблицу формыФорма не связана с новым реквизитом или не обновлена

Откройте форму и проверьте источник данных табличного поля

Ошибка при обновлении конфигурацииКонфигурация заблокирована или используется типовая поддержка

Остановитесь и уточните порядок внесения изменений у администратора

Далее перейдите к форме объекта, где должна появиться колонка. Для управляемых форм откройте табличное поле, соответствующее табличной части, и добавьте колонку, привязав её к новому атрибуту через путь вида «ТабличнаяЧасть.НовоеПоле». Настройте доступность, редактируемость и ширину колонки в зависимости от бизнес-задачи.

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

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

Запустите 1С в режиме предприятия, откройте объект с табличной частью и проверьте появление колонки. Введите тестовое значение в новую ячейку, сохраните документ или элемент справочника, затем откройте его повторно. Если значение сохранилось, поле работает корректно.

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

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

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

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

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

Контрольные точки

Как проверить результат

Открытие объекта после сохранения
Норма

Значение нового поля отображается и сохраняется

Тревожный признак

Поле пустое, отсутствует или не сохраняется

Повторное открытие документа
Норма

Данные в табличной части не пропадают

Тревожный признак

Значения сбрасываются после закрытия

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

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

Типичные ошибки
01
Колонка добавлена только на форме, данные не сохраняются в базе
02
Изменение типовой конфигурации без расширения и резервной копии

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

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

Итог

Что важно запомнить

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

Нужно ли программировать, чтобы добавить простое поле?

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

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

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

Почему значение нового поля пропадает после закрытия документа?

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

Можно ли изменять типовую конфигурацию напрямую?

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