Компонент Запуск процесса

Содержание

Описание
Свойства
См. также

Описание

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

Операция должна быть предварительно разрешена и настроена в файле ассетов permissions.json на каждом сервере, где может выполняться компонент.

Table 1. Системные характеристики

Индекс	`117`
Краткое название	`execprocess`
Типы сценариев	`Все`
Стартовый модуль	`r_script_component_execprocess`
Режим	Асинхронный
Иконка
Характер разветвления	Разветвляющий, замыкающий

Свойства

Table 2. Свойства
Спецификация	Описание
Название: `Режим` Код: `mode` Усл. видимости: `нет` По умолчанию: `Асинхронный запуск`	Режим ожидания завершения процесса ОС. Возможные значения: `Асинхронный запуск` (`async`, `0`) – Сразу после запуска процесса передает управление следующему компоненту. `Ожидание завершения` (`sync`, `1`) – Передает управление следующему компоненту только после завершения процесса или таймаута ожидания.
Название: `Путь к исполняемому файлу` Код: `path` Усл. видимости: `нет` По умолчанию: —	Путь к файлу или команда ОС. Префикс командной строки. Префикс должен быть разрешен в файле permissions.json. Примеры указания команд: `echo` `myprogram1` `/bin/myprogram2` `:GLOBALSHARE_COMMON/cmd/myprogram3` `bash :SYNC_COMMON/cmd/myscript.sh` Для разрешения этих примеров в файле 'permissions.json' должно быть следующее содержание: { "exec_perm": { "check": true, "user": "root", "commands": [ "echo", "myprogram1", "/bin/myprogram2", ":GLOBALSHARE/common/cmd/myprogram3", ":SYNC/common/cmd/myscript.sh" ] } } Используя bash-скрипты можно запускать любые команды, разрешение проверяется только на путь к стартовому bash-скрипту.
Название: `Параметры запуска командной строки` Код: `params` Усл. видимости: `нет` По умолчанию: —	Постфикс команды, содержащий параметры.
Название: `Время, с` Код: `timeout` Усл. видимости: `да` По умолчанию: —	Таймаут ожидания завершения процесса.
Название: `Переход` Код: `transfer` Усл. видимости: `нет` По умолчанию: —	Компонент, которому передается управление после асинхронного запуска, либо после успешного завершения процесса.
Название: `Результат в переменную` Код: `result` Усл. видимости: `нет` По умолчанию: —	Переменная для сохранения консольного вывода завершенного процесса.
Название: `Переход, ошибка` Код: `transferError` Усл. видимости: `нет` По умолчанию: —	Компонент, которому передается управление в случае ошибки запуска или падения процесса.
Название: `Причина ошибки в переменную` Код: `error` Усл. видимости: `нет` По умолчанию: —	Переменная для сохранения ошибки.
Название: `Переход, время` Код: `transferTimeout` Усл. видимости: `да` По умолчанию: —	Компонент, которому передается управление по истечении времени ожидания завершения процесса.

См. также

Роль svc
Ассет permissions.json