Как элементу формы присвоить значение в 1С

Элемент формы в 1С — это визуальный объект (поле ввода, флажок, надпись, таблица), который отображает данные. Ключевой принцип платформы: значение почти всегда присваивается не самому элементу, а связанному с ним реквизиту формы, а элемент лишь показывает это значение пользователю. Поэтому корректный ответ на вопрос «как присвоить значение элементу формы» — присвоить значение реквизиту формы или реквизиту объекта, с которым элемент связан через свойство «ПутьКДанным».

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

Ниже разобраны основные способы с примерами кода на встроенном языке 1С, ограничения каждого подхода и типичные ошибки, из-за которых значение «не присваивается».

Как связаны элемент формы и данные

В управляемой форме действует модель разделения данных и представления. Реквизиты формы хранят значения, а элементы формы только отображают их и передают ввод пользователя. Связь задаётся свойством элемента «ПутьКДанным»: например, поле ввода «Контрагент» связано с реквизитом объекта «Объект.Контрагент».

Из этого следует главное правило: чтобы на экране появилось нужное значение, нужно изменить данные по указанному пути. Обращение к самому элементу (Элементы.Контрагент) даёт доступ только к оформлению — цвету, видимости, доступности, заголовку — но не к редактируемому значению.

Исключение — обычные формы (устаревший режим) и отдельные случаи с полем HTML-документа или полем календаря, где платформа допускает обращение к содержимому элемента. Но в современных конфигурациях на управляемых формах работа всегда идёт через данные.

Присвоение значения реквизиту формы в коде

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

&НаКлиенте
Процедура ЗаполнитьКомментарий(Команда)
Комментарий = "Создано автоматически";
КонецПроцедуры

Если реквизит принадлежит объекту (например, форма документа), обращение идёт через «Объект»:

&НаКлиенте
Процедура УстановитьСклад(Команда)
Объект.Склад = ПредопределенноеЗначение("Справочник.Склады.Основной");
КонецПроцедуры

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

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

Присвоение значения при открытии формы

Частая задача — заполнить поля при создании нового документа или открытии формы. Для этого используются события «ПриСозданииНаСервере» и «ПриОткрытии». Разница принципиальна: первое выполняется на сервере до отображения формы, второе — на клиенте, когда форма уже показана.

&НаСервере
Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)
Если Объект.Ссылка.Пустая() Тогда
Объект.Ответственный = ПользователиИнформационнойБазы.ТекущийПользователь().Имя;
КонецЕсли;
КонецПроцедуры

Заполнять значения рекомендуется именно в «ПриСозданииНаСервере»: это снижает число серверных вызовов и гарантирует, что пользователь увидит уже заполненную форму. Дополнительно для новых объектов существует событие «ОбработкаЗаполнения» в модуле объекта — оно срабатывает при любом способе создания (в том числе программном), поэтому логику заполнения по умолчанию правильнее размещать там.

Программное изменение по событию другого поля

Когда значение одного поля должно зависеть от другого, используется обработчик «ПриИзменении». Например, при выборе договора автоматически подставляется валюта, или при изменении количества пересчитывается сумма.

&НаКлиенте
Процедура КонтрагентПриИзменении(Элемент)
Если ЗначениеЗаполнено(Объект.Контрагент) Тогда
Объект.Договор = ПолучитьОсновнойДоговор(Объект.Контрагент);
КонецЕсли;
КонецПроцедуры

&НаСервереБезКонтекста
Функция ПолучитьОсновнойДоговор(Контрагент)
// запрос к данным справочника
Возврат Неопределено;
КонецФункции

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

Изменение свойств элемента: когда присваивают самому элементу

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

&НаКлиенте
Процедура ПереключитьРежим(Команда)
Элементы.ГруппаОплата.Видимость = Не Элементы.ГруппаОплата.Видимость;
Элементы.Контрагент.Заголовок = "Покупатель";
Элементы.Сумма.ТолькоПросмотр = Истина;
КонецПроцедуры

Отдельный практический случай — заполнение списка выбора поля: Элементы.Поле.СписокВыбора.Добавить(Значение, "Представление"). Это не присваивание значения полю, а настройка вариантов, которые пользователь сможет выбрать.

Присвоение значения форме, открытой программно

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

ПараметрыФормы = Новый Структура;
ПараметрыФормы.Вставить("ЗначенияЗаполнения", Новый Структура("Организация,Склад", Орг, Склад));
ОткрытьФорму("Документ.РеализацияТоваровУслуг.ФормаОбъекта", ПараметрыФормы);

Параметр «ЗначенияЗаполнения» обрабатывается стандартным механизмом заполнения, поэтому реквизиты объекта заполнятся автоматически. Для произвольных реквизитов формы передают собственные параметры и читают их в «ПриСозданииНаСервере» через коллекцию «Параметры».

&НаСервере
Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)
    Если Параметры.Свойство("КомментарийПоУмолчанию") Тогда
        Комментарий = Параметры.КомментарийПоУмолчанию;
    КонецЕсли;
КонецПроцедуры

Типичные ошибки и проверка результата

Наиболее частая жалоба — «присваиваю, но значение не появляется». Причины почти всегда одни и те же: элемент связан с другим реквизитом, чем тот, который заполняет код; присваивание выполняется в форме списка, а проверяется форма объекта; значение присваивается до заполнения формы и затем перезаписывается стандартной обработкой.

Вторая группа ошибок — несоответствие типов. Если реквизит имеет тип «СправочникСсылка.Номенклатура», присвоение строки с наименованием не сработает: нужно сначала найти или создать элемент справочника и присвоить ссылку. Для реквизитов составного типа проверяйте, что присваиваемое значение входит в список допустимых типов.

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

FAQ