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

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

В этой статье мы разберём 5 основных методов получения реквизитов формы программно, включая работу с элементами управления, динамическими списками и параметрами. Особое внимание уделим нюансам, которые могут возникнуть при работе с управляемыми и обычными формами, а также типичным ошибкам, которые допускают начинающие программисты 1С. Если вы когда-либо сталкивались с проблемами вроде Неопределённое значение (Null) при попытке получить данные из формы — этот материал поможет разобраться в причинах и найти решение.

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

1. Основные понятия: реквизиты формы vs элементы управления

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

📌 Реквизиты формы — это данные, которые хранятся в модуле формы и могут быть привязаны к элементам управления. Они объявлены в дереве объектов конфигуратора в разделе Реквизиты конкретной формы. Например, реквизит ТекущийДокумент или ФильтрПоДате.
🎛️ Элементы управления — визуальные компоненты формы (поля ввода, кнопки, табличные поля), которые отображают или позволяют редактировать реквизиты. Примеры: ПолеВвода1, ТаблицаТоваров, КнопкаСохранить.

Ключевое отличие: реквизит может существовать независимо от элемента управления (например, для хранения промежуточных вычислений), а элемент управления без привязанного реквизита обычно используется для статического отображения данных или выполнения действий (кнопки, закладки).

В управляемых формах (начиная с версии 8.2) доступ к реквизитам и элементам реализован через объект ЭтаФорма, тогда как в обычных формах (устаревший формат) использовались прямые обращения к свойствам. Сегодня управляемые формы доминируют, поэтому основное внимание в статье уделено именно им.

⚠️ Внимание: Если вы работаете с обычными формами (например, в устаревших конфигурациях), синтаксис обращения к реквизитам будет отличаться. В таком случае используйте префикс ЭлементыФормы. вместо ЭтаФорма..

2. Способ 1: Прямое обращение через точку

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

Синтаксис:

ЗначениеРеквизита = ЭтаФорма.ИмяРеквизита;

ЭлементУправления = ЭтаФорма.ЭлементыФормы.ИмяЭлемента;

Примеры использования:

📄 Получение значения реквизита ДатаДокумента:
```
ТекущаяДата = ЭтаФорма.ДатаДокумента;
```

🔍 Чтение текста из поля ввода ПолеПоиска:

ТекстПоиска = ЭтаФорма.ЭлементыФормы.ПолеПоиска.Значение;

📋 Получение текущей строки табличного поля ТаблицаТоваров:

ТекущаяСтрока = ЭтаФорма.ЭлементыФормы.ТаблицаТоваров.ТекущиеДанные;

Преимущества метода:

✅ Минимальный код, высокая читаемость.
✅ Быстрое выполнение (нет дополнительных вызовов методов).

Недостатки:

❌ При изменении имени реквизита или элемента в конфигураторе код перестанет работать.
❌ Нет проверки на существование реквизита/элемента — при ошибке возникнет исключение.

💡

Если вы часто используете реквизиты формы в коде, создайте область в начале модуля с объявлением переменных типа Перем ТекущаяДата; и инициализируйте их в обработчике ПриСозданииНаСервере. Это упростит отладку и поддержку кода.

3. Способ 2: Метод ПолучатьАтрибут()

Для более гибкого доступа к реквизитам, особенно когда их имена формируются динамически или неизвестны заранее, используется метод ПолучатьАтрибут(). Он позволяет получить значение реквизита по его имени в виде строки.

Синтаксис:

Значение = ЭтаФорма.ПолучатьАтрибут("ИмяРеквизита");

Примеры:

🔄 Динамическое получение реквизита по имени из переменной:

ИмяРеквизита = "СуммаДокумента";
ЗначениеСуммы = ЭтаФорма.ПолучатьАтрибут(ИмяРеквизита);

📊 Чтение параметра формы (например, переданного при открытии):
```
ИдОбъекта = ЭтаФорма.ПолучатьАтрибут("КлючОбъекта");
```

Особенности метода:

