Как открыть общую форму в 1С 8

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

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

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

Где создаётся общая форма и как её найти в конфигураторе

Общие формы находятся в ветке дерева конфигурации: Общие → Общие формы. Если ветка пустая, форму нужно создать: правый клик по «Общие формы» → «Добавить», задать имя (например, НастройкиОбмена) и тип формы. В конфигурациях на управляемом приложении по умолчанию создаётся управляемая форма.

Перед открытием убедитесь, что форма существует и её имя написано точно — платформа чувствительна к точному совпадению имени, хотя регистр букв не учитывается. Ошибка в имени приведёт к исключению «Общая форма не обнаружена» уже в момент вызова, а не на этапе проверки модуля.

Открытие общей формы в управляемом приложении

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

&НаКлиенте
Процедура ОткрытьНастройки(Команда)
	ОткрытьФорму("ОбщаяФорма.НастройкиОбмена");
КонецПроцедуры

Полная сигнатура метода позволяет передать параметры, владельца, ключ уникальности и обработчик закрытия:

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

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

Открытие с обработкой результата

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

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

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

В закрываемой форме результат возвращается методом Закрыть(ЗначениеРезультата). Такой шаблон — стандартный способ организации диалогов «выбрать и вернуть» в управляемом приложении.

Открытие общей формы в обычном приложении

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

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

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

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

Открытие через общую команду без программирования

Если форму нужно просто показывать пользователю из интерфейса, можно обойтись без кода. Создайте объект Общие → Общие команды, в свойстве «Тип параметра команды» оставьте пустым, а в модуле команды напишите вызов ОткрытьФорму("ОбщаяФорма.ИмяФормы"). Затем включите команду в командный интерфейс нужной подсистемы.

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

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

Параметры формы — основной способ настроить поведение открываемой общей формы. В модуле формы обработайте их в ПриСозданииНаСервере:

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

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

Модальное и блокирующее открытие

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

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

Частые проблемы и их решение

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

Форма открывается пустой. Обычно причина в том, что параметры не обработаны или обработаны на клиенте, а заполнение данных выполняется на сервере. Переносите логику инициализации в ПриСозданииНаСервере.

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

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