Как открыть управляемую форму в 1С 8

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

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

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

Какие способы открытия формы существуют

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

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

Метод ОткрытьФормуМодально открывает форму в модальном режиме и возвращает результат после её закрытия. Однако модальные вызовы заблокированы в веб-клиенте и считаются устаревшим подходом — вместо них следует использовать ОткрытьФорму с описанием оповещения о закрытии.

Как открыть форму методом ОткрытьФорму

Базовый синтаксис выглядит так: ОткрытьФорму(ИмяФормы, Параметры, Владелец, Уникальность, Окно, НавигационнаяСсылка, ОписаниеОповещенияОЗакрытии, РежимОткрытияОкна). Обязателен только первый параметр — полное имя формы.

Имя формы строится по шаблону: тип объекта, имя объекта, затем Форма и имя конкретной формы. Например: «Справочник.Номенклатура.Форма.ФормаЭлемента» или «Документ.РеализацияТоваровУслуг.Форма.ФормаСписка». Если имя формы не указано явно, откроется основная форма объекта: «Справочник.Номенклатура.ФормаОбъекта» или «Справочник.Номенклатура.ФормаСписка».

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

&НаКлиенте
Процедура ОткрытьСписокНоменклатуры(Команда)
ОткрытьФорму("Справочник.Номенклатура.ФормаСписка");
КонецПроцедуры

После выполнения этого кода у пользователя откроется форма списка номенклатуры в новом окне или вкладке — в зависимости от настроек клиентского приложения.

&НаКлиенте
Процедура ОткрытьКарточку(Команда)
	ПараметрыФормы = Новый Структура;
	ПараметрыФормы.Вставить("Ключ", ТекущийЭлемент);
	ОткрытьФорму("Справочник.Номенклатура.Форма.ФормаЭлемента", ПараметрыФормы);
КонецПроцедуры

Как передать параметры в открываемую форму

Второй параметр метода ОткрытьФорму — структура с параметрами. Самый частый параметр — «Ключ», через который передаётся ссылка на объект, чью форму нужно открыть. Если ключ не передан, откроется форма нового элемента.

Помимо ключа можно передавать произвольные параметры, если в модуле формы они объявлены через конструкцию Параметры.ИмяПараметра в обработчике ПриСозданииНаСервере. Для этого в форме-получателе параметр должен быть описан в палитре свойств формы на закладке «Параметры» — иначе обращение к нему вызовет ошибку.

Пример открытия формы с отбором и дополнительным параметром:

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

Стандартный параметр «Отбор» автоматически применяется к динамическому списку формы — это удобный способ показать пользователю только нужные записи без доработки самой формы.

Как получить результат после закрытия формы

Так как ОткрытьФорму работает асинхронно, код после вызова выполняется сразу, не дожидаясь закрытия формы. Чтобы получить результат — например, выбранное пользователем значение — используется описание оповещения.

Механизм такой: создаётся объект ОписаниеОповещения с именем процедуры-обработчика, который передаётся в ОткрытьФорму седьмым параметром. Когда форма закроется, платформа вызовет указанную процедуру и передаст в неё результат закрытия.

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

&НаКлиенте
Процедура ПослеВыбораКонтрагента(Результат, ДополнительныеПараметры) Экспорт
Если Результат <> Неопределено Тогда
Контрагент = Результат;
КонецЕсли;
КонецПроцедуры

Обратите внимание: процедура-обработчик должна быть экспортной (с ключевым словом Экспорт), иначе платформа не сможет её вызвать. Форма выбора при закрытии возвращает выбранное значение автоматически; для собственных форм результат возвращается методом Закрыть(ЗначениеРезультата).

1. 1
   Создайте экспортную клиентскую процедуру-обработчик результата
2. 2
   Сформируйте объект ОписаниеОповещения с именем этой процедуры
3. 3
   Вызовите ОткрытьФорму, передав оповещение седьмым параметром
4. 4
   В открываемой форме возвращайте значение через Закрыть(Результат)
5. 5
   Проверьте в обработчике, что результат не равен Неопределено

Уникальность, владелец и режим открытия окна

Параметр «Уникальность» управляет повторным открытием форм. Если передать Истина или произвольное значение, то при повторном вызове с тем же ключом уникальности вместо новой формы активируется уже открытая. Это защищает от дублирования окон при многократном нажатии кнопки.

Параметр «Владелец» связывает открываемую форму с текущей: при закрытии владельца закроется и дочерняя форма. Обычно владельцем назначают текущую форму (ЭтаФорма) или элемент управления. Для форм выбора владелец определяет, кому будет передан результат по умолчанию.

Параметр «РежимОткрытияОкна» позволяет открыть форму независимо, блокировать окно владельца или весь интерфейс. Значение БлокироватьОкноВладельца — ближайший аналог модального режима, совместимый с веб-клиентом: пользователь не сможет переключиться на родительское окно, пока не закроет дочернее.

Открытие формы внешней обработки и особенные случаи

Для форм внешних обработок и отчётов, не подключённых к конфигурации, сначала нужно получить объект обработки. В тонком клиенте для этого используется помещение файла во временное хранилище и подключение через менеджер внешних обработок, после чего форма открывается по имени вида «ВнешняяОбработка.ИмяОбработки.Форма».

Формы общих форм конфигурации открываются по имени «ОбщаяФорма.ИмяФормы». Формы записей регистров сведений — «РегистрСведений.ИмяРегистра.ФормаЗаписи» с передачей ключа записи в параметре «Ключ».

Если форму нужно просто показать пользователю без программной логики, часто достаточно стандартных команд интерфейса или навигационных ссылок вида «e1cib/...», которые можно получить командой «Получить навигационную ссылку». Это избавляет от лишнего кода в простых сценариях навигации.

Как проверить, что форма открылась корректно

После внедрения кода проверьте сценарий в нескольких режимах: тонкий клиент, толстый клиент (если используется) и веб-клиент. Особое внимание уделите оповещениям — убедитесь, что обработчик вызывается и корректно обрабатывает как результат, так и Неопределено при отмене выбора.

Полезный приём отладки — временно вывести в обработчике оповещения значение результата через Сообщить() или СообщениеПользователю. Если обработчик не вызывается, первым делом проверьте наличие слова Экспорт и правильность имени процедуры в описании оповещения.

Частые вопросы