Documentation for JIRA 5.1.x. Documentation for other versions of JIRA is available too.

JIRAはメールサーバー、または外部メールサービスによって受信された着信メッセージに基づいて、新しい課題の作成や、既存の課題についてのコメントを作成するように構成することができます。

This is especially useful in a helpdesk or support scenario, where users send support queries via email that you wish to track with JIRA. Subsequent email messages about the issue (for example, responses to Email Notifications) can be automatically recorded as comments. Additionally, any attachments in the emails can automatically be attached to the issue (with appropriate configuration).

メールから課題やコメント作成を行う設定をする

JIRAの課題やコメントは、以下のいずれかから生成することができます。

  • POP または IMAP メール サーバーのアカウントに送信されたメール メッセージ。
  • 外部メール サービスで生成されたファイル システムに書き込まれたメッセージ。

ステップ1：メールサーバー/サービスを設定する

POP または IMAP メール メッセージ

To set up issue and comment creation from email, you will need to create a mail account for a POP or IMAP mail server that JIRA can access – typically, one mail account for each JIRA project. For example, for the 'ABC' project, you might establish an account abc-issues@example-company.com

JIRA はメールアカウントから (サービス経由で) 受信した新しい電子メールメッセージを定期的にスキャンし、適宜課題を作成したり、何か見つかった場合は電子メールにコメントを付けます (メールハンドラ経由で)。

JIRA's mail handlers can also optionally create new user accounts for senders not previously seen. (warning) Note that this is not possible if you are using External User Management.

Once you have created a mail account on a POP or IMAP mail server, configure JIRA to receive email from that mail server account.

(tick) Tip: You can configure JIRA's mail servers so that recipients of email notifications can simply reply to these messages and have the body of their replies added as comments to the relevant issue. To do this, simply set the From address in JIRA's SMTP mail server to match that of the POP or IMAP mail server's account being monitored. (In most cases, this means having JIRA's SMTP and POP or IMAP mail servers use the same mail account.) Details on how to configure JIRA to handle these emailed replies is mentioned below.

ファイル システム メッセージ

To set up issue and comment creation from messages written to the file system by an external mail service, your external mail service must be able to write these messages within the import/mail subdirectory of the JIRA Home Directory.

External mail services are very much like the POP or IMAP services above, except that instead of email messages being read from a mail account, they are read from a directory on the disk. External mail services are useful because they overcome the potential security risks associated with anonymous mail accounts. Instead you can simply configure your external mail service to dump incoming email messages within the JIRA Home Directory's import/mail subdirectory, which is scanned periodically.

Jira はファイルあたり 1 件のメッセージのみを想定しているため、そのように出力するよう外部メール サービスを設定してください。

(info) Please Note — how JIRA handles messages on a mail server/service:

  • メールアカウントの場合、JIRAは、メールアカウントの[受信トレイ]フォルダで受信した電子メールメッセージをスキャンします。しかし、IMAPメール・サーバーでは、メールアカウント内の別のフォルダを指定することができます。
  • JIRAが正常にメッセージを処理する場合、JIRAはメールアカウントからのメッセージ（POPまたはIMAPメールサーバー上の）やファイルシステムからのメッセージ（ファイル・システム・メッセージ用）を削除します。
  • JIRAが正常にメッセージを処理しない場合、メッセージはメールアカウントまたはファイル・システム上のいずれかのままになります。

On this page:

(warning) Some functionality described on this page is restricted in JIRA OnDemand.

ステップ2：メールハンドラーを設定する

メールサーバー/サービスからのメッセージを受信するようにJIRAを設定したら、「メール・ハンドラ 'を介してこれらのメッセージを処理するようにJIRAを設定します。

