Выполнение задач

Раздел создания задач используется для запуска команд на удалённых компьютерах.

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

Общая схема создания задачи

При создании задачи нужно последовательно указать:

1. клиента;
2. команду или групповую команду;
3. значения параметров, если они требуются;
4. компьютеры, на которых нужно выполнить задачу;
5. базы 1С, если команда выполняется для 1С;
6. нажать «Создать».

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

Выбор клиента

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

После выбора клиента отображается список компьютеров, относящихся к этому клиенту.

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

Выбор групповой команды

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

Например, групповая команда «Загрузка расширения 1С» может включать несколько последовательных действий:

1. скачать файл с облака;
2. скачать дополнительный файл с облака;
3. загрузить расширение в базу 1С;
4. выполнить код 1С после загрузки.

Если выбрана групповая команда, поле «Команда» заполняется как «Групповая задача». Это означает, что будет выполнена не одна команда, а вся цепочка действий, настроенная в разделе «Групповые команды».

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

Параметр	Значение
task01	данные первой команды цепочки
task02	данные второй команды цепочки
task03	данные третьей команды цепочки
task04	данные четвёртой команды цепочки

Эти строки отражают состав групповой команды и её внутренние действия.

Важно

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

Выполнение одной команды

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

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

Например:

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

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

Пример описания:

Выполнить функцию общего модуля 1С,
где "name_module" — название общего модуля,
"name_func" — имя функции.
Параметры: name_module; name_func

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

У некоторых команд есть параметры. Они отображаются в таблице «Параметры команды».

Таблица состоит из двух колонок:

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

Пример для команды закрытия месяца:

Параметр Значение name_module ЗакрытиеМесяца_Выполнение name_func ЗакрытиеМесяца Перепровести Нет Организация значение указывается при необходимости Месяц значение указывается при необходимости Год значение указывается при необходимости

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

Когда заполнять параметры при создании задачи

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

Например:

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

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

Выбор компьютеров

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

Можно выбрать один компьютер или несколько компьютеров.

Для удобства доступны кнопки:

«Отметить все» — выбрать все компьютеры из списка; «Снять отметки» — снять выбор со всех компьютеров.

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

Важно

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

Выбор базы данных 1С

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

База отображается в формате:

Имя компьютера - имя базы

Например:

DESKTOP-12345 - ЗУП

Выбор базы нужен для команд, которые выполняются внутри 1С:

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

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

Пример: проверка ОФД

Чтобы создать задачу проверки отправки чеков в ОФД:

Выберите клиента. В поле «Групповая команда» выберите «Без групповой команды». В поле «Команда» выберите команду проверки ОФД. Проверьте параметры команды. Отметьте нужные компьютеры. Нажмите «Создать».

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

Пример: закрытие месяца в 1С

Чтобы создать задачу закрытия месяца:

Выберите клиента. В поле «Групповая команда» выберите «Без групповой команды». В поле «Команда» выберите команду «Закрытие месяца».

Проверьте параметры:

Параметр Пример значения name_module ЗакрытиеМесяца_Выполнение name_func ЗакрытиеМесяца Перепровести Нет Организация укажите при необходимости Месяц укажите месяц Год укажите год Отметьте компьютер. Отметьте базу 1С. Нажмите «Создать».

После создания задача будет выполнена для выбранной базы 1С.

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

Чтобы создать задачу на основе групповой команды:

Выберите клиента. В поле «Групповая команда» выберите нужную групповую команду. Проверьте состав команды в таблице параметров. Отметьте компьютеры. Если групповая команда работает с 1С, отметьте нужную базу данных. Нажмите «Создать».

Дистансис выполнит все команды из цепочки в заданном порядке.

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

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

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

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

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

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

Проверяйте выбранного клиента, компьютеры и базы 1С перед нажатием «Создать».

Просмотр созданных задач

После создания задачи она появляется в разделе «Задачи».

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

Список задач

В таблице задач отображаются основные сведения:

Колонка	Описание
Дата	дата и время создания задачи
Задача	наименование выполненной команды или групповой команды
Компьютер	компьютер, на котором выполнялась задача
Выполнено	дата и время завершения выполнения
Результат	результат выполнения задачи

Пример результата:

Дата	Задача	Компьютер	Выполнено	Результат
9 июня 2026 г. 17:21	PingClient	WIN-JKSJ8M9UMEC	9 июня 2026 г. 17:21	Ok

Если задача выполнена успешно, в колонке «Результат» отображается значение Ok.

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

Фильтр по датам

Над таблицей задач расположены поля:

• Начальная дата;
• Конечная дата;
• кнопка «Применить фильтр».

Фильтр позволяет посмотреть задачи за выбранный период.

Чтобы отфильтровать задачи:

1. Укажите начальную дату.
2. Укажите конечную дату.
3. Нажмите «Применить фильтр».

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

Добавление новой задачи из списка

В верхней части раздела «Задачи» доступна кнопка «Добавить».

Она используется для перехода к созданию новой задачи.

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

Контроль выполнения

После запуска задачи рекомендуется проверить её результат в списке задач.

Особенно это важно для операций:

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

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

Интерпретация результата

Значение Ok означает, что команда была выполнена успешно.

Если результат отличается от Ok, нужно проверить текст ошибки.

Возможные причины ошибки:

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

Важно

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

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

Проверяйте список задач после каждого массового запуска.

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

Для диагностики сначала смотрите колонку «Результат».

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

При работе с 1С убедитесь, что выбрана правильная база данных.

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