Документация 0.4 Справочник действий
Запустить приложение
app.start · Windows
Запускает программу с аргументами
Запускает программу Windows — 1С, бухгалтерскую программу, Блокнот, свой .exe — с аргументами командной строки.
Шаг не ждёт, пока появится окно программы: следом поставьте ui.waitElement с селектором главного окна.
Свойства #
| Свойство | Имя в файле | Значение | Обязательное | По умолчанию | Описание |
|---|---|---|---|---|---|
| Программа | path |
путь к файлу | да | — | Путь с папкой отсчитывается от папки flow; имя без папки (notepad.exe) ищется в PATH |
| Аргументы | arguments |
текст | нет | — | |
| Рабочая папка | workingDirectory |
путь к файлу | нет | — | По умолчанию — папка программы |
Результат #
Значение выхода сохраняется в переменную, выбранную для него в свойствах шага (раздел выходов).
| Выход | Имя в файле |
|---|---|
| ID процесса | processId |
Как работает #
- Программа (
path):- путь с папкой (
..\testapp\Tulpar.TestApp.exe,C:\Program Files\App\app.exe) — относительный считается от папки процесса; - только имя (
notepad.exe,excel.exe) — программа ищется вPATHи среди зарегистрированных в Windows; - путь можно взять из ресурса оркестратора (
orch.getAsset):{{ appPath }}— тогда на каждом роботе свой путь без правки процесса.
- путь с папкой (
- Аргументы (
arguments) — строка аргументов, например/F "C:\Base" /N robot. - Рабочая папка (
workingDirectory) — по умолчанию папка программы. - Выход ID процесса — номер процесса Windows (PID); если программа запущена через оболочку и процесс неизвестен, выход не заполняется.
Ошибки #
| Код | Причина и что делать |
|---|---|
AppStartFailed |
Файл программы не найден, рабочей папки нет, Windows отказался запускать (нет прав, неверный файл). Проверьте путь; путь без диска считается от папки процесса |
Пример #
{ "type": "app.start", "props": { "path": "../testapp/Tulpar.TestApp.exe", "arguments": "" }, "out": { "processId": "pid" } }