Email This Issue
📈 Marketplace❓ Support❤️ Feedback🏠 META-INF Apps
Email This Issue - for Jira Cloud
Email This Issue - for Jira Cloud
  • ⬇️Overview
  • Email This Issue - for Jira Cloud
  • Features
  • How Email This Issue Works
  • Secure the email channel with Email This Issue
  • Comparing Email This Issue and Jira Cloud
  • 📤Outgoing Emails
    • Outgoing emails overview
    • Manual emails
      • Configuring manual emails
      • Sending manual emails
    • Email notification schemes and email notifications
    • Workflow post functions
    • Advanced email configuration
    • Customizing email templates
    • Canned Responses (default messages)
    • Scope evaluation
  • 📥Incoming Emails (Mail Handlers)
    • Incoming emails overview
  • Mail handlers - adding / editing
    • General handler settings
    • Filtering
    • Finding issues
    • Setting up rules and actions in the actions editor
      • Adding/editing actions
      • Adding recipients to Request Participants
      • Creating an issue
      • Updating an issue
      • Setting field values
      • Adding comments
      • Sending auto-reply emails
      • Executing workflow transitions
      • Creating a customer
      • Using split regexp
      • Conditions
      • Approve request
      • Decline request
    • Maintaining email chains
    • Mail Handler New UI
  • Global Sender Address Filters
  • Attachment Filters
    • Regular Attachment Handling Deprecation
  • 🤓Administration
    • Outgoing Mail Connections
    • Alerting via Webhooks
      • Webhooks
        • Configuring Slack to receive alerts via webhooks
        • Configuring OpsGenie to Receive alerts via webhooks
        • Configuring Microsoft Teams to receive alerts via webhooks
      • Webhook execution logs
    • Mail Queue
    • Email Audit Log
    • Permissions
    • Recipient Restrictions
    • Incoming Mail Connections
    • Email Security
    • Incoming Mail Queue
    • Incoming Mail Log
    • OAuth2 Credentials
      • Enabling OAuth2 Authorization in your Google Account
      • Enabling OAuth2 Authorization in your Microsoft 365 Account
      • Troubleshooting guides for Microsoft OAuth2 Connections
        • How to fix "BAD User is authenticated but not connected" error​
        • How to fix "401 Unauthorized" error
        • How to fix "key expires_in " error
        • How to fix "Need admin approval" error
  • ☁️Server to Cloud Migration
    • 🛫Server to Cloud - Automatic Migration tool
      • Preparing for the migration
      • Doing the migration
      • Finalizing the migration in Cloud
      • Migration with unsupported Jira versions causes errors
    • Server to Cloud - Manual migration guide for Email This Issue
  • ❓FAQ
    • No recipients error in outgoing emails
    • How-to add custom macro to email Template?
    • Why cannot I select custom event types in notification?
    • How to configure the Email This Issue addon user in Jira Cloud?
    • I get an error: Could not create request on behalf of the sender
    • Why is the Incoming Mail Queue size limited?
    • Outgoing mail not sent - Read timeout error
    • Access restriction icon is not appearing when adding internal attachments via Email this Issue
  • 🌪️General
    • Release Notes
    • API
      • API for Velocity Context Objects - 1.7
      • API for Velocity Context Objects
    • Addon Pages
      • Integrity Check
      • Feedback and Support
    • Security Advisories
      • Email This Issue Security Advisory September 28, 2020
    • Appendix
      • Supported Time Zones
    • Integration of Glass Documentation
Powered by GitBook
On this page
  • Motivation
  • How to set a Mail Handler on the new UI?
  • Creating a new Mail Handler
  • Configuring a Mail Handler
  • Filter emails
  • Find Issue
  • Rules and Actions
  • Saving a Mail Handler
  • Overview

Was this helpful?

  1. Mail handlers - adding / editing

Mail Handler New UI

A new and modern skin for Mail Handlers

PreviousMaintaining email chainsNextGlobal Sender Address Filters

Last updated 1 year ago

Was this helpful?

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.

At the moment, both skins are present in Email this issue for all users. All the Mail Handlers can be viewed and edited under both menu points In the long run, it is planned to replace the old skin. If you still use the original skin, please consider trying out the new one, and , especially in case you miss something or have any problems using it.

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

  • Filter emails

  • Find issue

  • Rules and Actions

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.

Click on the Configure () icon in order to open the Configure page. Three tabs can be found here:

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.

give us feedback
Templates for newly created Mail Handlers
Create new Handler screen
Mail handlers list
Mail handler status
Actions for Mail Handlers
Tabs on Configure page
Filter emails tab
Find issue tab
Add first Mail Handler item
Rules and Actions dialog
Create issue Item
Add item under an action
Moving items around