Configuring processing rules

Introduced in 2023.1

Use the Processing tab of the Mail Connector window to view, modify, or create rules that define how the Mail Connector processes incoming e-mail.

The Processing tab is divided into these sections:

• Operations: See how the Mail Connector creates objects from new email messages and updates objects (for example, adds entries to the object's Activity Log) when the email message is part of an object's communication thread. These operations are performed through the workflow Service Actions configured for the Mail Connector.

  TIP: The web Admin Center lets you view processing operations and see how the Mail Connector handles incoming messages. To make changes, use the desktop Settings App. For configuration details, see Settings Help: Configuring processing rules.

  NOTE: When the Mail Connector creates or updates objects, it extracts attachments from incoming email message and adds them to created objects or object Activities. This behavior is hard-coded and does not depend on Service Actions.

• Incoming E-mail Handling: Define how the Mail Connector treats original email messages after processing.

TIP: To access the Mail Connector window, navigate to E-Mail Processing > Mail Connector from the Sidebar and click New to create a new job or double-click an existing one to modify it. The Mail Connector window appears.

Configuring workflow operations

When you create a Mail Connector job, Alloy Navigator automatically populates the Operations section of the Processing tab and places existing Service Actions for the Mail Connector in the default conditional statement.

The first criteria (IF %[EML ObjectRef]% is not blank) checks whether the message is part of a thread initiated for an existing Alloy Navigator object, i.e. whether the system parsing rule has detected the ID of an active object in the email Subject. If the first criteria return TRUE, Alloy Navigator checks the nested IF and ELSE IF criteria to find out the class of the object to update, and updates that particular object using the corresponding Update Service Action. If the first IF criteria return FALSE, Alloy Navigator creates a new object using the corresponding Create Service Action.

NOTE: The ObjectRef virtual field contains the ID of an active object. When the object is inactive (closed Ticket, retired Computer, inactive Person, etc.), its ID is placed in the InactiveObjectRef virtual field.

TIP: Click the plus icon (+) to expand and the minus icon (-) to collapse a node in the statement. To expand or collapse all nodes, click Expand All or Collapse All.

In addition to operations in the conditional statement, the Mail Connector creates new Person records when the message sender cannot be matched to an existing Person record.

• To specify the Service Action for creating Persons for unmatched senders:

  Alloy Navigator creates Person records when a message sender cannot be matched to an existing Person record.

  • Under Unmatched sender workflow, click the ellipsis button in the Create Persons field and double-click the Create Service Action for the Mail Connector that you want to use.

• To attach the original email message to corresponding objects:

  • Under Email attachment, select the Attach original e-mail message to object/activity check box.
    
    When the Mail Connector creates objects, the message will be attached to those objects. If it updates objects by adding entries to the object's Activity Log, the original email message will be attached to the respective Activity records.

    NOTE: Regardless of the check box state, the Mail Connector extracts attachments from incoming email message and adds them to created objects or object Activity records.

Configuring incoming email handling

The Incoming e-mail handling settings tell the Mail Connector what to do with original email messages after processing. These settings apply to all processed messages, regardless of if they have been actually used in the Mail Connector workflow or not.

Depending on the type of email account you use, the Mail Connector can handle processed mail differently. The default settings are recommended for optimal performance. You can keep the defaults, or you can customize them to your needs.

To configure Microsoft Exchange or IMAP4 email handling:

1. Under When an object is created or modified successfully:

• To mark processed email messages as read and keep them on the mail server, select the Mark the message as read check box. Otherwise the Mail Connector will attempt to process those messages again next time the task runs.

• To mark processed email messages as deleted, select the Mark the message as deleted check box. Otherwise they will remain in the mail folder in Read state.

2. Under When a workflow item rejects the message:

• To mark failed email messages as read and keep them on the mail server, select the Mark the message as read check box. Otherwise the Mail Connector will attempt to process those messages again next time the task runs.

• To mark failed email messages as deleted, select the Mark the message as deleted check box. Otherwise, it will remain in the mail folder in Read state.

3. To purge deleted messages from the mailbox at the end of the session, select the Purge the deleted messages at the end of session check box. Otherwise, messages marked for deletion will remain in the mailbox’s Deleted folder.

• To configure POP3 email handling:

  1. Under When an object is created or modified successfully, the only available option is Delete the message from the mailbox. This means that once email messages have been successfully processed and converted to objects, they are permanently deleted from the inbox.

  2. Under When a workflow item rejects the message, select the Delete the message from the mailbox check box if you want to delete failed email messages. Otherwise, rejected messages will remain in the inbox.

Next Steps

After you have configured processing rules for the Mail Connector job, you can test the job and check its results to make sure it works correctly. You can test even a disabled job. For instructions, see Checking Mail Connector job results.

You may have multiple Mail Connector jobs that process several email accounts. By default, all Mail Connector jobs run using the Automation Server startup account and connects to the database using the Automation Server database connection. If you consider having all resources available under the same Automation Server startup account a security risk, you can configure to use a dedicated Windows account for every job. For instructions, see Configuring Mail Connector settings.

Related Information:

Understanding the Mail Connector

Configuring Mail Connector settings

Configuring parsing rules

Configuring preprocessing rules