Глобальный контекст.ЗапуститьПриложениеАсинх (Global context.RunAppAsync)

Глобальный контекст (Global context)

ЗапуститьПриложениеАсинх (RunAppAsync)

Доступен, начиная с версии 8.3.18.

Синтаксис:

ЗапуститьПриложениеАсинх(<СтрокаКоманды>, <ТекущийКаталог>, <ДождатьсяЗавершения>)

Параметры:

<СтрокаКоманды> (обязательный)

Тип: Строка.
Командная строка для запуска приложения либо имя файла, ассоциированного с некоторым приложением.

<ТекущийКаталог> (необязательный)

Тип: Строка.
Задает текущий каталог запускаемого приложения.
В режиме веб-клиента игнорируется.

<ДождатьсяЗавершения> (необязательный)

Тип: Булево.
Истина - дожидаться завершения запущенного приложения перед продолжением работы.
Значение по умолчанию: Ложь.

Возвращаемое значение:

Тип: Обещание.
Результатом выполнения обещания является код возврата типа Число или Неопределено, если соответствующий входной параметр <ДождатьсяЗавершения> не указан.

Описание:

Асинхронная функция.
Выполняет запуск внешнего приложения либо открытие файла с использованием ассоциированного с ним приложения.

Доступность:

Тонкий клиент, веб-клиент, мобильный клиент, толстый клиент, мобильное приложение (клиент).

Примечание:

В отличие от функции КомандаСистемы запуск приложения выполняется непосредственно, минуя командный интерпретатор.
Поведение метода зависит от используемой операционной системы и режима запуска. Используемые в реализации метода механизмы операционной системы допускают различные варианты использования. Например, в некоторых режимах метод может открывать html ссылки с помощью браузера "по умолчанию". Такие возможности не являются штатными т.к. не гарантируется их наличие во всех режимах запуска.
При запуске "1С:Предприятия" в пакетном режиме, а также при вызове метода на сервере будет сгенерировано исключение.
Для работы метода на веб-клиенте необходимо предварительно подключить расширение работы с файлами.
При использовании метода на мобильной платформе возможно только открытие файла по ассоциации.
На мобильной платформе под управлением ОС Windows параметр <ДождатьсяЗавершения> игнорируется, а результат выполнения возвращается сразу после запуска приложения.

См. также:

Глобальный контекст, метод НачатьЗапускПриложения
Глобальный контекст, метод ЗапуститьПриложение

Использование в версии:

Доступен, начиная с версии 8.3.18.

Методическая информация