Skip Ribbon Commands
Skip to main content
SharePoint

Start a Process following an Email Event

To start a process following an Email event, complete the following steps:
  1. Check out and open the process you want to edit.

  2. In the Toolbox pane, click Process Initiation. A list of initiators is displayed.

  3. Double-click or drag the Receive Email Monitor Event activity into the process.

  4. Right-click the Receive Email Monitor Event. A shortcut menu is displayed.

  5. Select View Properties. The Receive Email Monitor Event window is displayed.

  6. Click the Email Initiator tab. The corresponding screen is displayed.

  7. In the right pane, click the Add button. The Create Email Initiator Event window is displayed.

  8. In the Select an Email System Resource field, click the drop-down arrow. A drop-down list is displayed.

  9. Select the POP3 system resource that corresponds to the e-mail address you want to monitor.

  10. Click Next. The Message Criteria tab is displayed.

  11. Enter values for the criteria you wish to monitor in the fields provided (From, To, Subject, Body and Attachments) for the selected email address.
     
    Note:
    When using a filter, you can use an asterisk (*) for a wild card. For example, you could filter for messages with "Expense Report" in the subject. To do this, the Subject filter would be *Expense Report*.

     
  12. Click Next. The Map Data Items tab is displayed.

  13. In the Data Item field, click the Data Item editor icon and select a solution or process data item to which you wish to assign a value of a field in the email.

    Note:
    Calculation data items are read-only. You cannot select this type of data item.
     
    Of the values available, %Embedded%, %Resources%, %To%, %CC%, and %Attachments% support collection data items.
     
    Additionally, the %Attachments% works with the File Service, which is part of the Process Engine service. The File Service starts when the Process Engine starts and saves the attachments to the runtime database. the path to the files will be written to the data item you select in the Data Item field. The path will use the following format:
     
    http://<RuntimeServer>:<Port>/Bluespring/<RuntimeEnvironment>/files/<RunspaceID>/<FileID>/<FileName>

    The File ID is used to identify the file. The File Name is their for readability purposes and allows you to rename the file by changing the path to the file while keeping the same File ID.
     
    Files saved to the runtime database are deleted 24 hours after the process completes.


    Note:
    You can add a mapping by clicking the plus sign (+). Use the minus sign (-) to remove a mapping.


  14. Click OK. You configured the Email Initiator Event.

  15. Click OK. You configured the activity to start a process following an Email event. You will see a message in the Process Engine log file indicating that the event has been registered.
Related Topics
Data Items
Remove an Email Event Monitor

Source
BPM Designer Topics > Overview of Activities and Activity Topics > Process Initiation Activities > Receive Email Monitor Event
Last modified at 7/31/2020 12:01 PM