Setting Up a Flow to Handle Email Events

Overview -rework prob example lab for scheduled jobs

An Email Event is a change in state on an Email Server, such as when the Server receives or relays an email. The system can be configured to handle email events for a Post Office Protocol (POP3) server or an Internet Message Access Protocol (IMAP) Server. A POP3 Server requires that clients download emails from the server to access them. An IMAP server allows a client to access emails directly on the Server. 

Example

1. Create a new Scheduled Job
2. Enter "Email Check" under Scheduled Job Name then click PICK SCHEDULED FLOW. Click CREATE and create a new Flow.
    
3. Attach a Get Headers step from the COMMUNICATION > EMAIL > POP category in the Toolbox panel to the Start step. 
4. On the Properties panel, enter "10" under the Count field. 
5. Constant map the Email Servers information for the Username, Password, Server, and Port.

   

6. Attach a ForEach Step from the FLOW MANAGEMENT > ITERATION category in the Toolbox panel to the Received path of the Get Headers step.
7. On the Properties panel. Select From Flow map Headers to Collection. 
   Mapping the Collection Input will automatically adjust the Type under DATA, to its corresponding Data Type. This will allow the ForEach Step to pass EmailHeader data through the Flow. 

   

8. Attach the Done path to the End step, then attach a Get Email step from COMMUNICATION > EMAIL > POP. On the Properties panel, configure the inputs to match the settings from the Get Headers step. Click Unknown next to the Unique Id field and select Select From Flow. Select Headers. All UniqueId.First and click DONE.
   
9. Connect the Not Found path to the End step. 
10. Attach the Found path to any desired Email processing Flows running as an Asynchronous Sub Flow. 
    When using an Email processing Sub Flow, define the Output Message data from the Get Email step as the Input for the Sub Flow, to allow the Flow to transfer all information through the Sub Flow and back. 

    

11. Click Save to save changes to the Flow and close the Flow.  
12. Back in the New Scheduled Flow window, scroll down to Calendar under Schedule Configuration. Select Time Span Schedule from the dropdown menu.
    
13. Navigate to Time Span Schedule Information and configure the values to the desired time. Click Save. 
    The proper configuration of this example allows the Flow to check for new emails on a POP server, then process those emails via process logic in an Async Sub Flow.