Групповые команды

Раздел «Групповые команды» используется для создания цепочек действий, которые должны выполняться на удалённом компьютере в заданном порядке.

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

Например, обновление базы 1С может состоять из нескольких этапов:

1. Создать архив базы.
2. Скачать файл обновления.
3. Загрузить обновление в режиме конфигуратора и обновить конфигурацию.
4. Выполнить обновление базы 1С в режиме предприятия.

В результате оператор запускает одну групповую команду, а Дистансис последовательно выполняет все действия из цепочки.

Список групповых команд

В разделе «Групповые команды» отображается список уже созданных групповых команд.

В списке показывается наименование групповой команды, например:

• Загрузка расширения 1С
• Обновление конфигурации ЗУП

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

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

Создание групповой команды

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

• наименование;
• признак «Прерывать по ошибке»;
• список команд для выполнения;
• порядок выполнения команд.

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

В поле «Наименование» указывается понятное название групповой команды.

Название должно отражать итоговую задачу, которую выполняет цепочка.

Примеры:

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

Прерывать по ошибке

Признак «Прерывать по ошибке» определяет поведение цепочки при ошибке на одном из этапов.

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

Это важно для сценариев, где следующие действия нельзя выполнять, если предыдущий этап завершился неуспешно.

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

Рекомендация

Для критичных операций, таких как обновление 1С, изменение конфигурации, загрузка расширений или выполнение служебных команд, рекомендуется включать признак «Прерывать по ошибке».

Команды для выполнения

В блоке «Команды для выполнения» формируется цепочка команд.

Каждая строка — это отдельная команда, которая будет выполнена на удалённом компьютере.

Команды выполняются сверху вниз, в том порядке, в котором они указаны в списке.

Пример цепочки:

№	Команда	Назначение
1	Создание архива базы	Создать резервную копию перед изменениями
2	Скачать файл с облака	Получить файл обновления или расширения
3	Загрузка расширения в базу 1С	Загрузить расширение в информационную базу
4	Выполнить код 1С	Выполнить завершающие действия внутри базы

Добавление команды в цепочку

Чтобы добавить команду в групповую команду:

1. Нажмите «Добавить команду».
2. В новой строке выберите нужную команду из списка.
3. При необходимости добавьте ещё команды.
4. Проверьте порядок выполнения.
5. Нажмите «Сохранить».

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

Удаление команды из цепочки

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

После удаления строки сохраните изменения.

Важно

Удаление команды из цепочки влияет только на состав групповой команды. Сама обычная команда из раздела «Команды» при этом не удаляется.

Пример: обновление базы 1С

Рассмотрим пример групповой команды для обновления базы 1С.

Цепочка может состоять из следующих действий:

1. Создание архива базы
   Перед обновлением создаётся резервная копия базы.

2. Скачивание файла обновления
   На удалённый компьютер загружается файл обновления из облака.

3. Загрузка обновления в режиме конфигуратора
   Обновление загружается в базу 1С через конфигуратор.

4. Обновление базы 1С в режиме предприятия
   После изменения конфигурации выполняется обновление базы в пользовательском режиме.

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

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

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

Групповые команды удобно использовать для повторяющихся сценариев обслуживания.

Типовые примеры:

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

Отличие обычной команды от групповой

Обычная команда выполняет одно действие.

Групповая команда выполняет несколько обычных команд последовательно.

Например:

Тип	Пример
Обычная команда	Скачать файл из облака
Обычная команда	Выполнить код 1С
Групповая команда	Скачать файл, загрузить расширение, выполнить код 1С

Если задача состоит из одного действия, достаточно обычной команды.

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

Редактирование групповой команды

При редактировании групповой команды можно изменить:

• наименование;
• признак «Прерывать по ошибке»;
• список команд;
• порядок выполнения команд.

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

Важно

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

Удаление групповой команды

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

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

Важно

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

Рекомендации

Создавайте групповые команды для тех операций, которые выполняются регулярно.

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

Размещайте команды в строгом порядке выполнения.

Для критичных операций включайте «Прерывать по ошибке».

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

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