Настройки модулей отправки в систему Directum
Contents
Для занесения захваченных и упакованных документов в систему Directum предназначены модули отправки в систему Directum.
Отправка документов в систему Directum зависит от принятых в организации схем обработки документов. При отправке документов в систему Directum можно реализовать свою схему обработки документов. Для этого следует создать собственный сценарий и указать его в конфигурационном файле службы ввода CaptureService.exe.config.
Отправка в систему Directum возможна через службу обработки событий или через процесс SBRte. Для работы модуля отправки в Directum через SBRte требуется установленная клиентская часть. Для работы модуля отправки в Directum через службу обработки событий установленная клиентская часть не требуется.
Настройки модуля отправки в систему Directum хранятся в конфигурационном файле службы ввода CaptureService.exe.config.
Для увеличения производительности службы ввода используйте несколько потоков отправки пакетов документов с нескольких линий.
Отправка через службу обработки событий
Отправка документов в систему Directum через службу обработки событий представлена на схеме:
Алгоритм работы модуля отправки в систему Directum:
| 1. | Модуль отправки в систему Directum с помощью линии получает сформированный пакет документов и метаданных от модуля упаковки. Подробнее см. разделы «DeviceInfo.xml», «InstanceInfos.xml», «InputFiles.xml». |
| 2. | Модуль отправки подключается к системе Directum. Для подключения используются данные из конфигурационного файла служб ввода CaptureService.exe.config: имя и пароль пользователя, тип аутентификации Windows, сервер и база данных системы Directum. |
| 3. | Модуль отправки в систему Directum ставит в очередь службы обработки событий серверное событие, которое будет обрабатывать пакет документов. |
| 4. | Служба обработки событий вызывает серверное событие, которое запускает сценарий Обработка захваченного документа службой ввода с переданными параметрами. Модуль отправки в систему Directum передает параметры сначала серверному событию, после этого параметры передаются в сценарий. |
В качестве параметров используются метаданные о пакете с документами, путь к пакету и код записи справочника Параметры запуска компонент, в котором могут быть настроены дополнительные параметры сценария.
Для каждого документа действия, выполняемые сценарием, зависят от переданных параметров и от того, используется ли модуль «Инструменты Ario». Подробнее о действиях сценария Обработка захваченного документа службой ввода см. в описании сценария.
Если за заданное в конфигурационном файле количество попыток не удается поставить серверное событие в очередь, пакет документов сохраняется в папке ошибок.
Примечание
1. Для работы со сценарием «Обработка захваченного документа службой ввода» задайте исполнителя роли ОтветственныйЗаСлужбуВвода в компоненте Роли.
2. Также для корректной работы сценария заполните константу DCSDefaultEDocKind в компоненте Константы. Укажите вид, с которым по умолчанию будут создаваться документы при занесении в систему. В списке типов карточек документов, которые могут использоваться для документов данного вида, должен быть тип карточки Документы произвольной формы (ПЭА).
Отправка документов в систему Directum через процесс SBRte представлена на схеме:
Алгоритм работы модуля отправки в систему Directum:
| 1. | Модуль отправки в систему Directum с помощью линии получает сформированный пакет документов и метаданных от модуля упаковки. Подробнее см. разделы «DeviceInfo.xml», «InstanceInfos.xml», «InputFiles.xml». |
| 2. | Модуль отправки подключается к системе Directum. Для подключения используются данные из конфигурационного файла службы ввода CaptureService.exe.config: имя и пароль пользователя, признак использования Windows-аутентификации, сервер и база данных системы Directum. |
| 3. | Модуль отправки в систему Directum вызывает сценарий Обработка захваченного документа службами ввода с переданными параметрами. В качестве параметров используются метаданные о пакете с документами, путь к пакету и код записи справочника Параметры запуска компонент, в котором могут быть настроены дополнительные параметры сценария. Для каждого документа действия, выполняемые сценарием, зависят от переданных параметров и от того, используется ли модуль «Инструменты Ario». Подробнее о действиях сценария Обработка захваченного документа службой ввода см. в описании сценария. |
| 4. | Модуль отправки в систему Directum ожидает завершения сценария. Сценарий импортирует документ в систему. |
Примечания
1. Для работы со сценарием «Обработка захваченного документа службами ввода» задайте исполнителя роли ОтветственныйЗаСлужбуВвода в компоненте Роли.
2. Также для корректной работы сценария заполните константу DCSDefaultEDocKind в компоненте Константы. Укажите вид, с которым по умолчанию будут создаваться документы при занесении в систему. В списке типов карточек документов, которые могут использоваться для документов данного вида, должен быть тип карточки Документы произвольной формы (ПЭА).
Модули отправки в систему Directum настраиваются с помощью секций:
| • | EventProcessingSender – для отправки пакетов в службу обработки событий; |
| • | ISBuilderSender – для отправки пакетов через SBRte. |
Структура секции EventProcessingSender
Структура секции:
<EventProcessingSender
Type="Directum.Dcs.Capture.Senders.EventProcessingSender.EventProcessingSenderFactory">
<clear/>
<add Name="FileCaptureSender"
WorkingFolder="C:\DCS\FileCapture\FileCaptureSenderTemp"
ServerEventName="DCSProcessCapturedDocument"
ConnectionString="Data Source=directumsql;
Initial Catalog=directumdatabase;
Integrated Security=False;
User ID=Administrator;
Password=;"
ServerEventWorkingFolder="\\serverevents\ServerEventWorkingFolders\SomeServerEvent"
LaunchParamsCode=""
TimeOutInSeconds ="15"
TryCount="1"
WorkersCount="2"/>
</EventProcessingSender>
Type – имя класса, реализующего отправитель.
add – настройки модуля отправки:
| • | Name. Уникальное имя модуля отправки, используемое для настройки линии; |
| • | WorkingFolder. Папка временных файлов; |
| • | ServerEventName. Указывается имя серверного события из компоненты Серверные события, которое будет обрабатывать пакет документов; |
| • | ConnectionString. Параметры подключения к системе Directum. Задаются в формате: |
{Параметры подключения с указанием сервера и базы данных}
<add Name="{Имя модуля отправки}"
ConnectionString="Data Source={Имя SQL-сервера с базой данных системы Directum};
Initial Catalog={Имя базы данных системы Directum};
Integrated Security={Признак Windows-аутентификации};
UserID={Имя пользователя системы Directum};
Password={Пароль пользователя системы Directum}/>
Указанные имя и пароль пользователя используются для подключения к БД системы и запуска серверного события. Пользователю не требуется привилегии. У пользователя должны быть права на выполнение в базе данных SQL-запроса EXECUTE для хранимой процедуры SBServerEventStart.
| • | ServerEventWorkingFolder. Папка временных файлов серверного события. Сюда складываются пакеты документов для обработки серверным событием. Пользователь, от имени которого запущена служба обработки событий, должен иметь права на удаление файлов из папки. Папка создается вручную. |
| • | LaunchParamsCode. Параметры вызова сценария, запускаемого серверным событием. Соответствует коду записи справочника Параметры запуска компонент. |
| • | TimeOutInSeconds. Временной интервал, в течение которого модуль отправки будет ожидать постановки серверного события в очередь обработки. Указывается в секундах. Значение по умолчанию 60. |
| • | TryCount. Количество попыток постановки серверного события в очередь. Если за указанное количество попыток не удастся поставить серверное событие в очередь, то пакет с документом будет сохранен в папке для временных файлов. |
| • | WorkersCount. Количество потоков отправки. Значение не должно превышать число ядер процессора. Значение по умолчанию 2. |
Примечание
Можно указать несколько модулей отправки.
Cекция ISBuilderSender
Структура секции:
<ISBuilderSender
Type="Directum.Dcs.Capture.Senders.ISBuilderSender.ISBuilderSenderFactory">
<clear/>
<add Name="MailCaptureSender"
ConnectionString="ServerName=directumsql;
DBName=directumdatabase;UserName=Administrator;
Password=;
IsOSAuth=False;
IsVirtualPassword=False"
Script="DCSProcessDocument"
LaunchParamsCode=""
WorkingFolder="C:\DCS\MailCapture\MailCaptureSenderTemp"
KeepConnection="False"
TimeOutInSeconds="60"
TryCount="1"
WorkersCount="2"/>
</ISBuilderSender>
Type – имя класса, реализующего отправитель.
add – настройки модуля отправки:
| • | Name. Уникальное имя модуля отправки, используемое для настройки линии; |
| • | ConnectionString. Параметры подключения к системе Directum. Задаются в одном из форматов: |
{Параметры подключения с указанием кода системы}
<add Name="{Имя модуля отправки}"
ConnectionString="SystemCode={Код системы Directum};
[UserName={Имя пользователя системы Directum};
Password={Пароль пользователя системы Directum};
IsOSAuth={Признак windows-аутентификации};
IsVirtualPassword={Признак перекодированного пароля}"]/>
{Параметры подключения с указанием сервера и базы данных}
<add Name="{Имя модуля отправки}"
ConnectionString="ServerName={Имя SQL-сервера с базой данных системы Directum};
DBName={Имя базы данных системы Directum};
[UserName={Логин пользователя системы Directum};
Password={Пароль пользователя системы Directum};
IsOSAuth={Признак Windows-аутентификации};
IsVirtualPassword={Признак перекодированного пароля}"]/>
Пользователь должен обладать правами на запуск и выполнение сценария из параметра Script.
Примечание
В сценарии могут быть заданы вычисления, для выполнения которых требуются дополнительные права доступа.
| • | Script. Имя сценария из компоненты Сценарии, который будет заносить документы в Directum. |
| • | LaunchParamsCode. Код записи справочника Параметры запуска компонент, которая содержит дополнительные параметры сценария занесения в Directum. Параметр является необязательным. Если его значение не указано, то будут использоваться параметры по умолчанию. Подробнее см. в руководстве администратора, раздел «Параметры запуска». |
| • | WorkingFolder. Папка временных файлов. |
| • | KeepConnection. Признак сохранения соединения после каждой отправки пакета. Возможные значения: |
| • | True – соединение с системой Directum устанавливается один раз для всех пакетов (при отправке первого после старта службы пакета); |
| • | False – для отправки каждого пакета устанавливается новое соединение. |
| • | TimeOutInSeconds. Временной интервал, в течение которого модуль отправки будет ожидать выполнения сценария. Указывается в секундах. Если время ожидания истекает, то служба ввода пытается снова отправить пакет (в зависимости от значения параметра TryCount). Значение по умолчанию 60. |
| • | TryCount. Количество попыток выполнения сценария. Если за указанное количество попыток не удастся выполнить сценарий, то пакет с документом будет сохранен в папке для временных файлов. |
| • | WorkersCount. Количество потоков отправки. Значение не должно превышать число ядер процессора. Значение по умолчанию 2. |
Примечание
Можно указать несколько модулей отправки.
| © Компания Directum, 2020 | Сообщество пользователей Directum |