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

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

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

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

Самый простой и частый сценарий — когда вам нужно получить или изменить значение реквизита непосредственно в модуле самой формы. В этом случае используется прямой доступ через ключевое слово ЭтотОбъект (или его англоязычный аналог ThisObject в конфигурациях на английском языке).

Пример обращения к реквизиту Наименование (тип Строка):

ЭтотОбъект.Наименование = "Новое значение";

Если реквизит является табличной частью (например, Товары), то для работы с её строками используется коллекция Элементы:

НоваяСтрока = ЭтотОбъект.Товары.Добавить();
НоваяСтрока.Номенклатура = Справочники.Номенклатура.НайтиПоНаименованию("Монитор");
НоваяСтрока.Количество = 2;

Это означает:

• 🔄 Изменения на форме не сохранятся в базе, пока не будет вызван метод Записать() для объекта.
• 📊 Для динамических списков и табличных полей требуется явное обновление отображения (метод Обновить()).
• ⚡ При обращении к несуществующему реквизиту платформа выбросит исключение Ошибка при обращении к свойству объекта.

2. Доступ к реквизитам через элементы управления

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

Синтаксис обращения:

ЭлементыФормы.ИмяЭлемента.Значение = НовоеЗначение;

Примеры:

// Установка значения в поле ввода
ЭлементыФормы.ПолеНаименования.Значение = "Тестовый товар";

// Чтение значения из флажка
Если ЭлементыФормы.ФлажокАктивности.Значение Тогда
Сообщить("Элемент активен!");
КонецЕсли;

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

ЭлементыФормы.ПолеЦены.Значение = 2000;
ЭтотОбъект.ОбновитьДанные(); // Синхронизирует данные формы и элементов

3. Работа с реквизитами из глобального модуля или других форм

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

1. Через менеджер форм — если форма уже открыта:

   ФормаДокумента = Формы.Получить("Документ.ЗаказПокупателя.ФормаДокумента", ИдентификаторФормы);

2. Через открытие новой формы:

   ФормаДокумента = Документы.ЗаказПокупателя.ПолучитьФорму();

3. Через параметр — если форма передаётся как аргумент в процедуру.

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

ФормаДокумента.Объект.ДатуДокумента = ТекущаяДата();

Обратите внимание на ключевое слово .Объект — оно указывает на данные документа, связанного с формой. Без него вы получите доступ только к реквизитам самой формы, которые могут отличаться от реквизитов объекта.

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

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

4. Обращение к реквизитам динамических списков и табличных частей

Динамические списки и табличные части требуют особого подхода, так как представляют собой коллекции данных. Рассмотрим основные сценарии:

Чтение данных из табличной части:

Для Каждого Строка Из ЭтотОбъект.Товары Цикл
Сообщить(Строка.Номенклатура.Наименование + ": " + Строка.Количество);
КонецЦикла;

Изменение данных в динамическом списке:

ТекущаяСтрока = ЭлементыФормы.СписокДокументов.ТекущаяСтрока;
Если ТекущаяСтрока <> Неопределено Тогда
ТекущаяСтрока.Объект.Комментарий = "Обновлено вручную";
ЭлементыФормы.СписокДокументов.ОбновитьСтроку(ТекущаяСтрока);
КонецЕсли;

Для работы с динамическими списками (например, в формах списков документов) часто требуется:

• 🔍 Получать текущую строку через .ТекущаяСтрока.
• 🔄 Обновлять отображение после изменений (.Обновить() или .ОбновитьСтроку()).
• 📌 Использовать .ПолучитьЭлемент() для доступа к конкретной строке по индексу.

Получить коллекцию строк через ЭтотОбъект.ИмяТабличнойЧасти

Использовать цикл Для Каждого для перебора строк

Обновлять отображение после изменений (Обновить())

Проверять ТекущаяСтрока на Неопределено перед работой

-->

Особенность динамических списков: они могут быть привязаны к запросу или объекту метаданных. В первом случае изменения в списке не сохранятся в базе автоматически — потребуется отдельная логика для записи.

5. Оптимизация доступа к реквизитам: советы для ускорения работы

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

1. Минимизируйте обращения к элементам формы — кэшируйте часто используемые значения в переменных:

   ЗначениеНоменклатуры = ЭтотОбъект.Номенклатура; // Одно обращение вместо многократного

2. Используйте массовые операции для табличных частей вместо построчного изменения:

   ЭтотОбъект.Товары.Очистить();
   ЭтотОбъект.Товары.Загрузить(МассивСтрок); // Массовая загрузка

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

   ЭтотОбъект.ЗапретитьОбновлениеЭкрана(Истина);
   //..массовые изменения..
   ЭтотОбъект.РазрешитьОбновлениеЭкрана(Истина);
   ЭтотОбъект.ОбновитьПанель();

Для динамических списков критично:

• 🚀 Использовать Отбор и ПараметрыЗапроса для уменьшения объёма загружаемых данных.
• 📈 Ограничивать количество выводимых колонок (свойство ОтображаемыеКолонки).
• 🔄 Обновлять только изменённые строки (ОбновитьСтроку() вместо Обновить()).

Если форма подвисает при открытии, проверьте:

⚠️ Внимание: Частая причина тормозов — избыточные обработчики событий (например, ПриИзменении) на элементах формы, которые срабатывают при каждом изменении. Оптимизируйте логику обработчиков или переносите её в события формы (ПриАктивизацииСтроки).

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

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

Ещё одна распространённая проблема — рассинхронизация данных между формой и объектом. Например:

