Administer Triggers › Configure Mail Trigger Properties at the Domain Level

Configure Mail Trigger Properties at the Domain Level

The Domain Administrator rights let you configure Mail Trigger properties at the Domain level. Mail Trigger properties only enable the triggering of processes when they are inherited or configured at lower levels. To achieve the inheritance, configure Inherit from Domain at the environment level and configure Inherit from the Environment at the Orchestrator level.

When active, the Mail trigger searches the email account (configured as User Name and Password) for emails. If the email body or an attachment contains valid XML content, the product processes it. The parameters that the product creates in the triggered process instance depend on whether the email contains valid XML content.

Before you configure the Mail Trigger properties, complete the following tasks:

• Create an email account that is dedicated to receiving emails that trigger processes.
• Verify that the IMAP service is enabled on the mail server you identify as the Incoming mail server.

  If your corporate mail server restricts enabling the IMAP service, create a proxy mail server with IMAP enabled. Specify the proxy server as the Incoming mail server. Then, configure your corporate mail server to forward the emails that are addressed to the configured user account to the proxy mail server.

• (Optional) Create a default Domain Orchestrator process and save it to the Default Process handler path. The product uses the default process only then the email does not contain valid XML content. In this case, the default process starts and populates the following variables in the SMTP page in the process dataset:

  senderAdd

  Identifies the email address of the sender.

  senderTime

  Identifies the email server time when the email was sent.

  MailBody

  Contains the complete content of the email.

  The default process determines any further action.

You can configure the Mail Trigger properties at the Domain level.

Follow these steps:

1. Click the Configuration tab, select Domain, and click Lock.
2. Click the Triggers tab, right-click Mail Trigger, and then click Edit.
3. On the Mail Trigger dialog, General Properties tab, complete the fields as appropriate.

   Default Trigger Process (Orchestrator only)

   Specifies how to handle emails that have invalid XML content in the message body or attachment.

   Values:

   • Blank - Ignore the emails with no valid XML trigger content.
   • The full path of the process that the Domain Orchestrator is to start. (One default process can be defined for each Orchestrator.)

   IMAP Mail Server

   Specifies the hostname or IP address of the mail server that receives incoming emails. The Inbox folder for the configured email account is searched for new emails. This server must have the IMAP protocol enabled. The Mail Trigger does not support POP3.

   IMAP Server Port

   If the default TCP port for an IMAP server is used, enter 143. If a nondefault port is used or secure communication is set up on a different port, obtain the correct port to enter from an administrator.

   User Name

   Specifies the user name with which to connect to the incoming mail server. Observe the requirements of your IMAP server when determining whether to enter the full email address or the alias as the user name. The user name pamadmin@ca.com is an example of a full address; pamadmin is the alias.

   Note: Microsoft Exchange Server accepts both the full email address or the alias.

   Password

   Specifies the password that is associated with the specified user name.

   Mail Processing Interval (seconds)

   Frequency is seconds with which CA Process Automation searches the IMAP server for new incoming emails into the specified account. The user name and password specify the account.

   Default:

   2

   Save mail attachments to database

   Specifies whether to save attachments of mails that trigger CA Process Automation processes in the database.

   • Selected: CA Process Automation saves attachments of mails to the CA Process Automation database and populates the data set of the process being started with relevant information of the attachments.
   • Cleared: CA Process Automation does not save email attachments.

   Outgoing SMTP Mail Server

   Specifies the server name for the outgoing SMTP mail server. When a triggering email with valid XML content is received in the configured account of the IMAP mail server, an acknowledgment email is returned. The acknowledgment email is returned to the sender through the outgoing SMTP server.

   SMTP Server Port

   Specifies the port of the outgoing mail server.

   Default:

   25

   Use secure SMTP connection

   Specifies whether to process over a secure connection to the SMTP mail server.

   • Selected - The mail server allows a secure connection to the SMTP mail server.
   • Cleared - The mail server does not allow a secure connection.

   Default:

   Cleared

4. Click Save and Close.
5. Click Save.
6. Select Domain and click Unlock.