To configure a JIRA mail handler:

  1. Log in as a user with the JIRA Administrators  global permission.
  2. Select Administration > System > Mail > Incoming Mail to access the Mail Handlers section of the Incoming Mail page (below the POP / IMAP Mail Servers section).
    (tick) Keyboard shortcut: g + g + start typing incoming mail
  3. Click the Configure new incoming mail handler button (or the Edit link next to an existing mail handler) to open the Mail Handler dialog box.
  4. 名前を特定します。メールハンドラーの名前は、メールハンドラーが何をするか、説明します。例えば、「IMAPメールサーバからの課題作成やコメント」 です。
  5. Select the mail Server that you configured in step one (above). This is either a POP or IMAP mail server or the Local Files option for an external mail service that writes messages to the file system.
  6. メールハンドラの実行時間の間（分単位）の　遅延を設定します。前のステップで指定した、サーバをスキャンするJIRAの頻度を効果的に定義します。
  7. Choose the type of mail Handler from dropdown list. For more information, refer to the Mail Handlers section below.
  8. If you chose either an IMAP mail server or the Local Files option in the Server field, then a Folder Name field appears below the Handler  dropdown list:
    • IMAPメールサーバーでは、メールハンドラーにメールアカウントの「受信トレイ」以外のフォルダから新しいメッセージをスキャンさせたい場合は、そのフォルダの名前を指定します。
    • For the Local Files option, if your file messages are being written to a subdirectory within the import/mail subdirectory of the JIRA Home Directory, specify the subdirectory structure (within import/mail) here.
  9. Click Next to continue with specifying the remaining options specific to mail Handler you selected above. For more information, refer to the Mail Handlers section below.
  10. (Optional) Click the Test button to test your mail handler.
  11. Add / Save ボタンをクリックしてメールハンドラー設定を保存します。

(info) Please Note — the relationship between JIRA mail handlers and services:

  • A JIRA mail handler is part of a JIRA service. Hence, when you create a mail handler, its service will appear as an entry on the Services page.
  • Be aware that editing mail handlers can only be performed through the Mail Handlers page (described above).
  • 「メールハンドラ」ページで、メールハンドラと関連付けられている「削除」リンクをクリックすると、そのハンドラが削除されます。メールハンドラはサービスの一部であるため、「サービス」ページでメールハンドラのサービスを削除すると、関連付けられたメードハンドラも「メールハンドラ」ページから削除されます。

メール ハンドラ

 JIRAには、次の既定のメールハンドラが用意されています。

For more information about how these mail handlers create issues and comments in JIRA, refer to Issue/comment creation (below).

Also refer to the Handy tips with mail handlers (below) for tips on tweaking mail handlers to allow JIRA to handle the following types of email messages:

  • JIRAユーザーアカウントなしで送られてきたメール

新規課題の作成または既存の課題にコメントの追加

このメッセージハンドラは、新規で課題を作成、または既存の課題にコメントを追加します。件名に課題キーが含まれている場合、メッセージはその問題にコメントとして追加されます。課題キーが見つからない場合は、新規課題としてデフォルトプロジェクトに作成されます。

