2 378 документов
← К списку

ПараметрыЗапускаПрограммы

страница

Предусмотрено две одноименных функции: ФайловаяСистема.ПараметрыЗапускаПрограммы для вызова с сервера ФайловаяСистемаКлиент.ПараметрыЗапускаПрограммы для вызова с клиента

1. Для вызова с сервера

Конструктор параметров для ФайловаяСистема.ЗапуститьПрограмму.

Синтаксис

Функция ПараметрыЗапускаПрограммы() Экспорт

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

Структура:

  • ТекущийКаталог - Строка - задает текущий каталог запускаемого приложения.
  • ДождатьсяЗавершения - Булево - Ложь - дожидаться завершения запущенного приложения перед продолжением работы.
  • ПолучитьПотокВывода - Булево - Ложь - результат, направленный в поток stdout, если не указан ДождатьсяЗавершения - игнорируется.
  • ПолучитьПотокОшибок - Булево - Ложь - ошибки, направленные в поток stderr, если не указан ДождатьсяЗавершения - игнорируется.
  • КодировкаПотоков - КодировкаТекста
    • Строка - кодировка, используемая для чтения stdout и stderr. По умолчанию используется для Windows "CP866", для остальных - "UTF-8".
  • КодировкаИсполнения - Строка
    • Число - кодировка, устанавливаемая в Windows с помощью команды chcp, возможные значения: "OEM", "CP866", "UTF8" или номер кодовой страницы. В Linux устанавливается переменной окружения "LANGUAGE" для конкретной команды, возможные значения можно определить выполнив команду "locale -a", например "ru_RU.UTF-8". В MacOS игнорируется.

Пример вызова

Результат = ФайловаяСистема.ПараметрыЗапускаПрограммы()

Доступность

Сервер, Толстый клиент, Внешнее соединение

2. Для вызова с клиента

Конструктор параметров для ФайловаяСистемаКлиент.ЗапуститьПрограмму.

Синтаксис

Функция ПараметрыЗапускаПрограммы() Экспорт

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

Структура:

  • ТекущийКаталог - Строка - задает текущий каталог запускаемого приложения.
  • Оповещение - ОписаниеОповещения - оповещение о результате завершения запущенного приложения, если оповещение не задано в случае ошибки будет показано предупреждение. Параметры обработчика завершения: Результат - Структура - результат работы программы: -- ПриложениеЗапущено - Булево - Истина, если внешнее приложение не вызвало ошибок при открытии. -- ОписаниеОшибки - Строка - краткое описание ошибки. При отмене пользователем пустая строка. -- КодВозврата - Число - код возврата программы. -- ПотокВывода - Строка - результат работы программы, направленный в поток stdout. В веб-клиенте всегда принимает значение "". -- ПотокОшибок - Строка - ошибки исполнения программы, направленные в поток stderr. В веб-клиенте всегда принимает значение "". ДополнительныеПараметры - Произвольный - значение, которое было указано при создании объекта ОписаниеОповещения:
  • ДождатьсяЗавершения - Булево - Истина, дожидаться завершения запущенного приложения перед продолжением работы.
  • ПолучитьПотокВывода - Булево - Ложь - результат, направленный в поток stdout, если не указан ДождатьсяЗавершения - игнорируется.
  • ПолучитьПотокОшибок - Булево - Ложь - ошибки, направленные в поток stderr, если не указан ДождатьсяЗавершения - игнорируется.
  • КодировкаПотоков - КодировкаТекста
    • Строка - кодировка, используемая для чтения stdout и stderr. По умолчанию для Windows "CP866", для остальных - "UTF-8".
  • КодировкаИсполнения - Строка
    • Число - кодировка, устанавливаемая в Windows с помощью команды chcp, возможные значения: "OEM", "CP866", "UTF8" или номер кодовой страницы. В Linux устанавливается переменной окружения "LANGUAGE" для конкретной команды, возможные значения можно определить выполнив команду "locale -a", например "ru_RU.UTF-8". В MacOS игнорируется.
  • ВыполнитьСНаивысшимиПравами - Булево - Истина, если требуется запустить программу на исполнение с повышением привилегий системы: Windows: запрос UAC; Linux: исполнение с командой pkexec; macOS, веб-клиент и мобильный клиент: будет возвращен Результат.ОписаниеОшибки.
  • СредаИсполнения - Строка - пустая строка, если среда исполнения не Windows. Используется при определении недопустимых символов в строке запуска.

Пример вызова

Результат = ФайловаяСистемаКлиент.ПараметрыЗапускаПрограммы()

Доступность

Тонкий клиент, Толстый клиент