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