<< Щелкните, чтобы показать Содержание >> Разработчику > Руководство разработчика > Сценарии

Разработка сценариев для выполнения по расписанию

Contents

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

Сценарии для выполнения по расписанию разрабатываются в компоненте Сценарии. Подробнее см. раздел «Компонента «Сценарии».

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

через справочник «Параметры запуска компонент»

1.	Создайте новый сценарий.

2.	Создайте запись справочника Параметры запуска компонент и заполните в ней параметры сценария. Подробнее см. раздел «Параметры запуска компонент».

3.	В начале текста сценария вызовите функцию GetComponentLaunchParams для обращения к значениям его параметров:

// Получить список параметров из справочника «Параметры запуска компонент».

ListParams = GetComponentLaunchParams()

// Считать элементы списка по имени элемента в переменные.

if ListParams.IndexOfName(ИмяПараметра1) <> -1

Переменная1 = ListParams.ValueByName(ИмяПараметра1)

else

Переменная1 = ЗначениеПоУмолчанию1

endif

if ListParams.IndexOfName(ИмяПараметра2) <> -1

Переменная2 = ListParams.ValueByName(ИмяПараметра2)

else

Переменная2 = ЗначениеПоУмолчанию2

endif

//… Продолжение выполнения сценария.

где

•	Переменная№ – имя переменной сценария;

•	ИмяПараметра№ – имя параметра из записи справочника Параметры запуска компонент;

•	ЗначениеПоУмолчанию№ – значению параметра по умолчанию.

Функция возвращает список параметров и их значений из записи справочника Параметры запуска компонент, код которой указан в параметре запуска сценария LaunchParamsCode. Подробное описание функции см. в компоненте Функции ISBL.

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

В этом случае формат строки для передачи параметров имеет вид:

-R="LaunchParamsCode=<Код записи справочника Параметры запуска компонент>"

вручную через командную строку

1.	Создайте новый сценарий.

2.	В начале текста сценария добавьте вызов функции GetComponentLaunchParams.

В этом случае формат строки для передачи параметров имеет вид:

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

Варианты запуска:

•	если сеть имеет доменную структуру, то для настройки автоматического выполнения сценариев рекомендуется использовать SAJobRunner.exe и специально созданного пользователя с Windows-аутентификацией или Novell-аутентификацией;

•	если нет возможности работать с Windows-аутентификацией или Novell-аутентификацией, то для настройки автоматического запуска компонент следует использовать утилиту SBLauncher.exe.

Для выполнения сценария по расписанию можно использовать:

•	назначенные задания Windows

•	серверные события

Пример вызова сценария, значения параметров которого заданы в справочнике Параметры запуска компонент:

sajobrunner.exe -S="SQLSERVER" -D="DIRECTUM" -F="Рассылка об окончании срока действия сертификата" -R="LaunchParamsCode=РАССЕРТ"

Сообщество пользователей DIRECTUM