Skip to Content

Changes for page Receive emails

Last modified by Erik Bakker on 2024/09/03 08:52
From version 17.1
edited by eMagiz
on 2022/05/05 16:14
Change comment: There is no comment for this version
To version 18.1
edited by Erik Bakker
on 2022/06/10 08:38
Change comment: Imported from XAR

Summary

Details

Page properties
Author
... ... @@ -1,1 +1,1 @@
1 -XWiki.marijn
1 +XWiki.ebakker
Content
... ... @@ -1,16 +1,9 @@
1 -{{html wiki="true"}}
2 -<div class="ez-academy">
3 - <div class="ez-academy_body">
4 -
5 -<div class="doc">
6 -
7 -
8 -
1 +{{container}}{{container layoutStyle="columns"}}(((
9 9  = Receive emails =
10 10  
11 11  We explained the MIME protocol in a previous [microlearning](advanced-mail-connectivity-whatis-mime.md). In this microlearning, we will expand our knowledge by learning how to receive emails with the help of MIME messages via the eMagiz platform.
12 12  
13 -Should you have any questions, please get in touch with academy@emagiz.com.
6 +Should you have any questions, please get in touch with [[academy@emagiz.com>>mailto:academy@emagiz.com]].
14 14  
15 15  * Last update: January 27th, 2022
16 16  * Required reading time: 6 minutes
... ... @@ -43,48 +43,48 @@
43 43  
44 44  As stated above, the IMAP option allows you to listen to a specific mailbox and wait till mail messages are pushed to eMagiz. To configure this in eMagiz, we need to open a flow in eMagiz and enter "Start Editing" mode. The first component we need is an IMAP idle channel adapter. Search for the component by typing in IMAP to select the suitable component. Once you have found the component, please drag it onto the canvas.
45 45  
46 -<p align="center">[[image:advanced-mail-connectivity-receive-email-mailserver-imap-components.png||]]</p>
39 +[[image:Main.Images.Microlearning.WebHome@advanced-mail-connectivity-receive-email-mailserver-imap-components.png]]
47 47  
48 48  Once you have added the component to the canvas, we need to add a channel to the flow that will serve as the output channel for our component. This is necessary because we want to transform the MIME message to XML before further processing the message.
49 49  
50 50  Once you open the component, you will see a basic and advanced tab. For our configuration, we start at the basic tab. Here we need to select the proper output channel and define the Store URI. The Store URI describes which mailbox at which mail server you want to connect to and which username and password you need to authenticate yourself. Please check out the help text when configuring the component to identify the correct structure.
51 51  
52 -<p align="center">[[image:advanced-mail-connectivity-receive-email-mailserver-imap-basic-filled-in.png||]]</p>
45 +[[image:Main.Images.Microlearning.WebHome@advanced-mail-connectivity-receive-email-mailserver-imap-basic-filled-in.png]]
53 53  
54 54  Once you have defined the correct information elements on the basic tab, it has become time to shift our attention to the advanced tab. In most cases, the default setting will suffice; however, it is good to know that you have specific options to customize the component's behavior when a message is processed. Below you see the default setting eMagiz provides you.
55 55  
56 -<p align="center">[[image:advanced-mail-connectivity-receive-email-mailserver-imap-advanced-default.png||]]</p>
49 +[[image:Main.Images.Microlearning.WebHome@advanced-mail-connectivity-receive-email-mailserver-imap-advanced-default.png]]
57 57  
58 58  The help text will explain what the setting does for every option. Based on that explanation, you should be able to determine whether it is wise to deviate from the standard in your particular setup or not. Once you are satisfied with your chosen settings, press Save.
59 59  
60 60  To ensure that we can validate and transform the mail message further upstream, we need to transform the MIME message to an XML message. Then, drag the "MIME message transformer to XML" on the canvas and select the correct input and output channel. As a result, your solution should look as follows.
61 61  
62 -<p align="center">[[image:advanced-mail-connectivity-receive-email-mailserver-imap-solution.png||]]</p>
55 +[[image:Main.Images.Microlearning.WebHome@advanced-mail-connectivity-receive-email-mailserver-imap-solution.png]]
63 63  
64 64  === 3.2 "Standard" mail ===
65 65  
66 66  As stated above, the "standard" mail option allows you to poll at your interval to check whether new messages have arrived. To configure this in eMagiz, we need to open a flow in eMagiz and enter "Start Editing" mode. The first component we need is a "Mail inbound channel adapter." Select the category inbound channel adapter and search for mail. Once you have the component, please drag it onto the canvas.
67 67  
68 -<p align="center">[[image:advanced-mail-connectivity-receive-email-mailserver-mail-components-inbound.png||]]</p>
61 +[[image:Main.Images.Microlearning.WebHome@advanced-mail-connectivity-receive-email-mailserver-mail-components-inbound.png]]
69 69  
70 70  Once you have added the component to the canvas, we need to add a channel to the flow that will serve as the output channel for our component. This is required because we want to transform the MIME message to XML before further processing the message.
71 71  
72 72  Once you open the component, you will see a basic and advanced tab. For our configuration, we start at the basic tab. Here we need to select the correct output channel, define the Store URI and define our poller. The Store URI describes which mailbox at which mail server you want to connect to and which username and password you need to authenticate yourself. Please check out the help text when configuring the component to identify the correct structure. Finally, the poller defines the frequency with which you will check the mailbox for new messages. Finally, we advise using the cron trigger option for the poller, as that gives you the flexibility to define this dynamically across environments.
73 73  
74 -<p align="center">[[image:advanced-mail-connectivity-receive-email-mailserver-mail-basic-filled-in.png||]]</p>
67 +[[image:Main.Images.Microlearning.WebHome@advanced-mail-connectivity-receive-email-mailserver-mail-basic-filled-in.png]]
75 75  
76 76  Once you have defined the correct information elements on the basic tab, it has become time to shift our attention to the advanced tab. In most cases, the default setting will suffice; however, it is good to know that you have specific options to customize the component's behavior when a message is processed. Below you see the default setting eMagiz provides you.
77 77  
78 -<p align="center">[[image:advanced-mail-connectivity-receive-email-mailserver-mail-advanced-default.png||]]</p>
71 +[[image:Main.Images.Microlearning.WebHome@advanced-mail-connectivity-receive-email-mailserver-mail-advanced-default.png]]
79 79  
80 80  The help text will explain what the setting does for every option. Based on that explanation, you should be able to determine whether it is wise to deviate from the standard in your particular setup or not. Once you are satisfied with your chosen settings, press Save.
81 81  
82 82  To ensure that we can validate and transform the mail message further upstream, we need to transform the MIME message to an XML message. Drag the "MIME message transformer to XML" on the canvas and select the correct input and output channel. As a result, your solution should look as follows.
83 83  
84 -<p align="center">[[image:advanced-mail-connectivity-receive-email-mailserver-mail-solution.png||]]</p>
77 +[[image:Main.Images.Microlearning.WebHome@advanced-mail-connectivity-receive-email-mailserver-mail-solution.png]]
85 85  
86 -===== Practice =====
87 87  
80 +
88 88  == 4. Assignment ==
89 89  
90 90  Build two flows that can receive emails. One flow should use the IMAP configuration, and the other should use the "standard" configuration. This assignment can be completed with the help of the (Academy) project that you have created/used in the previous assignment.
... ... @@ -109,11 +109,4 @@
109 109  
110 110  This video demonstrates a working solution and how you can validate whether you have completed the assignment.
111 111  
112 -<iframe width="1280" height="720" src="../../vid/microlearning/advanced-mail-connectivity-receive-email-mailserver.mp4" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
113 -
114 -</div>
115 -</main>
116 -</div>
117 -</div>
118 -
119 -{{/html}}
105 +{{video attachment="advanced-mail-connectivity-receive-email-mailserver.mp4" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>)))((({{toc/}}))){{/container}}{{/container}}