Mail Handler New UI
A new and modern skin for Mail Handlers
Motivation
Mail Handler in Email This Issue is the app's most popular feature. Our intention behind creating a new UI was to present an interface that is easy to use, easy to see through, and that is better suited to modern needs.
All the saved changes made while using one of the skins are shown on the other skin as well. In other words, the Mail Handler entities are not duplicated, they can be viewed and edited in two different skins.
How to set a Mail Handler on the new UI?
Creating a new Mail Handler
After the Add button is clicked, a panel with four templates is going to be opened. Select the desired Mail Handler template and hit the Next button.
On the Create new Handler screen type in the Handler name, choose at least one Incoming Mail Connection, and set a Default reporter if needed.
After clicking on the Save button, the Mail Handlers list page will be opened.
In case the Incoming Connection is not working for some reason, the Connection is marked as red.
The Status shows if the Handler is switched ON or OFF.
There are three different Actions next to a Mail Handler. These are in the order of appearance:
Configure Handler
Edit Handler
Delete Handler
Configuring a Mail Handler
Click on the Configure (
) icon in order to open the Configure page. Three tabs can be found here:
Filter emails
Find issue
Rules and Actions
Please note: the fourth Tab that can be found on the original Mail Handler UI - General Handler Settings - is not available on the Configuring page. Instead, it is obtainable by clicking on the Edit Handler (
) icon.
Filter emails
Available filters can be switched ON or OFF by using the toggle.
Find Issue
Alongside the two finders from the old Handler UI (Lookup by mail headers and Lookup by JQL), the Lookup by issue key finder can also be seen on the Find issue tab. As this is the default method, it cannot be modified or switched off.
Rules and Actions
The new Rules and Action tab is quite different from the old one.
Start to add items by clicking on the Add Item button.
Clicking the button opens a dialog with all the available rules and actions to choose from.
After choosing an item, a right-hand panel opens where all the settings can be done for the action. Until there is anything missing, the item remains red.
There is an additional Add item button under the action, where applicable. For example, the Set field action can be found under the Create issue action.
Easy editing
Items can be moved around by drag and drop. Move the cards around to find out where it is possible to place them.
Conditions
The new Mail Handler UI highly encourages to use of Condition Groups instead of conditions under each other.
Usually Conditions Groups are a better alternative since they are easier to manage and overview.
A single Condition contains an IF, may contain multiple IFELSE, and finally an ELSE branch.
A Condition Group can contain multiple Conditions. Condition Groups are like brackets “()” in math, where Conditions can be connected with AND/OR actions. This is the suggested way to create complex Condition structures.
Saving a Mail Handler
On the top right corner, a warning message appears if there are unsaved items. If the Save button is clicked, the message shows the Last saved time.
Overview
An overview of the created Mail Handler is available in HTML, JSON, and image formats.
To get an Overview, choose the Overview button at the top of the Rules and Actions tab.
With the Download All button, all three formats will be downloaded at once.
Please send the downloaded files if you contact our support team in relation to the Mail Handler to provide us with a better understanding of your problem.
Last updated
Was this helpful?