Копировать ссылку на страницу

Секция Mail предназначена для настройки модуля ввода с электронной почты. В файле настроек нужно создавать секцию для каждого почтового адреса, сообщения с которого необходимо отправлять в конечную систему.

Структура секции:

 

<Mail
SenderLine="{Имя линии по умолчанию}">
<clear />
<Электронная почта>
 …
</Mail>
 
где <Электронная почта>::=
<add Name="{Имя варианта захвата}"
  MailReceivePeriod="{Период опроса почтового сервера}"
  DeleteOnCapture="{Удалять после обработки}"
  SenderLine="{Имя линии}"
  TempFolder="{Рабочая папка}"
  DeleteAfterPeriod="{Длительность хранения сообщений}"
  IncludeMessagesFrom="{Отправители обрабатываемых сообщений}"
  ExcludeMessagesFrom="{Отправители не обрабатываемых сообщений}"
  SubjectInclude="{Темы обрабатываемых сообщений}"
  SubjectExclude="{Темы не обрабатываемых сообщений}"
  MessageMaxSize="{Максимальный размер сообщения}"
  IncludeMailBody="{Захватывать текст сообщения}"
  IncludeAttachments="{Захватывать вложения сообщения}"
  CaptureLegacyMessages="{Вводить находящиеся в ящике сообщения}"
  MessageBodyEncoding="{Кодировка сообщений}"
  SeparateLineForEachSender="{Создавать отдельную линию для каждого
    модуля отправки сообщения}"
  CaptureOnlyUnreadMessages="{Вводить только непрочитанные сообщения}"
  MarkCapturedMessagesAsRead="{Помечать сообщения как прочитанные}" >
  <Server>
    <clear />
    <add
      Name="{Имя настройки сервера}"
      Value="{Значение настройки сервера}" />[…n]
  </Server>

SenderLine – имя линии для обработки сообщений со всех почтовых ящиков по умолчанию. Если для отдельного почтового ящика необходимо использовать другую линию, ее нужно указать в теге SenderLine секции add. Параметр является обязательным для заполнения.

add – настройки почтового ящика.

Name. Имя варианта захвата, с помощью которого вводятся документы с электронной почты.

MailReceivePeriod. Интервал времени, через который модуль ввода с электронной почты опрашивает почтовый сервер. Интервал задается в формате <[дни.]чч:мм:сс>. Параметр является необязательным. Значение по умолчанию 0.00:10:00.

DeleteOnCapture. Признак удаления сообщений после обработки. Возможные значения:

•True – сообщения будут удаляться после обработки;
•False – сообщения не будут удаляться после обработки. Можно настроить DeleteAfterPeriod.

Параметр является необязательным. Независимо от значения параметра незахваченные сообщения не будут удаляться с сервера. Значение по умолчанию True.

SenderLine. Имя линии для обработки сообщений с указанного почтового ящика. В качестве значения параметра следует указывать одну из линий, перечисленных в теге Lines файла настроек. Подробнее см. раздел «Настройки линий». Параметр является необязательным. Если значение параметра не указано, для обработки сообщений используется линия по умолчанию, указанная в теге SenderLine секции Mail.

TempFolder. Папка для временных файлов модуля ввода с электронной почты. Параметр является обязательным для заполнения.

DeleteAfterPeriod. Период, в течение которого сообщение будет храниться на почтовом сервере. Указывается в формате <[дни.]чч:мм:сс>. После окончания указанного периода сообщение будет удалено. Используется, если тег DeleteOnCapture имеет значение False. Период указывается в днях. Если параметр принимает значение 0.00:00:00, то сообщение не удаляется. Параметр является необязательным. Значение по умолчанию 0.00:00:00.

IncludeMessagesFrom. Список отправителей, сообщения от которых будут обрабатываться модулем ввода с электронной почты. Список должен содержать адреса электронной почты отправителей, разделенные символом «;». Вместо адресов можно указывать регулярные выражения. Параметр является необязательным. Значение по умолчанию «^.*$».

ExcludeMessagesFrom. Список отправителей, сообщения от которых не будут обрабатываться модулем ввода с электронной почты. Список должен содержать адреса электронной почты отправителей, разделенные символом «;». Вместо адресов можно указывать регулярные выражения. Параметр является необязательным. Значение по умолчанию: пустая строка.

SubjectInclude. Список тем сообщений, которые будут обрабатываться модулем ввода с электронной почты. Список должен содержать темы сообщений или их части, разделенные символом «;». Вместо тем можно указывать регулярные выражения. Параметр является необязательным. Значение по умолчанию: пустая строка.

