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

Другое · 6 мин

Добавление реквизита на форму в расширении 1С

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

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

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

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

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

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

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

Реквизит есть в объектеМожно добавить на форму

Проверьте список реквизитов объекта в конфигураторе

Реквизита нет в объектеНужно создать в расширении

Создайте реквизит объекта, затем обновите конфигурацию

Форма не открывается для редактированияВозможно ограничение поддержки

Проверьте права и блокировку конфигурации

Подготовка и проверка объекта конфигурации

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

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

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

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

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

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

Программное отображение реквизита в модуле формы

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

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

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

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

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

Типичные ошибки
01
Добавление реквизита на форму без создания в объекте конфигурации
02
Изменение рабочей базы без резервной копии и тестирования
03
Игнорирование прав доступа при открытии нового поля

Частые ошибки и альтернативы

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

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

Итог

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

Реквизит на форме в расширении 1С добавляется после проверки объекта конфигурации, обновления конфигурации и тестирования на копии базы.

Нужно ли создавать реквизит объекта, если он уже есть в конфигурации?

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

Можно ли добавить реквизит только на форму без привязки к объекту?

Только если тип формы и конфигурация позволяют создавать собственные реквизиты формы. В большинстве случаев реквизит формы привязан к реквизиту объекта конфигурации.

Что делать, если форма не открывается для редактирования?

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

Как понять, что реквизит добавился корректно?

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

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

Не рекомендуется. Сначала сделайте резервную копию, проверьте изменения на тестовой копии и только затем переносите на рабочую базу по согласованию с администратором.