Параметр	Описание	Пример
`ИмяАтрибута`	Строка с именем реквизита или параметра формы	`"ДатаНачала"`
`ЗначениеПоУмолчанию` (необязательно)	Значение, возвращаемое если атрибут не найден	`Неопределено` или `0`
Возвращаемое значение	Значение реквизита или `Неопределено`, если реквизит не найден	`100500` (для числового реквизита)

Преимущества:

🔧 Гибкость — имя реквизита можно формировать динамически.
🛡️ Безопасность — если реквизит не существует, метод вернёт Неопределено вместо ошибки.

⚠️ Внимание: Метод ПолучатьАтрибут() работает медленнее прямого обращения через точку, так как требует внутреннего поиска по имени. Не используйте его в циклах с большим количеством итераций.

4. Способ 3: Работа с элементами управления

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

🎯 Элемент не привязан к реквизиту формы.
📱 Нужно получить текущее значение, которое пользователь ввёл, но ещё не сохранил.
🔄 Требуется работа с динамическими данными (например, текущая строка таблицы).

Основные свойства элементов управления:

// Получение значения из поля ввода Текст = ЭтаФорма.ЭлементыФормы.ПолеВвода1.Значение; // Чтение состояния флажка ФлагУстановлен = ЭтаФорма.ЭлементыФормы.ФлажокАктивен.Значение; // Получение текущей строки табличного поля

ТекущаяСтрока = ЭтаФорма.ЭлементыФормы.ТаблицаДокументов.ТекущиеДанные;

Для работы с табличными полями (ТаблицаФормы) доступны дополнительные методы:

📋 ТекущиеДанные — возвращает объект текущей строки.
📤 ВыгрузитьДанные() — экспортирует все данные таблицы в таблицу значений.
📥 ЗагрузитьДанные() — импортирует данные из таблицы значений.

Важно: При работе с табличными полями помните, что метод ТекущиеДанные вернёт Неопределено, если ни одна строка не выбрана. Всегда проверяйте результат на пустоту перед использованием.

Имя элемента указано верно (регистр имеет значение)|

Элемент существует на форме (проверьте в конфигураторе)|

Для таблиц проверена текущая строка (ТекущиеДанные <> Неопределено)|

Учтена разница между Значение и Текст (для полей ввода)

-->

5. Способ 4: Использование параметров формы

Параметры формы — это специальные реквизиты, которые предназначены для передачи данных при открытии формы. Они объявлены в разделе Параметры формы и доступны только для чтения в модуле формы. Часто используются для передачи идентификаторов объектов, режимов работы или фильтров.

Пример объявления параметра в конфигураторе:

// В дереве формы, раздел "Параметры"

Параметр ИдДокумента Тип Число;

Доступ к параметру в коде:

// Получение значения параметра ИдДокумента = ЭтаФорма.Параметры.ИдДокумента; // Альтернативный синтаксис

ИдДокумента = Параметры.ИдДокумента;

Типичные сценарии использования параметров:

🔑 Передача Ссылка или УникальныйИдентификатор объекта при открытии формы.
🔍 Установка режима работы формы (например, РежимПросмотра = Истина).
📅 Передача даты или периода для фильтрации данных.

Особенности работы с параметрами:

🔒 Параметры доступны только для чтения в модуле формы. Изменить их программно нельзя.
📤 Значения параметров устанавливаются при открытии формы через метод ОткрытьФорму():

ОткрытьФорму("Документ.ЗаказПокупателя.ФормаОбъекта", Новый Структура("ИдДокумента, Режим", 12345, "Просмотр"));

⚠️ Внимание: Если вы передаёте в параметрах сложные объекты (например, таблицы значений), убедитесь, что они сериализуемы. В противном случае при открытии формы возникнет ошибка.

6. Способ 5: Динамический доступ через Метаданные

Дляadvanced-сценариев, когда требуется получить список всех реквизитов формы или работать с ними в цикле, можно использовать метаданные формы. Этот подход полезен для создания универсальных обработок, аналитических отчётов или автоматизированного тестирования.

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

// Получение коллекции реквизитов
РеквизитыФормы = ЭтаФорма.Метаданные().Реквизиты;

