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

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

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

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

Какие формы документа можно открыть

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

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

Открытие формы через ОткрытьФорму

Базовый вызов выглядит так: первым параметром передаётся полное имя формы, далее — структура параметров, владелец, уникальность, окно и другие настройки. Минимальный пример открытия формы нового документа:

ОткрытьФорму("Документ.РеализацияТоваровУслуг.Форма.ФормаДокумента");

Чтобы открыть существующий документ по ссылке, в параметры добавляют ключ «Ключ»:

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

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

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

Открытие нового документа с заполнением реквизитов

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

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

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

ОткрытьФорму("Документ.ЗаказКлиента.Форма.ФормаДокумента", ПараметрыФормы, ЭтаФорма);

Важный нюанс: переданные значения попадут в документ только если они соответствуют свойству «Заполнять из данных заполнения» у реквизитов и не отфильтрованы в обработчике ОбработкаЗаполнения модуля объекта. Если реквизит не заполняется, проверяйте именно эти два места, а не код открытия формы.

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

1. 1
   Определите, что открываете: новый документ, существующий по ссылке или список
2. 2
   Сформируйте структуру параметров: Ключ для существующего, ЗначенияЗаполнения для нового
3. 3
   Укажите владельца формы (обычно ЭтаФорма), чтобы связать окна
4. 4
   Вызовите ОткрытьФорму с полным именем формы документа
5. 5
   Проверьте результат: документ открылся, реквизиты заполнены, права доступа соблюдены

Открытие по ссылке через ОткрытьЗначение и навигационные ссылки

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

Если ЗначениеЗаполнено(СсылкаНаДокумент) Тогда
ОткрытьЗначение(СсылкаНаДокумент);
КонецЕсли;

Дополнительно платформа поддерживает навигационные ссылки вида e1cib/data/Документ.РеализацияТоваровУслуг?ref=.... Метод ПолучитьНавигационнуюСсылку() возвращает такую строку для любой ссылки, а глобальный метод ПерейтиПоНавигационнойСсылке() открывает объект по ней. Это удобно для уведомлений, внешних ссылок в письмах и интеграций.

Модальное открытие и возврат результата

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

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

В открываемой форме результат возвращают вызовом Закрыть(ВозвращаемоеЗначение) или ОповеститьОВыборе(Значение). Процедура «ПослеВыбораДокумента» в исходном модуле получит это значение первым параметром. Параметр «БлокироватьОкноВладельца» делает родительскую форму неактивной до закрытия дочерней — это аналог модальности без нарушения ограничений платформы.

Открытие формы списка с отбором

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

Отбор = Новый Структура;
Отбор.Вставить("ЗаказКлиента", СсылкаНаЗаказ);

ПараметрыФормы = Новый Структура;
ПараметрыФормы.Вставить("Отбор", Отбор);

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

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

Типичные ошибки и ограничения

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

Вторая ошибка — попытка открыть форму объекта на сервере. ОткрытьФорму доступна только в клиентском контексте (директивы &НаКлиенте, тонкий или веб-клиент). Вызов с сервера приведёт к ошибке компиляции или выполнения. Данные для параметров при этом готовить на сервере можно и нужно — например, получать ссылки запросом, — а сам вызов выполнять на клиенте.

Третья группа проблем связана с правами. Если у пользователя нет права «Просмотр» на документ, форма не откроется независимо от корректности кода. Также в файловой базе при монопольной блокировке или в момент обновления конфигурации открытие форм может временно завершаться ошибкой — это не дефект кода.

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

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

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