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

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

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

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

Что такое ссылка и почему её недостаточно для открытия формы

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

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

Открытие формы в управляемом приложении через ОткрытьЗначение

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

&НаКлиенте
Процедура ПоказатьКонтрагента(Команда)
ОткрытьЗначение(КонтрагентСсылка);
КонецПроцедуры

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

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

1. 1
   Убедитесь, что код выполняется в клиентском контексте (&НаКлиенте)
2. 2
   Проверьте, что ссылка заполнена: ЗначениеЗаполнено(Ссылка)
3. 3
   Вызовите ОткрытьЗначение(Ссылка)
4. 4
   Проверьте, что открылась форма именно нужного объекта — сверьте наименование или номер

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

Когда нужен контроль над открытием, используют ОткрытьФорму() с параметром «Ключ». Имя формы указывают в полном виде: "Справочник.Контрагенты.ФормаОбъекта" или "Документ.РеализацияТоваровУслуг.Форма.ФормаДокумента".

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

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

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

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

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

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

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

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

Также работает универсальный ОткрытьЗначение() — в обычном приложении он тоже доступен и часто удобнее, так как не требует хранить форму в переменной. Модальное открытие через ОткрытьМодально() блокирует родительское окно до закрытия формы; в управляемом приложении модальный режим ограничен и требует разрешения в настройках, поэтому в новых разработках его избегают.

Открытие объекта по навигационной ссылке

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

&НаКлиенте
Процедура ПерейтиКОбъекту(Команда)
НавСсылка = ПолучитьНавигационнуюСсылкуНаСервере(ОбъектСсылка);
ПерейтиПоНавигационнойСсылке(НавСсылка);
КонецПроцедуры

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

Проверка результата и типичные ошибки

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

Частая проблема — вызов клиентских методов в серверном контексте. Директива &НаСервере не имеет доступа к ОткрытьФорму() и ОткрытьЗначение(): код либо не скомпилируется, либо завершится ошибкой выполнения. Логику получения данных держите на сервере, а открытие формы — на клиенте.

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