Секция Mail предназначена для настройки модуля ввода с электронной почты. В файле настроек нужно создавать секцию для каждого почтового адреса, сообщения с которого необходимо отправлять в конечную систему.
Структура секции:
<Mail
SenderLine="{Линия по умолчанию}">
<clear />
<Электронная почта>
…
</Mail>
где <Электронная почта>::=
<add Name="{Имя почтового ящика}"
MailReceivePeriod="{Интервал проверки сообщений}"
DeleteOnCapture="{Признак удаления сообщений}"
SenderLine="{Линия}"
TempFolder="{Папка временных файлов}"
DeleteAfterPeriod="{Время хранения сообщений}"
IncludeMessagesFrom="{Обрабатывать сообщения от}"
ExcludeMessagesFrom="{Игнорировать сообщения от}"
SubjectInclude="{Обрабатывать темы}"
SubjectExclude="{Игнорировать темы}"
MessageMaxSize="{Максимальный размер сообщения}"
IncludeMailBody="{Добавить текст сообщения в пакет}"
IncludeAttachments="{Добавить вложения в пакет}"
CaptureLegacyMessages="{Захватывать все сообщения}"
MessageBodyEncoding="{Кодировка сообщений}"
UpdateHtmlCharsetOnMessageBodyEncoding="{Обновление атрибута Charset в HTML-содержимом сообщения при его перекодировке}"
SeparateLineForEachSender="{Обработка сообщения отправителей}"
CaptureOnlyUnreadMessages="{Захватывать только непрочитанные}"
MarkCapturedMessagesAsRead="{Пометить сообщения как прочитанные}" >
<Server>
<clear />
<add
Name="{Имя настройки сервера}"
Value="{Значение настройки сервера}" />[…n]
</Server>
SenderLine – имя линии по умолчанию для обработки сообщений со всех почтовых ящиков, если в настройке ящика не указана другая линия. Параметр является обязательным.
add – настройка почтовых ящиков:
| • | Name. Имя почтового ящика. |
| • | MailReceivePeriod. Интервал в формате <[дни.]чч:мм:сс>, через который модуль ввода проверяет новые сообщения на почтовом сервере. Параметр является необязательным. Значение по умолчанию 0.00:10:00. |
| • | DeleteOnCapture. Признак удаления обработанных сообщений с почтового сервера. Возможные значения: True, False. Параметр является необязательным. Независимо от значения параметра незахваченные сообщения не удаляются с сервера. Значение по умолчанию True. |
| • | SenderLine. Имя линии для обработки сообщений. Укажите линию из тега Lines файла DctsCaptureService.exe.config. Подробнее см. раздел «Настройки линий». Параметр является необязательным. Если значение не указано, используется линия по умолчанию. |
| • | TempFolder. Папка временных файлов. Параметр является обязательным. |
| • | DeleteAfterPeriod. Период, по истечении которого сообщения будут удалены с почтового сервера. Указывается в формате <[дни.]чч:мм:сс>. Используется, если параметр DeleteOnCapture имеет значение True. Если указан период 0.00:00:00, или поле не заполнено, то сообщения не удаляются. Значение по умолчанию 0.00:00:00. |
| • | IncludeMessagesFrom. Список почтовых адресов, сообщения от которых будут обрабатываться, указываются через «;». Можно использовать регулярные выражения, например, ^(\w+)@directum.ru$ – адреса электронной почты сотрудников компании DIRECTUM. Параметр является необязательным. Значение по умолчанию ^.*$. |
| • | ExcludeMessagesFrom. Список почтовых адресов, сообщения от которых не будут обрабатываться, указываются через «;». Можно использовать регулярные выражения, например, ^(\w+)@directum.ru$ – адреса электронной почты сотрудников компании DIRECTUM. Параметр является необязательным. Значение по умолчанию – пустая строка. |
| • | SubjectInclude. Список тем сообщений, которые будут обрабатываться, указываются через «;». Можно использовать регулярные выражения. Параметр является необязательным. Значение по умолчанию – пустая строка. |
| • | SubjectExclude. Список тем сообщений, которые не будут обрабатываться, указываются через «;». Можно использовать регулярные выражения. Параметр является необязательным. Значение по умолчанию – пустая строка. |
О параметрах IncludeMessagesFrom, ExcludeMessagesFrom, SubjectInclude, SubjectExclude подробнее см. разделы «Фильтрация сообщений», «Регулярные выражения».
Если значения параметров SubjectInclude и SubjectExclude указаны одновременно, то сообщения будут фильтроваться по параметру SubjectInclude. Если значения параметров SubjectInclude и SubjectExclude не указаны, то входящие сообщения не будут фильтроваться по теме сообщения.
| • | MessageMaxSize. Сообщения, размер которых превышает максимальный, не будут обрабатываться. Укажите 0, чтобы обрабатывать все сообщения. Параметр является необязательным. Значение по умолчанию 0. |
| • | IncludeMailBody. Признак добавления текста сообщения в пакет для отправки в конечную систему. Возможные значения: True, False. Параметр является необязательным. Значение по умолчанию True. |
| • | IncludeAttachments. Признак добавления вложений в пакет для отправки в конечную систему. Возможные значения: True, False. Параметр является необязательным. Значение по умолчанию True. |
Один из параметров IncludeMailBody и IncludeAttachments должен иметь значение True. Если в обоих параметрах указано значение False, то в журнал событий Windows будут записываться ошибки ввода с электронной почты. Подробнее см. раздел «Журнал событий».
| • | CaptureLegacyMessages. Укажите, какие сообщения захватывать: |
| • | True – все сообщения в почтовом ящике; |
| • | False – только сообщения, поступившие после запуска модуля. |
Параметр не является обязательным. Значение по умолчанию True.
| • | MessageBodyEncoding. Кодировка, в которой будет сохранен текст сообщения. Если поле не заполнено, то текст сообщения сохраняется в исходной кодировке. |
| • | UpdateHtmlCharsetOnMessageBodyEncoding. Признак обновления атрибута Charset в HTML-содержимом сообщения при его перекодировке: |
| • | True – обновлять атрибут; |
| • | False – не обновлять атрибут. |
Параметр является необязательным. Значение по умолчанию False.
| • | SeparateLineForEachSender. Укажите, как обрабатывать сообщения отправителей: |
| • | True – независимо друг от друга, для каждого формировать отдельные пакеты; |
| • | False – для всех сообщений формировать общий пакет. |
Значение по умолчанию True.
| • | CaptureOnlyUnreadMessages. Захватываются только непрочитанные сообщения. Возможные значения: True; False. Значение по умолчанию True. Рекомендуется использовать только для отправки в Exchange. |
| • | MarkCapturedMessagesAsRead. Захватываемые сообщения будут помечаться как прочитанные. Возможные значения: True; False. Значение по умолчанию True. Рекомендуется использовать только для отправки в Exchange. |
Server – настройки почтового сервера.
add – добавление почтового сервера:
| • | Name. Имя настройки соединения с сервером. Обязательная настройка Type определяет тип почтового сервера. После нее указываются настройки, соответствующие выбранному типу сервера. Подробный список настроек для каждого сервера см. раздел «Метод Logon – выполнить вход на сервер». |
| • | Value. Значение настройки почтового сервера. Возможные значения для настройки Type: MAPI, POP3, SimpleMAPI. |
Пример
<Mail
SenderLine="SimpleLineToSystem">
<clear />
<add Name="Exchange"
MailReceivePeriod="0.00:01:00"
DeleteOnCapture="False"
SenderLine="SimpleLineToSmtp"
TempFolder="D:\temp\Dcts\Exchange\Outlook"
DeleteAfterPeriod="1.00:00:00"
IncludeMessagesFrom=""
ExcludeMessagesFrom=""
SubjectInclude=""
SubjectExclude=""
MessageMaxSize="0"
IncludeMailBody="True"
IncludeAttachments="False"
CaptureLegacyMessages="False"
MessageBodyEncoding="windows-1251"
UpdateHtmlCharsetOnMessageBodyEncoding="False"
SeparateLineForEachSender="True"
CaptureOnlyUnreadMessages="False"
MarkCapturedMessagesAsRead="False" >
<Server>
<clear />
<add Name="Type" Value="MAPI" />
<add Name="ProfileName" Value="Outlook" />
<add Name="BodyEncodingGatheringStrategy" Value="Default" />
</Server>
</add>
<add Name="reko@orpi.comp.npo"
SenderLine="SimpleLineToProgram"
TempFolder="D:\temp\DCTS\Mail\Folder"
MailReceivePeriod="0.00:00:20"
DeleteOnCapture="False"
DeleteAfterPeriod="0.00:01:00"
IncludeMessagesFrom=""
ExcludeMessagesFrom=""
SubjectInclude=""
SubjectExclude=""
MessageMaxSize="0"
IncludeMailBody="True"
IncludeAttachments="True"
CaptureLegacyMessages="true"
MessageBodyEncoding="windows-1251"
SeparateLineForEachSender="True"
CaptureOnlyUnreadMessages="False"
MarkCapturedMessagesAsRead="False" >
<Server>
<clear />
<add Name="Type" Value="POP3" />
<add Name="Server" Value="mail" />
<add Name="User" Value="user@mail" />
<add Name="Password" Value="12345" />
<add Name="EncryptionMode" Value="OptionalExplicit" />
<add Name="EncryptionVersion" Value="TLSv1" />
</Server>
</add>
</Mail>
|