新規の課題作成、または既存の課題にコメントを追加する設定にする場合のメールハンドラー；

  1. If you have not already done so, begin configuring your mail handler (above).

  2. 新規課題を作成または既存の課題にコメントを追加ダイアログ ボックスで、次のフィールド/オプションを入力します。

    プロジェクト

    このハンドラーが新しい課題を作成した際の既定のプロジェクトのプロジェクト キーを指定します (JRA など)。

    (info) 注意:

    • このフィールドは課題の作成にのみ関連するもので、課題のコメントには関係しません。
    • メール メッセージの件名行に課題キーが含まれ、その課題キーが Jira インストール内に存在する場合、ハンドラーは課題が格納されているプロジェクトにかかわらず、メール メッセージのコンテンツを課題のコメントとして追加します。
    課題タイプ新しい課題の既定の課題タイプを選択します。
    引用を取り除くSelect this check box to remove quoted text from from an email message's body (e.g. from previous email replies) before the body's content is added to the JIRA issue's comment.
    メール アドレスのキャッチ

    指定した場合、"To:"、"Cc:"、"Bcc:" 行にこのフィールドで指定した受信者を含むメール メッセージのみが処理されます。例: issues@mycompany.com

    Upon specifying an address here, all email messages whose To:, Cc:, Bcc: lines contain addresses other than the Catch Email Address are ignored. This is useful if you have multiple aliases for the same mail account (e.g. foo-support@example-co.com and bar-support@example-co.com aliases for support@example-co.com) for multiple mail services (e.g. each one to create issues in separate JIRA projects).

    (info) Please note: in practice, this option is rarely useful and should not be confused with the more common Default Reporter. You can only specify one catch email address and one issue type per mail handler.

    一括

    このオプションは、ヘッダーで優先順位フィールドが一括に設定されている、または自動送信フィールドがnoに設定されている「一括」電子メールメッセージにのみ影響します。これらのメッセージは一般的時に同サービスによって送信されます。これらの電子メールメッセージを受信すると、選択したオプションに応じて次の操作が実行されます。

    1. メールを無視して、何もしない。
    2. メールを転送する (メールの転送テキスト フィールドで設定されたアドレスへの転送など)。
    3. メールを完全に削除する。

    一般的に、bulk=forward と転送メール アドレスを設定することは、ループを防ぐため (例: 別の Jira インストール) に有用です。

    メール転送

    これを指定し、このメールサービスが受信した電子メールメッセージを処理できない場合、この問題を示す電子メールメッセージはこのフィールドで指定した電子メールアドレスに転送されます。

    (info) Please Note: An SMTP mail server must be configured for this option to function correctly.

    ユーザーの作成

    Select this check box if you want JIRA to create new user accounts from any received email messages whose From: field contains an address that does not match one associated with an existing JIRA user account. This allows the creator of the email message to be notified of subsequent updates to the issue, which can be achieved by configuring the relevant project's notification scheme to notify the Reporter of updates.

    これらの新しく作成された Jira ユーザー アカウントのユーザ名とメール アドレスは、受信メッセージの From: フィールドで指定されるメール アドレスになります。新しい Jira ユーザーのパスワードはランダムに生成され、Jira のユーザー アカウントについて通知するメールがアドレスに送信されます。

    (info) Note: this option is not compatible with Default Reporter field option below and as such, choosing the Create Users option will hide the Default Reporter option.

    既定の報告者

    Specify the username of a default reporter, which will be used if the email address in the From: field of any received messages does not match the address associated with that of an existing JIRA user — for example, a JIRA username such as emailed-reporter

    (info) 注意:

    • This option is not available if the Create Users check box is selected.
    • Please ensure that the user specified in this field has the Create I ssues  project permission for the relevant Project (specified above) as well as the Create Comments   project permission for the other relevant projects to which this mail handler should add comments.
    • 課題を作成してこのオプションを指定すると、送信者を特定できるよう、メール メッセージの From: フィールド アドレスは課題の説明フィールドの末尾に短いメッセージとして追加されます。
    ユーザーの通知

    上記の「ユーザーの作成」オプションでアカウントを作成したユーザーに、JIRA が通知する電子メールメッセージを送信しないよう設定する場合は、このチェックボックスをオフにします。

    (info) Note: this option only functions if the Create Users check box has been selected.

    CC 担当者

    Select this check box if you want JIRA to automatically assign the issue created to a JIRA user:

    • Who's email address (registered with their JIRA account) matches the first matching address encountered in the To:, then Cc: and then Bcc: field of the email message received.
    • Who also has the Assignable User project permission for the relevant Project (specified above).
    CC ウォッチャー

    Select this check box if you want JIRA to automatically add JIRA users to the issue created, where those users' email addresses (registered with their JIRA accounts) match addresses encountered in the To:, Cc: or Bcc: fields of the email message received.

    (info) Please note that when an issue is created, new JIRA users created by the Create Users option (above) cannot also be added to the issue's watchers list by this CC Watchers option. JIRA users must already exist in JIRA's userbase, and must have an email address.

  3. Test and save your mail handler (above).

引用符なしのメール本文からコメントを追加する

このメッセージ ハンドラーはコメントを作成しますが、メール メッセージ本文の非引用部分のみを使用します。引用行とは、「>」や「|」記号で開始する行です。これらのテキスト行はコメントには追加されません。コメントが追加される課題は、メールの件名にある最初の課題キーから選択されます。コメントの作成者はメール メッセージの From: フィールドのアドレスから取得されます。

