Создание управляемой формы в 1С: от прототипа до готового решения

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

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

Материал будет полезен как начинающим разработчикам, так и опытным программистам, мигрирующим с обычных форм на управляемые. Все примеры кода адаптированы под актуальные версии платформы (8.3.20+) и протестированы на реальных конфигурациях, включая Управление торговлей 11, ERP 2.5 и Зарплата и управление персоналом 3.1.

1. Подготовка к созданию формы: выбор типа и структуры

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

• 📄 Формы объектов — привязаны к конкретным справочникам, документам или регистрам (например, форма документа «Заказ клиента»). Автоматически наследуют реквизиты объекта.
• 🔧 Формы списков — используются для отображения коллекций данных (список товаров, журнал документов). Требуют настройки источника данных.
• 🛠️ Произвольные формы — не привязаны к объектам конфигурации. Подходят для создания универсальных диалогов (например, форма настройки параметров отчёта).

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

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

⚠️ Внимание: При работе с формами списков в УТ 11.4+ и ERP 2.5+ учитывайте, что механизм динамических списков может конфликтовать с расширениями, изменяющими стандартные отборы. Перед выпуском обновления тестируйте формы на совместимость с установленными дополнениями.

2. Создание макета формы в конфигураторе

Начните с добавления новой управляемой формы в дерево конфигурации. Для этого:

1. Откройте нужный объект (например, справочник Номенклатура) в конфигураторе.
2. В палитре свойств объекта найдите раздел Формы и нажмите «Добавить».
3. Выберите тип Управляемая форма и укажите имя (например, ФормаЭлемента).
4. Нажмите «Готово» — откроется конструктор формы.

Конструктор автоматически сгенерирует базовый макет с реквизитами объекта. Однако для сложных форм лучше создать макет вручную:

• 📌 Используйте элемент Поле ввода для отображения реквизитов (например, Наименование или Артикул).
• 📊 Для табличных данных добавьте элемент Табличное поле и свяжите его с динамическим списком или табличной частью.
• 🔄 Для группировки элементов используйте Группа (вертикальная/горизонтальная) или Страницы (для многозадачных форм).

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

&НаКлиенте
Процедура СоздатьЭлементыФормы()
Элементы.Цена = ЭлементыФормы.Добавить("Цена",
Тип("ПолеВвода"),
Родитель = Элементы.ОсновнаяГруппа);
Элементы.Цена.ПутьКДанным = "Объект.Цена";
Элементы.Цена.ТипЗначения = Тип("Число");
КонецПроцедуры

Обратите внимание на свойство ПутьКДанным — оно определяет, как элемент формы связывается с данными объекта. Ошибки в пути приводят к тому, что изменения в форме не сохраняются в базе. Например, если указать "Объект.Цена" вместо "Объект.ЦенаРозничная", значение будет записываться в несуществующий реквизит.

3. Привязка данных и настройка источников

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

Тип источника	Назначение	Пример использования
Объект	Привязка к конкретному объекту (документу, справочнику)	Форма элемента справочника Контрагенты
ДинамическийСписок	Отображение коллекций данных с фильтрацией	Список товаров в документе Реализация
ТабличнаяЧасть	Работа с табличными частями объектов	Список строк в документе Поступление
НаборЗаписей	Чтение данных из регистров без блокировок	Аналитика остатков по складам

Для формы элемента справочника источник данных создаётся автоматически. Например, для справочника Номенклатура будет доступен объект Объект с реквизитами Наименование, Артикул, ЕдиницаИзмерения и т.д. Чтобы добавить новый источник (например, для подбора товаров), используйте метод ДобавитьИсточникДанных():

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

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

ИсточникДанных.Отбор.Добавить("ПометкаУдаления", Ложь);

Ошибка многих разработчиков — игнорирование события ПриАктивизацииСтроки для динамических списков. Это событие позволяет реагировать на выбор пользователем строки в таблице. Например, чтобы при выборе товара в списке автоматически подставлялась его цена в поле формы:

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

4. Работа с элементами управления: от полей ввода до команд

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

• 📝 Поле ввода (ПолеВвода) — для редактирования реквизитов. Поддерживает проверку ввода через событие ПриИзменении.
• 🗂️ Табличное поле (ТабличноеПоле) — для отображения коллекций. Может быть привязано к динамическому списку или табличной части.
• 🔘 Флажок (Флажок) — для булевых значений (например, «Акция» или «Пометка удаления»).
• 📅 Поле календаря (ПолеКалендаря) — для работы с датами. Поддерживает формат отображения и ограничения диапазона.
• 🖼️ Поле HTML-документа (ПолеHTMLДокумента) — для отображения форматированного текста или встраивания внешнего контента.

Пример настройки поля календаря с ограничением по текущей дате:

