Как открыть внешнюю ссылку из 1С

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

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

Ниже разобраны все рабочие способы с примерами кода, типичными ошибками и проверкой результата. Материал применим к платформе 1С:Предприятие 8.3 в управляемом приложении; отдельно указаны отличия для обычных форм.

Как открыть ссылку методом ПерейтиПоНавигационнойСсылке

Глобальный метод ПерейтиПоНавигационнойСсылке() — рекомендуемый способ в управляемом приложении. Он доступен на клиенте, не требует разрешений операционной системы и корректно работает в веб-клиенте, где прямой запуск приложений невозможен.

&НаКлиенте
Процедура ОткрытьСайт(Команда)
    ПерейтиПоНавигационнойСсылке("https://example.com/page");
КонецПроцедуры

Метод открывает ссылку в браузере по умолчанию пользователя. Если передать навигационную ссылку вида e1cib/..., будет выполнен переход внутри самой информационной базы — поэтому для внешних адресов всегда проверяйте, что строка начинается с http:// или https://.

Если адрес формируется динамически (например, из реквизита справочника), перед переходом стоит проверить, что поле заполнено, иначе пользователь получит пустую вкладку браузера или ошибку.

Как открыть ссылку через НачатьЗапускПриложения

Метод НачатьЗапускПриложения() (и устаревший синхронный ЗапуститьПриложение()) запускает программу операционной системы. Если передать ему URL, система откроет его в браузере по умолчанию. Способ работает в тонком и толстом клиенте, но в веб-клиенте запуск приложений ограничен или недоступен.

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

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

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

Как сделать кликабельную ссылку в форме без кода

Если ссылка статична, её можно разместить прямо в форме. Добавьте элемент «Надпись», в свойстве «Заголовок» укажите текст со ссылкой и включите свойство «Гиперссылка». При клике платформа откроет адрес в браузере.

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

1. 1
   Откройте форму в конфигураторе, добавьте элемент типа «Надпись»
2. 2
   В заголовке укажите текст с адресом, включите свойство «Гиперссылка»
3. 3
   Для динамической ссылки создайте обработчик Нажатие или ОбработкаНавигационнойСсылки
4. 4
   В обработчике вызовите ПерейтиПоНавигационнойСсылке с нужным адресом
5. 5
   Запустите базу в режиме Предприятие и проверьте клик по ссылке

Как открыть ссылку из макета, отчёта или печатной формы

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

В HTML-документе (поле вида «Поле HTML документа») ссылки работают нативно, но клики перехватываются событием ПриНажатии — там можно разрешить или запретить переход, анализируя адрес.

Безопасность и типичные ограничения

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

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

Если база работает под управлением веб-сервера с ограничениями безопасных режимов, запуск приложений на сервере запрещён — выполняйте открытие только на клиенте (директива &НаКлиенте).

Как проверить, что ссылка открывается корректно

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

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

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