Загрузка писем из почтового ящика


В этом примере мы разберем пример получения писем из ящика электронной почты и сохранение их в пользовательской директории C:\Atlas365\data\emails\. Файлы к этому примеру находятся в директории C:\Atlas365\examples\Email

Шаг 1


Скопировать файл «Пример.xls» в директорию C:\Atlas365\data\ . Этот файл будет служить в качестве триггера для запуска процесса загрузки писем.


Шаг 2


Сформировать файл процесса. Процесс будет проверять (с некоторой периодичностью) пользовательский почтовый ящик, и при обнаружении входящих писем скачивает их в директорию указанную пользователем (в нашем примере это C:\Atlas365\data\emails\) и обрабатывает их (сохраняет вложения и текст письма). В файле процесса необходимо указать эту директорию (полный путь). Для удобства этот файл уже создан: C:\Atlas365\examples\Email\ProcessDownloadEmailWithAttachment-yandex.xml, однако ниже мы разберем пошаговое создание такого файла.

  1. Откройте редактор процессов: Пуск –> Все программы -> Atlas365 -> Edit Atlas365 processes.



  2. Разрешите использование макросов.
  3. Создайте стартовое и конечное событие (Start event и End event).

  4. Между ними поместите задачу (Task). Измените имя задачи на “Загрузка письма”:

  5. Откройте только что созданную задачу, в разделе «Email functions» в подразделе «Receive all emails to directory» ввести следующие значения в поля 1 и 2 (остальные поля оставьте пустыми):

    И нажмите кнопку «Select this task»
  6. Откройте свойства стартового события (Start) путем нажатия указателя мыши на это событие:

    На вкладке «Files» определите путь к директории и маску (*.xls), которая будет проверяться на предмет наличия XLS-файлов: C:\Atlas365\data\*.xls. Частоту проверки «Check file every … sec» оставьте без изменений (PT5S).
    После этого нажмите кнопку «Select this trigger».
  7. Соедините все элемены так, как показано на рисунке. Для этого сначала выберите начальный элемент, затем нажмите кнопку «Select element and press me», затем выберите конечный элемент.
  8. Нажмите кнопку «Validate structure» и проверьте структуру только что созданного процесса.
  9. 9. Сохраните файл процесса с помощью кнопки «Save» (или «Save as»), в директории C:\Atlas365\examples\Email под именем «ProcessDownloadEmailWithAttachment-yandex.xml». Ниже представлена основная часть XML-структуры этого файла:
<process id="processID20160509">
 <startEvent name="Start" id="StartEvent0001" parallelMultiple="false" isInterrupting="true">
  <extensionElements>
   <atlas:File>
    <Path>C:\Atlas365\data\*.xls*</Path>
    <Interval>PT5S</Interval>
   </atlas:File>
  </extensionElements>
 </startEvent>
 <endEvent name="End" id="EndEvent0010"/>
 <task name="Загрузка письма" id="Task0028" completionQuantity="1" startQuantity="1" isForCompensation="false">
  <extensionElements>
   <atlas:action do="RetrieveEmailWithAttachment">
    <param1 type="text">emailserver</param1>
    <param2 type="text">C:\Atlas365\data\emails</param2>
    <param3 type="text"/>
    <param4 type="text"/>
    <param5 type="text"/>
   </atlas:action>
  </extensionElements>
 </task>
 <sequenceFlow name="" id="SequenceFlow0032" targetRef="Task0028" sourceRef="StartEvent0001" isImmediate="false"/>
 <sequenceFlow name="" id="SequenceFlow0033" targetRef="EndEvent0010" sourceRef="Task0028" isImmediate="false"/>
</process>

  • Закройте редактор процессов. На этом пример создания файла процесса с помощью редактора процессов завершается.

    • Шаг 3


    Сформировать файл конфигурации. Для этого необходимо запустить ConfigEditor, создать сервер, создать и настроить исходящий smtp сервер, и подключить (созданный на предыдущем шаге) файл процесса «ProcessDownloadEmailWithAttachment-yandex.xml». Конфигурационный файл также уже создан для этого примера, и находится по следующему адресу: C:\Atlas365\examples\Email\ExampleEmailConfig-yandex.atlas и вам необходимо открыть его, проверив необходимые настройки:

    Необходимо удостовериться в правильности параметров pop3 сервера (в нашем примере это pop.yandex.ru, порт 995) и почтового адреса для входящих писем (Этот адрес электронной почты защищён от спам-ботов. У вас должен быть включен JavaScript для просмотра. в нашем примере):

    Шаг 4


    Сохраните конфигурационный файл с помощью команды «Сохранить» или «Сохранить как» меню «Файл».

    Шаг 5


    Запустите программу при помощи кнопки «Запустить» и удостоверьтесь в правильности ее работы:

    Сохраненные письма (если таковые есть) должны находиться в директории C:\Atlas365\emails:
    На этом данный пример заканчивается." alt=""/>