Командная строка

Чтобы запустить выполнение скрипта из командной строки, используйте команду executor.

executor [параметры] [скрипт] [аргументы_метода]

Параметры

При выполнении команды executor вы можете указать следующие параметры:

• -v, --version — выводит информацию о версии.

• -h, --help — выводит справочную информацию по работе с командой.

• -d, --debug-port <аргумент> — устанавливает номер порта для отладки. Номер порта <аргумент> должен находиться в диапазоне от 0 до 65535 (не включая эти значения).

• c, --cmpt-mode <режим_совместимости> — устанавливает режим совместимости. Параметр <режим_совместимости> может принимать следующие значения:

  • 8.0, 9.0 и т. д. — конкретная версия режима совместимости. Можно указывать только мажорные версии «1С:Предприятие.Элемента Скрипта», начиная с 6.0;

  • current — режим совместимости, соответствующий текущей версии «1С:Предприятие.Элемента Скрипта»;

  • script (по умолчанию) — режим совместимости, указанный в скрипте с помощью директивы #совместимость <режим_совместимости>. Например:

    #совместимость 8.0

    Если директива отсутствует, используется значение current. Если значение, указанное в директиве, отличается от режима совместимости запуска скрипта, выводится предупреждение.

• -l, -locale <аргумент> — устанавливает локаль.

• --warn-unclosed-resources — сообщает о незакрытых ресурсах в конце выполнения.

• --modules-path <путь> — устанавливает путь к каталогу подключаемых модулей (подробнее).

• --dev-lang <язык> — устанавливает вариант языка разработки: ru — русский, en — английский. Значение по умолчанию определяется по ключевому слову в первом объявлении метода.

Запуск скрипта

Чтобы запустить метод Скрипт(), используемый по умолчанию, вы можете указать только путь до скрипта:

executor path/to/script.sbsl

Чтобы запустить определенный метод в скрипте, укажите его имя при вызове команды:

executor path/to/script.sbsl::Выполнить

Аргументы

Вы можете передать в параметры методов позиционные и именованные аргументы:

• Для передачи именованных аргументов используйте ключевое слово <arg>: -arg1 знч1 -arg2 знч2. Например, метод с сигнатурой РешитьКвадратноеУравнение(a: Число, b: Число, с: Число): Массив<Число> можно вызвать следующим образом:

  executor path/to/script.sbsl::РешитьКвадратноеУравнение -a 1 -b -3 -c 2

• Для передачи позиционных аргументов перечислите значения аргументов в нужном порядке: знч1 знч2.

  executor path/to/script.sbsl::РешитьКвадратноеУравнение 1 -3 2

В качестве признака прекращения разбора аргументов командной строки используйте параметр --. Он отключает разбор оставшейся части командной строки, и все остальные значения передаются как параметры скрипта (с пробелом в качестве разделителя).

Параметр -- также используется, если в качестве значения другого параметра командной строки executor необходимо передать последовательность символов, начинающихся с -.

Аргументы типа «Строка»

Для передачи аргумента типа Строка используйте двойные кавычки: "строковое значение".

executor path/to/script.sbsl::ПолучениеСтроки "Это строка-аргумент"

Аргументы типа «Массив»

Для передачи аргумента типа Массив используйте параметр --: -- элемент1, элемент2, элемент3.

executor path/to/script.sbsl::ПолучениеМассиваСтрок -- "Первая строка" "Вторая строка" "Самая последняя строка"

Аргументы типа «Соответствие»

Чтобы передать аргумент типа Соответствие, используйте именованные параметры. Чтобы передать в метод соответствие {ключ1: знч1, ключ2: знч2}, укажите аргументы в формате -ключ1 знч1 -ключ2 знч2.

важно

Обратите внимание, что соответствие должно быть единственным аргументом метода.

executor path/to/script.sbsl::ПолучениеСоответствия -"1" "Строка1" -"2" "Строка2"

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

Во время работы executor выводит информацию в стандартный поток вывода (stdout).

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

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

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

• для Linux: UTF-8,
• для macOS: UTF-8,
• для Windows: CP866.

Открытие скриптов в среде разработки

Помимо запуска скриптов, из командной строки можно открывать директории и файлы скриптов в среде разработки.

важно

Исполняемый файл среды разработки 1c-enterprise-element-desktop-ide не добавляется в PATH. Для вызова через командную строку необходимо использовать полный путь к нему:

• Windows: C:\Program Files\1C\1CE\components\1c-enterprise-element-script-<версия>\ide\1c-enterprise-element-desktop-ide.exe
• Linux: /opt/1C/1CE/components/1c-enterprise-element-script-<версия>/ide/1c-enterprise-element-desktop-ide

Синтаксис команды

[путь_к_исполняемому_файлу] [рабочая_область] [файлы...] [параметры]

• путь_к_исполняемому_файлу — полный путь к исполняемому файлу 1c-enterprise-element-desktop-ide.exe.
• рабочая_область — необязательный первый аргумент. Если это директория — она открывается как рабочая область. Если первый аргумент — не директория, рабочая область определяется автоматически как наиболее «общая» родительская папка для всех переданных файлов.
• файлы — список файлов и/или директорий для открытия.
• параметры — дополнительные параметры среды разработки.

Если среда разработки не запущена:

• открывается новый экземпляр среды разработки;
• рабочая область — явно переданная директория, либо наиболее «общая» родительская папка для переданных файлов, либо директория по умолчанию;
• переданные файлы открываются в новом экземпляре среды разработки, ранее открытые в этой области файлы восстанавливаются;
• если среди файлов есть директории, после открытия отображается уведомление, что в качестве рабочей области можно открыть только одну из них.

Если среда разработки запущена:

• файлы добавляются в уже открытый экземпляр среды разработки;
• если первым аргументом передана директория, текущая рабочая область не меняется — пользователю предлагается открыть директорию как новую рабочую область;
• если рабочая область не передана, а среди файлов есть директории, пользователю предлагается открыть одну из них как рабочую область (или отказаться).

Для несуществующих файлов открывается «виртуальная» вкладка — файл и содержащие его директории можно создать в среде разработки.

Примеры

примечание

В примерах ниже для краткости записи путь к исполняемому файлу заменен командой 1c-enterprise-element-desktop-ide.

# Открыть скрипт и директорию
1c-enterprise-element-desktop-ide ~/work/scripts/Script1.sbsl

# Открыть несколько скриптов
1c-enterprise-element-desktop-ide ~/work/scripts/Script1.sbsl ~/work/extra/Script2.sbsl

# Открыть скрипты и директорию как рабочую область
1c-enterprise-element-desktop-ide ~/workspace/ ~/work/scripts/Script1.sbsl ~/work/extra/Script2.sbsl

# Скрипты на разных дисках — рабочая область определится автоматически
1c-enterprise-element-desktop-ide C:\work\scripts\Script1.sbsl D:\scenarios\Script2.sbsl

# Открыть скрипт с дополнительным параметром среды разработки
1c-enterprise-element-desktop-ide ~/work/scripts/Script1.sbsl --log-level trace

# Открыть директорию
1c-enterprise-element-desktop-ide ~/work/scripts/

См. также

• Подробнее об аргументах командной строки