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

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

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

1. Базовый способ: получение значения через ЭлементыФормы

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

Для управляемых форм код будет выглядеть так:

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

Для обычных форм (тонкий клиент, толстый клиент):

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

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

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

• ✅ Работает во всех типах форм
• ✅ Простой и интуитивно понятный синтаксис
• ⚠️ Требует проверки на существование элемента в динамических формах
• ⚠️ Не подходит для получения значений реквизитов формы (только элементов)

2. Работа с реквизитами формы: когда ЭлементыФормы не подходят

Не все данные на форме хранятся в элементах интерфейса. Часто значения привязаны к реквизитам формы — внутренним переменным, которые могут не иметь визуального представления. Например, в форме документа "Заказ клиента" реквизит СуммаДокумента может рассчитываться автоматически и не отображаться как поле для ввода.

Чтобы получить значение реквизита, используйте коллекцию РеквизитыФормы:

СуммаЗаказа = РеквизитыФормы.СуммаДокумента;

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

⚠️ Внимание: Если реквизит формы имеет тип СправочникСсылка.Номенклатура или другой ссылочный тип, его значение может быть Неопределено, даже если поле на форме пустое. Всегда проверяйте тип значения перед использованием:

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

3. Получение значений из табличных частей и динамических списков

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

Для табличной части документа:

ТабличнаяЧасть = ЭлементыФормы.Товары;
// Получаем значение из первой строки, колонки "Количество"
ПервоеКоличество = ТабличнаяЧасть.Получить(0).Количество;

Для динамического списка (например, список справочника "Номенклатура"):

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

Проверьте, что таблица не пустая (ТабличнаяЧасть.Количество() > 0)

Используйте Получить() для доступа к строке по индексу

Для динамических списков сначала получите ВыделенныеСтроки или ТекущаяСтрока

Учитывайте, что индексация начинается с 0-->

Особое внимание уделите текущей строке — часто требуется получить значение именно из неё, а не из произвольной. Для этого используйте:

ТекущаяСтрока = ЭлементыФормы.Товары.ТекущаяСтрока;
Если ТекущаяСтрока <> Неопределено Тогда
ТекущееКоличество = ТекущаяСтрока.Количество;
КонецЕсли;

Табличные части документов|Динамические списки справочников|Таблицы значений на форме|Отчёты с детализацией-->

4. Работа с формами в модуле объекта: ЭтотОбъект vs. ЭлементыФормы

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

Пример для документа "РеализацияТоваровУслуг":

// Получаем реквизит объекта (не формы!)
ДатаДокумента = ЭтотОбъект.Дата;
СуммаДокумента = ЭтотОбъект.СуммаДокумента;

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

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

Пример для обработчика "Перед записью":

Процедура ПередЗаписью(Отказ, ПараметрыЗаписи)
// Получаем форму из параметров
ТекущаяФорма = ПараметрыЗаписи.Форма;
ЗначениеСФормы = ТекущаяФорма.ЭлементыФормы.ПолеВвода1.Значение;
КонецПроцедуры

⚠️ Внимание: В модуле объекта ЭтотОбъект и Объект — это одно и то же. Но если вы работаете в модуле формы, то ЭтотОбъект ссылается на саму форму, а не на объект данных. Это частая причина ошибок у начинающих разработчиков!

5. Продвинутые методы: контекст формы, API и события

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

• 🔹 Контекст формы: доступ через ПолучитьФорму() или ОткрытыеФормы
• 🔹 API формы: методы ПолучитьАтрибут(), УстановитьАтрибут()
• 🔹 Обработчики событий: ПриИзменении, ПриАктивизацииСтроки

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

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

Для работы с внешними обработками или расширениями часто используют метод ПолучитьФорму():

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

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

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

Процедура ПолеВводаКоличествоПриИзменении(Элемент)
ТекущееКоличество = Элемент.Значение;
Если ТекущееКоличество > 100 Тогда
Сообщить("Превышено максимальное количество!");
КонецЕсли;
КонецПроцедуры

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

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

1. Неопределено вместо значения поля

   Причина: поле не существует на форме или не видно в текущем контексте. Решение — проверяйте существование элемента через Свойство() или НайтиПоИмени().

2. Ошибка "Объект не найден"

   Причина: попытка получить доступ к форме, которая не открыта. Решение — используйте ОткрытыеФормы.НайтиПоИмени() с проверкой на Неопределено.

3. Значение не обновляется после изменения

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

4. Несоответствие типов данных

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

   Количество = Число(ЭлементыФормы.ПолеКоличество.Значение);

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

⚠️ Внимание: В веб-клиенте и мобильном приложении некоторые методы работы с формами могут быть ограничены по сравнению с толстым клиентом. Например, динамическое создание элементов формы в веб-клиенте требует особого подхода. Всегда тестируйте код в целевой среде!

7. Практические примеры для разных сценариев

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

Пример 1: Получение значения из поля ввода при нажатии кнопки

Задача: при нажатии на кнопку "Рассчитать" получить значение из поля "Цена", умножить его на "Количество" и вывести результат в поле "Сумма".

Процедура КнопкаРассчитатьНажатие(Кнопка)
Цена = ЭлементыФормы.ПолеЦена.Значение;
Количество = ЭлементыФормы.ПолеКоличество.Значение;
Если ТипЗнч(Цена) = Тип("Число") И ТипЗнч(Количество) = Тип("Число") Тогда
ЭлементыФормы.ПолеСумма.Значение = Цена * Количество;
Иначе
Сообщить("Некорректные данные в полях Цена или Количество!");
КонецЕсли;
КонецПроцедуры

Пример 2: Получение всех выделенных строк в динамическом списке

Задача: при нажатии на кнопку "Экспортировать" получить все выделенные строки из списка "Номенклатура" и вывести их наименования в сообщение.

Процедура КнопкаЭкспортироватьНажатие(Кнопка)
Список = ЭлементыФормы.СписокНоменклатуры;
ВыделенныеСтроки = Список.ВыделенныеСтроки;
Сообщение = "";
Для Каждого Строки Из ВыделенныеСтроки Цикл
Сообщение = Сообщение + Строки.Наименование + "; ";
КонецЦикла;
Сообщить(Сообщение);
КонецПроцедуры

Пример 3: Получение значения из формы в внешней обработке

Задача: из внешней обработки получить значение поля "ДатаДокумента" из открытой формы документа "ПоступлениеТоваров".

Процедура ПолучитьДатаИзФормы()
ФормаДокумента = ОткрытыеФормы.НайтиПоИмени("Документ.ПоступлениеТоваровУслуг.ФормаОбъекта");
Если ФормаДокумента <> Неопределено Тогда
ДатаДокумента = ФормаДокумента.ЭлементыФормы.ДатаДокумента.Значение;
Сообщить("Дата документа: " + Формат(ДатаДокумента, "ДФ=dd.MM.yyyy"));
Иначе
Сообщить("Форма не найдена!");
КонецЕсли;
КонецПроцедуры

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

ЗначениеПоля = ЭлементыФормы.Закладка2.ПолеВвода1.Значение;

СсылкаНаНоменклатуру = ЭлементыФормы.ПолеНоменклатура.Значение; // Ссылка
Наименование = ЭлементыФормы.ПолеНоменклатура.Отображение; // Строка

Процедура ПриОткрытии()
ЗначениеПоля = ЭлементыФормы.ПолеВвода1.Значение;
КонецПроцедуры

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