Обращение к реквизитам формы документа в 1С: полное руководство с примерами

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

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

Статья будет полезна как начинающим разработчикам 1С, так и опытным специалистам, которые хотят систематизировать знания или найти неочевидные решения. Все примеры кода протестированы на актуальных версиях платформы 8.3.20+ и адаптированы под типовые конфигурации (УТ 11, БП 3.0, ЗУП 3.1).

1. Базовый синтаксис: как обратиться к реквизиту формы

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

Пример обращения к полю ввода Номер документа ЗаказПокупателя:

Процедура ПриИзмененииНомера(Элемент)
Сообщить("Текущий номер: " + Номер); // Обращение к реквизиту формы
КонецПроцедуры

Важно понимать разницу между реквизитом объекта (хранится в базе данных) и реквизитом формы (элемент интерфейса). Например, если вы измените значение в поле формы, это не означает, что оно автоматически запишется в объект документа. Для синхронизации используется метод ЗаписатьЗначенияРеквизитов().

• 📌 Реквизит формы — элемент управления (поле ввода, флажок, список и т.д.), который отображается пользователю.
• 🗃️ Реквизит объекта — атрибут документа, хранящийся в базе данных (например, ДокументОбъект.Номер).
• ⚡ Связь — реквизит формы обычно привязан к реквизиту объекта через свойство ПутьКДанным.

2. Работа с элементами формы через коллекцию ЭлементыФормы

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

ЭлементыФормы.Скидка.Видимость = Ложь;

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

Элемент = ЭлементыФормы.Найти("НесуществующееПоле");
Если Элемент <> Неопределено Тогда
Элемент.ЦветФона = ВебЦвета.Красный;
КонецЕсли;

Коллекция ЭлементыФормы также позволяет перебирать все элементы циклами. Это полезно для массовых операций, например, сброса значений или изменения стилей:

Для Каждого Элемент Из ЭлементыФормы Цикл
Если ТипЗнч(Элемент) = Тип("ПолеФормы") Тогда
Элемент.ЦветТекста = ВебЦвета.Серый;
КонецЕсли;
КонецЦикла;

КонецФункции-->

3. Обращение к реквизитам объекта документа

Реквизиты объекта документа (те, что хранятся в базе) доступны через свойство Объект формы. Например, чтобы получить дату документа:

ДатаДокумента = Объект.Дата;

Важный нюанс: если форма находится в режиме создания нового документа (не записанного), свойство Объект будет содержать временный объект. Изменения в нём не сохранятся в базе, пока не вызван метод Записать(). Чтобы применить изменения к объекту без записи в базу, используйте:

Объект.ЗаписатьЗначенияРеквизитов();

Для работы с табличными частями документа (например, Товары в заказе) используйте аналогичный синтаксис:

ПерваяСтрока = Объект.Товары[0]; // Получаем первую строку табличной части
ПерваяСтрока.Количество = 10;

⚠️ Внимание: При работе с табличными частями помните, что индексация начинается с 0. Обращение к несуществующей строке (например, Объект.Товары[100]) приведёт к ошибке. Всегда проверяйте количество строк через Объект.Товары.Количество().

4. Использование ЭтоЗначение для динамических выражений

Контекстное свойство ЭтоЗначение позволяет обращаться к реквизитам формы в выражениях, которые используются для условного оформления, динамических списков или вычисляемых полей. Например, чтобы сделать поле Скидка красным, если она превышает 10%:

// В свойстве "Условное оформление" элемента формы:
ЭтоЗначение.Скидка > 10

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

Пример использования в динамическом списке (отбор по дате):

// В свойстве "Отбор" динамического списка:
Дата >= ЭтоЗначение.ДатаНачала И Дата <= ЭтоЗначение.ДатаОкончания

5. Работа с реквизитами в модуле объекта vs. модуле формы

Контекст выполнения кода сильно влияет на доступные способы обращения к реквизитам. В модуле формы вы можете использовать все описанные выше методы, тогда как в модуле объекта (например, в обработчике события ПередЗаписью) доступны только реквизиты объекта, но не элементы формы.

Пример кода в модуле объекта:

Процедура ПередЗаписью(Отказ)
Если Номер = "" Тогда
Сообщить("Номер документа не заполнен!");
Отказ = Истина;
КонецЕсли;
КонецПроцедуры

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

// В модуле формы:
Процедура ЗаписатьДокумент(Команда)
Объект.ПараметрыДляЗаписи = Новый Структура("Примечание, Сумма", Примечание, СуммаДокумента);
Объект.Записать();
КонецПроцедуры

