Email integration in TargetProcess connects to POP Email account, retrieves emails and binds them to user stories (bugs, tasks, etc.), and creates comments or requests from emails.
Upcoming version 2.21.15 has new Email Integration. Previously, it was project-based. When you created a new project you were able to configure a POP email account for it. That was a serious limitation if you wanted to have one mailbox for several projects. For example, you have email@example.com account and want to bind incoming emails to various projects or create requests in projects based on some rules. You can do that now easily: Bind Email to Project plugin was removed and Rules settings were moved directly into Email Integration plugin.
Also, Email Integration functionality is represented as a plugin under an open source license. It means you can modify and extend it.
|Old Email Integration||New Email Integration|
|Where to find?||Project Add/Edit screen||Settings → Plugins → Email Integration|
|Project/Email Account||1 Project - 1 Email Account||1 Email Account - Many Projects|
|Rules||Hidden, implicit||Explicit, visible|
|Modifications||Not possible||You can modify plugin source code|
To set up email integration, navigate to Settings → Plugins and find Email Integration section. Click Add Profile
Setup is straightforward. Fill in POP account details and push Check Connection button
Rules setup is more complex. Each rule has the following format:
when [conditions] then [actions]
Note that "conditions" part is optional and each rule should start with a new line.
|subject contains 'keyword1, keyword2, ...'||actions from "then" part will be performed if ANY of the listed keywords is in the subject|
|company matched to PROJECT ID||actions from "then" part will be executed only if requester and project mentioned in "when" clause relate to the same company|
|attach to project PROJECT ID||email message will be attached to project|
|create request in project PROJECT ID||request will be created from email for a given project|
Let's say, we have 2 projects. Project1 with id=1 and Project2 with id=2. Project 2 is assigned to TargetProcess company.
We can set the following 3 rules in the profile:
when company matched to project 2 then attach to project 2
then attach to project 1 and create request in project 1
Rules are checked from top to bottom. Let's see how these rules are applied to messages.
- If a message is sent by requester assigned to Targetprocess company and there is either "targetprocess" or "tp" word in the subject then the 1st rule†will be matched and the message will be attached to Project 2, with request created in this project.
- If a message is sent by requester from Targetprocess company but there is NO "targetprocess" or "tp" words in the subject, then the 1st rule will be skipped as†there's no match and the 2nd rule will be applied, with the email attached to Project 2.
- All the other messages not matching any of the first 2 rules will be moved to Project 1, with requests created for Project 1.
Till the end of Summer we will add IMAP integration and more actions, like create user stories, bugs and tasks from incoming email.