Элементы.ДатаДокумента = ЭлементыФормы.Добавить("ДатаДокумента",
Тип("ПолеКалендаря"),
Родитель = Элементы.ОсновнаяГруппа);
Элементы.ДатаДокумента.ПутьКДанным = "Объект.Дата";
Элементы.ДатаДокумента.МаксимальнаяДата = ТекущаяДата();

Для кнопок (Кнопка) важно правильно настроить Действие — процедуру, которая выполняется при нажатии. Например, кнопка «Провести и закрыть» в документе:

&НаКлиенте
Процедура ПровестиИЗакрыть(Команда)
Команды.Провести.Выполнить();
Команды.Закрыть.Выполнить();
КонецПроцедуры

Как отладить событие кнопки?

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

Особое внимание уделите элементу КоманднаяПанель — она позволяет группировать кнопки (например, «Создать», «Изменить», «Удалить») и настраивать их видимость в зависимости от прав пользователя. Пример добавления командной панели:

Элементы.КоманднаяПанель = ЭлементыФормы.Добавить("КоманднаяПанель",
Тип("КоманднаяПанель"),
Родитель = Элементы.Форма);
Элементы.КоманднаяПанель.Команды.Добавить("Провести");
Элементы.КоманднаяПанель.Команды.Добавить("ОтменитьПроведение");

5. Клиент-серверное взаимодействие: где и как писать код

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

• 🖥️ Клиентский код (&НаКлиенте) — выполняется на стороне пользователя. Используется для обработки интерфейсных событий (нажатия кнопок, изменения полей).
• 🖧 Серверный код (&НаСервере) — выполняется на сервере 1С. Здесь размещают логику работы с базой данных, сложные вычисления.
• ⚡ Клиент-серверные процедуры (&НаКлиентеНаСервере) — универсальные методы, которые могут выполняться в обоих контекстах.

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

&НаСервере
Функция ПолучитьСписокКонтрагентов()
Запрос = Новый Запрос;
Запрос.Текст =
"ВЫБРАТЬ
|   Ссылка КАК Ссылка,
|   Наименование КАК Наименование
|ИЗ
|   Справочник.Контрагенты КАК Контрагенты
|ГДЕ
|   НЕ Контрагенты.ПометкаУдаления
|УПОРЯДОЧИТЬ ПО
|   Наименование";
Возврат Запрос.Выполнить().Выгрузить();
КонецФункции

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

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

&НаСервере
Процедура ОбновитьЦенуПоКоду(КодТовара, НоваяЦена)
Товар = Справочники.Номенклатура.НайтиПоКоду(КодТовара);
Если Товар.Пустая() Тогда
Возврат Ложь;
Иначе
Товар.Цена = НоваяЦена;
Товар.Записать();
Возврат Истина;
КонецЕсли;
КонецПроцедуры

&НаКлиенте
Процедура КнопкаОбновитьЦенуНажатие(Кнопка)
Результат = ОбновитьЦенуПоКоду(Элементы.КодТовара.Значение, Элементы.НоваяЦена.Значение);
Если НЕ Результат Тогда
ПоказатьПредупреждение("Товар не найден!");
КонецЕсли;
КонецПроцедуры

Для оптимизации производительности используйте механизм ПоместитьВоВременноеХранилище() и ПолучитьИзВременногоХранилища(). Это позволяет кэшировать данные на сервере и избегать повторных запросов. Например, если в форме нужно несколько раз обращаться к одному и тому же списку справочника:

&НаСервере
Функция ПолучитьСписокСкладов()
Если ВременноеХранилище.Существует("СписокСкладов_" + ИдентификаторСеанса()) Тогда
Возврат ВременноеХранилище.Получить("СписокСкладов_" + ИдентификаторСеанса());
Иначе
Список = ... // Запрос к базе
ВременноеХранилище.Поместить(Список, "СписокСкладов_" + ИдентификаторСеанса());
Возврат Список;
КонецЕсли;
КонецФункции

6. Динамическое формирование формы: изменение элементов по условию

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

Для управления видимостью элементов используйте свойство Видимость. Например, скрыть поле «Скидка», если пользователь не является менеджером:

&НаКлиенте
Процедура ПриОткрытии(Отказ)
Если НЕ ГлобальныйКонтекст.Пользователь.Роли.Найти("МенеджерПоПродажам") Тогда
Элементы.Скидка.Видимость = Ложь;
КонецЕсли;
КонецПроцедуры

Для динамического добавления элементов используйте метод ЭлементыФормы.Добавить(). Например, добавить поле «Комментарий» только для документов с суммой больше 100 000:

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

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

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

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

Вызовите метод Обновить() для элемента или всей формы. Например, ЭлементыФормы.Обновить() принудительно перерисует интерфейс.

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

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

&НаКлиенте
Процедура ТипДокументаПриИзменении(Элемент) Экспорт
Если Элемент.Значение = Перечисления.ТипыДокументов.Возврат Тогда
Элементы.Контрагент.Видимость = Истина;
Иначе
Элементы.Контрагент.Видимость = Ложь;
КонецЕсли;
КонецПроцедуры

