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