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

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

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

1. Базовые методы: ЗначениеРеквизита() и прямой доступ к элементам

Начнем с самого простого и распространенного подхода — использования метода ЗначениеРеквизита(). Этот метод универсален и работает как для управляемых, так и для обычных форм, но имеет свои особенности в зависимости от контекста.

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

// Получение значения реквизита "Контрагент" из текущей формы ТекущийКонтрагент = ЭтотОбъект.ЗначениеРеквизита("Контрагент"); // Альтернативный вариант (короткая запись)

ТекущийКонтрагент = ЭтотОбъект.Контрагент;

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

// В модуле формы обычного приложения

ТекущийКонтрагент = ЗначениеРеквизита("Контрагент");

🔹 Плюсы метода: простой синтаксис, работает везде, поддерживает вложенные реквизиты (например, "Контрагент.ИНН").
🔸 Минусы: не всегда возвращает актуальное значение при динамических изменениях (требуется вызов Обновить()).
🔥 Важно: в управляемых формах ЗначениеРеквизита() может вернуть Неопределено, если реквизит не инициализирован в модуле объекта.

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

2. Работа с элементами формы: ПолучитьЭлемент() и свойство Значение

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

📝 Значение в элементе формы отличается от значения реквизита (например, пользователь изменил данные, но еще не сохранил).
🔄 Нужно работать с динамически созданными элементами, которые не привязаны к реквизитам объекта.
🎨 Требуется доступ к свойствам элемента (цвет, видимость, доступность).

Пример для управляемой формы:

// Получаем элемент формы по имени ЭлементКонтрагент = ЭтотОбъект.ПолучитьЭлемент("Контрагент"); // Читаем значение из элемента

ТекущийКонтрагент = ЭлементКонтрагент.Значение;

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

ЭлементКонтрагент = ЭлементыФормы.Контрагент.Значение;

Метод	Управляемая форма	Обычная форма	Когда использовать
`ЗначениеРеквизита()`	`ЭтотОбъект.ЗначениеРеквизита("Имя")`	`ЗначениеРеквизита("Имя")`	Для чтения данных реквизита объекта
`ПолучитьЭлемент()`	`ЭтотОбъект.ПолучитьЭлемент("Имя")`	`ЭлементыФормы.Имя`	Для работы с визуальными элементами
Прямой доступ	`ЭтотОбъект.Имя`	`РеквизитФормы.Имя`	Краткая запись для реквизитов

💡

Если элемент формы не найден, метод ПолучитьЭлемент() вернет Неопределено. Всегда проверяйте результат перед использованием: Если ЭлементКонтрагент = Неопределено Тогда...

3. Динамические реквизиты и табличные части: особенности чтения

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

Пример для управляемой формы:

// Получаем табличную часть ТабличнаяЧастьТовары = ЭтотОбъект.Товары; // Читаем значение из первой строки

ПервоеКоличество = ТабличнаяЧастьТовары[0].Количество;

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

// В модуле формы списка документов "ЗаказыПокупателей" ТекущийЗаказ = ЭтотОбъект.ВыбраннаяСтрока();

НомерЗаказа = ТекущийЗаказ.Номер;

⚠️ Внимание: При работе с табличными частями в обычных формах синтаксис отличается — используйте ЭлементыФормы.Товары.ТекущаяСтрока или обращайтесь по индексу: ЭлементыФормы.Товары.Строки[0].Количество.

📌 Для иерархических списков (дерево) используйте метод ПолучитьЭлементПоИдентификатору() с указанием пути.
🔄 Если табличная часть пуста, попытка обращения к строке вызовет ошибку. Всегда проверяйте количество строк: Если ТабличнаяЧастьТовары.Количество() > 0 Тогда...
🛠️ Для динамического обновления значений в таблице используйте событие ПриИзменении у колонки.

☑️ Работа с табличными частями

Проверить количество строкОбращаться по индексу [0], [1] и т.д.Использовать ТекущаяСтрока для активного элементаОбновлять форму после изменений

Выполнено: 0 / 4

4. Использование отладчика для поиска значений

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

Алгоритм действий:

