Автоматизация администрирования

 

Запуск сценариев через задания Windows

 

Командная строка запуска сценариев

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

Если сеть имеет доменную структуру, то для настройки автоматического выполнения сценариев рекомендуется использовать SAJobRunner.exe и специально созданного пользователя с Windows-аутентификацией. SAJobRunner.exe, в отличие от SBlauncher.exe, имеет следующие особенности:

·         остается запущенным на все время выполнения сценария и возвращает результат его выполнения, который может отражаться в свойствах назначенного задания: 0 – если выполнение сценария прошло успешно, 1 - если при выполнении сценария было сгенерировано исключение;

·         подавляет вывод на экран всех сообщений, которые могут возникнуть при выполнении сценария: сообщения об ошибках, сообщения, предусмотренные в вычислениях сценария и т.п. Если при выполнении произошло подавление сообщения, то генерируется исключение и выполнение сценария завершается с результатом 1. При этом исключение регистрируется в log-файле процесса sbsce (см. раздел «Расположение log-файлов клиентской части» в главе «Файловый состав»). Если было подавлено сообщение об ошибке, то в log-файл заносится текст ошибки; если было подавлено сообщение,  предусмотренное в тексте вычислений, то в log-файл заносится текст «Показ форм и сообщений в режиме работы службы невозможен.»;

·         может быть запущен только от имени пользователя с Windows-аутентификацией. Для этого пользователь Windows, указанный в свойствах назначенного задания, должен быть зарегистрирован в системе DIRECTUM с Windows-аутентификацией и должен иметь права на выполнение запускаемого  сценария.

При вызове файла SAJobRunner должны быть указаны ключи –S и –D или –SYS (см. раздел «Общие ключи запуска компонент» в главе «Запуск компонент системы DIRECTUM»), а также ключ –F и ключ –R, если в тексте сценария используются параметры:

·         -F - предназначен для указания выполняемого сценария. В качестве значения указывается имя сценария из компоненты Сценарии:

-F="Имя сценария из компоненты Сценарии"

Если опущен, то выполнения сценария не происходит;

·         -R – предназначен для передачи значений параметров, используемых в тексте сценария. Список таких параметров задается на этапе разработки сценария и может быть приведен в примечании к нему или в его описании. В качестве значения параметра -R может указываться строка значений параметров, используемых в тексте сценария:

-R=”<Параметр1>=<Значение1>|…|<ПараметрN>=<ЗначениеN>”

или полное имя текстового файла с указанием пути доступа:

-R=”Полное имя файла с указанием пути доступа”

Если указывается имя файла, то его структура должна быть следующей:

<Параметр1>=<Значение1>

<ПараметрN>=<ЗначениеN>

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

Например, для запуска сценария «Агент рассылки входящих заданий» в системе, данные которой расположены в базе данных DIRECTUM на сервере SQLSERVER, нужно использовать следующую командную строку:

"C:\Program Files\Common Files\NPO Computer Shared\IS-BUILDER\sajobrunner.exe" -S="SQLSERVER" –D="DIRECTUM"

-F="Агент рассылки входящих заданий" -R="LaunchParamsCode=JOBSENDING"

Если в сети нет доменов, то пользователей с Windows-аутентификацией использовать нельзя, и для настройки автоматического выполнения сценариев следует использовать файл SBLauncher.exe (см. раздел «Исполняемые файлы запуска компонент» в главе «Запуск компонент системы DIRECTUM»).

Например, для запуска сценария «Агент рассылки входящих заданий» в системе, данные которой расположены в базе данных DIRECTUM на сервере SQLSERVER, можно использовать следующую командную строку:

"C:\Program Files\DIRECTUM Company\DIRECTUM\SBLauncher.exe"

-S="SQLSERVER" –D="DIRECTUM" -CT="Script" -F="Агент рассылки входящих заданий" -R=" LaunchParamsCode=JOBSENDING" –N="User1" –W="12345"

 

 

 

См. также:

·         Порядок настройки запуска сценариев.