Создание реквизита формы в 1С программно: от теории к практике

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

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

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

1. Способы создания реквизита формы: обзор вариантов

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

• 🔹 Добавление через коллекцию Реквизиты — классический метод для обычных форм, работает во всех версиях платформы. Подходит для простых случаев, когда нужно быстро добавить поле.
• 🔹 Использование ДобавитьРеквизит() — более современный способ, рекомендуемый для управляемых форм. Позволяет гибко настраивать свойства реквизита.
• 🔹 Динамическое создание элементов управления — когда реквизит привязан к визуальному компоненту (поле ввода, флажок и т.д.). Требует синхронизации с данными.

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

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

2. Создание реквизита в управляемой форме

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

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

В этом примере мы:

1. Добавляем реквизит НовыйРеквизит типа Строка.
2. Создаём элемент формы (поле ввода) и привязываем его к реквизиту.
3. Делаем элемент видимым.

Обратите внимание: если не указать Видимость = Истина, поле будет создано, но не отобразится пользователю. Также важно правильно задать тип значения — например, для даты используйте Новый ОписаниеТипов("Дата").

⚠️ Внимание: В управляемых формах нельзя добавлять реквизиты с именами, совпадающими с существующими реквизитами объекта или формы. Это приведёт к конфликту и ошибке выполнения.

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

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

3. Работа с обычными формами: особенности и ограничения

В обычных формах (тонкий/толстый клиент) процесс добавления реквизита отличается. Здесь используется коллекция Реквизиты, и часто требуется ручная привязка к элементам управления. Пример:

Процедура ДобавитьРеквизитВОбычнуюФорму(Форма)
// Добавляем реквизит в коллекцию
Реквизит = Форма.Реквизиты.Добавить("ДинамическийРеквизит");
Реквизит.ТипЗначения = Новый ОписаниеТипов("Число");

// Создаём поле ввода и привязываем к реквизиту
ПолеВвода = Форма.ЭлементыФормы.Добавить("ПолеДинамическийРеквизит",
Тип("ПолеВвода"),
Форма.ЭлементыФормы.ГруппаЭлементов1);
ПолеВвода.Данные = Форма.Реквизиты.ДинамическийРеквизит;
ПолеВвода.Видимость = Истина;
КонецПроцедуры

Ключевые отличия от управляемых форм:

• 🔸 Нужно явно указывать контейнер (например, ГруппаЭлементов1), куда будет помещён новый элемент.
• 🔸 Привязка данных осуществляется через свойство Данные, а не автоматически.
• 🔸 Для отображения может потребоваться вызов ОбновитьФорму().

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

⚠️ Внимание: В обычных формах динамически созданные реквизиты не поддерживают все типы значений. Например, нельзя добавить реквизит типа ТаблицаЗначений или ДеревоЗначений — это вызовет исключение.

4. Динамическое создание элементов управления

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

Пример добавления флажка (ПолеФлажка) на управляемую форму:

Процедура ДобавитьФлажокНаФорму(Форма)
// 1. Добавляем реквизит типа Булево
Форма.ДобавитьРеквизит("ФлажокАктивен", Новый ОписаниеТипов("Булево"));

// 2. Создаём элемент управления "Флажок"
ЭлементФормы = Форма.ЭлементыФормы.Добавить("ФлажокАктивен",
Тип("ПолеФлажка"),
Форма.ЭлементыФормы.Группа1);
ЭлементФормы.Данные = Форма.Реквизиты.ФлажокАктивен;
ЭлементФормы.Заголовок = "Активен";
ЭлементФормы.Видимость = Истина;
КонецПроцедуры

Для разных типов элементов управления используются разные классы:

• 📝 ПолеВвода — для строк и чисел.
• 🗓️ ПолеКалендаря — для дат.
• 🔘 ПолеФлажка — для булевых значений.
• 📋 ПолеТаблицы — для табличных данных.

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

Имя реквизита уникально|Тип реквизита соответствует типу элемента|Элемент добавляется в существующий контейнер|Установлена видимость элемента-->

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

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

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