「メールの非引用本文からコメントを追加する」メール ハンドラーを設定するには:

  1. If you have not already done so, begin configuring your mail handler (above).

  2. 新規課題を作成または既存の課題にコメントを追加ダイアログ ボックスで、次のフィールド/オプションを入力します。

    メール アドレスのキャッチ指定した場合、"To:"、"Cc:"、"Bcc:" 行にこのフィールドで指定した受信者を含むメール メッセージのみが処理されます。例: issues@mycompany.com

    Upon specifying an address here, all email messages whose To:, Cc:, Bcc: lines contain addresses other than the Catch Email Address are ignored. This is useful if you have multiple aliases for the same mail account (e.g. foo-support@example-co.com and bar-support@example-co.com aliases for support@example-co.com) for multiple mail services (e.g. each one to create issues in separate JIRA projects).

    (info) Please note: in practice, this option is rarely useful and should not be confused with the more common Default Reporter. You can only specify one catch email address and one issue type per mail handler.

    一括

    このオプションは、ヘッダーで優先順位フィールドが一括に設定されている、または自動送信フィールドがnoに設定されている「一括」電子メールメッセージにのみ影響します。これらのメッセージは一般的時に同サービスによって送信されます。これらの電子メールメッセージを受信すると、選択したオプションに応じて次の操作が実行されます。

    1. メールを無視して、何もしない。
    2. メールを転送する (メールの転送テキスト フィールドで設定されたアドレスへの転送など)。
    3. メールを完全に削除する。
    メール転送

    これを指定し、このメールサービスが受信した電子メールメッセージを処理できない場合、この問題を示す電子メールメッセージはこのフィールドで指定した電子メールアドレスに転送されます。

    (info) Please Note: An SMTP mail server must be configured for this option to function correctly.

    ユーザーの作成

    Select this check box if you want JIRA to create new user accounts from any received email messages whose From: field contains an address that does not match one associated with an existing JIRA user account. This allows the creator of the email message to be notified of subsequent updates to the issue, which can be achieved by configuring the relevant project's notification scheme to notify the Reporter of updates.

    新しく作成した JIRA ユーザアカウントのこれらのユーザ名とメールアドレスは、メッセージの送信者：フィールドで指定したメールアドレスになります。新しいユーザのパスワードはランダムに生成され、JIRA のアカウントについて知らせるメールが新しいユーザに送信されます。

    (info) Note: this option is not compatible with Default Reporter field option below and as such, choosing the Create Users option will hide the Default Reporter option.

    既定の報告者

    Specify the username of a default reporter, which will be used if the email address in the From: field of any received messages does not match the address associated with that of an existing JIRA user — for example, a JIRA username such as emailed-reporter

    (info) 注意:

    • This option is not available if the Create Users check box is selected.
    • Please ensure that the user specified in this field has the Create Issues project permission for the relevant Project (specified above) as well as the Create Comments project permission for the other relevant projects to which this mail handler should add comments.
    ユーザーの通知

    上記の「ユーザーの作成」オプションでアカウントを作成したユーザーに、JIRA が通知する電子メールメッセージを送信しないよう設定する場合は、このチェックボックスをオフにします。

    (info) Note: this option only functions if the Create Users check box has been selected.

  3. Test and save your mail handler (above).

メール本文全体でコメントを追加する

このメッセージ ハンドラーは、受信したメール メッセージの本文全体をもとにコメントを作成します。コメントが追加される課題は、メールの件名で見つかった最初の課題キーから選択されます。コメントの作成者はメール メッセージの From: フィールドのアドレスから取得されます。

「メール本文を使用してコメントを追加する」ようにメール ハンドラーを設定するには:

  1. If you have not already done so, begin configuring your mail handler (above).

  2. 新規課題を作成または既存の課題にコメントを追加ダイアログ ボックスで、次のフィールド/オプションを入力します。

    メール アドレスのキャッチ指定した場合、"To:"、"Cc:"、"Bcc:" 行にこのフィールドで指定した受信者を含むメール メッセージのみが処理されます。例: issues@mycompany.com

    Upon specifying an address here, all email messages whose To:, Cc:, Bcc: lines contain addresses other than the Catch Email Address are ignored. This is useful if you have multiple aliases for the same mail account (e.g. foo-support@example-co.com and bar-support@example-co.com aliases for support@example-co.com) for multiple mail services (e.g. each one to create issues in separate JIRA projects).

    (info) Please note: in practice, this option is rarely useful and should not be confused with the more common Default Reporter. You can only specify one catch email address and one issue type per mail handler.

    一括

    このオプションは、ヘッダーで優先順位フィールドが一括に設定されている、または自動送信フィールドがnoに設定されている「一括」電子メールメッセージにのみ影響します。これらのメッセージは一般的時に同サービスによって送信されます。これらの電子メールメッセージを受信すると、選択したオプションに応じて次の操作が実行されます。

    1. メールを無視して、何もしない。
    2. メールを転送する (メールの転送テキスト フィールドで設定されたアドレスへの転送など)。
    3. メールを完全に削除する。
    メール転送

    これを指定し、このメールサービスが受信した電子メールメッセージを処理できない場合、この問題を示す電子メールメッセージはこのフィールドで指定した電子メールアドレスに転送されます。

    (info) Please Note: An SMTP mail server must be configured for this option to function correctly.

    ユーザーの作成

    Select this check box if you want JIRA to create new user accounts from any received email messages whose From: field contains an address that does not match one associated with an existing JIRA user account. This allows the creator of the email message to be notified of subsequent updates to the issue, which can be achieved by configuring the relevant project's notification scheme to notify the Reporter of updates.

    新しく作成した JIRA ユーザアカウントのこれらのユーザ名とメールアドレスは、メッセージの送信者：フィールドで指定したメールアドレスになります。新しいユーザのパスワードはランダムに生成され、JIRA のアカウントについて知らせるメールが新しいユーザに送信されます。

    (info) Note: this option is not compatible with Default Reporter field option below and as such, choosing the Create Users option will hide the Default Reporter option.

    既定の報告者

    Specify the username of a default reporter, which will be used if the email address in the From: field of any received messages does not match the address associated with that of an existing JIRA user — for example, a JIRA username such as emailed-reporter

    (info) 注意:

    • This option is not available if the Create Users check box is selected.
    • Please ensure that the user specified in this field has the Create Issues project permission for the relevant Project (specified above) as well as the Create Comments project permission for the other relevant projects to which this mail handler should add comments.
    ユーザーの通知

    上記の「ユーザーの作成」オプションでアカウントを作成したユーザーに、JIRA が通知する電子メールメッセージを送信しないよう設定する場合は、このチェックボックスをオフにします。

    (info) Note: this option only functions if the Create Users check box has been selected.

  3. Test and save your mail handler (above).

