Как открыть другую форму внешней обработки 1С

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

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

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

Как устроено обращение к формам внешней обработки

У внешней обработки, как и у любого объекта метаданных, может быть несколько форм. Одна из них назначена основной (свойство «Основная форма» в палитре свойств обработки), остальные открываются только программно. Чтобы обратиться к конкретной форме, платформе нужно полное имя, состоящее из трёх частей: вида объекта, имени обработки и имени формы.

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

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

Открытие формы через ОткрытьФорму() для подключенной обработки

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

ОткрытьФорму("ВнешняяОбработка.МояОбработка.Форма.ФормаНастроек");

Имя обработки в строке должно совпадать с именем регистрации. Если обработка подключена через механизм дополнительных отчетов и обработок БСП, имя можно получить программно — например, из параметров формы или через методы БСП, которые возвращают используемое имя внешнего объекта.

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

// Открытие формы настроек с передачей параметров
ПараметрыФормы = Новый Структура;
ПараметрыФормы.Вставить("ПериодОтчета", ТекущаяДатаСеанса());

ОткрытьФорму("ВнешняяОбработка.МояОбработка.Форма.ФормаНастроек",
    ПараметрыФормы, ЭтаФорма, Новый УникальныйИдентификатор);

Открытие формы файловой обработки через ПолучитьФорму

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

В управляемой форме внешней обработки объект обработки доступен через РеквизитФормыВЗначение("Объект") — но это создаёт новый экземпляр объекта на сервере, что не всегда приемлемо. Практичнее хранить путь к файлу обработки и создавать объект через ВнешниеОбработки.Создать(ПутьКФайлу), после чего вызывать ПолучитьФорму("ФормаНастроек").

Полученная форма открывается методом Открыть(). У этого подхода есть ограничение: он хуже сочетается с асинхронной моделью и требует аккуратной работы с владельцем формы, иначе при закрытии основной формы дочерняя может остаться «висеть» или, наоборот, закрыться неожиданно.

Передача параметров и получение результата

Вторым параметром ОткрытьФорму() передаётся структура с параметрами. В открываемой форме эти значения доступны через объект Параметры — обычно их читают в обработчике ПриСозданииНаСервере. Так удобно передать в форму настроек текущие значения, чтобы пользователь видел актуальное состояние, а не пустой диалог.

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

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

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

Модальное и немодальное открытие

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

Для модального режима в асинхронной модели используют ОткрытьФорму() с режимом открытия окна РежимОткрытияОкнаФормы.БлокироватьОкноВладельца — параметр «РежимОткрытияОкна» передаётся в структуре параметров либо через соответствующий параметр метода. Устаревший ОткрытьМодально() в современных конфигурациях запрещён настройками совместимости и вызовет ошибку, если в свойствах конфигурации отключён модальный режим.

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

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

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

Вторая группа ошибок связана с параметрами: в открываемой форме обращаются к Параметры.Ключ, который не был передан, — возникает обращение к несуществующему свойству. Защищайтесь проверкой через Параметры.Свойство("Ключ", Значение) перед использованием.

Третья типичная ситуация — результат закрытия «не приходит». Обычно причина в том, что процедура, указанная в ОписаниеОповещения, объявлена без ключевого слова Экспорт в клиентском контексте, либо форма-владелец уже закрыта к моменту срабатывания оповещения. Также проверьте, что в дочерней форме результат действительно передаётся в Закрыть(), а не теряется при закрытии крестиком — в этом случае в оповещение придёт Неопределено.

Проверка результата после внедрения

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

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

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