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

executor

executor -s имя файла [ -m метод] [ --modules-path путь к каталогу общих скриптов]
        [-v] [-d номер порта] [--] [параметры сценария]

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

• -s имя файла

  --source-path имя файла

  Указывает имя файла со скриптом, который будет выполняться. Скриптом считается файл с расширением .sbsl.

  Если ключ не указан, то единственный переданный параметр будет считаться именем файла со скриптом. Если имя запускаемого сценария не является единственным параметром при запуске executor (например, запускается сценарий, который получает на вход какие-то параметры), то указание параметра запуска -s является обязательным.

• -m метод

  --method метод

  Указывает имя метода, с вызова которого начнется исполнение скрипта.

  Если параметр не указан, то исполнение скрипта начнется с вызова метода Скрипт().

• --modules-path путь к каталогу общих скриптов

  Указывает путь к каталогу, в котором будет выполняться поиск подключаемых скриптов.

• -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С:Исполнителя»

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