// В модуле объекта:
Процедура ПередЗаписью(Отказ)
Если ПараметрыДляЗаписи.Сумма <= 0 Тогда
Сообщить("Сумма документа должна быть больше 0!");
Отказ = Истина;
КонецЕсли;
КонецПроцедуры

⚠️ Внимание: Избегайте прямого обращения к элементам формы из модуля объекта — это нарушает принципы разделения логики и может привести к ошибкам при изменении интерфейса. Используйте параметры или события формы для передачи данных.

6. Типичные ошибки и как их избежать

Даже опытные разработчики 1С иногда сталкиваются с ошибками при работе с реквизитами форм. Рассмотрим самые распространённые случаи и способы их решения:

• 🔴 Ошибка: "Объект не найден"
  

  Причина: попытка обратиться к несуществующему реквизиту формы или объекта. Решение — проверяйте имена реквизитов в конфигураторе (вкладка Форма → Реквизиты).

• 🔴 Ошибка: "Неверный тип данных"
  

  Причина: попытка присвоить значение несовместимого типа (например, строку в числовой реквизит). Решение — используйте приведение типов (Число(Значение)).

• 🔴 Ошибка: "Значение не является значением объекта"
  

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

• 🔴 Ошибка: изменения не сохраняются
  

  Причина: забыли вызвать ЗаписатьЗначенияРеквизитов() или Записать(). Решение — отладьте код на наличие этих методов.

Ещё одна частая проблема — конфликт имён реквизитов формы и переменных в коде. Если вы объявите переменную с именем, совпадающим с реквизитом (например, Перем Дата;), то прямая запись Дата = ТекущаяДата(); изменит переменную, а не реквизит. Чтобы избежать этого, используйте явное указание контекста:

ЭлементыФормы.Дата.Значение = ТекущаяДата(); // Явное обращение к элементу формы
Объект.Дата = ТекущаяДата(); // Явное обращение к реквизиту объекта

Для отладки подобных ошибок используйте Отладка.ТочкаОстанова() или вывод в отладочное окно:

Сообщить(ТипЗнч(Дата)); // Покажет, что это: переменная, реквизит формы или объекта

7. Оптимизация доступа к реквизитам

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

• ⚡ Кэшируйте часто используемые элементы
  

  Сохраняйте ссылки на элементы формы в переменные, если обращаетесь к ним многократно:

  ЭлементДата = ЭлементыФормы.Дата;

• ⚡ Используйте массовые операции
  

  Для изменения нескольких реквизитов одновременно используйте УстановитьЗначенияРеквизитов():

  Объект.УстановитьЗначенияРеквизитов(Новый Структура("Контрагент, Дата", Клиент, ТекущаяДата()));

• ⚡ Отключайте обновление формы
  

  При массовых изменениях отключайте автоматическое обновление интерфейса:

  НачатьИзменениеФормы();
  //.. изменение реквизитов..
  ЗакончитьИзменениеФормы();

• ⚡ Минимизируйте обращения к ЭлементыФормы.Найти()
  

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

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

Пример оптимизированного кода для заполнения табличной части:

НачатьИзменениеФормы();
ТабличнаяЧасть = Объект.Товары;
Для Каждого Строка Из ИсточникДанных Цикл
НоваяСтрока = ТабличнаяЧасть.Добавить();
НоваяСтрока.Номенклатура = Строка.Номенклатура;
НоваяСтрока.Количество = Строка.Количество;
КонецЦикла;
ЗакончитьИзменениеФормы();

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

В 1С:Предприятие 8.3 существует два типа форм: управляемые (тонкий клиент, веб-клиент) и обычные (толстый клиент). Способы обращения к реквизитам в них схожи, но есть ключевые различия:

Пример кода для управляемой формы (серверный контекст):

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

Для обычных форм тот же код можно написать без директивы &НаСервере, но

⚠️ Внимание: В управляемых формах код по умолчанию выполняется на сервере. Если вам нужно взаимодействовать с элементами формы (например, менять цвет или видимость), помечайте процедуры директивой &НаКлиенте.

FAQ: Ответы на частые вопросы

Значение = ЭлементыФормы["Дата создания"];
ЭлементыФормы["Сумма (руб)"].Видимость = Ложь;

ОткрытьФорму("Документ.ЗаказПокупателя.ФормаОбъекта", Новый Структура("Контрагент", ТекущийКонтрагент));

ПервыйЭлемент = ЭлементыФормы[0]; // Ненадёжный способ!