Руководство по настройке сценария «Агент рассылки входящих заданий»
В связи с частыми обращениями в службу поддержки DIRECUM за консультациями по настройке сценария «Агент рассылки входящих заданий», предлагаем вашему вниманию инструкцию по его настройке для DIRECTUM 4.6.1.
Сценарий «Агент рассылки входящих заданий» предназначен для оповещения исполнителей о входящих заданиях по электронной почте. Для работы сценария, необходимо заполнить справочник «Контактные лица организаций» и настроить систему DIRECTUM для работы с почтой, поэтому сначала поговорим об этом.
Заполнение справочника «Контактные лица организаций»
Для автоматической рассылки уведомлений на e-mail, необходимо настроить систему DIRECTUM таким образом, чтобы каждому пользователю, для которого планируется рассылка, соответствовала одна запись в справочнике «Персоны», а каждой персоне - соответствовала одна запись в справочнике «Контактные лица организации».
Справочник «Контактные лица организаций» не рекомендуется заполнять «вручную» - открыв справочник и создавая новые карточки стандартным способом. Корректно заполнять данный справочник следует из карточки справочника «Персоны», с помощью кнопки Контакт. лица:
Для создания записей в справочнике «Контактные лица организаций», выполните следующие шаги:
- Откройте справочник Персоны. Откройте карточку.
- По кнопке Контакт. лица, перейдите в справочник «Контактные лица организаций».
- Создайте/откройте карточку для текущей персоны. В соответствующем поле, заполните e-mail, на который будут приходить уведомления.
Проверка электронной почты
Т.к. агент рассылает письма через почтовый ящик, необходимо убедиться, что данный почтовый ящик работает и почтовый сервер доступен в сети. Для этого выполните следующие шаги:
- Установите почтовый клиент (пример: MS Office Outlook 2007) на компьютер, с которого будет происходит отправка электронной почты системой DIRECTUM.
- Настройте учетную запись для почтового клиента, которая будет использоваться для автоматической рассылки. Назначьте соответствующий электронный адрес (пример: robot@demodirectum.ru)
- Проверьте работу исходящей и входящей почты, отправив письмо, адресованное самому себе.
Если почта работает корректно, переходите дальше, иначе – обратитесь к системному администратору почтового сервера.
Работа с почтой в DIRECTUM
Параметры работы с электронной почтой задаются с помощью сценария «Установки модулей системы DIRECTUM» в группе установок «Работа с почтой» (Компоненты\ Утилиты администратора\ Установки системы и администрирование БД). Для отправки почты, могут использоваться два типа почтовых серверов:
● POP3/SMTP
● Exchange.
Рассмотрим настройку сценария «Установки модулей системы DIRECTUM» для каждого отдельно.
POP3/SMTP
Для настройки параметров работы с электронной почтой через POP3/SMTP, выполните следующие шаги:
- Запустите сценарий «Установки модулей системы DIRECTUM» (Компоненты\ Утилиты администратора\ Установки системы и администрирование БД).
- Выберите группу установок «Работа с почтой».
- Выберите тип почтового сервера входящей почты: POP3
- Укажите адрес почтового сервера, порт, имя пользователя и пароль учетной записи, которая будет использоваться для получения входящей почты.
Пример:
Сервер входящей почты (POP3): DemoDIRECTUM (сетевое имя cервера, на котором находится почтовый сервер)
Порт POP3-сервера: 110
Имя пользователя: robot
Пароль: Password
5. Нажмите кнопку Далее >>
6. Выберите тип почтового сервера исходящей почты: SMTP
7. Настройте параметры исходящей почты аналогично пункту 4.
Пример:
Имя отправителя почты: DIRECTUM (Имя указывается в параметре From (отправитель) электронного письма, можно указать произвольное)
Электронный адрес отправителя почты: robot@demodirectum.ru
Имя программы-отправителя почты: DIRECTUM (имя программы, которой было отправлено электронное письмо, можно указать произвольное)
Сервер исходящей почты (SMTP): DemoDIRECTUM (сетевое имя компьютера, на котором находится почтовый сервер)
Порт SMTP-сервера: 25
SMTP-серверу требуется проверка подлинности: да (Признак проверки подлинности при подключении к серверу исходящей почты)
Имя пользователя: robot
Пароль: Password
7. Нажмите кнопку Готово.
Exchange
Для настройки параметров работы с электронной почтой через Exchange, выполните следующие шаги:
- Запустите сценарий «Установки модулей системы DIRECTUM» (компоненты администратора, установки системы и администрирование БД).
- Выберите группу установок «Работа с почтой».
- Выберите тип почтового сервера входящей почты: Exchange
4. Нажмите кнопку Далее >>
5. Укажите имя профиля Exchange. Узнать имя конфигурации Exchange профиля можно следующим образом: откройте меню Пуск\ Панель управления. Выберите группу «Почта». В открывшемся окне, в разделе конфигурации – нажмите кнопку «Показать». Текст в окне: на компьютере установлены следующие конфигурации: «ИмяКонфигурации», где «ИмяКонфигурации» - и есть имя профиля Exchange, которое следует вводить в DIRECTUM (на скриншоте - Outlook).
6. Выберите тип почтового сервера исходящей почты: Exchange. Укажите имя профиля Exchange аналогично пункту 5. Пример: Outlook.
7. Нажмите кнопку Готово.
Проверка корректности настроек
Все подготовительные работы выполнены, теперь следует выполнить проверку корректности работы агента. Сделаем это следующим образом:
- Создайте задачу пользователю, немного подождите, убедитесь, что задание для пользователя пришло, и оно в состоянии «не прочтено».
- Запустите сценарий «Агент рассылки входящих заданий» «вручную» из компоненты Сценарии, с помощью кнопку Выполнить.
- Проверьте почтовый ящик пользователя, для которого была создана задача.
Если письмо пришло, переходите к настройке планировщика заданий, иначе проверьте правильность выполнения предыдущих шагов.
Настройка запуска агента
Для регулярного запуска агента рассылки по расписанию, рекомендуется использовать планировщик заданий Windows. Для настройки планировщика заданий выполните следующие шаги (настройка описана для Windows 2008).
- Запустите планировщик заданий Windows (Панель управления\ Администрирование\ Планировщик заданий).
- Создайте новую задачу для планировщика заданий, укажите следующие параметры:
действие: запускать программу: sajobrunner.exe
(обычно находится по адресу: C:\Programm Files\Common Files\NPO Computer Shared\IS-Builder)
аргументы запуска: -S="<имя sql сервера >" -D="<имя БД DIRECTUM>" -CT="Script" -F="Агент рассылки входящих заданий"
Пример: sajobrunner.exe -S="DEMODIRECTUM" -D="DIRECTUMDataBase" -CT="Script" -F="Агент рассылки входящих заданий"
Для запуска сценария, вы также можете использовать следующую форму:
sblauncher.exe -SYS="DIRECTUM" -CT="Script" -F="Агент рассылки входящих заданий" -N="Administrator" -W="Password",
но такая форма менее предпочтительна при работе на сервере, т.к. sblauncher.exe, в отличии от sajobrunner.exe, не подавляет вывод исключений и диалоговых окон на экран.
3. Настройте запуск задачи по расписанию с помощью соответствующих триггеров и условий в планировщике заданий (например, запускать сценарий каждый час).
Внимание:
- Запуск задачи следует производить от учетной записи Windows пользователя, имеющего права в DIRECTUM на запускаемый сценарий или компоненту.
- Для учетной записи Windows пользователя, от которого будет работать SAJobRunner, на сервере в локальных политиках безопасности (Администрирование\ Локальная политика безопасности) нужно задать следующее: В разделе "Локальные политики - Назначение прав пользователя" в политики "Вход в качестве пакетного задания" и "Вход в качестве службы" необходимо добавить пользователя от имени которого выполняется задание. В противном случае, придется всегда держать открытым сеанс Windows под этим пользователем. Если же сделать эти настройки, то задание будет работать и без открытого сеанса.
- При использовании SAJobRunner, в аргументах запуска следует указывать имя сервера и базы данных, и не допускается указание вместо них кода системы.
- При самом первом запуске сценария рассылка не состоится, т.к. будет просто установлено время запуска. В последующие запуски, в константу РАСЗДЧВР будет записано время последнего запуска, чтобы исключить повторную рассылку по одному и тому же невыполненному заданию.
4. Проверьте настройку планировщика заданий. Создайте задачу в DIRECTUM пользователю, убедитесь, что пользователь получил задание в папке Входящие и оно в состоянии «не прочтено». Дождитесь времени запуска задачи планировщика заданий. Проверьте электронную почту пользователя - вы должны получить уведомление.
Дополнительные возможности запуска сценария "Агент рассылки входящих заданий"
1. Письма могут рассылаться пользователям, имена и почтовые ящики которых указанны в файле. Для работы в этом режиме, необходимо создать текстовый файл со списком электронных адресов, на которые будет происходить рассылка, по шаблону:
<Имя пользователя 1>;<Адрес e-mail 1>|<Имя пользователя 2>;<Адрес e-mail 2>|…
где:
<Имя пользователя> - имя пользователя системы DIRECTUM (логин);
<Адрес e-mail> - адрес электронной почты, по которому будут приходить задания для указанного пользователя.
Пример командной строки для запуска сценария в этом режиме:
sblauncher.exe -SYS="DIRECTUM" -CT="Script" -F="Агент рассылки входящих заданий" -R="C:\UsersList.txt"
sajobrunner.exe -S="MAINSERVER" -D="DIRECTUM" -CT="Script" -F="Агент рассылки входящих заданий" -R="C:\UsersList.txt"
2. Письма могут рассылаться пользователям, которые явно указаны в строке запуска. Пример командной строки для запуска сценария в этом режиме:
sblauncher.exe -SYS="DIRECTUM" -CT="Script" -F="Агент рассылки входящих заданий" -N="Administrator" -W="Password" -R="Type=U|Users=User1;User2| EMails=User1@yourcompany.com;User2@yourcompany.com"
sajobrunner.exe -S="MAINSERVER" -D="DIRECTUM" -CT="Script" -F="Агент рассылки входящих заданий" -R="Type=U|Users=User1;User2| EMails=User1@yourcompany.com;User2@yourcompany.com"
3. Письма рассылаются пользователям, которые указанны в записи справочника «Параметры запуска компонент». Пример командной строки для запуска сценария в этом режиме:
sblauncher.exe -SYS="DIRECTUM" -CT="Script" -F="Агент рассылки входящих заданий" -R="LaunchParamsCode=JOBSENDING"
sajobrunner.exe -S="MAINSERVER" -D="DIRECTUM" -CT="Script" -F="Агент рассылки входящих заданий" -R="LaunchParamsCode=JOBSENDING"
Если указан параметр «LaunchParamsCode», то параметры «Type», «Users» и «EMails» указывать не надо. В данном случае информация о списках рассылок должна находиться в записи справочника "Параметры запуска компонент", код которой указывается в значении параметра "LaunchParamsCode".
Для более ранних версий DIRECTUM есть интересная статья в базе знаний на аналогичную тему Рекомендации по настройке сценария "Агент рассылки входящих заданий"
Как быть с рассылкой если работает репликация и есть вторичные сервера? На каком сервере запускать агент? Будут ли письма по несколько раз приходить?
Несколько примечаний, касающихся настройки работы с почтовыми серверами, способных облегчить жизнь администраторов.
В текущей реализации System Builder Universal Mailer (SBUM) накладывает следующие ограничения при работе с почтовыми серверами:
1. При работе с Exchange - сервером требуется установка MS Outlook (работа с прочими почтовыми клиентами не гарантируется).
2. Для отправки сообщений на почтовый сервер вне зависимости от состояния сессии пользователя ОС, должен быть отключен режим кэширования Exchange в настройках учетной записи Outlook.
3. Имя профиля соединения с Exchange сервером на данный момент задается жестким значением: "Outlook".
Как быть в случае нескольких вторичных серверов?
Поскольку каждый из серверов репликации (будь то главный или вторичные) являются самостоятельными серверами DIRECTUM, то в данном случае можно воспользвоаться следующими способами:
1. Обеспечить выполнение агента рассылки входящих заданий на главном сервере. При этом будут доступны все задания каждой из систем (поскольку все данные со вторичных серверов реплицируются на главный). Однако, стоит учесть зависимость оперативности рассылки от интервала выполнения сеансов репликации. Если репликация выполняется редко, то уведомление может прийти значительно позже фактического выполнения задания.
Примечание: для корректности выполнения рассылки должны реплицироваться справочники,у частвующие в настройке агента рассылки.
2. Обеспечить выполнение агента рассылки входящих заданий на каждом из серверов. Данный способ позволит более оперативно получать уведомления о поступивших заданиях.
Примечание: если не исключить из обработки агентом главного сервера заданий вторичных серверов, то возможно дублирование писем пользвоателям вторичных серверов.
В конечном итоге вариант выбора стоит за администратором системы. Наиболее простым является первый способ, но на практике могут быть получены прочие ответы.
Нет. Достаточно установить бесплатный пакет Extended MAPI and CDO.
Такого ограничения нет ни в SBUM, ни в функциях ISBL для работы с почтой.
Мне еще DCOM пришлось настраивать. Я что-то пропустил в настройках или это обязательный пункт?
Константин Широбоков,
У компании ДИРЕКУТМ есть планы по доведению до ума агента с учетом всех вариантов которые вы предложили?
Для SBUM?
В зависимости от.
Что именно вы настраивали?
Для SBUM'а настроить DCOM вообще не удалось, т.к. для него не существует APPID - т.е. он не отображается в списке компонентов. Обращение сейчас находится в СП.
DCOM настроил на IS-Builder Logon, т.к. он изначально на него ругался (сейчас, соответственно, происходит ошибка на Local Activate SBUM).
Собственно запуск агента по рассылке входящих заданий с помощью sajobrunner из-под пользователя с windows-аутентификацией в Task Sheduler.
Для SBUM, как правило, ничего настраивать и не надо. "Запуск от имени указанного пользователя" рекомендуется заменять на настройку клиента. Т.е. в случае заданий Windows надо просто указать запуск sbrte от указанного пользователя.
Разумеется, все это относится только к особенностям доступа к Exchange (MAPI). Для POP3/SMTP применяется парольная аутентификация.
Вообще, хоть какие-то сложности, приводящие к необходимости настройки DCOM ("запуск от имени") я встречал только при
а) обращении к COM-серверам из VB.NET;
б) использовании позднего связывания (late binding).
Во всех остальных случаях достаточно было просто указать запуск клиентского приложения от нужного аккаунта.
Давайте еще раз. Что именно вы настраивали в dcomcnfg для SBLogon?
Давайте. С начала:
1) В таск шедулере настроено задание на запуск от имени пользователя DocMail со следующей строкой на запуск:
"C:\Program Files (x86)\Common Files\NPO Computer Shared\IS-Builder\SAJobRunner.exe"
и доп. параметрами:
-S="EKA-SQL" -D="DirectumTest" -CT="Script" -F="Агент рассылки входящих заданий"
2) После первого запуска ничего не происходит. В эвент вьювере можно увидеть в разделе System можно увидеть следующее событие:
The machine-default permission settings do not grant Local Activation permission for the COM Server application with CLSID
{0A790054-8E2E-4099-8B1F-2F0492F97194}
and APPID
{0A790054-8E2E-4099-8B1F-2F0492F97194}
to the user EKA\DocMail SID (S-1-5-21-4031759066-3832068547-2654856660-8261) from address LocalHost (Using LRPC). This security permission can be modified using the Component Services administrative tool.
Ключу {0A790054-8E2E-4099-8B1F-2F0492F97194} соответствует ISBuilder Logon. Т.к. не хватает права на Local Activation, то соответственно я даю пользователю DocMail на Local Activation компоненты ISBuilder Logon. И на ISBuilder, на всякий случай тоже.
3) После этого любые другие сценарии Директума отрабатывают успешно, кроме агента по рассылке входящих заданий. При его запуске (и по всей видимости до посылки первого письма) возникает следующее событие:
The machine-default permission settings do not grant Local Activation permission for the COM Server application with CLSID
{A1B65D46-9DDA-494D-AC21-180207E55F6F}
and APPID
Unavailable
to the user EKA\DocMail SID (S-1-5-21-4031759066-3832068547-2654856660-8261) from address LocalHost (Using LRPC). This security permission can be modified using the Component Services administrative tool.
Ключу {A1B65D46-9DDA-494D-AC21-180207E55F6F} соответствует SBUM
Прояснилась ситуация с невозможностью выполнения назначенного задания (Агент расылки входящих заданий) на MS WINDOWS 2008 R2 (Куров Андрей).
При том что задание выполняется от имени доменного пользвоателя, входящего в группу локальных администраторов, запуск сценария вне активного сеанса пользвоателя в ОС приводил к ошибке.
исправилось настройкой самого назначенного задания: в свойствах заданий на вкладке "Общие" был активирован параметр "запускать с наивысшими параметрами". после этого агент рассылки выполнился корректно и вне активной сессии пользваотеля в ОС.
Если еще интересно - настройка Activation permission не является штатной для SBUM (и, насколько мне известно, для IS-Builder вообще).
Т.е. как и в описанном решении мы рекомендуем смотреть настройки ОС для аккаунта и стартующего процесса (в данном случае, задания).
Добрый день!
Столкнулся с проблемой DCOM при запуске. Сделал. Теперь валится другая ошибка MSSQLSERVER (17806) - n/a "Подтверждение связи с SSPI закончилось ошибкой с кодом x8009030c во время установления соединения со встроенной защитой. Соединение было закрыто. [CLIENT: 172.16.1.140]"
Ни как не разберусь из-за чего она :(
У пользователя от которого запускается сценарий, настроена Windows-аутентификация. Запуск происходит с помощью sajobrunner.exe.
Алексей, просмотрите ветку форума MS по аналогичной проблеме: http://social.msdn.microsoft.com/Forums/en-US/sqldataaccess/thread/db3d8038-4c3b-4daa-b5c9-b1486fe1d3c5/
Вопрос по лицензиям, при запуске агент всегда отъедает 1 лицензию? В этом отношении sajobrunner и sblauncher ведут себя одинаково?
Любое подключение к базе данных DIRECTUM посредством регистрации на сервере сеансов (как sajobrunner, так и sblauncher) осуществляется с резервированием лицензии для подключения. Поэтому ответ: да, лицензия будет занята на время выполнения назначенного задания.
Понятно, спасибо. И последний вопрос: для пользователя от имени которого выполняется сценарий необходимы права администратора директума? Если я правильно понимаю при использовании объектной модели для поиска задач/заданий не администратор их просто не увидит?
Да, лучше запускать от пользователя с правами администратора.
Для облегчения работы админов, написала сценарий, который заполняет Email в справочнике "Контактные лица организации" (email = логин пользователя directum & @ & домен...). Недавно его использовала по назначению, агент работает корректно.
В строках запуска, которые приведена в качестве примера в пункте 1 "Дополнительные возможности запуска сценария" необходимо в параметры добавить значение параметра Type=F:
sblauncher.exe -SYS="DIRECTUM" -CT="Script" -F="Агент рассылки входящих заданий" -R="Type=F|Users=C:\UsersList.txt"
sajobrunner.exe -S="MAINSERVER" -D="DIRECTUM" -CT="Script" -F="Агент рассылки входящих заданий" -R="Type=F|Users=C:\UsersList.txt"
Будет ли работать сценарий «Агент рассылки входящих заданий" для замещающих?
Вряд ли будет, но я уже не помню как там в стандартном агенте. Мы его полностью переписали. У нас отправляется только тем сотрудникам, которые не работают в данный момент с Директумом, да и скорость работы сценария увеличили :)
Если смотреть по коду, то вытаскиваются задания только определенного пользователя:
Для наблюдателей тоже уведомление приходит при срабатывания Агента. А можно настроить каким нибудь образом, чтобы наблюдателям не рассылались уведомления?
Можно, но для этого придется изменять разработку сценария. Примерно в 140 строке выполняется поиск заданий по пользователю, вам нужно в этот поиск добавить условие по типу задания = Задание или Задание-контроль, исключая уведомление.
Подскажите какие права нужно дать Пользователю от которого запускается служба?
Анатолий, про какую службу речь?
Очепятался, Сценарий «Агент рассылки входящих заданий» конечно!
В принципе мне ответили в этой теме http://club.directum.ru/forum/topic338-агент-рассылки-входящих-задании.aspx
Такие права чтобы он видел все задания пользователей :) Админские.
Возможно ли все же модифицировать сценарий, чтобы он в случае замещения присылал уведомления и замещающему ??
Как быть если для 1 персоны 1 пользователь и 3 контактного лице (3 наших организации), а по описанию требуется настроить "каждому пользователю, для которого планируется рассылка, соответствовала одна запись в справочнике «Персоны», а каждой персоне - соответствовала одна запись в справочнике «Контактные лица организации»"?
и прямой связи между персоной и пользователем нет.
Давненько не обращал внимания на когда-то настроенную рассылку почты пользователям. Сейчас выяснилось, что давно уже никому ничего не приходит. Не буду вдаваться в подробности, но хочу задать вопрос -
Рассылку делал с помощью Дополнительные возможности запуска сценария "Агент рассылки входящих заданий", п1.
По началу почта уходила, сейчас в диспетчере задач с каждым установленным временем запуска появляется еще один процесс SBRte.exe и не исчезает, их количество растет и растет.
Вчера попробовал рассылку с помощью Настройка запуска агента
и тоже нет результата.
Как можно не разработчику проверить, в чем проблема? Может ли вообще наш директум отсылать письма. Настройки POP3 и SMTP не менялись, проверил, они в порядке. И вообще ничего не менялось с тех пор.
Все настроено, этим тоже не пренебрег "настройкой самого назначенного задания: в свойствах заданий на вкладке "Общие" был активирован параметр "запускать с наивысшими параметрами".
Не понимаю, в чем проблема. Подскажите, пожалуйста, в какую сторону рыть...
Далее нужно искать лог-файлы с компьютера, где происходит запуск назначенного задания - по уже логам постараемся понять, в чем дело.
Аналогичная ситуация. Windows Server 2008 x64: были настроены задания по расписанию с наивысшими правами, все работало, но только до определенного времени. Все параметры настройки остались без изменений, а рассылка прекратилась. SaJobRunner с параметрами засунул в bat-ник - работает. Через планировщик заданий - никак.
Тоже очень интересует!
Алексей, Андрей, в сценарии цикл идет от работников. Т.е. отправная точка - запись справочника РАБ (который тоже ведется в разрезе НОР и думаю, там у вас 3 работника, как и контактных лиц). Сценарий возьмет то контактное лицо и того пользователя, которые выбраны в соответствующих реквизитах записей справочника работники.
Здравствуйте!
Появилась проблема в работе агента рассылки входящих заданий. Причем последний год работал без проблем. Ничего не меняли и вдруг от пользователей начали поступать жалобы, что приходит несколько писем по одному и тому же не просмотренному заданию. Интервалы отправки писем разные - 45 минут, час, 2 часа , 5 часов, хотя агент запускается каждые 15 минут. После просмотра задания в системе письма перестают приходить. Проверил все настройки по инструкции - все в порядке. Перезапуск служб не помог. Даже не знаю в каком направлении рыть. Сервер один. Репликаций нет. Может кто-то помочь?
Евгений, в стандартном сценарии подобное наблюдали, когда возникают какие-либо ошибки при отправке писем. Когда сценарий запускается, записывается время запуска в константу РАСЗДЧВР, далее возникает ошибка и время в константе откатывается назад. В результате при очередном запуске заново ищет все непрочитанные задания, созданные после времени, указанному в константе.
Ошибки возникали, например, когда некорректно был указан email, когда сервер не мог отправить на внешний email в связи с политиками безопасности.
Посмотрите, отправляются ли пользователю (по умолчанию Administrator вроде) уведомления об ошибке отправки.
Посмотрите историю изменения константы РАСЗДЧВР. Если константа изменяется по 2 раза подряд примерно в одну секунду - это значит что как раз и происходит откат.
Вышла версия DIRECTUM 5.6. В ней запуск сценариев по расписанию рекомендуется проводить через службу обработки событий. Сами события инициировать через SQL-job-ы. Хотелось бы увидеть рекомендации по настройке запуска сценария для такой ситуации.
Авторизуйтесь, чтобы написать комментарий