В процессе разработки в среде 1С:Предприятие 8.3, особенно при создании расширений конфигураций, часто возникает необходимость программного добавления новых полей на управляемую форму. Типичная проблема, с которой сталкиваются разработчики — созданное поле отображается на форме, но введенные пользователем данные не сохраняются в базе данных или вовсе недоступны для изменения. В этой статье мы подробно разберем, почему возникает эта ошибка, как правильно связать элемент формы с данными объекта и как оптимизировать код, избежав критических архитектурных ошибок.
Рассмотрим стандартную ситуацию. Разработчик программно создает элемент формы (поле ввода) в процедуре ПриСозданииНаСервере общего модуля или модуля формы. При этом в метаданных справочника (например, «Номенклатура») уже существует необходимый реквизит.
Основная ошибка кроется в неверной привязке элемента формы к данным объекта. Автор темы в своем исходном коде указал:
ЭлементФормы.ПутьКДанным = "Реквизит";
При такой настройке платформа пытается связать элемент с локальным реквизитом самой управляемой формы с именем Реквизит. Однако этот локальный реквизит никак не связан с основным реквизитом объекта базы данных (Объект.Реквизит), который отвечает за запись данных в СУБД. В результате пользователь видит поле на форме, но данные «виснут» в оперативной памяти формы и не уходят в объект при записи.
Выясним причину этой ошибки. На управляемой форме основным источником данных выступает реквизит с типом ДанныеФормыСтруктура (обычно он называется Объект для документов и справочников). Все реквизиты объекта базы данных доступны на форме именно через эту структуру. Следовательно, правильный путь к данным для элемента формы обязательно должен содержать префикс главного реквизита.
Для решения проблемы достаточно указать верный путь к данным в виде строки:
ЭлементФормы.ПутьКДанным = "Объект.Реквизит";
Обратите внимание, что свойство ПутьКДанным принимает именно строковое значение, а не ссылку на сам объект. Попытка написать Форма.Объект.Реквизит вызовет ошибку компиляции на сервере, так как это свойство ожидает имя пути в виде текста.
Проанализируем исходный код автора темы более глубоко. В самом начале процедуры выполняется добавление нового реквизита на форму:
Реквизит_Реквизит = Новый РеквизитФормы("Реквизит", Новый ОписаниеТипов("СправочникСсылка.__Реквизиты"), , "Реквизит");
ДобавляемыеРеквизиты.Добавить(Реквизит_Реквизит);
Форма.ИзменитьРеквизиты(ДобавляемыеРеквизиты);
Важное правило: если реквизит уже добавлен в метаданные объекта (в конфигураторе основной базы или в самом расширении), он автоматически присутствует на управляемой форме в составе структуры Объект. Вызов метода Форма.ИзменитьРеквизиты() в данном случае абсолютно избыточен!
Создавая локальный реквизит формы с именем Реквизит, мы дублируем данные, выделяя под них дополнительную память на сервере и клиенте. Локальный реквизит формы Форма.Реквизит и реквизит объекта Объект.Реквизит будут существовать параллельно и никак не свяжутся между собой автоматически.
Как сделать правильно: если реквизит есть в метаданных, блок кода с ИзменитьРеквизиты необходимо полностью удалить. Достаточно лишь программно создать элемент формы (поле ввода) и привязать его к существующим данным объекта.
Рассмотрим правильный алгоритм программного вывода поля на форму из общего модуля. Этот код рекомендуется размещать в обработчике события формы ПриСозданииНаСервере (например, через механизм &После в расширении конфигурации).
Шаг 1. Проверка существования элемента. Чтобы избежать ошибок при повторном открытии формы или динамическом обновлении интерфейса, всегда проверяйте, не был ли элемент создан ранее.
Шаг 2. Определение родительской группы. Находим группу формы, в которую будет помещено новое поле ввода.
Шаг 3. Создание элемента и привязка к данным. Создаем элемент управления и связываем его с реквизитом объекта через свойство ПутьКДанным.
Посмотрим на готовый и оптимизированный пример кода:
Процедура Расш1_ПриСозданииНаСервереПосле(Отказ, СтандартнаяОбработка)
// Определяем родительскую группу на форме, куда добавим новое поле
ГруппаФормы = Элементы.СворачиваемаяГруппаКлассификаторы;
Если ГруппаФормы <> Неопределено Тогда
ИмяЭлемента = "Расш1_РеквизитНоменклатуры";
// Проверяем, чтобы элемент не был создан ранее
Если Элементы.Найти(ИмяЭлемента) = Неопределено Тогда
// Добавляем новый элемент формы типа ПолеФормы в найденную группу
НовыйЭлемент = Элементы.Добавить(ИмяЭлемента, Тип("ПолеФормы"), ГруппаФормы);
НовыйЭлемент.Вид = ВидПоляФормы.ПолеВвода;
// Связываем элемент с существующим реквизитом объекта базы данных
НовыйЭлемент.ПутьКДанным = "Объект.Реквизит";
НовыйЭлемент.Заголовок = "Дополнительный реквизит";
КонецЕсли;
КонецЕсли;
КонецПроцедуры
Использование метода ИзменитьРеквизиты оправдано только в том случае, если вам необходимо создать «виртуальный» реквизит формы, которого вообще нет в базе данных (в метаданных конфигурации). Это может быть временный флажок, переключатель режимов отображения или поле для ввода промежуточных расчетных данных, которые не нужно сохранять.
В такой ситуации порядок действий будет следующим:
РеквизитФормы.Форма.ИзменитьРеквизиты().ПутьКДанным элемента к только что созданному реквизиту формы напрямую (без префикса Объект, например: Элемент.ПутьКДанным = "ИмяЛокальногоРеквизита").Разберем пример создания такого локального реквизита формы:
// 1. Создаем массив добавляемых реквизитов
ДобавляемыеРеквизиты = Новый Массив;
// 2. Описываем локальный реквизит формы (например, временный флажок)
ОписаниеТипаБулево = Новый ОписаниеТипов("Булево");
НовыйРеквизит = Новый РеквизитФормы("ВременныйФлаг", ОписаниеТипаБулево, , "Показать скрытые данные");
ДобавляемыеРеквизиты.Добавить(НовыйРеквизит);
// 3. Добавляем реквизит на форму
Форма.ИзменитьРеквизиты(ДобавляемыеРеквизиты);
// 4. Создаем элемент интерфейса для этого реквизита
НовыйЭлемент = Форма.Элементы.Добавить("ПолеВременныйФлаг", Тип("ПолеФормы"), РодительскаяГруппа);
НовыйЭлемент.Вид = ВидПоляФормы.ПолеФлажка;
// 5. Указываем путь к данным (без префикса "Объект")
НовыйЭлемент.ПутьКДанным = "ВременныйФлаг";
При программном изменении состава управляемых форм (особенно в расширениях) необходимо соблюдать правила хорошего тона в разработке, чтобы избежать сбоев при обновлении типовых конфигураций:
Расш1_ПолеВвода). Если вендор добавит в типовую конфигурацию элемент с таким же именем, ваша база данных выдаст критическую ошибку при обновлении из-за конфликта имен.Объект.МойРеквизит), обязательно убедитесь, что у пользователей настроены права на этот реквизит в ролях расширения. Если у пользователя нет прав «Просмотр» или «Редактирование» на этот реквизит базы данных, элемент формы либо вообще не отобразится, либо будет недоступен для изменения, а система может выдать предупреждение о недопустимом пути к данным.ПриСозданииНаСервере). Попытки вызвать добавление элементов на клиенте в процедуре ПриОткрытии приведут к аварийному завершению работы интерфейса.Соблюдение этих простых правил и понимание архитектуры работы управляемых форм 1С позволит вам создавать стабильный, легко поддерживаемый код и избегать досадных ошибок с потерей данных пользователей.