Установите точку останова в модуле формы на строке, где должно считываться значение.
Запустите отладку (F5 или кнопка "Отладка" в конфигураторе).
В окне Отладка перейдите на вкладку Локальные переменные или Глобальные переменные.
Раскройте объект ЭтотОбъект (для управляемых форм) или ЭлементыФормы (для обычных).
Найдите нужный реквизит или элемент и проверьте его значение.

Пример того, что можно обнаружить с помощью отладчика:

🔍 Реквизит существует, но не инициализирован в модуле объекта.
🔄 Значение в элементе формы и реквизите объекта различаются (пользователь изменил данные, но не сохранил).
🚫 Доступ к реквизиту заблокирован правами или условиями видимости.

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

В пользовательском режиме отладчик можно открыть комбинацией клавиш Ctrl+Alt+Shift+F12 (для управляемых форм) или через меню Файл → Отладка. Если отладка заблокирована, проверьте настройки прав пользователя в конфигураторе.

Отладчик также полезен для пошагового выполнения кода — вы можете увидеть, как меняются значения реквизитов при переходе между строками программы. Например, если значение реквизита меняется в обработчике события ПриИзменении, но не сохраняется, отладчик покажет, на каком этапе происходит сброс.

5. События формы: когда и как читать значения

Значения реквизитов могут изменяться в зависимости от событий формы. Например, если пользователь изменил поле, но еще не нажал "Записать", значение в реквизите объекта останется прежним. Чтобы получить актуальные данные, нужно понимать, в каком событии выполняется ваш код.

Событие	Когда происходит	Где брать значение	Пример использования
`ПриОткрытии`	Форма загружается	Реквизит объекта или элемент формы	Инициализация полей по умолчанию
`ПриИзменении`	Пользователь изменил элемент	`Элемент.Значение`	Валидация введенных данных
`ПередЗаписью`	Перед сохранением объекта	Реквизит объекта	Проверка данных перед записью
`ПослеЗаписи`	Объект успешно сохранен	Реквизит объекта	Обновление связанных данных

Пример кода для события ПриИзменении:

Процедура КонтрагентПриИзменении(Элемент) // Получаем новое значение из элемента формы НовыйКонтрагент = Элемент.Значение; // Обновляем связанные поля (например, ИНН) Если НовыйКонтрагент.Ссылка.Пустая() Тогда ЭтотОбъект.ИНН = ""; Иначе ЭтотОбъект.ИНН = НовыйКонтрагент.ИНН; КонецЕсли;

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

⚠️ Внимание: В событии ПередЗаписью изменения реквизитов объекта не отразятся в базе данных, если в обработчике возникнет ошибка. Всегда используйте конструкцию Попытка...Исключение для критичных операций.

💡

Для динамического обновления связанных полей (например, подстановки ИНН при выборе контрагента) используйте событие ПриИзменении у элемента формы, а не у реквизита объекта.

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

Даже опытные разработчики сталкиваются с проблемами при чтении значений реквизитов. Вот наиболее распространенные ошибки и способы их исправления:

🚨 "Неопределено" вместо значения
Причина: реквизит не инициализирован в модуле объекта или не существует.
Решение: проверьте имя реквизита в конфигураторе (регистр важен!) и убедитесь, что он добавлен в форму. Для динамических реквизитов используйте ЭтотОбъект.РеквизитФормы.Имя.
🔄 Значение в элементе и реквизите различаются
Причина: пользователь изменил данные в форме, но не сохранил объект.
Решение: используйте Элемент.Значение для текущего состояния или Обновить() для синхронизации.
🔒 Нет доступа к реквизиту
Причина: права пользователя ограничивают чтение/запись.
Решение: проверьте роли в конфигураторе или используйте Попытка...Исключение для обработки ошибок.
📉 Значение сбрасывается после обновления формы
Причина: в событии ПриАктивизацииСтроки или Обновить() происходит перезапись данных.
Решение: сохраняйте критичные значения в переменные или используйте флаг Модифицированность.

Если проблема не решается стандартными методами, воспользуйтесь журналом регистрации (Администрирование → Журнал регистрации) или тестированием и исправлением (Конфигуратор → Администрирование → Тестирование и исправление). Эти инструменты помогут выявить системные ошибки или конфликты в коде.

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

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

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

