{{tag>Index Action Action_List Process Service Email}}
====== CONNECT TO EMAIL ======

Using this action allows you to handle incoming e-mails dynamically, from a process. This action starts listening to the specified incoming e-mail account. 

===== Syntax =====

''CONNECT TO EMAIL'' AttributeIdentifier()

The attribute identifier specified in the action identifies the e-mail account to connect to. It is expected that this identifier points to the object containing the following mandatory attributes:

  * ''MailHost'' – email host server
  * ''MailUser'' – user name of the e-mail account on this server
  * ''MailPassword'' – password of the e-mail account on this server
  * ''AccountName'' – a unique name identifying this connection (which is then used in the [[a_f:a:disconnect_from_email|DISCONNECT FROM EMAIL]] action).


The following attributes are optional. If not provided default values are used:

  * ''MailPort'' (Number, default value is 110) – port which the e-mail server uses
  * ''MailCheck'' (Number, default value is 300) – how frequently to check for new emails (in seconds)
  * ''MailSSL'' (Yes/No, default is No) – whether e-mail account requires SSL
  * ''MailTLS'' (Yes/No, default is No) – whether e-mail account requires TLS

===== Example =====

<code aim>CONNECT TO EMAIL EmailAccount </code>

This assumes that the application contains the EmailAccount object with the attributes above. At runtime the values of this object identify the e-mail account to connect to.