// Перебор реквизитов и вывод их значений
Для Каждого Реквизит Из РеквизитыФормы Цикл
Если ЭтаФорма.ПолучатьАтрибут(Реквизит.Имя) <> Неопределено Тогда
Сообщить(СтрШаблон("Реквизит %1: %2", Реквизит.Имя, ЭтаФорма.ПолучатьАтрибут(Реквизит.Имя)));
КонецЕсли;
КонецЦикла;

Аналогично можно получить список элементов управления:

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

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

🔍 Аудит форм: автоматическая проверка заполненности обязательных полей.
📊 Экспорт данных: выгрузка всех значений формы в JSON или таблицу значений.
🤖 Автотесты: программная проверка состояния формы в тестовых сценариях.

Ограничения метода:

⚠️ Работа с метаданными требует прав на чтение конфигурации (может не работать в 1С:Предприятие без прав администратора).
⚠️ Динамический доступ медленнее статического — не рекомендуется использовать в высоконагруженных обработках.

Как получить скрытые реквизиты формы?

Скрытые реквизиты (с свойством Видимость = Ложь) также доступны через методы ПолучатьАтрибут() или метаданные. Однако их значения могут не обновляться автоматически при изменении связанных элементов. Для принудительного обновления используйте метод Обновить():

ЭтаФорма.Обновить();

7. Типичные ошибки и их решения

При программной работе с реквизитами форм разработчики часто сталкиваются с типичными ошибками. Рассмотрим наиболее распространённые из них и способы их устранения.

Ошибка	Причина	Решение
`Неопределённое значение (Null)`	Обращение к несуществующему реквизиту или незаполненному элементу	Проверяйте существование реквизита через `?()` или используйте `ПолучатьАтрибут()` с значением по умолчанию
`Ошибка при получении данных формы: элемент не найден`	Опечатка в имени элемента или реквизита	Убедитесь в правильности имени (регистр важен!). Используйте подсказки конфигуратора
`Значение не является значением объекта`	Попытка присвоить несовместимые типы данных	Преобразуйте значение к нужному типу (например, `Число()`, `Дата()`)
`Доступ запрещён`	Недостаточно прав на чтение реквизита	Проверьте роли пользователя или используйте серверные методы с повышенными правами

Дополнительные рекомендации по отладке:

🐞 Используйте Сообщить() для вывода промежуточных значений:

Сообщить(СтрШаблон("Значение реквизита 'Сумма': %1", ?(ЭтаФорма.Сумма = Неопределено, "NULL", ЭтаФорма.Сумма)));

🔍 Включите режим отладки (Ctrl+Alt+F5) для пошагового выполнения кода.
📋 Проверяйте журнал регистрации (Администрирование → Журнал регистрации) для анализа ошибок.

💡

Всегда проверяйте реквизиты на Неопределено перед использованием. Это предотвратит большинство ошибок выполнения и упростит поддержку кода.

8. Практический пример: экспорт данных формы в JSON

Рассмотрим реальный пример, который объединяет несколько описанных методов: экспорт всех реквизитов и элементов формы в строку JSON для дальнейшей передачи по API или сохранения в файл.

Алгоритм:

Собрать все реквизиты формы через метаданные.
Получить их значения с проверкой на Неопределено.
Собрать данные элементов управления (например, таблиц).
Сформировать структуру и сериализовать её в JSON.

Код обработчика:

Процедура ЭкспортироватьДанныеФормыВJSON(Результат)

ДанныеДляЭкспорта = Новый Структура();
Реквизиты = ЭтаФорма.Метаданные().Реквизиты;

// 1. Экспорт реквизитов формы
Для Каждого Реквизит Из Реквизиты Цикл
Значение = ЭтаФорма.ПолучатьАтрибут(Реквизит.Имя);
Если Значение <> Неопределено Тогда
ДанныеДляЭкспорта.Вставить(Реквизит.Имя, Значение);
КонецЕсли;
КонецЦикла;