各メールのメッセージから新規課題の作成

このメッセージ ハンドラーは、受信したメッセージごとに新しい課題を作成します。

「各メール メッセージから新しい課題を作成する」ようにメール ハンドラーを設定するには:

  1. If you have not already done so, begin configuring your mail handler (above).

  2. 新規課題を作成または既存の課題にコメントを追加ダイアログ ボックスで、次のフィールド/オプションを入力します。

    プロジェクト

    このハンドラーが新しい課題を作成した際の既定のプロジェクトのプロジェクト キーを指定します (JRA など)。

    (info) 注意:

    • このフィールドは課題の作成にのみ関連するもので、課題のコメントには関係しません。
    • メール メッセージの件名行に課題キーが含まれ、その課題キーが Jira インストール内に存在する場合、ハンドラーは課題が格納されているプロジェクトにかかわらず、メール メッセージのコンテンツを課題のコメントとして追加します。
    課題タイプ新しい課題の既定の課題タイプを選択します。
    メール アドレスのキャッチ

    指定した場合、"To:"、"Cc:"、"Bcc:" 行にこのフィールドで指定した受信者を含むメール メッセージのみが処理されます。例: issues@mycompany.com

    Upon specifying an address here, all email messages whose To:, Cc:, Bcc: lines contain addresses other than the Catch Email Address are ignored. This is useful if you have multiple aliases for the same mail account (e.g. foo-support@example-co.com and bar-support@example-co.com aliases for support@example-co.com) for multiple mail services (e.g. each one to create issues in separate JIRA projects).

    (info) Please note: in practice, this option is rarely useful and should not be confused with the more common Default Reporter. You can only specify one catch email address and one issue type per mail handler.

    一括

    このオプションは、ヘッダーで優先順位フィールドが一括に設定されている、または自動送信フィールドがnoに設定されている「一括」電子メールメッセージにのみ影響します。これらのメッセージは一般的時に同サービスによって送信されます。これらの電子メールメッセージを受信すると、選択したオプションに応じて次の操作が実行されます。

    1. メールを無視して、何もしない。
    2. メールを転送する (メールの転送テキスト フィールドで設定されたアドレスへの転送など)。
    3. メールを完全に削除する。
    メール転送

    これを指定し、このメールサービスが受信した電子メールメッセージを処理できない場合、この問題を示す電子メールメッセージはこのフィールドで指定した電子メールアドレスに転送されます。

    (info) Please Note: An SMTP mail server must be configured for this option to function correctly.

    ユーザーの作成

    Select this check box if you want JIRA to create new user accounts from any received email messages whose From: field contains an address that does not match one associated with an existing JIRA user account. This allows the creator of the email message to be notified of subsequent updates to the issue, which can be achieved by configuring the relevant project's notification scheme to notify the Reporter of updates.

    新しく作成した JIRA ユーザアカウントのこれらのユーザ名とメールアドレスは、メッセージの送信者：フィールドで指定したメールアドレスになります。新しいユーザのパスワードはランダムに生成され、JIRA のアカウントについて知らせるメールが新しいユーザに送信されます。

    (info) Note: this option is not compatible with Default Reporter field option below and as such, choosing the Create Users option will hide the Default Reporter option.

    既定の報告者

    Specify the username of a default reporter, which will be used if the email address in the From: field of any received messages does not match the address associated with that of an existing JIRA user — for example, a JIRA username such as emailed-reporter

    (info) 注意:

    • This option is not available if the Create Users check box is selected.
    • Please ensure that the user specified in this field has the Create Issues project permission for the relevant Project (specified above) as well as the Create Comments project permission for the other relevant projects to which this mail handler should add comments.
    • 課題を作成してこのオプションを指定すると、送信者を特定できるよう、メール メッセージの From: フィールド アドレスは課題の説明フィールドの末尾に短いメッセージとして追加されます。
    ユーザーの通知

    上記の「ユーザーの作成」オプションでアカウントを作成したユーザーに、JIRA が通知する電子メールメッセージを送信しないよう設定する場合は、このチェックボックスをオフにします。

    (info) Note: this option only functions if the Create Users check box has been selected.

    CC 担当者

    Select this check box if you want JIRA to automatically assign the issue created to a JIRA user:

    • Who's email address (registered with their JIRA account) matches the first matching address encountered in the  To: , then Cc: and then Bcc: field of the email message received.
    • Who also has the Assignable User project permission for the relevant Project (specified above).
    CC ウォッチャー

    Select this check box if you want JIRA to automatically add JIRA users to the issue created, where those users' email addresses (registered with their JIRA accounts) match addresses encountered in the To:, Cc: or Bcc: fields of the email message received.

    (info) Please note that when an issue is created, new JIRA users created by the Create Users option (above) cannot also be added to the issue's watchers list by this CC Watchers option. JIRA users must already exist in JIRA's userbase, and must have an email address.

  3. Test and save your mail handler (above).

