Командная строка «1С:Исполнителя»

executor

executor -s имя файла [ -m метод] [-v] [-d номер порта] [--] [параметры сценария]

Описание параметров

-s имя файла
--source-path имя файла
Указывает имя файла со скриптом, который будет выполняться. Скриптом считается файл, у которого расширение .sbsl.
Если ключ не указан, то единственный переданный параметр будет считаться именем файла со скриптом. Если имя запускаемого сценария не является единственным параметром при запуске executor (например, запускается сценарий, который получает на вход какие-то параметры), то указание параметра запуска -s является обязательным.
-m метод
--method метод
Указывает имя метода, с вызова которого начнется исполнение скрипта.
Если параметр не указан, то исполнение скрипта начнется с вызова метода Скрипт().
-l код-языка
--locale код-языка
Только для «1С:Исполнителя»-X. Позволяет задать язык сообщений «1С:Исполнителя»-X: en (английский) или ru (русский). По умолчанию используется русский язык.
-v
--V
--version
Позволяет получить версию «1С:Исполнителя».
-d номер порта
--debug-port номер порта
Указывает номер порта, который будет использоваться сервером отладки.
Номер порта должен находиться в диапазоне от 0 до 65535 (исключая значения 0 и 65535).
--
Признак прекращения разбора аргументов командной строки. Указание этого параметра отключает разбор оставшейся части командной строки и все оставшиеся значения передаются как параметры сценария (с разделителем пробел).
Еще одним назначением параметра -- является необходимость передать в качестве значения другого параметра командной строки «1С:Исполнителя» последовательность символов, начинающихся с -.
параметры сценария
Если после определения именованных параметров в командной строке запуска сценария остались какие-либо значения, то эти значения будет переданы в запускаемый сценарий в качестве параметров. Подробнее о работе с параметрами запуска сценария написано здесь.

Результат работы

Во время работы «1С:Исполнитель» выводит информацию в стандартный поток вывода (stdout).

Информация об ошибках выводится в стандартный поток ошибок (stderr).

Кодировка выводимой информации

Кодировка выводимой информации зависит от используемой операционной системы:

  • для Linux: UTF-8
  • для macOS: UTF-8
  • для Windows:

    • CP866 (по умолчанию) — для «1С:Исполнителя»-U;
    • CP1251 — для «1С:Исполнителя»-X.

Код завершения

Результат работы скрипта сообщается в виде кода завершения «1С:Исполнителя»:
0
Успешное завершение работы скрипта и самого «1С:Исполнителя».
255
Скрипт завершил работу с ошибкой.

Примеры запуска «1С:Исполнителя»

// 1. самый простой способ исполнить скрипт с методом Скрипт()
executor <путь до скрипта>
  
// 2. аналог 1
executor -s <путь до скрипта>
executor --source-path <путь до скрипта>
  
// 3. исполнить скрипт с указанием метода без параметров
executor -s <путь до скрипта> -m <название метода>
  
// 4. исполнить скрипт с указанием метода с параметрами
executor -s <путь до скрипта> -m <название метода> <параметр метода#1> <параметр метода#2> ...
  
// 5. аналог 4 но параметры начинаются с различных символов, например "-" и "--"
executor -s <путь до скрипта> -m <название метода> -- -<параметр метода#1> --<параметр метода#2> ...
  
// 6. посмотреть версию «1С:Исполнителя»
executor -v
  
// 7. посмотреть версию «1С:Исполнителя» и исполнить скрипт
executor -v -s <путь до скрипта>
  
// 8. исполнить скрипт с отладкой
executor -d <порт> -s <путь до скрипта>