// Имя реквизита хранится в переменной ИмяРеквизита = "Контрагент"; // Получаем значение динамически

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

Для работы с составными реквизитами (например, "Контрагент.ИНН") используйте функцию ЗначениеЗаполнено() и цепочку обращений:

Если ЗначениеЗаполнено(ЭтотОбъект.Контрагент) Тогда
ИНН = ЭтотОбъект.Контрагент.ИНН;
КонецЕсли;

Для перебора всех реквизитов формы можно использовать Метаданные():

// Получаем коллекцию реквизитов формы РеквизитыФормы = ЭтотОбъект.Метаданные().Реквизиты; // Перебираем и выводим значения Для Каждого Реквизит Из РеквизитыФормы Цикл Сообщить(Реквизит.Имя + ": " + ЭтотОбъект[Реквизит.Имя]);

КонецЦикла;

⚠️ Внимание: Динамический доступ к реквизитам (Объект[Имя]) работает медленнее прямого обращения и может вызвать ошибку, если реквизит не существует. Всегда проверяйте наличие реквизита через Метаданные().

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

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

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

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

Для взаимодействия между формами используйте параметры формы или глобальные переменные. Пример:

В исходной форме при открытии второй формы передайте значение через параметр:

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

Во второй форме получите значение из параметров:

// В модуле формы при открытии Процедура ПриОткрытии(Отказ, СтандартнаяОбработка) Если Параметры.Контрагент <> Неопределено Тогда ЭтотОбъект.Контрагент = Параметры.Контрагент; КонецЕсли;

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

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

Почему ЗначениеРеквизита() возвращает Неопределено, хотя реквизит есть в форме?

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

🔹 Реквизит добавлен в форму, но не существует в объекте (например, это вычисляемое поле).
🔹 Вы обращаетесь к реквизиту до его инициализации (например, в событии ПриСозданииНаСервере).
🔹 Реквизит является динамическим и создается только при определенных условиях.

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

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

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

Передайте нужные данные в задание через параметры:

Параметры = Новый Структура("ДокументСсылка", ЭтотОбъект.Ссылка);
ВыполнитьФоновоеЗадание("ОбработкаДокумента", Параметры);

В обработчике фонового задания загрузите объект по ссылке и читайте реквизиты:

Процедура ОбработкаДокумента(Параметры) Экспорт
Документ = Параметры.ДокументСсылка.ПолучитьОбъект();
Контрагент = Документ.Контрагент;
КонецПроцедуры

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

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

Да, но с учетом особенностей форм списков. В форме списка документов (например, "Документ.ЗаказПокупателя.ФормаСписка") текущий объект доступен через ВыбраннаяСтрока():

// В модуле формы списка
ТекущийЗаказ = ЭтотОбъект.ВыбраннаяСтрока();
Если ТекущийЗаказ <> Неопределено Тогда
НомерЗаказа = ТекущийЗаказ.Номер;
ДатаЗаказа = ТекущийЗаказ.Дата;
КонецЕсли;

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

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

Артикул = ТекущаяСтрока.Артикул;

Как отладить чтение реквизитов в расширении конфигурации?

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

🔧 Убедитесь, что расширение подключено к базе данных (Конфигуратор → Расширения).
🔍 Для отладки используйте точки останова в модуле расширения, а не в основной конфигурации.
📌 Если реквизит не виден, проверьте, что он экспортирован в расширение (в свойствах реквизита должен быть флаг Включать в расширение).

Пример кода в расширении для чтения реквизита:

// В модуле формы расширения Процедура ПриОткрытии(Отказ, СтандартнаяОбработка) // Получаем основной объект формы ОсновнойОбъект = ЭтотОбъект.Объект; // Читаем реквизит через основной объект Контрагент = ОсновнойОбъект.Контрагент;

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

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

1. Базовые методы: ЗначениеРеквизита() и прямой доступ к элементам

2. Работа с элементами формы: ПолучитьЭлемент() и свойство Значение

3. Динамические реквизиты и табличные части: особенности чтения

☑️ Работа с табличными частями

4. Использование отладчика для поиска значений

5. События формы: когда и как читать значения

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

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

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

📖 Читайте также