メール本文の指定したマーカーまたはセパレーターの前にコメントを追加する

このメッセージ ハンドラーは、メール メッセージの本文からコメントを作成しますが、指定の正規表現 (regex) と一致するマーカーまたは区切り記号以降の本文をすべて無視します。

Lotus Notes や Outlook などのメール システムの場合、メール メッセージのコア コンテンツは、"---- Original Message ----" や "Extranet\n email.address/DOM/REG/CONT/CORP@CORPMAIL" などの決まった文字列で、本文内にある他のコンテンツ (返信済や転送済など) と互いに区切られます。そのため、有効な regex を取得できるこのメッセージ ハンドラーを使用して、さまざまなメール システムで、不要なコンテンツからコアをフィルターすることができます。

また、コメントが追加される課題は、メールの件名で見つかった最初の課題キーから選択されることに注意してください。

The Add a comment before a specified marker or separator in the email body mail handler has the following behaviour with respect to received email messages:

  • (メール ハンドラーで指定された) regex パターンが見つかった場合、メール メッセージ本文の、最初に一致した regex パターンの前のテキストがコメントに使用され、本文の残りの部分は破棄されます。
  • (メール ハンドラーで指定された) regex パターンが見つからない場合、メール メッセージ本文のテキスト全体がコメントに使用されます。
  • regex パターンがメール ハンドラーで指定されていない場合、メール メッセージ本文のテキスト全体がコメントに使用されます。
  • メール ハンドラーに指定された regex 表現に誤りがある場合、メール メッセージ本文のテキスト全体がコメントに使用されます。

