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

Другое · 6 мин

Как добавить колонку в табличную часть формы 1С программно

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

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

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

Порядок действий на управляемой форме
  1. 1
    Откройте модуль формы и найдите процедуру, где форма инициализируется
  2. 2
    Создайте элемент типа ПолеФормы через Элементы.Добавить
  3. 3
    Задайте Имя, ПутьКДанных, Заголовок, Видимость и Доступность
  4. 4
    Разместите элемент в нужной группе формы
  5. 5
    Проверьте отображение колонки и сохранение данных

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

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

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

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

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

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

Типичные ошибки
01
Дублирование имени элемента формы приводит к конфликту при открытии
02
Привязка к несуществующему реквизиту даёт пустую колонку без ошибки
03
Скрытие обязательных реквизитов нарушает сохранение документов

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

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

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

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

Колонка отображается на форме
Норма

Виден заголовок и значения реквизита

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

Колонка отсутствует или ячейки пустые

Данные сохраняются
Норма

Документ записывается без ошибок

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

Ошибка записи или потеря данных

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

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

Итог

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

Программная колонка формы связана с существующим реквизитом табличной части; новый реквизит создаётся в конфигураторе, а не в модуле формы.

Можно ли создать новый реквизит табличной части прямо из формы?

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

В каком событии формы лучше добавлять колонку?

Часто используется ПриСозданииНаСервере или ПриОткрытии. Выбор зависит от того, нужна ли колонка до открытия формы или при работе с данными на клиенте.

Что делать, если колонка появилась, но данные не отображаются?

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

Безопасно ли программно менять типовую форму?

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