// Ошибка: изменяем реквизит объекта, но не обновляем форму
ЭтотОбъект.Объект.СуммаДокумента = 1000;
// Форма всё ещё показывает старое значение!

Решение — явное обновление:

ЭтотОбъект.Объект.СуммаДокумента = 1000;
ЭтотОбъект.ОбновитьДанные(); // Синхронизация формы и объекта

Для динамических списков актуальна ошибка с потерей контекста при обновлении:

⚠️ Внимание: Если вы изменяете отбор динамического списка в обработчике события (например, ПриИзменении), а затем вызываете Обновить(), текущая строка может сброситься. Чтобы сохранить позицию, используйте метод СохранитьПозицию() до обновления и ВосстановитьПозицию() после.

7. Продвинутые техники: рефлексия и динамическое обращение

В некоторых случаях требуется динамически обращаться к реквизитам, имена которых заранее неизвестны (например, при создании универсальных обработок). Для этого в 1С можно использовать механизм рефлексии через метод Метаданные().

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

МетаданныеФормы = ЭтотОбъект.Метаданные();
Для Каждого Реквизит Из МетаданныеФормы.Реквизиты Цикл
Сообщить(Реквизит.Имя);
КонецЦикла;

Динамическое обращение к реквизиту по имени (строка):

ИмяРеквизита = "ДатуДокумента";
ЗначениеРеквизита = ЭтотОбъект[ИмяРеквизита]; // Чтение
ЭтотОбъект[ИмяРеквизита] = ТекущаяДата();   // Запись

Для элементов управления динамический доступ реализуется через метод ЭлементыФормы.Получить():

ИмяЭлемента = "ПолеКомментария";
Элемент = ЭлементыФормы.Получить(ИмяЭлемента);
Если Элемент <> Неопределено Тогда
Элемент.Значение = "Динамически установленное значение";
КонецЕсли;

Преимущества динамического подхода:

• 🔧 Универсальность — один код работает с разными формами.
• 🛠 Гибкость — возможность модифицировать логику без изменения конфигурации.

Недостатки:

• ⚠️ Потеря контроля типов — ошибки выявляются только на этапе выполнения.
• ⏳ Более медленная работа по сравнению с прямым доступом.

Пример использования — универсальная функция для копирования значений между формами:

Процедура СкопироватьРеквизиты(Источник, Приемник, СписокРеквизитов)
Для Каждого ИмяРеквизита Из СписокРеквизитов Цикл
Если Источник[ИмяРеквизита] <> Неопределено Тогда
Приемник[ИмяРеквизита] = Источник[ИмяРеквизита];
КонецЕсли;
КонецЦикла;
КонецПроцедуры

8. Практические примеры: от простого к сложному

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

Задача 1: При изменении цены в табличной части автоматически пересчитывать сумму строки.

Процедура ТоварыКоличествоПриИзменении(Элемент)
ТекущаяСтрока = ЭлементыФормы.Товары.ТекущаяСтрока;
ТекущаяСтрока.Сумма = ТекущаяСтрока.Цена * ТекущаяСтрока.Количество;
ЭлементыФормы.Товары.ОбновитьСтроку(ТекущаяСтрока);
КонецПроцедуры

Задача 2: При открытии формы документа устанавливать текущую дату в реквизит ДатуДокумента, если он пустой.

Процедура ПриОткрытии()
Если ПустоеЗначение(ЭтотОбъект.ДатуДокумента) Тогда
ЭтотОбъект.ДатуДокумента = ТекущаяДата();
КонецЕсли;
КонецПроцедуры

Задача 3: Динамически скрывать элементы формы в зависимости от прав пользователя.

Процедура ПриСозданииНаСервере()
Если НЕ ГлобальныйКонтекст.Пользователь.ПроверитьПрава("Администрирование") Тогда
ЭлементыФормы.КнопкаУдалить.Видимость = Ложь;
КонецЕсли;
КонецПроцедуры

Задача 4: Массовое изменение значений в табличной части по условию.

Процедура УстановитьСкидкуНаТовары(ПроцентСкидки)
Для Каждого Строка Из ЭтотОбъект.Товары Цикл
Если Строка.Номенклатура.Группа = Справочники.ГруппыНоменклатуры.Электроника Тогда
Строка.Цена = Строка.Цена * (1 - ПроцентСкидки/100);
КонецЕсли;
КонецЦикла;
ЭтотОбъект.ОбновитьПанель();
КонецПроцедуры

Для отладки сложных сценариев используйте Сообщить() или точку останова в конфигураторе. Например, чтобы проверить текущее значение реквизита:

Сообщить("Текущая цена: " + ЭтотОбъект.Цена);

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

ЭтотОбъект.Объект.Комментарий = "Новый комментарий";
ЭтотОбъект.Записать();

ИмяРеквизита = "ДатуДокумента";
Значение = ЭтотОбъект[ИмяРеквизита];

Элемент = ЭлементыФормы.Получить(ИмяРеквизита);
Если Элемент <> Неопределено Тогда
Значение = Элемент.Значение;
КонецЕсли;

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

// Серверный код
Процедура СервернаяПроцедура(Параметры) Экспорт
ЭтотОбъект[Параметры.ИмяРеквизита] = Параметры.Значение;
КонецПроцедуры

ЭтотОбъект.СуммаДокумента = 1000;
ЭтотОбъект.ОбновитьДанные();
ЭлементыФормы.ПолеСуммы.Обновить();