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

Другое · 5 мин

Как программно заполнить реквизит формы в 1С

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

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

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

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

Отличие реквизита формы от реквизита объекта

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

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

Где и когда заполнять реквизит формы

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

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

1c
&НаСервере
Процедура ЗаполнитьРеквизитФормыНаСервере()
    РеквизитФормы.Контрагент = Объект.Контрагент;
    РеквизитФормы.Дата = ТекущаяДата();
КонецПроцедуры

&НаКлиенте
Процедура ПриОткрытии(Отказ)
    ЗаполнитьРеквизитФормыНаСервере();
КонецПроцедуры

Примеры программного заполнения

Заполнение при открытии формы

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

Заполнение по действию пользователя

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

Работа с табличной частью формы

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

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

Типичные ошибки
01
Обращение к реквизиту формы из модуля объекта: такой реквизит там недоступен.
02
Заполнение реквизита формы до открытия формы: реквизиты ещё не созданы.
03
Забыть сохранить объект после изменения реквизита формы: значение пропадёт при закрытии.

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

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

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

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

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

Открыта ли форма перед заполнением
Норма

Форма отображается, реквизит доступен

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

Ошибка обращения к несуществующему реквизиту

Значение отображается на экране
Норма

Поле заполнено нужным значением

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

Поле пустое или содержит старое значение

Данные сохраняются после записи
Норма

Значение остаётся после открытия документа заново

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

Значение сброшено после закрытия формы

Альтернативы и когда не стоит заполнять форму

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

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

Итог

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

Реквизит формы заполняется в модуле формы, не заменяет реквизит объекта и не сохраняется автоматически в базу.

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

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

Где лучше разместить код заполнения: на клиенте или на сервере?

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

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

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

Нужно ли проверять существование реквизита формы перед записью?

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