// 2. Экспорт табличных полей
Если ЭтаФорма.ЭлементыФормы.СписокТоваров <> Неопределено Тогда
ТаблицаТоваров = ЭтаФорма.ЭлементыФормы.СписокТоваров.ВыгрузитьДанные();
ДанныеДляЭкспорта.Вставить("Товары", Новый Массив());
Для Каждого Строка Из ТаблицаТоваров Цикл
ДанныеДляЭкспорта.Товары.Добавить(Строка.Скопировать());
КонецЦикла;
КонецЕсли;

// 3. Сериализация в JSON
ЗаписьJSON = Новый ЗаписьJSON;
ЗаписьJSON.УстановитьСтроку();
ЗаписьJSON.ЗаписатьJSON(ДанныеДляЭкспорта);
Результат = ЗаписьJSON.Закрыть();

КонецПроцедуры

Пример использования:

JSONСтрока = "";
ЭкспортироватьДанныеФормыВJSON(JSONСтрока);
Сообщить(JSONСтрока);

Результирующий JSON может выглядеть так:

{ "ДатаДокумента": "2026-05-20T12:00:00", "НомерДокумента": "ЗП-000123", "Сумма": 45789.20, "Товары": [ {"Номенклатура": "Стол письменный", "Количество": 2, "Цена": 8500}, {"Номенклатура": "Стул офисный", "Количество": 4, "Цена": 3200} ]

}

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

FAQ: Частые вопросы по работе с реквизитами формы

❓ Как получить значение реквизита формы из другого модуля (например, из общей формы)?

Для доступа к реквизитам формы из внешнего модуля необходимо:

Получить ссылку на форму через ПолучитьФорму():

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

Обратиться к реквизиту через объект формы:

Значение = ФормаОбъекта.Реквизит1;

Обратите внимание: такой доступ возможен только если форма открыта в текущем сеансе.

❓ Почему при обращении к реквизиту формы возвращается Неопределено, хотя он заполнен?

Вероятные причины:

🔹 Реквизит объявлен, но не инициализирован (например, не установлено значение по умолчанию).
🔹 Ошибка в имени реквизита (регистр символов имеет значение!).
🔹 Реквизит является вычисляемым и его значение ещё не рассчитано. Попробуйте вызвать ЭтаФорма.Обновить() перед чтением.
🔹 Доступ осуществляется на клиенте, а реквизит доступен только на сервере (проверьте контекст выполнения).

Для диагностики используйте:

Сообщить(СтрШаблон("Реквизит '%1' существует: %2", "ИмяРеквизита", ?(ЭтаФорма.Метаданные().Реквизиты.Найти("ИмяРеквизита") <> Неопределено, "Да", "Нет")));

❓ Можно ли программно изменить значение реквизита формы, который помечен как "Только чтение"?

Да, но с оговорками:

🔧 На клиенте изменение заблокированного реквизита вызовет ошибку. Используйте серверные методы.
🔧 Для обхода ограничения можно временно снять флаг ТолькоЧтение:

ЭтаФорма.ЭлементыФормы.ПолеВвода1.ТолькоЧтение = Ложь; ЭтаФорма.ЭлементыФормы.ПолеВвода1.Значение = НовоеЗначение;

ЭтаФорма.ЭлементыФормы.ПолеВвода1.ТолькоЧтение = Истина;

⚠️ Изменение свойств элементов управления может нарушить логику работы формы. Используйте этот приём только в крайних случаях.

❓ Как получить значение реквизита формы в обработчике кнопки?

В обработчике нажатия кнопки (например, ПриНажатии) доступ к реквизитам осуществляется стандартными способами:

&НаКлиенте Процедура КнопкаСохранитьНажатие(Кнопка) // Получение реквизита ТекущаяСумма = ЭтаФорма.СуммаДокумента; // Получение значения из поля ввода Комментарий = ЭтаФорма.ЭлементыФормы.ПолеКомментария.Значение; // Дальнейшая обработка...

КонецПроцедуры

Если требуется серверная обработка, передайте данные через параметры:

&НаКлиенте Процедура КнопкаСохранитьНажатие(Кнопка) СообщитьОСохраненииНаСервере(ЭтаФорма.СуммаДокумента); КонецПроцедуры &НаСервере Процедура СообщитьОСохраненииНаСервере(Сумма) // Серверная логика...