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

executor

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

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

// 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 <путь до скрипта>