Outgoing Mail Connections
In contrast with Jira, Email This Issue supports multiple Outgoing Mail Connections that brings the following important improvements:
- Emails may be sent via various Outgoing Mail Connections if needed, even depending on issue fields.
- The email subject prefix is optional, and not a mandatory value as it is in Jira.
Connections can be added in the Outgoing Mail Connections menu. Go to OUTGOING EMAILS ADMINSTRATION --> Outgoing Mail Connections.
Outgoing Mail Connections have a set of mandatory and optional attributes. The new Protocol Attribute is used to specify if connection to the provider is based on password authentication or on OAuth2.
When using OAuth2 connection protocol, a reduced set of fields are shown because attributes like host, port, password are not required.
If you want to connect to an Outgoing Mail Connection service using OAuth2 after specifying the OAuth Credential and Username you must start the authorization process by clicking the Authorization button.
The authorization is specific to the service provider. The procedure is detailed here:
A shared mailbox is a mailbox that multiple users can use to read and send e-mail messages. You can read more about them here: https://docs.microsoft.com/en-us/exchange/collaboration/shared-mailboxes/shared-mailboxes
To use a shared mailbox you just have to enter the email address of the shared mailbox into the From Address field then proceed with the settings as if it was a normal mail account. For the username and password fields (or for the OAuth authorization) use the credentials of the account you want to log in with.
There are two ways to test a configured connections:
- Testing connections on the Edit Outgoing Mail Connection screen
It is possible to test the connections before saving it. Immediate results are received as popup flags.
- Sending test emails
It is possible (and recommended) to test the connections by sending test emails. Click the three dots next to a connection and choose Send Test Email.
Click Send Email to get a detailed output.
Connections need to be set in the Contexts in order to activate them and to start sending emails through them. This means it is possible to use different connections depending on the issue fields because Contexts may be configured with an arbitrary JQL scope.
This attribute is used with manual emails. If the total size of attachments added to the email exceeds this value, a warning message pops up before the email is dispatched.
An outgoing connection may be marked as Default. Contexts can be configured to send emails via the Default connection instead of directly binding them to one dedicated connection.
It is possible to mark another connection as Default without having to change any of the Contexts configured to use the Default connection.