SubjectExclude. Список тем сообщений, которые не будут обрабатываться модулем ввода с электронной почты. Список должен содержать темы сообщений или их части, разделенные символом «;». Вместо тем можно указывать регулярные выражения. Параметр является необязательным. Значение по умолчанию: пустая строка.

О тегах IncludeMessagesFrom, ExcludeMessagesFrom, SubjectInclude, SubjectExclude подробнее см. разделы «Фильтрация сообщений», «Регулярные выражения».

Если значения тегов SubjectInclude и SubjectExclude указаны, то сообщения будут фильтроваться по параметру SubjectInclude. Если значения тегов SubjectInclude и SubjectExclude не указаны, то входящие сообщения не будут фильтроваться по теме сообщения.

MessageMaxSize. Максимальный размер сообщения в Мб. Значением параметра может быть целое число, большее либо равное 0. Сообщения, размер которых превышает максимальный, не будут обрабатываться модулем ввода с электронной почты. Если параметр принимает значение 0, то все сообщения будут обрабатываться модулем ввода с электронной почты. Параметр является необязательным. Значение по умолчанию 0.

IncludeMailBody. Признак включения текста сообщения в пакет для отправки в конечную систему. Возможные значения:

•True – текст сообщения будет включен в пакет в виде текстового файла и файла в формате HTML для Exchange и в том виде, в котором отправил почтовый клиент, для POP3;
•False – текст сообщения не будет включен в пакет.

Параметр является необязательным. Значение по умолчанию True.

IncludeAttachments. Признак включения вложений в пакет для отправки в конечную систему. Возможные значения:

•True – вложения будут включены в пакет;
•False – вложения не будут включены в пакет.

Параметр является необязательным. Значение по умолчанию True.

Один из параметров IncludeMailBody и IncludeAttachments должен иметь значение True. Если оба параметра будут принимать значение False, то в журнал событий Windows будут записываться ошибки ввода с электронной почты. Подробнее см. главу «Журнал событий».

CaptureLegacyMessages. Признак обработки существующих сообщений при запуске модуля ввода с электронной почты. Возможные значения:

•True – все входящие сообщения, находящиеся в почтовом ящике до запуска модуля ввода с электронной почты, будут обработаны;
•False – модуль ввода с электронной почты будет обрабатывать только те сообщения, которые поступят после его запуска.

Параметр является необязательным. Значение по умолчанию True.

MessageBodyEncoding. Имя кодировки, в которой должен быть сохранен текст сообщения. Значение по умолчанию: пустая строка. Если в качестве параметра указать пустую строку, то текст сообщения сохранится в исходной кодировке.

SeparateLineForEachSender. Признак создания отдельной линии для каждого отправителя сообщения. Возможные значения:

•True – сообщения от каждого отправителя будут обрабатываться независимо и никогда не попадут в один пакет;
•False – сообщения будут обрабатываться совместно и попадут в один пакет.

Значение по умолчанию True.

CaptureOnlyUnreadMessages. Признак ввода непрочитанных сообщений. Возможные значения:

•True – будут захватываться только непрочитанные сообщения;
•False – будут захватываться все сообщения.

Значение по умолчанию True. Рекомендуется использовать только для отправки в Exchange.

MarkCapturedMessagesAsRead. Признак пометки сообщений прочитанными. Возможные значения:

•True – захватываемые сообщения будут помечаться как прочитанные;
•False – захватываемые сообщения не будут помечаться как прочитанные.

Значение по умолчанию True. Рекомендуется использовать только для отправки в Exchange.

Server – настройки почтового сервера.

add – добавление почтового сервера.

Name. Имя настройки соединения с сервером. Обязательная настройка Type определяет тип почтового сервера. После нее указываются настройки, соответствующие выбранному типу сервера. Подробный список настроек для каждого сервера см. раздел «Метод Logon – выполнить вход на сервер».

Value. Значение настройки почтового сервера. Возможные значения для настройки Type: MAPI, POP3, SMTP, 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"
  SeparateLineForEachSender="True"
  CaptureOnlyUnreadMessages="False"
  MarkCapturedMessagesAsRead="False" >
  <Server>
    <clear />
    <add Name="Type" Value="MAPI" />
    <add Name="ProfileName" Value="Outlook" />
  </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>
© 2016 Компания DIRECTUM Сообщество пользователей DIRECTUM