• 💾 Хранить данные в реквизитах объекта (если форма привязана к справочнику, документу и т.д.).
• 📄 Сохранять в настройках пользователя или регистре сведений.
• 🔄 Сериализовать данные в строку (например, в JSON) и сохранять в стандартном реквизите.

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

6. Практический пример: добавление реквизита с привязкой к справочнику

Рассмотрим реальный пример: добавим на форму документа ЗаказПокупателя реквизит ОтветственныйМенеджер, который будет ссылаться на справочник Пользователи. Код для управляемой формы:

Процедура ДобавитьОтветственногоМенеджера(Форма)
// 1. Определяем тип данных (ссылка на справочник "Пользователи")
ТипМенеджера = Новый ОписаниеТипов("СправочникСсылка.Пользователи");

// 2. Добавляем реквизит
Форма.ДобавитьРеквизит("ОтветственныйМенеджер", ТипМенеджера);

// 3. Создаём поле выбора и настраиваем его
ПолеВыбора = Форма.ЭлементыФормы.Добавить("ОтветственныйМенеджер",
Тип("ПолеВвода"),
Форма.ЭлементыФормы.ГруппаРеквизитов);
ПолеВыбора.Данные = Форма.Реквизиты.ОтветственныйМенеджер;
ПолеВыбора.Видимость = Истина;
ПолеВыбора.Заголовок = "Ответственный менеджер";

// 4. Настраиваем выбор из справочника
ПолеВыбора.ВыборИзСправочника = Истина;
ПолеВыбора.ПутьКДанным = "Справочник.Пользователи";
КонецПроцедуры

В этом примере:

• 🔹 Мы явно указали тип СправочникСсылка.Пользователи для реквизита.
• 🔹 Использовали ПолеВвода с включённой опцией ВыборИзСправочника.
• 🔹 Задали ПутьКДанным, чтобы при нажатии на кнопку выбора открывался справочник Пользователи.

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

7. Оптимизация и производительность

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

• 🚀 Минимизируйте количество динамических реквизитов. Если реквизит нужен постоянно, добавьте его в конфигурацию.
• 🔄 Используйте кэширование. Если реквизиты добавляются при каждом открытии формы, сохраните их в настройках сеанса.
• 📊 Группируйте элементы. Добавляйте связанные реквизиты в одну группу элементов — это уменьшит количество обновлений интерфейса.
• 🧹 Удаляйте ненужные реквизиты. Если реквизит больше не нужен, удалите его с помощью Форма.Реквизиты.Удалить().

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

Пример оптимизированного кода для добавления нескольких реквизитов:

Процедура ДобавитьНесколькоРеквизитов(Форма)
// Отключаем обновление формы на время добавления
Форма.ОтключитьОбработкуСобытий();

// Добавляем реквизиты
Форма.ДобавитьРеквизит("Реквизит1", Новый ОписаниеТипов("Строка"));
Форма.ДобавитьРеквизит("Реквизит2", Новый ОписаниеТипов("Число"));

// Добавляем элементы управления
Форма.ЭлементыФормы.Добавить("Реквизит1", Тип("ПолеВвода"), Форма.ЭлементыФормы.Группа1);
Форма.ЭлементыФормы.Добавить("Реквизит2", Тип("ПолеВвода"), Форма.ЭлементыФормы.Группа1);

// Включаем обработку событий и обновляем форму
Форма.ВключитьОбработкуСобытий();
Форма.ОбновитьФорму();
КонецПроцедуры

Использование ОтключитьОбработкуСобытий() и ВключитьОбработкуСобытий() позволяет избежать многократных перерисовок формы при добавлении нескольких элементов.

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

ПараметрыСеанса.ДинамическиеРеквизиты = Новый Структура("Реквизит1, Значение1");

Форма.Реквизиты.Удалить("ИмяРеквизита");

Форма.ЭлементыФормы.Удалить("ИмяЭлемента");