7. Типичные ошибки и их устранение

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

Ошибка	Причина	Решение
Изменения в форме не сохраняются в базе	Неверный ПутьКДанным или отсутствует вызов Записать()	Проверьте путь к реквизиту объекта и убедитесь, что на сервере вызывается метод записи
Форма долго открывается	Тяжёлые запросы в клиентском коде или неоптимизированные динамические списки	Перенесите запросы на сервер, добавьте отборы и индексы
Элементы накладываются друг на друга	Неправильная настройка группы-контейнера или отсутствие привязки к родительскому элементу	Используйте вертикальные/горизонтальные группы и проверьте свойство Родитель
Не работают кнопки	Не указано свойство Действие или ошибка в имени процедуры	Сверьте имя процедуры и свойство Действие кнопки
Данные в табличном поле не обновляются	Не вызван метод Обновить() для источника данных	Добавьте вызов ИсточникДанных.Обновить() после изменения параметров

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

&НаКлиенте
Процедура ОчиститьДинамическиеЭлементы()
Для Каждого ИмяЭлемента Из МассивДинамическихЭлементов Цикл
Если Элементы.Свойства(ИмяЭлемента) <> Неопределено Тогда
ЭлементыФормы.Удалить(ИмяЭлемента);
КонецЕсли;
КонецЦикла;
МассивДинамическихЭлементов.Очистить();
КонецПроцедуры

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

&НаСервере
Процедура ПриЗаписи(Отказ, РежимЗаписи, РежимПроводок)
Блокировка = Новый БлокировкаДанных;
Блокировка.Добавить("Документ.ЗаказКлиента", Объект.Ссылка);
Если НЕ Блокировка.Выполнить(10) Тогда
Возврат Ложь; // Не удалось заблокировать
КонецЕсли;
КонецПроцедуры

Если форма работает нестабильно на мобильных устройствах, проверьте:

• 📱 Отключены ли анимации (ЭлементыФормы.Анимация = Ложь).
• 🔄 Используются ли лёгкие элементы управления (замените ТабличныйДокумент на ПолеHTMLДокумента для больших таблиц).
• 📶 Оптимизированы ли запросы (избегайте выборки лишних полей).

8. Оптимизация и тестирование формы

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

1. Функциональное тестирование — проверьте все сценарии работы (создание, редактирование, удаление данных).
2. Тестирование производительности — откройте форму с большим объёмом данных (например, документ с 1000 строками табличной части).
3. Кросс-браузерное тестирование — проверьте отображение в разных браузерах (Chrome, Edge, Firefox) и на мобильных устройствах.
4. Тестирование прав доступа — убедитесь, что элементы формы скрываются/показываются в зависимости от ролей пользователей.

Для оптимизации производительности:

• 🚀 Используйте ОтложеннаяЗагрузка для динамических списков, если данные не нужны сразу при открытии формы.
• 🗃️ Кэшируйте часто используемые данные во временном хранилище.
• 🔍 Ограничивайте количество колонок в табличных полях (не более 10-15 для десктопов и 5-7 для мобильных устройств).
• 📉 Избегайте вложенных циклов при обработке больших массивов данных на клиенте.

Пример настройки отложенной загрузки для динамического списка:

ИсточникДанных.ОтложеннаяЗагрузка = Истина;
ИсточникДанных.КоличествоЗаписейПриОтложеннойЗагрузке = 50;

Для анализа производительности используйте встроенный профайлер 1С:

1. В конфигураторе откройте Сервис → Профайлер.
2. Запустите тестируемый сценарий (например, открытие формы с большим списком товаров).
3. Проанализируйте отчёт — обратите внимание на медленные запросы и часто вызываемые процедуры.

Если форма используется в тонком клиенте или веб-браузере, проверьте объём передаваемых данных между клиентом и сервером. Для этого:

1. Включите журнал регистрации (Администрирование → Журнал регистрации).
2. Отфильтруйте события по типу HTTPСервис или ВызовСервера.
3. Оцените размер передаваемых пакетов — если он превышает 1 МБ, оптимизируйте запросы.

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

• 📝 Нестандартных алгоритмов (например, сложная логика расчёта цены).
• 🔗 Внешних зависимостей (интеграция с другими системами).
• ⚠️ Известных ограничений (например, «Форма не поддерживает работу с более чем 5000 строками»).

⚠️ Внимание: В конфигурациях на базе БСП 3.1+ (Библиотека стандартных подсистем) некоторые стандартные формы могут переопределяться через механизм расширений. Перед модификацией формы проверьте, не перекрывается ли она в расширениях, чтобы избежать конфликтов при обновлении.

FAQ: Частые вопросы по управляемым формам в 1С