Use SIL™ scripts to process incoming emails! Power Scripts™ provides a set of specific routines for use within mail handling scripts that enable you to read the contents of the incoming email and handle any attachments, as described below.

Predefined structure: IncomingEmail

Name	Field	Type	Obs

Name	Field	Type	Obs
Incoming Email	from	string []	Array of email addresses
	to	string []	Array of email addresses
	cc	string []	Array of email addresses
	subject	string
	body	string	Entire body of the message including quoted text in case of replied or forwarded messages
	attachments	string []	Array containing the names of the attachments; there can be duplicates

Writing the handler script

There are the following important things to note about the mail handler script:

If the first email address in the from field (the sender of the email) belongs to a registered Jira user, the script will be run as that user, that is currentUser() will return that user. Otherwise, the script will be run as an anonymous user.
The return value of the script dictates if other mail handlers will be called for the email or not.
1. If the script returns true or has no return value, the email is considered as "handled" and subsequent mail handlers will not be called.
2. If the script returns false or throws an error, the email is considered "not handled" and subsequent mail handlers will be called.

Here is an example of a mail handler equivalent to Jira's built in "Create issue or add comment".

IncomingEmail mail = getIncomingEmail();

string issueKey = matchText(mail.subject, "[A-Z][A-Z]+-[0-9]+"); // find an issue key in the subject
if(isNull(issueKey)) {
	// if no issue key found, create a new issue
    string [] fields = {};
    fields += {"reporter", currentUserKey()};
    fields += {"assignee", getUserByEmail(mail.cc[0]).key}; 

    string newIssue = createIssue("TEST", "", "Task", mail.subject, "Minor", mail.body, {}, "", "", 0, fields);
    attachAllFilesFromEmail(newIssue);
    %newIssue%.watchers = getUserKeysFromEmails(mail.cc); 
} else {
	// if issue key found in subject, add a comment
    addComment(issueKey, currentUserKey(), mail.body);
}

You might find the getUserByEmail and getUserKeysFromEmails routines useful.

Adding the SIL™ Mail Handler

To add a new SIL™ Mail Handler:

Go to Administration > System > Incoming Mail and click Add incoming mail handler.
Fill in the necessary fields:
- Mail Handler name
- Incoming server to use
- Delay between running time
- Select the SIL Mail Handler
Click Next.
In the next screen, select the script to use for the handler and click Add.

To delete the mail handler, use the standard Jira feature.

That's it!

Power Suite Apps for Jira

Mail Handler

Predefined structure: IncomingEmail

Writing the handler script

Adding the SIL™ Mail Handler

See also