Другое · 7 мин
Как добавить новый реквизит на форму в 1С:Предприятие
Пошаговая инструкция: как добавить новый реквизит на форму в 1С:Предприятие, отличия реквизита формы и объекта, проверка результата и типичные ошибки.
Новый реквизит на форме в 1С позволяет отображать и редактировать дополнительное значение, которое не входит в стандартный состав объекта конфигурации. Решение подходит, когда нужно временно хранить данные в процессе работы с документом или справочником, не меняя структуру хранения при каждом новом требовании. Перед началом работы важно решить, где будет храниться значение: только на форме или в самом объекте.
В управляемом приложении реквизит формы добавляется через окно редактирования формы, а в обычном приложении — через свойства формы в конфигураторе. Разница влияет на способы обращения в коде и на порядок сохранения изменений. Неправильный выбор типа реквизита приводит к тому, что значение не сохранится после закрытия формы.
Любые изменения в конфигурации лучше выполнять на копии информационной базы или с резервной копией. Если конфигурация поддерживается поставщиком, прямое редактирование объектов может быть заблокировано или сброшено при обновлении. Работа с несколькими пользователями одновременно требует согласования, чтобы избежать блокировок объектов.
Отличие реквизита формы от реквизита объекта
Реквизит объекта хранится в базе данных как часть документа, справочника или другого элемента конфигурации. Его значение доступно после сохранения и при повторном открытии карточки. Такой реквизит подходит для данных, которые должны оставаться в информационной базе надолго.
Реквизит формы существует только пока открыта форма и хранится в памяти клиента или сервера в зависимости от типа приложения. При закрытии окна значение теряется, если его не скопировать в реквизит объекта, регистр или другое хранилище. Этот вариант удобен для временных флагов, промежуточных расчётов и служебных отметок.
Добавление реквизита объекта конфигурации
Откройте конфигуратор, найдите нужный объект в дереве конфигурации и откройте его редактирование. В разделе реквизитов создайте новую строку, укажите имя, тип данных и длину при необходимости. Имя должно соответствовать правилам именования 1С и не дублировать существующие реквизиты.
Сохраните объект и выполните обновление конфигурации базы данных. В обычном приложении изменения становятся доступны после перезапуска или обновления, в управляемом — обычно сразу после обновления конфигурации. Проверьте, что объект доступен для редактирования и не защищён правами или поддержкой поставщика.
- 1Откройте объект конфигурации и создайте новый реквизит с типом и именем
- 2Сохраните объект и обновите конфигурацию базы данных
- 3Добавьте реквизит на форму через редактор формы
- 4Проверьте отображение и сохранение значения в режиме предприятия
Размещение реквизита на форме
Откройте форму объекта в редакторе форм. Если реквизит принадлежит объекту, перетащите его из списка реквизитов на форму или используйте команду добавления элемента управления. Для нового реквизита формы создайте его непосредственно в свойствах формы, выбрав тип и имя.
Разместите элемент на нужной группе или странице формы, настройте надпись, доступность и видимость. Сохраните форму и обновите конфигурацию. После этого откройте информационную базу в режиме предприятия и убедитесь, что поле появилось на карточке объекта.
Обращение к реквизиту в коде модуля формы
В модуле формы управляемого приложения обращайтесь к реквизиту через контекст формы, например через элементы формы или свойства объекта. В обычном приложении используется обращение к реквизиту объекта через этоОбъект или к форме через ЭтаФорма. Точный синтаксис зависит от типа приложения и платформы.
Запись значения в реквизит объекта выполняется перед сохранением документа или справочника. Если нужно сохранить временное значение формы, организуйте копирование в реквизит объекта в обработчике записи или перед закрытием формы. Иначе данные пропадут при закрытии окна.
Проверка результата и типичные ошибки
После добавления откройте карточку объекта в режиме предприятия, заполните новое поле и сохраните документ. Закройте карточку и откройте её снова: значение должно остаться, если реквизит относится к объекту. Для реквизита только формы проверьте, что значение корректно отображается пока форма открыта.
Если поле не появилось, проверьте обновление конфигурации, права доступа и видимость элемента на форме. Если значение не сохраняется, убедитесь, что реквизит принадлежит объекту или значение записано программно перед сохранением. При ошибке компиляции проверьте имя реквизита и тип данных в модуле формы.
Как проверить результат
Элемент виден и доступен для ввода
Поле отсутствует или недоступно для редактирования
Данные читаются при повторном открытии
Значение сбрасывается после закрытия формы
Ограничения и безопасные условия работы
Изменения в конфигурации, поддерживаемой поставщиком, могут быть ограничены или отменены при обновлении. Перед правкой создайте резервную копию информационной базы и по возможности протестируйте на отдельной копии. Не вносите изменения в рабочую базу во время активной работы пользователей.
Ограничьте доступ к редактированию конфигурации узким кругом сотрудников и фиксируйте порядок внесения изменений. При одновременной работе нескольких пользователей возможны блокировки объектов конфигурации, поэтому координируйте правки. Без резервной копии самостоятельные изменения могут привести к потере данных или нарушению работы информационной базы.
Альтернативы постоянному реквизиту
Если значение нужно только в рамках одной сессии, достаточно реквизита формы без записи в базу. Для данных, связанных с регистрами накопления или сведениями, используйте отдельные регистры или справочники вместо раздувания карточки объекта. Такой подход упрощает поддержку и обновление конфигурации.
Выбор варианта зависит от того, как долго значение должно храниться и кто должен иметь к нему доступ. Временные расчёты удобнее держать на форме, а справочную информацию — в реквизите объекта или регистре. Перед внедрением оцените влияние на обновления и права доступа.
Что важно запомнить
Реквизит объекта сохраняется в базе, реквизит формы — только пока открыта форма. Вносите изменения с резервной копией и проверяйте результат после обновления конфигурации.
Нужно ли обновлять конфигурацию после добавления реквизита?
Да, после создания или изменения реквизита объекта конфигурацию базы данных необходимо обновить, иначе новое поле не появится в режиме предприятия. Для реквизита только формы достаточно сохранить форму, но значение не сохранится после закрытия без дополнительной обработки.
Можно ли добавить реквизит в поддерживаемую поставщиком конфигурацию?
Прямое редактирование объектов поддерживаемой конфигурации может быть заблокировано или отменено при обновлении. Безопаснее использовать расширения конфигурации или согласовать изменения с поставщиком, а перед любыми правками сделать резервную копию базы.
Почему значение реквизита исчезает после закрытия формы?
Реквизит, созданный только на форме, существует в памяти пока форма открыта. Чтобы значение осталось после закрытия, оно должно относиться к объекту конфигурации или быть скопировано в реквизит объекта, регистр или другое постоянное хранилище перед сохранением.
Что делать, если новое поле не отображается на форме?
Проверьте, что конфигурация обновлена, реквизит добавлен на форму и элемент управления видим и доступен. Также убедитесь, что у пользователя есть права на просмотр и редактирование объекта, а форма открыта в правильном режиме приложения.