Как открыть другую форму в 1С: практическое руководство

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

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

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

Метод ОткрытьФорму — основной способ

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

Первый параметр — полное имя формы. Для типовых объектов оно строится по шаблону: Справочник.Номенклатура.Форма.ФормаОбъекта, Документ.РеализацияТоваровУслуг.Форма.ФормаСписка. Если форма основная, можно указывать сокращённо: Справочник.Номенклатура.ФормаОбъекта.

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

ОткрытьФорму("Справочник.Номенклатура.Форма.ФормаЭлемента");

Признак успешного выполнения — форма появилась на экране без сообщения об ошибке. Если появляется ошибка «Форма не найдена», проверьте точность имени объекта метаданных и имя формы в конфигураторе (свойства объекта, закладка «Формы»).

Передача параметров в открываемую форму

Второй параметр метода — структура с параметрами, которые открываемая форма получит в обработчике ПриСозданииНаСервере через коллекцию Параметры. Так передают отборы, ключи записей, признаки режима работы.

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

ОткрытьФорму("Справочник.Номенклатура.Форма.ФормаЭлемента", ПараметрыФормы);

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

Открытие формы конкретного объекта по ссылке

Частая задача — по команде из одной формы открыть карточку связанного объекта. Для этого достаточно передать ссылку в параметре Ключ:

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

Получение результата: оповещения и модальный режим

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

Вариант с оповещением — асинхронный и предпочтительный: после закрытия формы платформа вызовет указанную процедуру в вызывающей форме:

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

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

В открываемой форме результат возвращается методом Закрыть(ЗначениеРезультата). Чтобы форма вообще могла вернуть значение при закрытии, установите у неё свойство РежимОткрытияОкна = БлокироватьОкноВладельца или передавайте владельца третьим параметром.

Метод ОткрытьФормуМодально

ОткрытьФормуМодально() приостанавливает выполнение кода до закрытия формы и сразу возвращает результат. Синтаксис проще, но метод работает только если в свойствах конфигурации режим использования модальности разрешён. В веб-клиенте и большинстве современных типовых конфигураций модальность запрещена, и вызов приведёт к ошибке.

Результат = ОткрытьФормуМодально("Справочник.Номенклатура.Форма.ФормаВыбора");
Если Результат <> Неопределено Тогда
// результат получен синхронно
КонецЕсли;

Метод ПолучитьФорму: когда нужен доступ к форме до открытия

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

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

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

Открытие форм из разных мест конфигурации

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

Для открытия форм внешних обработок используется другой синтаксис — через ВнешниеОбработки.ПолучитьФорму() в обычном приложении или ОткрытьФорму("ВнешняяОбработка.Имя.Форма") после регистрации обработки в управляемом приложении.

1. 1
   Определите точное имя формы в конфигураторе: объект метаданных → закладка «Формы»
2. 2
   Напишите вызов ОткрытьФорму с именем формы в клиентской процедуре
3. 3
   При необходимости передайте структуру параметров (Ключ, Отбор, произвольные)
4. 4
   Если нужен результат — добавьте ОписаниеОповещения и процедуру-обработчик
5. 5
   Проверьте в режиме предприятия: форма открывается, параметры применяются, результат возвращается

Типичные ошибки и их диагностика

Ошибка «Форма не найдена» означает неверное имя: опечатку в имени объекта, отсутствие формы с таким именем или попытку открыть форму обычного приложения в управляемом интерфейсе. Сверьте имя с конфигуратором посимвольно.

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

Если оповещение не срабатывает, убедитесь, что процедура-обработчик объявлена с ключевым словом Экспорт, находится в клиентском контексте и что открываемая форма вызывает Закрыть(Результат), а не просто Закрыть().

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