「メール本文中で指定されたマーカーまたはセパレーターの前にコメントを追加」メール ハンドラーを設定するには:

  1. If you have not already done so, begin configuring your mail handler (above).

  2. 新規課題を作成または既存の課題にコメントを追加ダイアログ ボックスで、次のフィールド/オプションを入力します。

    スプリット正規表現

    メール メッセージのメール本文の内容を本文の他の (返信または転送された) 内容から分割する文字列に一致する正規表現を指定します。

    (info)  注意:

    • regex の先頭と末尾に区切り文字 (通常は "/" ) を付ける必要があります。
    • 各メール ハンドラーのフィールド/オプションを分割するためにカンマが使用されるため、正規表現ではカンマを使用できません。これは、メール ハンドラーが Jira サービスに統合されていて、エスケープ構文が存在しないためです。

    例:

    /----\s*Original Message\s*----/

    または

    /_____________*/
    メール アドレスのキャッチ指定した場合、"To:"、"Cc:"、"Bcc:" 行にこのフィールドで指定した受信者を含むメール メッセージのみが処理されます。例: issues@mycompany.com

    Upon specifying an address here, all email messages whose To:, Cc:, Bcc: lines contain addresses other than the Catch Email Address are ignored. This is useful if you have multiple aliases for the same mail account (e.g. foo-support@example-co.com and bar-support@example-co.com aliases for support@example-co.com) for multiple mail services (e.g. each one to create issues in separate JIRA projects).

    (info) Please note: in practice, this option is rarely useful and should not be confused with the more common Default Reporter. You can only specify one catch email address and one issue type per mail handler.

    一括

    このオプションは、ヘッダーで優先順位フィールドが一括に設定されている、または自動送信フィールドがnoに設定されている「一括」電子メールメッセージにのみ影響します。これらのメッセージは一般的時に同サービスによって送信されます。これらの電子メールメッセージを受信すると、選択したオプションに応じて次の操作が実行されます。

    1. メールを無視して、何もしない。
    2. メールを転送する (メールの転送テキスト フィールドで設定されたアドレスへの転送など)。
    3. メールを完全に削除する。
    メール転送

    これを指定し、このメールサービスが受信した電子メールメッセージを処理できない場合、この問題を示す電子メールメッセージはこのフィールドで指定した電子メールアドレスに転送されます。

    (info)  Please Note: An SMTP mail server must be configured for this option to function correctly.

    ユーザーの作成

    Select this check box if you want JIRA to create new user accounts from any received email messages whose From: field contains an address that does not match one associated with an existing JIRA user account. This allows the creator of the email message to be notified of subsequent updates to the issue, which can be achieved by configuring the relevant project's notification scheme to notify the Reporter of updates.

    新しく作成した JIRA ユーザアカウントのこれらのユーザ名とメールアドレスは、メッセージの送信者：フィールドで指定したメールアドレスになります。新しいユーザのパスワードはランダムに生成され、JIRA のアカウントについて知らせるメールが新しいユーザに送信されます。

    (info)  Note: this option is not compatible with Default Reporter field option below and as such, choosing the Create Users option will hide the Default Reporter option.

    既定の報告者

    Specify the username of a default reporter, which will be used if the email address in the From: field of any received messages does not match the address associated with that of an existing JIRA user — for example, a JIRA username such as emailed-reporter

    (info)  注意:

    • This option is not available if the Create Users check box is selected.
    • Please ensure that the user specified in this field has the Create Issues  project permission for the relevant Project (specified above) as well as the Create Comments   project permission for the other relevant projects to which this mail handler should add comments.
    ユーザーの通知

    上記の「ユーザーの作成」オプションでアカウントを作成したユーザーに、JIRA が通知する電子メールメッセージを送信しないよう設定する場合は、このチェックボックスをオフにします。

    (info)  Note: this option only functions if the Create Users check box has been selected.

  3. Test and save your mail handler (above).

カスタム メール ハンドラー

You can design your own message handlers to better integrate your own processes into JIRA. Such custom mail handlers configured using the standard procedure above.

For more information about creating custom mail handlers, see Adding your own email handling classes.

課題とコメントの作成

Jira がそれぞれの受信メール メッセージを処理し、既存の課題へのコメントまたは新しい課題として追加する過程については、次のポイントをご確認ください。

  • メール メッセージの件名は、既存の課題キーについて調べられます。
    • 件名に課題キーが見つかった場合、その課題キーを使用して、メール メッセージ本文のコンテンツが課題へのコメントとして処理および追加されます。
    • subject に課題キーが見つからない場合は、in-reply-to header が調べられます。
      • メール メッセージが、作成済みの課題から生成された別のメール メッセージに対する返信だと分かった場合、本文はその課題へのコメントとして処理および追加されます。
      • メール メッセージが応答でない場合、新しい課題が作成されます。

For example, an email message to a mail account foo@example-co.com on a POP or IMAP mail server configured against a JIRA server will be processed as follows:

  • 課題の作成:
    • The subject of the email message will become the issue summary.
      (warning) Since all issues require a summary, each email message intended for issue creation should include a subject.
    • メール メッセージの本文は課題の説明になります。
    • A bug will be created for project 'JRA' with the above information. (This is essentially based on the mail handler configuration above).
    • Any attachments to the email message will become attachments to the issue (assuming attachments have been enabled in JIRA).
      (info) To ensure compatibility with various operating systems, any of the following characters in the filename will be replaced with an underscore character: \, /, ", %, :, $, ?, *, <, |, >.
    • 受信メールが高い優先度に設定されている場合、対応する課題は JIRA システムで設定されている既定の優先度よりも高い優先度で作成されます。
  • コメントの作成
    • メールの本文は課題のコメントになります。

    • Any attachments to the email will become attachments to the issue (assuming attachments  have been enabled in JIRA).

メール ハンドラの便利なヒント

Allowing JIRA to handle email messages from people without a JIRA user account

JIRA ユーザー アカウントを持たない人から送信されたメール メッセージを JIRA が処理できるようにするには、

  1. Create an 'anonymous'/'dummy' mail account on your mail server/service (above).
  2. メール フィールドが以前の手順で作成したメール アカウントと一致する、同等の「匿名」/「ダミー」JIRA ユーザー アカウントを作成します。
  3. When configuring your mail handler(s) (above) to handle messages from this mail account, set the Default Reporter to this 'anonymous'/'dummy' JIRA user account.

