Утилита SAJobRunner.exe
Contents
Если сеть имеет доменную структуру, то для настройки автоматического выполнения сценариев рекомендуется использовать SAJobRunner.exe и специально созданного пользователя с Windows-аутентификацией или Novell-аутентификацией.
Примечание
Пользователь должен обладать правом «Вход в качестве службы» на компьютере, где настраивается автоматическое выполнение сценария. Подробнее см. в документации Microsoft Windows.
SAJobRunner.exe имеет особенности:
| • | остается запущенным на все время выполнения сценария и возвращает результат его выполнения, который может отражаться в свойствах назначенного задания: 0 –выполнение сценария прошло успешно, 1 – при выполнении сценария было сгенерировано исключение; |
| • | подавляет вывод на экран всех сообщений, которые могут возникнуть при выполнении сценария: сообщения об ошибках, сообщения, предусмотренные в вычислениях сценария и прочие. Если при выполнении произошло подавление сообщения, то генерируется исключение и выполнение сценария завершается с результатом 1. При этом исключение регистрируется в log-файле процесса sbsce. Подробнее см. раздел «Клиентская часть системы DIRECTUM». Если было подавлено сообщение об ошибке, то в log-файл заносится текст ошибки; если было подавлено сообщение, предусмотренное в тексте вычислений, то в log-файл заносится текст: «Показ форм и сообщений в режиме работы службы невозможен.»; |
| • | должен быть запущен от имени пользователя с Windows-аутентификацией или Novell-аутентификацией. Для этого пользователь Windows или Novell eDirectory, указанный в свойствах назначенного задания, должен быть зарегистрирован в системе DIRECTUM с Windows-аутентификацией или Novell-аутентификацией и должен иметь права на выполнение запускаемого сценария. |
Ключи для файла SAJobRunner.exe:
| • | -S – обязательный ключ, предназначен для указания наименования экземпляра SQL-сервера. Например: |
-S=MYSERVER
| • | -D – обязательный ключ, предназначен для указания наименования базы данных системы DIRECTUM. Например: |
-D=DIRECTUM_DB
| • | -F – обязательный ключ, предназначен для указания выполняемого сценария. В качестве значения указывается имя сценария из компоненты Сценарии: |
-F="Имя сценария из компоненты Сценарии"
| • | -R – необязательный ключ, предназначен для передачи значений параметров, используемых в тексте сценария. Список таких параметров может быть задан на этапе разработки сценария и может быть приведен в примечании к нему или в его описании. В качестве значения параметра -R может указываться строка значений параметров, используемых в тексте сценария: |
-R="<Параметр1>=<Значение1>|…|<ПараметрN>=<ЗначениеN>"
или полное имя текстового файла, содержащего параметры запуска сценария, с указанием пути доступа:
-R="Полное имя файла с указанием пути доступа"
Если указывается имя файла, то его структура должна иметь вид:
<Параметр1>=<Значение1>
<ПараметрN>=<ЗначениеN>
Если файл не найден, то считается, что передана строка параметров. Указывать одновременно и файл, и строку значений параметров нельзя;
| • | -HE – необязательный ключ, предназначен для блокировки вывода всех исключений на экран, которые могут возникнуть при выполнении сценария. Сообщения об исключениях записываются в лог утилиты; |
| • | -IM=False – необязательный ключ, признак работы сценария в интерактивном режиме. Возможные значения: IM=True, -IM=False. Значение по умолчанию IM=True; |
| • | -AuthType – необязательный ключ, предназначен для указания типа аутентификации. Возможные значения параметра: |
| • | OS – Windows-аутентификация; |
| • | NOVELL – Novell-аутентификация. |
Если опущен, то используется Windows-аутентификация.
Например, для запуска сценария Агент рассылки входящих заданий пользователем в системе, данные которой расположены в базе данных DIRECTUM на сервере SQLSERVER, нужно использовать следующую командную строку:
"C:\Program Files\Common Files\NPO Computer Shared\IS-BUILDER\sajobrunner.exe" -S="SQLSERVER" -D="DIRECTUM" -F="Агент рассылки входящих заданий" -R="LaunchParamsCode=JOBSENDING"
| © Компания DIRECTUM, 2018 | Сообщество пользователей DIRECTUM |