В качестве первого примера рассмотрим ситуацию, когда мы находимся в форме документа и нам нужно получить какой-либо его реквизит. Например, номер документа или значение реквизита Поставщик.
Примечание
Пример можно посмотреть в демонстрационной базе «Работа с данными объекта в форме», форма документа Накладная, группа команд Примеры, команда Значение реквизита. Это локальная команда формы документа Накладная.
Данные объекта, которые отображаются в форме (в нашем случае данные документа), находятся всегда в основном реквизите формы. В подавляющем большинстве случаев этот реквизит имеет имя Объект. По крайней мере именно такое имя дает ему платформа, когда с помощью конструктора создает форму объекта. В нашем случае это именно так (рис. 3.30).

Рис. 3.30. Стандартное имя основного реквизита формы объекта
Основной реквизит формы содержит набор подчиненных реквизитов, соответствующих реквизитам прикладного объекта. Поэтому для того, чтобы обратиться, например, к номеру документа, нужно указать имя реквизита формы и через точку – имя подчиненного реквизита, хранящего номер документа.
В нашем случае, для того чтобы сообщить номер документа и поставщика, нужно будет выполнить следующий код (листинг 3.21).
Листинг 3.21. Получение значения реквизита формы
Сообщение = Новый СообщениеПользователю;
Сообщение.Текст = Объект.Номер + Символы.ПС + Строка(Объект.Поставщик);
Сообщение.Сообщить();
Номер документа имеет тип Строка, поэтому мы выводим его просто как Объект.Номер, а значение реквизита Поставщик имеет тип ссылки. Поэтому для того, чтобы включить его в текстовую строку, мы получаем строковое представление этого ссылочного значения, преобразуя его к типу Строка: Строка(Объект.Поставщик).