|
Встроенные скрипты |
  
|
|
Встроенные скрипты |
|
В отличие от внешних скриптов, встроенные имеют следующие особенности -
| • | Они хранятся в конфигурации программы. |
| • | Они запускаются в среде программного процесса программы. |
| • | Они имеют расширенное объектное окружение. |
| • | Имеется возможность запуска скрипта по событиям изменений состояния объектов программы - клиентам, групповым счетам и внешним счетчикам. |
Это позволяет решать многие задачи автоматизации проще и эффективнее.
Для выполнения скрипта программа использует компоненты Windows Scripting. Скрипты могут быть написаны на языках JScript или VBScript - см. описание в MSDN. Объектное окружение при выполнении скриптов свое и имеет отличие в зависимости от способа запуска скрипта. Имеется два способа запуска -
| • | Встроенным планировщиком - по расписанию или вручную. В объектом окружении имеется объект Host. |
| • | По событиям изменения статуса объектов программы. В объектом окружении имеется объект Host и Sender. |
Если у объекта программы в настройках прописан запуск скрипта по событию, то этот скрипт также будет выполняться по событию загрузки конфигурации. Это событие производится в процессе старта службы программы сразу после первой успешной инициализации сетевых интерфейсов программы. Это сделано для того, что, если такой скрипт решает задачи внешнего управления, то после старта программы следует привести состояние внешнего управления состоянию объектов программы. Например, если скрипт управляет портами сетевого коммутатора, то после старта программы надо привести состояния всех портов в соответствие состояниями клиентов программы.
Служба программы не имеет возможности принудительно завершить работу скрипта. Служба программы не будет выгружена, пока выполняемый скрипт не завершит работу. Если на момент выгрузки службы в очереди есть невыполненные задачи, они будут отложены.
В программное окружение скриптов автоматически включены символические имена констант перечислений API Traffic Inspector.
Рекомендации по написанию скриптов.
Скрипты, генерируемые по событиям, ставятся на выполнение в отдельную очередь, в которой они обрабатываются последовательно одним программным потоком. Отложенные скрипты обрабатываются после того, как будут выполнены все скрипты из основной очереди.
Следует заботиться о том, что-бы скрипты выполнялись быстро, без больших задержек. Следует правильно выставить таймауты сетевых операций. В случае недоступности сетевой операции (например, отключилось сетевое оборудование), задачу следует сразу откладывать (см. процедуру SheduledTask()), а не пытаться в цикле ее выполнить повторно.
Для скриптов, которые могут долго выполняться, следует использовать проверки запроса на прерывание IsCancel().
Отладка и диагностика.
Для отладки и диагностики работы скрипта можно использовать функции вывода данных из скрипта в текстовый файл - см. процедуру Echo();
Для скриптов, запускаемых планировщиком, доступен как оперативный просмотр выводимых данных через консоль, так и из записываемого файла. Для скриптов, запускаемых по событиям, через консоль просмотра данных вывода не предусмотрено, запись данных в файл должна быть явно включена. Имена файлов вывода можно переопределить - см. свойство OutputFileName.
Текущая страница справки: http://help.smart-soft.ru/doc20/index.html?sdk_embeddedscript.htm