ベスト プラクティス (Jira メール メッセージの前処理)

JIRA 本番環境サーバーの場合、次のメール メッセージ事前処理を設定することをお勧めします。

  • JIRA のメール ハンドラーは、正常に処理されたメール メッセージをメール サーバーから削除するため、メールをバックアップ フォルダーに送信して、JIRA が処理したメールの記録が利用可能なことを確認してください。

  • メール フォルダーに JIRA メール通知への返信が含まれる場合は、自動返信やバウンス メールをフィルタリングするルールを設定します。
    これを行わない場合、「オフィス不在」通知などの自動応答システムと JIRA との間のメール ループが発生する可能性が高くなります。JIRA は送信メールに「Precedence:bulk」ヘッダー (無効にしていない場合) と「Auto-Submitted」ヘッダーを設定しますが、一部の自動応答システムはこれを無視します。メールがバウンスまたは自動応答の場合、完全な検出方法はありません。次の規則 (procmail 形式) は、ほとんどの自動返信を検出します。

    ^From:.*mailer-daemon@
^Auto-Submitted:.auto-
^Content-Type:\ multipart/report;\ report-type=delivery-status
^Subject:\ Delivery\ Status\ Notification
^Subject:\ Undeliverable
^Subject: Returned Mail:
^From:\ System\ Administrator
^Precedence:\ auto_reply
^Subject:.*autoreply
^Subject:.*Account\ signup

    これらの規則を使用しても、通常のメールと区別するためのヘッダー設定を行っていない自動応答を受け取る場合があります。こうした事例では、その送信者を除外するフィルターを手動で更新する必要があります。

  • 大容量の添付ファイル付きのメールをキャッチするフィルターを設定します。JIRA は標準の JavaMail ライブラリを使用してメールを解析していて、大容量の添付ファイルがあると、すぐにメモリ不足となります (たとえば、ヒープサイズ 512 MBヒープで 50 MBを超える場合)。未処理のメールは削除されないため、メール サービスを実行するたびにそのメールが再処理されます（OutOfMemoryError を発生させるもう一つの原因となります）。ほとんどのメール サーバーは大容量の添付ファイルの付いたメールを承諾しないよう設定されているため、実践では、この問題に遭遇することはめったにありません。メール サーバーが大容量の添付ファイルをそのまま JIRA に引渡すことはないと確信できない場合は、フィルターを設定して、JIRA が大容量の添付ファイル受け取らないようにするのが一番です。
  • JIRA がスパムを処理する（そして、おそらくは課題を作成する）必要がないように、スパムをフィルタリングするルールを設定します。

トラブルシューティング

JIRA's Logging & Profiling page has configuration options for Outgoing and Incoming mail.

（上記）新しいメール ハンドラを作成（または既存のものを編集）するたび、メールハンドラの設定が期待通りに動作することを確認するテストできるテストボタンが利用可能になります。

A useful tip for debugging mail-related problems in JIRA is to set the -Dmail.debug=true property on startup. This will cause protocol-level details of JIRA's email interactions to be logged in catalina.out (or standard output).

一般的な問題

  • If JIRA does not appear to be creating sending emails or creating issues and comments from email, your JIRA instance could be experiencing OutOfMemory errors. Please check your log files for OutOfMemory errors. If there are OutOfMemory errors, please restart JIRA and investigate the errors.
  • If you find some incoming emails simply disappear, check that you have not accidentally started a second copy of JIRA (e.g. in a staging environment) which is downloading and deleting mails. See the Disable email sending/receiving section of the Restoring Data page for flags you should set to prevent mail being processed.
  • Jira の通知による返信メールに、構成済みハンドラーの POP アカウントではなく Jira の SMTP サーバーが記載されている場合 (Outlook の「Reply-to」機能を使用した場合など)、プロジェクトを構成して送信通知のヘッダーに 'reply-to' を追加する必要があります。これは、Jira 管理メニューで、対象のプロジェクトのプロジェクト ビューで構成できます。
  • If HTML/Rich Text formatting is not being process correctly by JIRA, this is an expected behaviour. The email comment handler was designed to do plain text conversion.

ヘルプの活用

If you cannot resolve a problem yourself, please refer to the Getting Help page.



See our Getting Help page for details.



Raise an issue for our developers.



See answers from the community.



Tweet, blog and update our documentation.

Except where otherwise noted, content in this space is licensed under a Creative Commons Attribution 2.5 Australia License.