目的

This article details how to troubleshoot issues with the email channel in Jira Service Management. It is targeting why emails are not getting to Jira Service Management.

Test your email channel connection

Errors with your email channel connection can occur for a variety of reasons. To check if your Service Management can receive emails requests, test the connection between your Jira Service Management and your email account. To check your email channel connection:

You must be a Jira admin to check the connection.

1. Choose Settings  > Products.
2. Under Jira Service Management, select Email requests.
3. Select Actions next to the desired channel > Test connection.

Adjust the global mail settings

You can temporarily adjust the Global email settings to troubleshoot your email channel.

To change the global mail settings:

Prerequisite - You must be a Jira admin to check the connection.

1. Choose Settings  > System.
2. Navigate to the Global Mail Settings option.

Error - Email address in use

メッセージ

The email address you entered is currently used by another project's email channel.

ソリューション

Make sure each of your Service Management projects has a unique email account. An email account can't connect with multiple Service Management projects.

You can also receive this message if you're trying to use multiple email aliases that point to the same email account for multiple Service Management project email channels.

Error - Requests are not created or notifications received

説明

Customers are emailing requests that are not arriving in your queues. They also are not receiving notifications.

ソリューション

To troubleshoot why requests are nott created or notifications received:

1. Check the email connection.

2. Verify that the customer has permission to email your Service Management project.

3. メール チャンネルのデフォルト リクエスト タイプで [概要] フィールドと [説明] フィールドが表示されていることを確認します。

4. Verify if another Jira instance email channel/mail handler is intercepting mail items intended for the target instance.
   • With debug logging enabled for incoming mail you should find a "found x messages for processing" each time the mail puller is run.
   • In testing if you do not see a matching quantity of mail items pulled for processing as what was sent to the mailbox it is an indication there is something else pulling the email before the target instance is able to.

5. [グローバル メール設定] で [メールのプル機能] が有効であることを確認します。

• 関連付けられているメールの受信トレイが Office 365 のものである場合、リクエストの添付ファイルが 2MB を超えていると、この問題が発生する可能性があります。これは Office 365 の既知の問題です。これを解決するには、添付ファイルのサイズを小さくします。

• If the associated email is AOL, the AOL mail server might reject the mail. This is because the Atlassian Cloud mail server is not a fully-qualified domain name (FQDN). We recommend that you don't use AOL email addresses with your Service Management project.

Error - Requests not created due to too many required fields 

メッセージ

Configured request type has too many visible required fields.

ソリューション 

This issue can surface when fields other than the Summary (Subject) and Description (Body) are marked as required for the request type used by the email channel. To resolve this issue:

1. Within your Service Management project, navigate to Project Settings  > Request types.
2. Identify and select the request type used by the Email channels 
3. Select Request form.
4. Confirm that only the Subject or Body fields are marked as Required.
5. If other fields are marked as Required, adjust the value within the Required column to No and click the update button to save your changes.

Error - No suitable request type for the email channel

メッセージ

No suitable request type for the email channel. You will select the default request type assigned to requests created from the email channel during the setup. However, no existing request types are suitable for email requests. A suitable request type must have both the Summary and Description fields as visible fields and all the other visible fields, if any, must be optional. If you want to enable the email channel, add a new request type that meets the criteria or modify an existing one on the Request types page.

ソリューション

To troubleshoot why there are no suitable request types for the email channel:

1. In your Service Management project, select Project Settings > Request types.

2. 新しいリクエスト タイプを追加するか、既存のリクエスト タイプを選択します。

3. [フィールドの編集] を選択します。

4. [要約] および [説明] フィールドの両方が追加され、[表示] とマークが付けられていることを確認します。[添付ファイル] フィールドを追加し、任意とマークします。

5. [保存] を選択して、[プロジェクト設定] > [メール リクエスト] に戻ります。

Error - Archived messages are creating requests

Description
When Jira Service Management checks your email accounts for new messages, it polls the inbox folder. Gmail uses labels to classify messages into categories and only has the following folders:

• 受信トレイ

• 送信済みメール

• ビン(ゴミ箱)

つまり、アーカイブ済みメッセージはまだ受信トレイ フォルダ内にあるとみなされます。POP3 を使用している場合、Jira Service Management はラベルによってアーカイブ済みメッセージを識別できないため、リクエストとして処理します。

ソリューション

Use IMAP instead, or reconnect with OAuth by clicking on the Microsoft logo.

Error - Set up a Gmail account

メッセージ:

Unfortunately Jira couldn't connect to the mail server. Here is what the mail server said: "[ALERT] Please log in via your web browser:http://support.google.com/mail/accounts/bin/answer.py?answer=78754(Failure)"

解決状況：

Create an application-specific password for Jira Service Management in your Gmail account settings.

Error - Account locks for security - Microsoft Outlook

メッセージ:

Unfortunately, Jira Service Management couldn't connect to the mail server. Here is what the mail server said: "STAT command failed: Exceeded the login limit for a 15 minute period. Reduce the frequency of requests to the POP3 server.

解決状況：

Jira Service Management checks email accounts every minute. Microsoft Outlook might suspect inappropriate usage of this account and lock it for security reasons. To resolve this, use IMAP instead, or reconnect with OAuth by clicking on the Microsoft logo.