Команды

Раздел «Команды» используется для управления шаблонами команд, которые затем можно выполнять на удалённых компьютерах через задачи, групповые задачи или планировщик.

Команда в Дистансис — это заранее настроенное действие: запуск программы, выполнение кода 1С, загрузка внешней обработки, проверка параметров кассы, копирование файла, регистрация DLL, перезапуск службы и другие типовые действия.

Готовые команды

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

В списке команд отображаются:

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

Примеры стандартных команд:

• архивирование файла базы 1С;
• выполнение кода 1С;
• получение заводского номера ККТ;
• загрузка и обновление конфигурации 1С;
• загрузка расширения в базу 1С;
• перезапуск службы
• пегистрация dll

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

Создание своей команды

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

При создании указываются основные параметры:

Наименование

Это название команды, которое будет отображаться в списке.

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

Примеры:

• Внешняя обработка 1С закрытия кассовой смены
• Регистрация dll
• Проверка свободного места
• Загрузка файла в облако

Команда

В поле «Команда» выбирается вид команды из предопределённого списка.

Вид команды определяет, какое действие будет выполнено на удалённом компьютере.

Например:

• запуск приложения;
• выполнение кода 1С;
• загрузка внешней обработки;
• копирование файла;
• создание каталога;
• регистрация DLL;
• проверка даты ОФД;
• получение заводского номера ККТ;
• скачивание файла из облака;
• загрузка файла в облако.

Набор доступных видов команд задаётся системой. Пользователь выбирает нужный вариант из списка.

Признаки команды

У команды могут быть дополнительные признаки.

Для 1С

Используется, если команда связана с запуском внешней обработки 1С.

Для службы

Используется для команд, которые должны выполняться с правами системы на удалённом компьютере.

Такие команды подходят для служебных операций Windows, например регистрации DLL, работы с файлами, каталогами или системными компонентами.

Быстрая команда бота

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

Параметры команды

У команды могут быть параметры.

Параметры состоят из двух частей:

Поле	Описание
Параметр	техническое имя параметра
Значение	значение, которое будет передано при выполнении команды

Например, для команды регистрации DLL может использоваться параметр:

Параметр	Значение
dll_name	путь или имя DLL-файла

Для команды запуска внешней обработки 1С может быть указано имя файла обработки, например:

test.epf

Когда указывать значения параметров

Значения параметров можно указывать двумя способами.

1. При создании команды

Этот вариант подходит, если команда всегда выполняется с одними и теми же параметрами.

Например, если команда всегда должна запускать одну и ту же внешнюю обработку или использовать один и тот же файл.

1. При выполнении задачи

Этот вариант подходит, если команда одна и та же, но значения меняются от задачи к задаче.

Например:

каждый раз используется другой файл; нужно указать другой путь; оператор должен перед запуском указать конкретное значение.

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

Добавление строки параметра

Чтобы добавить параметр:

В блоке «Параметры команды» нажмите «Добавить строку». Укажите имя параметра. Укажите значение параметра, если оно известно заранее. Сохраните команду.

Если параметр больше не нужен, его можно удалить кнопкой удаления строки.

Редактирование команды

Для изменения существующей команды откройте её из списка.

В режиме редактирования можно изменить:

наименование; вид команды; признаки «Для 1С», «Для службы», «Быстрая команда бота»; параметры команды; значения параметров.

После внесения изменений нажмите «Сохранить».

Важно

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

Удаление команды

В карточке редактирования команды доступна кнопка «Удалить команду».

Удалять команду следует только в том случае, если она больше не используется.

Важно

Не удаляйте команду, если она используется в планировщике, групповых задачах или типовых сценариях обслуживания. Сначала проверьте, что команда больше не нужна.

Рекомендации по работе с командами

Используйте понятные названия команд. Оператор должен понимать назначение команды без просмотра технических параметров.

Для часто используемых действий лучше создавать отдельные команды с заранее заполненными параметрами.

Если действие выполняется с разными значениями, лучше оставить значение параметра пустым и заполнять его при создании задачи.

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

Для сложных сценариев используйте групповые команды, объединяя несколько отдельных команд в одну последовательность выполнения.

Пример использования

Допустим, нужно создать команду для запуска внешней обработки 1С.

Укажите наименование: Внешняя обработка 1С. В поле «Команда» выберите подходящий вид команды для запуска обработки. Включите признак «Для 1С». В параметрах укажите файл обработки, например test.epf, если он известен заранее. Нажмите «Сохранить».

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