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

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

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

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

Что такое реквизит формы в 1С 8.3 и как он работает

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

Основные характеристики реквизитов формы:

• 🔹 Тип данных: может быть любым — от простых (число, строка) до сложных (таблица значений, динамический список)
• 🔹 Источник: может быть привязан к реквизиту объекта или существовать независимо
• 🔹 Видимость: управляется через свойства формы и может изменяться динамически
• 🔹 События: поддерживает обработчики (например, ПриИзменении)

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

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

Существует несколько способов получить значение реквизита формы в 1С 8.3, и выбор метода зависит от контекста. Рассмотрим основные подходы с примерами кода.

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

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

2. Через метод ЗначениеРеквизита() — универсальный способ, работающий и для динамически созданных реквизитов:

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

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

// Если реквизит привязан к объекту
ОбъектФормы = ЭтаФорма.Объект;
СуммаИзОбъекта = ОбъектФормы.СуммаДокумента;

Установка значений реквизитов формы программно

Установка значений реквизитов формы требует внимания к типу данных и контексту выполнения. Основные методы:

1. Прямое присваивание (самый распространенный способ):

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

2. Через метод УстановитьЗначениеРеквизита():

ЭтаФорма.УстановитьЗначениеРеквизита("СтатусОплаты", "Оплачено");

3. Для реквизитов с типом "Таблица значений":

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

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

// Некорректно (вызовет ошибку):
ЭтаФорма.СписокТоваров[0].Цена = 1000;

// Корректно:
ОбъектФормы = ЭтаФорма.Объект;
ОбъектФормы.Товары[0].Цена = 1000;

Тип данных реквизита соответствует устанавливаемому значению|

Реквизит существует в форме (проверка через ЭтаФорма.РеквизитФормыСуществует())|

Для привязанных реквизитов изменение не конфликтует с бизнес-логикой|

Установка происходит в правильном контексте (не в транзакции, если это не требуется)-->

Работа с реквизитами формы в событиях

Обработчики событий формы — идеальное место для манипуляции реквизитами. Рассмотрим ключевые события и примеры их использования.

1. Событие ПриСозданииНаСервере — для инициализации значений:

&НаСервере
Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)
ЭтаФорма.ДатуДокумента = ТекущаяДату();
ЭтаФорма.Автор = ПользователиИнформационнойБазы.ТекущийПользователь();
КонецПроцедуры

2. Событие ПриИзменении — для реакции на изменения пользователя:

&НаКлиенте
Процедура КоличествоПриИзменении(Элемент)
Если ЭтаФорма.Количество > 10 Тогда
ЭтаФорма.Цена = ЭтаФорма.Цена * 0.9; // Скидка 10% при оптовой покупке
КонецЕсли;
КонецПроцедуры

3. Событие ПередЗаписью — для валидации данных:

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

Например, обращение к базе данных возможно только в серверных процедурах:

// Это вызовет ошибку на клиенте!
&НаКлиенте
Процедура НекорректныйПример(Элемент)
Справочник = Справочники.Номенклатура.НайтиПоНаименованию("Товар"); // Ошибка!
КонецПроцедуры

Типичные ошибки при работе с реквизитами формы

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

1. Ошибка "Реквизит не найден":

• 🔴 Причина: Опечатка в имени реквизита или попытка обратиться к несуществующему реквизиту
• 🟢 Решение: Используйте РеквизитФормыСуществует() для проверки:

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

2. Ошибка приведения типов:

• 🔴 Причина: Попытка присвоить значение несовместимого типа (например, строку в числовой реквизит)
• 🟢 Решение: Явное приведение типов или проверка перед присваиванием:

Попытка
ЭтаФорма.ЧисловойРеквизит = "123"; // Вызовет ошибку
Исключение
ЭтаФорма.ЧисловойРеквизит = Число("123"); // Корректное приведение
КонецПопытки;

3. Зацикливание в событиях ПриИзменении:

• 🔴 Причина: В обработчике ПриИзменении меняется тот же реквизит, что вызывает рекурсивный вызов
• 🟢 Решение: Используйте флаг для контроля рекурсии:

Перем ФлагИзменения;

&НаКлиенте
Процедура ЦенаПриИзменении(Элемент)
Если НЕ ФлагИзменения Тогда
ФлагИзменения = Истина;
ЭтаФорма.Сумма = ЭтаФорма.Цена * ЭтаФорма.Количество;
ФлагИзменения = Ложь;
КонецЕсли;
КонецПроцедуры

Продвинутые техники работы с реквизитами

Для сложных сценариев стандартных методов может быть недостаточно. Рассмотрим продвинутые подходы:

1. Динамическое создание реквизитов:

// Создание нового реквизита формы программно
НовыйРеквизит = ЭтаФорма.Реквизиты.Добавить("ДинамическийРеквизит");
НовыйРеквизит.Тип = Новый ОписаниеТипов("Число");
ЭтаФорма.УстановитьЗначениеРеквизита("ДинамическийРеквизит", 100);

2. Работа с реквизитами через ПараметрыФормы:

// Передача параметров при открытии формы
Параметры = Новый Структура("Режим,ДополнительнаяИнформация", "Просмотр", "Важные данные");
ОткрытьФорму("Документ.РеализацияТоваровУслуг.ФормаОбъекта", , Параметры);

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

3. Использование КонтекстФормы для сложных сценариев:

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

4. Оптимизация производительности при работе с большим количеством реквизитов:

• 🚀 Используйте ПриостановитьОбновлениеОтображения() для пакетных изменений:

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

Отладка и диагностика проблем с реквизитами

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

1. Проверка существования реквизита:

Сообщить(?("Реквизит существует: " + ЭтаФорма.РеквизитФормыСуществует("ИмяРеквизита"), "", ""));

2. Анализ типа данных:

Если ТипЗнч(ЭтаФорма.ИмяРеквизита) <> Тип("Число") Тогда
Сообщить("Ожидался числовой тип, получен: " + ТипЗнч(ЭтаФорма.ИмяРеквизита));
КонецЕсли;

3. Просмотр всех реквизитов формы:

Для Каждого Реквизит Из ЭтаФорма.Реквизиты Цикл
Сообщить(Реквизит.Имя + ": " + ЭтаФорма.ЗначениеРеквизита(Реквизит.Имя));
КонецЦикла;

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

• 🛠️ Установите точку останова в коде
• 🛠️ Просмотрите значение реквизита в Локальные переменные
• 🛠️ Отследите цепочку вызовов, приведшую к ошибке

Для сложных случаев полезно вести журнал изменений:

Процедура ЗаписатьВЖурнал(Сообщение)
ФайлЖурнала = Новый ЗаписьТекста(КаталогВременныхФайлов() + "ФормаЛог.txt", КодировкаТекста.UTF8, Истина);
ФайлЖурнала.ЗаписатьСтроку(Формат(ТекущаяДату(), "ДФ=dd.MM.yyyy HH:mm:ss") + " | " + Сообщение);
ФайлЖурнала.Закрыть();
КонецПроцедуры

// Использование:
ЗаписатьВЖурнал("Изменен реквизит Цена: старое=" + СтароеЗначение + ", новое=" + НовоеЗначение);

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

Процедура ОбработатьФорму(ФормаДляОбработки)
Значение = ФормаДляОбработки.ЗначениеРеквизита("ИмяРеквизита");
//.. обработка..
КонецПроцедуры

// Вызов:
ОбработатьФорму(ЭтаФорма);

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

ЭтаФорма.Элементы.ИмяСписка.Список.Перечитать();

ЭтаФорма.Элементы.ИмяТаблицы.ТолькоПросмотр = Истина;