Документация Algorius Net Viewer | Внешние команды

Общие сведения

Можно добавлять внешние команды устройствам на карте. Например, запуск утилиты ping.exe, вызов удаленного рабочего стола и т.д. При этом параметры устройства, например, адрес, проставляются автоматически. Это превращает Algorius Net Viewer в эффективный инструмент управления компьютерной сетью.

Algorius Net Viewer содержит большой список предустановленных внешних команд. При первом запуске приложение автоматически проверяет, какие из внешних команд доступны на компьютере пользователя, те включаются. Можно скрыть или удалить команды, которые не требуются, или добавить новые команды.

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

Настройка

Чтобы настроить список внешних команд, выберите Команды→Настроить в контекстном меню устройства. Появится окно Настройки:

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

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

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

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

Нажатие кнопок Вверх (Ctrl+Up) или Вниз →Ctrl+Down) позволяет переупорядочить внешние команды для удобства использования.

Нажатие на кнопку Добавить, Дублировать или Править отобразит окно Внешняя команда:

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

Предусмотрены следующие макросы:

%ADDRESS%	Адрес устройства
%HOST%	Имя хоста устройства
%IP%	IP адрес устройства
%IPV4%	IPv4 адрес устройства
%IPV6%	IPv6 адрес устройства
%MAC%	MAC адрес устройства
%NAME%	Название устройства
%DESCRIPTION%	Описание устройства
%MAP%	Название карты (имя файла без расширения)
%TIME%	Текущее время в формате операционной системы
%USER%	Имя текущего пользователя операционной системы
%COMPUTER%	Название локального компьютера
%LOGIN_USER%	Имя пользователя для авторизации на устройстве
%LOGIN_PASSWORD%	Пароль для авторизации на устройстве

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

Вы можете добавлять произвольные макросы, например, %Timeout%. Их значения не будут подставляться автоматически, а будут запрашиваться. При этом если название макроса содержит слово Password, то оно будет запрашиваться в скрытом виде. Имена произвольных параметров не могут содержать пробел, чтобы исключить случайную замену текста между двумя символами ‘%’, в этом случае используйте подчеркивание вместо пробела.

Макросы %LOGIN_USER% и %LOGIN_PASSWORD% подставляются из логина, заданного для устройства. Если любой из этих параметров не указан, то он будет запрошен перед запуском команды.

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

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

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

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

Выполнение

Чтобы выполнить внешнюю команду, выберите ее в контекстном меню устройства. Если команде для выполнения требуется адрес устройства (используется макрос %ADDRESS%, %HOST%, %IP%, %MAC%), но соответствующий адрес устройства не определён, то данная команда будет заблокирована для выполнения. Это позволяет исключить запуск внешних команд для пассивных объектов, например, зданий.