Перейти к содержанию

MAX-бот Дистансис

MAX-бот Дистансис позволяет управлять подключенными компьютерами через MAX: выбирать компьютер, запускать быстрые команды, выполнять задачи 1С, передавать параметры команд и получать результат выполнения прямо в чат.

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

Возможности MAX-бота

Через MAX-бота можно:

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

1. Привязка MAX к личному кабинету

Для работы с MAX-ботом нужно привязать MAX к учетной записи Дистансис.

Откройте личный кабинет:

https://lk.distansys.ru/

На главной странице выберите раздел Данные Max или откройте страницу Привязка MAX.

На странице привязки нажмите кнопку Открыть бота MAX.

После этого откроется бот Дистансис в MAX.

2. Если привязка не произошла автоматически

На странице Привязка MAX отображается специальный код привязки.

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

Пример кода:

maxlink_5e450cc3e-5ec3-418...

После отправки кода MAX будет привязан к вашей учетной записи Дистансис.

Код нужен только для привязки. После успешной привязки повторно отправлять его не требуется.

3. Запуск MAX-бота

Откройте MAX-бота Дистансис и отправьте команду:

/help

Бот отправит краткую справку и покажет доступные команды.

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

  • /find_comp — найти компьютер;
  • /select_comp — выбрать компьютер;
  • /current_comp — показать текущий компьютер;
  • /basic_commands — открыть быстрые команды;
  • /select_task — выбрать задачу;
  • /select_base_1c — выбрать базу 1С;
  • /help — показать справку.

4. Выбор компьютера

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

Для поиска компьютера используйте команду:

/find_comp

После команды бот попросит ввести параметры поиска.

Например, можно ввести часть имени компьютера:

desk

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

Также можно выбрать компьютер из списка командой:

/select_comp

Бот покажет список доступных компьютеров.

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

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

/current_comp

5. Быстрые команды

Для открытия быстрых команд используйте команду:

/basic_commands

Бот покажет список доступных быстрых команд.

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

  • Закрытие месяца;
  • Запустить приложение;
  • Очистить очередь печати;
  • Провести документ;
  • Перезапустить службу

Список быстрых команд зависит от настроек в личном кабинете Дистансис.

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

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

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

По компьютеру win10123456 задача ExecuteApp выполнена, результат Ok

6. Выбор задачи

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

/select_task

Бот покажет список задач, настроенных в личном кабинете Дистансис.

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

Например:

  • Часть 1/4;
  • Часть 2/4;
  • Часть 3/4;
  • Часть 4/4.

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

Например:

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

7. Выбор базы 1С

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

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

/select_base_1c

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

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

8. Ввод параметров команды

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

После выбора такой команды бот попросит ввести параметры.

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

service_name

В этом случае нужно отправить имя службы.

Пример:

Spooler

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

Пример сообщения:

Задача Перезапустить службу для win101235 создана

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

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

По компьютеру win101235 задача RestartService выполнена, результат Ok

9. Формат ручного ввода параметров

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

Возможны разные варианты:

  • позиционный ввод параметров;
  • именованные параметры;
  • пропуск значения по умолчанию.

Пример позиционного ввода:

Знач1 Знач2 "Значение с пробелом" Знач4

Пример именованных параметров:

key1=Значение key3="Строка с пробелами"

Если параметр нужно оставить по умолчанию, можно использовать специальное значение:

-

или

пропустить

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

Например, если бот показывает:

Ключи: service_name

нужно отправить значение для service_name, например:

Spooler

10. Что происходит после запуска задачи

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

  1. В Дистансис создается задача.
  2. Задача отображается в личном кабинете.
  3. Управляемый компьютер получает задачу.
  4. Клиент Дистансис выполняет команду на компьютере.
  5. Результат выполнения отправляется обратно в MAX.

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

Если при выполнении возникла ошибка, сообщение с ошибкой также приходит в MAX.

11. Где посмотреть созданную задачу

Все задачи, созданные через MAX-бота, отображаются в личном кабинете Дистансис.

В личном кабинете можно проверить:

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

Это удобно, если нужно проконтролировать выполнение задачи не только из MAX, но и через веб-интерфейс.

12. Общий порядок работы

Обычно работа с MAX-ботом выглядит так:

  1. Открыть личный кабинет Дистансис.
  2. Перейти в раздел Данные Max или Привязка MAX.
  3. Нажать Открыть бота MAX.
  4. Если привязка не произошла автоматически, отправить боту код привязки.
  5. Выполнить команду /help.
  6. Найти или выбрать компьютер через /find_comp или /select_comp.
  7. При необходимости выбрать базу 1С через /select_base_1c.
  8. Выбрать задачу через /select_task или открыть быстрые команды через /basic_commands.
  9. Указать параметры команды, если они требуются.
  10. Запустить задачу.
  11. Получить результат выполнения в MAX.

13. Пример сценария: очистка очереди печати

Пример запуска быстрой команды через MAX:

  1. Пользователь открывает MAX-бота Дистансис.
  2. Выполняет команду /select_comp.
  3. Выбирает компьютер win101235.
  4. Выполняет команду /basic_commands.
  5. Выбирает команду Очистить очередь печати.
  6. Дистансис создает задачу на выбранном компьютере.
  7. Клиент Дистансис выполняет команду.
  8. В MAX приходит результат выполнения.

14. Пример сценария: перезапуск службы

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

  1. Пользователь выбирает компьютер.
  2. Выполняет команду /select_task.
  3. Выбирает задачу Перезапустить службу.
  4. Бот запрашивает параметр service_name.
  5. Пользователь отправляет имя службы:

Spooler

  1. Дистансис создает задачу.
  2. После выполнения в MAX приходит результат.

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

По компьютеру win101235 задача RestartService выполнена, результат Ok

15. Важные рекомендации

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

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

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

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

Если задача не выполняется, проверьте:

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

16. Кратко

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