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

管理者は、メールを受信および処理するよう Jira を設定できます。Jira はライセンスを持つユーザーからメールを受信して、自動的に課題を作成したり、既存の課題へコメントや添付ファイルを追加します。

ヘルプデスクソリューションをお探しの場合、Jira Core または Jira をセットアップするよりも Jira Service Management を使用するほうが実用的な場合があります。

Jira Service Management はビルトインプロセッサーを使用して、メールによる課題リクエストを受信および処理します。Jira Service Management で作成される課題では、送信者が課題の作成、表示、コメントや添付ファイルの追加、または課題のトランジションを実行するためのライセンスを持っている必要はありません。Jira Service Management を使用したメールリクエストの受信についてはこちらをご覧ください。

お使いのインスタンスで Jira Service Management をダウンロードしてセットアップする方法をご確認ください。

On this page:

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

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

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

注意: 次のすべての手順において、Jira 管理者グローバル権限を持つユーザーとしてログインする必要があります。

ステップ 1: Jira を OAuth 2.0 クライアントとして設定する

基本認証の使用が廃止された Gmail または Microsoft Exchange Online をご利用の場合、この設定は必須です。

Jira を OAuth 2.0 クライアントとして設定する必要があります。完了すると、メールサーバーの認証方法として Google または Microsoft との OAuth 2.0 統合を選択できるようになります。この方法の詳細については「送信リンクを設定する」をご確認ください。

カスタムメールサーバーまたはその他のサービスプロバイダーで IMAP または POP3 が使用されている場合、それらの設定を更新する必要はありません。これらは引き続き動作します。

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

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

メールからの課題およびコメントの作成をセットアップするには、Jira がアクセスできる POP または IMAP メールサーバーにメールアカウントを作成する必要があります。一般に、Jira プロジェクトについて 1 つのメールアカウントを使用します。たとえば、"ABC" プロジェクトの場合、アカウント abc-issues@example.com を用意します。

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

Jira のメールハンドラーは任意で新しい送信者に対して新しいユーザーアカウントを作成することができます。詳細については、「新しい課題を作成または既存の課題にコメントを追加する」セクションを参照してください。

外部ユーザー管理を使用している場合、この操作は実行できません。

POP または IMAP メールサーバーでメールアカウントを作成したら、そのメールサーバーアカウントからメールを受信するよう Jira を設定します。

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. See below for details on how to configure Jira to handle these emailed replies.

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

外部メールサービスからファイルシステムに書き込まれたメッセージからの課題およびコメントの作成をセットアップするには、外部メールサービスが Jira ホームディレクトリの import/mail サブディレクトリ内でそのようなメッセージを書き込むことができる必要があります。

外部メールサービスは上記の POP や IMAP サービスと非常に似ていますが、メールメッセージをメールアカウントではなくディスク上のディレクトリから読み込みます。外部メールサービスは、匿名メールアカウントに関連する潜在的なセキュリティリスクに対応するために有用です。また外部メールサービスを設定して、定期的にスキャンされる Jira ホームディレクトリの import/mail サブディレクトリ内の受信メッセージを破棄するようにできます。

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

注 — Jira がメールサーバ/サービスでメッセージをハンドリングする方法：

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

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

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

上部のナビゲーションバーから [管理者 ] > [システム] を選択します。
メール > 受信メールを選択し、受信メールページを開きます。
[メールハンドラー] セクションで [受信メールハンドラの追加] をクリック (または既存のメールハンドラーの横の [編集] リンクをクリック) して、[メールハンドラー] ダイアログボックスを開きます。
名前を特定します。メールハンドラーの名前は、メールハンドラーが何をするか、説明します。例えば、「IMAPメールサーバからの課題作成やコメント」です。
メールサーバー(上記のステップ1で設定した) を選択します。これは、POPまたはIMAPメールサーバーまたは、ファイル・システムにメッセージを書き込む、外部メールサービスのローカルファイル オプションがあります。
メールハンドラの実行時間の間（分単位）の　遅延を設定します。前のステップで指定した、サーバをスキャンするJiraの頻度を効果的に定義します。
この課題ドロップダウンリストから、メールハンドラーのタイプを選択します。詳細については、以下の「メールハンドラー」セクションを参照してください。
IMAPメールサーバまたはサーバフィールド内の、ローカルファイルオプションのいずれかを選択した場合フォルダ名フィールドが ハンドラー ドロップダウンリストの下に表示されます：
- IMAPメールサーバーでは、メールハンドラーにメールアカウントの「受信トレイ」以外のフォルダから新しいメッセージをスキャンさせたい場合は、そのフォルダの名前を指定します。
- ローカルファイル オプションでは、ファイルメッセージを Jira ホームディレクトリの import/mail サブディレクトリに書き込む場合、サブディレクトリ構造 (import/mail 内) をここで指定します。
「次へ」をクリックして、引き続き、上記で選択したメールハンドラに固有の残りのオプションを指定します。詳細については、以下の「メールハンドラ」セクションを参照してください。
(オプション) [テスト] ボタンをクリックしてメールハンドラーをテストします。ローカルファイルをサーバーとして使用する場合は、"Subject:" 行を含む保存済みのメールを、設定したディレクトリにコピーします。Jira は、このファイルを解析後に削除するか、課題が作成できなかった理由についてのメッセージをログに記録します。最小構成として、project、issuetype、reporterusername の各プロパティを指定する必要がある場合があります。
メールファイルの例は、次のようになります。
To: jira@example.com
From: some-jira-user@example.com
Subject: (TEST-123) issue summary title here
Body of the email goes here
Add / Save ボタンをクリックしてメールハンドラー設定を保存します。

注 - Jiraのメールハンドラーとサービス間の関係：

Jira メールハンドラは Jira サービスの一部です。そのため、メールハンドラを作成するときには、「サービス」ページにエントリとしてサービスが表示されます。
メールハンドラの編集は、「メールハンドラ」ページ空のみ実行できます (上記で説明したとおり)。
「メールハンドラ」ページで、メールハンドラと関連付けられている「削除」リンクをクリックすると、そのハンドラが削除されます。メールハンドラはサービスの一部であるため、「サービス」ページでメールハンドラのサービスを削除すると、関連付けられたメードハンドラも「メールハンドラ」ページから削除されます。

メールハンドラ

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

新規課題の作成または既存の課題にコメントの追加
引用符なしのメール本文からコメントを追加する
メール本文全体でコメントを追加する
各メールのメッセージから新規課題の作成
メール本文の指定したマーカーまたはセパレーターの前にコメントを追加する

メールハンドラーでJiraの課題とコメントを作成する方法の詳細については、課題/コメントの作成を参照してください。 (以下参照)

また、以下のヒントも参照してください。メールハンドラーの利用の秘訣ー Jiraで電子メールメッセージの以下のタイプを処理可能にするためのメールハンドラーの微調整のヒントについて

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

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

このメールヘッダーは正規表現を使用しません。メール本文の指定されたマーカーまたはセパレーターの前にコメントを追加するハンドラーを代用することをお勧めします。詳細については「Jira 通知をセットアップ」をご参照ください。

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

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

メールハンドラーの設定を開始していない場合は、開始します (上記)。

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

プロジェクト	このハンドラーが新しい課題を作成した際の既定のプロジェクトのプロジェクトキーを指定します (`JRA` など)。注意: このフィールドは課題の作成にのみ関連するもので、課題のコメントには関係しません。メールメッセージの件名行に課題キーが含まれ、その課題キーが Jira インストール内に存在する場合、ハンドラーは課題が格納されているプロジェクトにかかわらず、メールメッセージのコンテンツを課題のコメントとして追加します。
課題タイプ	新しい課題の既定の課題タイプを選択します。
引用を取り除く	Jira 課題のコメントに本文のコンテンツを追加する前に、電子メールメッセージの本文から引用文 (例: 以前のメールの返信から) を削除するにはこのチェックボックスを選択します。
メールアドレスのキャッチ	指定した場合、"To:"、"Cc:"、"Bcc:" 行にこのフィールドで指定した受信者を含むメールメッセージのみが処理されます。例: `issues@mycompany.com` メールの送信時には、キャッチするメールアドレスを Bcc ヘッダーではなく To: と Cc: の各ヘッダーに入れるようにしてください。これは、メールサーバーが Bcc ヘッダーを取り除く傾向があるためです。さらに、メールハンドラーはこのヘッダーがメールソースで利用可能な場合にのみ、このヘッダーでキャッチするメールアドレスを検索します。ここでアドレスを指定すると、"To:"、"Cc:"、"Bcc:" 行にキャッチするメールアドレス以外を含むすべてのメールメッセージが無視されます。これは、複数のメールサービス (それぞれが別の Jira プロジェクトで課題を作成する場合など) で、1 つのメールアカウントに複数のエイリアスがある場合 (例: `foo-support@example-co.com` および `bar-support@example-co.com` エイリアスが `support@example-co.com` に使用される) に便利です。注: 実践では、このオプションが訳に立つことはあまりないため、より一般的な既定の報告者と混同しないでください。メールハンドラごとに 1 つのキャッチ電子メールアドレスと 1 つの課題のみを指定できます。さらに、Jira 7.0.0 と Jira 7.0.1 には既知のバグがあります。メールが複数のエイリアスに送信された際に、異なるプロジェクトで課題の作成に使用された複数のメールハンドラーがメールを正しく処理できません。この問題は Jira 7.0.2 で修正されました。詳細については、JRA-41831 - 課題情報を取得中... ステータスをご参照ください。
一括	このオプションは、ヘッダーで優先順位フィールドが一括に設定されている、または自動送信フィールドがnoに設定されていない「一括」電子メールメッセージにのみ影響します。これらのメッセージは一般的に自動サービスによって送信されます。これらのメールメッセージを受信すると、選択したオプションに応じて次の操作が実行されます。メールを無視して何も行わないメールを転送する ("メールの転送" テキストフィールドで設定されたアドレスへの転送など)。メールを完全に削除するメールを許可して処理する一般的に、bulk=forward と転送メールアドレスを設定することは、ループを防ぐため (例: 別の Jira インストール) に有用です。
メール転送	これを指定し、このメールサービスが受信した電子メールメッセージを処理できない場合、この問題を示す電子メールメッセージはこのフィールドで指定した電子メールアドレスに転送されます。注: このオプションが正しく機能するには、SMTP メールサーバーを構成する必要があります。
ユーザーの作成	このチェックボックスを選択すると、受信したメールメッセージの「From:」フィールドのアドレスが既存の Jira ユーザーアカウントに関連付けられたアドレスと一致しない場合に、Jira で新しいユーザーアカウントが作成されます。この設定と、関連プロジェクトの通知スキームで更新を報告者に通知する設定で、メールメッセージの作成者は課題に対するその後の更新の通知を受け取れます。これらの新しく作成された Jira ユーザーアカウントのユーザ名とメールアドレスは、受信メッセージの From: フィールドで指定されるメールアドレスになります。新しい Jira ユーザーのパスワードはランダムに生成され、Jira のユーザーアカウントについて通知するメールがアドレスに送信されます。このようにして作成されたユーザーは既定の Jira アプリケーションの既定のグループに追加されます (したがって、このアプリケーションのライセンスを使用します)。詳細は、「グループの管理」ドキュメントを参照してください。注: このオプションは以下の「既定の報告者」フィールドオプションとの互換性はありません。そのため、「ユーザーの作成」オプションを選択すると、「既定の報告者」オプションが非表示となります。
既定の報告者	既定の報告者のユーザー名を指定します。この名前は、受信したメッセージの "From:" フィールドのメールアドレスが既存の Jira ユーザーに関連付けられているアドレスと一致しない場合に使用されます。例: `emailed-reporter` などの Jira ユーザー名注意: このオプションは、「ユーザーの作成」チェックボックスが選択されている場合は利用できません。このフィールドで指定したユーザーに、関連するプロジェクトの課題の作成プロジェクト権限 (上記で指定)、およびメールハンドラーがコメントを追加する他の関連プロジェクトのコメントの作成プロジェクト権限があることを確認してください。課題を作成してこのオプションを指定すると、送信者を特定できるよう、メールメッセージの From: フィールドアドレスは課題の説明フィールドの末尾に短いメッセージとして追加されます。
ユーザーの通知	上記の「ユーザーの作成」オプションでアカウントを作成したユーザーに、Jira が通知する電子メールメッセージを送信しないよう設定する場合は、このチェックボックスをオフにします。注: このオプションは、「ユーザーの作成」チェックボックスがオンになっている場合にのみ機能します。
CC 担当者	Jira が作成された課題を Jira ユーザーに自動的に割り当てるようにする場合はこのチェックボックスを選択します。電子メールアドレス (Jira アカウントで登録したもの) が受信した電子メールメッセージのTo:、Cc:、およびBcc:フィールドで遭遇した最初の照合アドレスと一致します。関連するプロジェクトで割り当て可能なユーザープロジェクト権限も持っているユーザー (上記で指定)。
CC ウォッチャー	作成した課題を Jira が Jira ユーザーに自動的に追加するようにしたい場合はこのチェックボックスを選択します。これらのユーザーの電子メールアドレス (Jira アカウントに登録されているもの) は、受信した電子メールメッセージのTo:、Cc: または Bcc: フィールドのアドレスと一致します。課題を作成する際、ユーザーの作成オプション (上記) で作成された新規 Jira ユーザーをこの CC ウォッチャーオプションで課題のウォッチャーリストに追加することはできません。Jira ユーザーは、Jira のユーザーベースに既に存在し、メールアドレスを持っている必要があります。

メールハンドラーのテストと保存 (上記)。

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

このメールハンドラーでは正規表現は使用されません。代わりに、メール本文の指定したマーカーまたはセパレーターの前にコメントを追加するハンドラーを使用することをお勧めします。詳細については「Jira 通知をセットアップ」をご参照ください。

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

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

メールハンドラーの設定を開始していない場合は、開始します (上記)。

メール本文の非引用部分からコメントを追加するダイアログボックスで、次のフィールド/オプションを入力します。

メールアドレスのキャッチ	指定した場合、"To:"、"Cc:"、"Bcc:" 行にこのフィールドで指定した受信者を含むメールメッセージのみが処理されます。例: `issues@mycompany.com` メールの送信時には、キャッチするメールアドレスを Bcc ヘッダーではなく To: と Cc: の各ヘッダーに入れるようにしてください。これは、メールサーバーが Bcc ヘッダーを取り除く傾向があるためです。さらに、メールハンドラーはこのヘッダーがメールソースで利用可能な場合にのみ、このヘッダーでキャッチするメールアドレスを検索します。ここでアドレスを指定すると、"To:"、"Cc:"、"Bcc:" 行にキャッチするメールアドレス以外を含むすべてのメールメッセージが無視されます。これは、複数のメールサービス (それぞれが別の Jira プロジェクトで課題を作成する場合など) で、1 つのメールアカウントに複数のエイリアスがある場合 (例: `foo-support@example-co.com` および `bar-support@example-co.com` エイリアスが `support@example-co.com` に使用される) に便利です。注: 実際の本番環境では、このオプションはあまり使われません。より一般的な既定の報告者と混同しないようにしてください。メールハンドラーごとに、キャッチする 1 つのメールアドレスと 1 つの課題タイプのみを指定できます。
一括	このオプションは、ヘッダーで優先順位フィールドが一括に設定されている、または自動送信フィールドがnoに設定されていない「一括」電子メールメッセージにのみ影響します。これらのメッセージは一般的に自動サービスによって送信されます。これらのメールメッセージを受信すると、選択したオプションに応じて次の操作が実行されます。メールを無視して何も行わないメールを転送する ("メールの転送" テキストフィールドで設定されたアドレスへの転送など)。メールを完全に削除するメールを許可して処理する
メール転送	これを指定し、このメールサービスが受信した電子メールメッセージを処理できない場合、この問題を示す電子メールメッセージはこのフィールドで指定した電子メールアドレスに転送されます。注: このオプションが正しく機能するには、SMTP メールサーバーを構成する必要があります。
ユーザーの作成	このチェックボックスを選択すると、受信したメールメッセージの「From:」フィールドのアドレスが既存の Jira ユーザーアカウントに関連付られたアドレスと一致しない場合に、Jira で新しいユーザーアカウントを作成できます。この設定と、関連プロジェクトの通知スキームで更新を報告者に通知する設定で、メールメッセージの作成者は課題に対するその後の更新の通知を受けることができます。新しく作成した Jira ユーザアカウントのこれらのユーザ名とメールアドレスは、メッセージの送信者：フィールドで指定したメールアドレスになります。新しいユーザのパスワードはランダムに生成され、Jira のアカウントについて知らせるメールが新しいユーザに送信されます。このようにして作成されたユーザーは既定の JIRA アプリケーションの既定のグループに追加されます (これにより、このアプリケーションのライセンスを使用します)。詳細は、「グループの管理」ドキュメントを参照してください。注: このオプションは以下の「既定の報告者」フィールドオプションとの互換性はありません。そのため、「ユーザーの作成」オプションを選択すると、「既定の報告者」オプションが非表示となります。
既定の報告者	既定の報告者のユーザー名を指定します。この名前は、受信したメッセージの "From:" フィールドのメールアドレスが既存の Jira ユーザーに関連付けられているアドレスと一致しない場合に使用されます。例: `emailed-reporter` などの Jira ユーザー名注意: このオプションは、「ユーザーの作成」チェックボックスが選択されている場合は利用できません。このフィールドで指定したユーザーに、関連するプロジェクトの課題の作成プロジェクト権限 (上記で指定)、およびメールハンドラーがコメントを追加する他の関連プロジェクトのコメントの作成プロジェクト権限があることを確認してください。
ユーザーの通知	上記の「ユーザーの作成」オプションでアカウントを作成したユーザーに、Jira が通知する電子メールメッセージを送信しないよう設定する場合は、このチェックボックスをオフにします。注: このオプションは、「ユーザーの作成」チェックボックスがオンになっている場合にのみ機能します。

メールハンドラーのテストと保存 (上記)。

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

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

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

メールハンドラーの設定を開始していない場合は、開始します (上記)。

メールの本文全体を使用してコメントを追加するダイアログボックスで、次のフィールド/オプションを入力します。

メールアドレスのキャッチ	指定した場合、"To:"、"Cc:"、"Bcc:" 行にこのフィールドで指定した受信者を含むメールメッセージのみが処理されます。例: `issues@mycompany.com` メールの送信時には、キャッチするメールアドレスを Bcc ヘッダーではなく To: と Cc: の各ヘッダーに入れるようにしてください。これは、メールサーバーが Bcc ヘッダーを取り除く傾向があるためです。さらに、メールハンドラーはこのヘッダーがメールソースで利用可能な場合にのみ、このヘッダーでキャッチするメールアドレスを検索します。ここでアドレスを指定すると、"To:"、"Cc:"、"Bcc:" 行にキャッチするメールアドレス以外を含むすべてのメールメッセージが無視されます。これは、複数のメールサービス (それぞれが別の Jira プロジェクトで課題を作成する場合など) で、1 つのメールアカウントに複数のエイリアスがある場合 (例: `foo-support@example-co.com` および `bar-support@example-co.com` エイリアスが `support@example-co.com` に使用される) に便利です。注: 実際の本番環境では、このオプションはあまり使われません。より一般的な既定の報告者と混同しないようにしてください。メールハンドラーごとに、キャッチする 1 つのメールアドレスと 1 つの課題タイプのみを指定できます。
一括	このオプションは、ヘッダーで優先順位フィールドが一括に設定されている、または自動送信フィールドがnoに設定されていない「一括」電子メールメッセージにのみ影響します。これらのメッセージは一般的に自動サービスによって送信されます。これらのメールメッセージを受信すると、選択したオプションに応じて次の操作が実行されます。メールを無視して何も行わないメールを転送する ("メールの転送" テキストフィールドで設定されたアドレスへの転送など)。メールを完全に削除するメールを許可して処理する
メール転送	これを指定し、このメールサービスが受信した電子メールメッセージを処理できない場合、この問題を示す電子メールメッセージはこのフィールドで指定した電子メールアドレスに転送されます。注: このオプションが正しく機能するには、SMTP メールサーバーを構成する必要があります。
ユーザーの作成	このチェックボックスを選択すると、受信したメールメッセージの「From:」フィールドのアドレスが既存の Jira ユーザーアカウントに関連付られたアドレスと一致しない場合に、Jira で新しいユーザーアカウントを作成できます。この設定と、関連プロジェクトの通知スキームで更新を報告者に通知する設定で、メールメッセージの作成者は課題に対するその後の更新の通知を受けることができます。新しく作成した Jira ユーザアカウントのこれらのユーザ名とメールアドレスは、メッセージの送信者：フィールドで指定したメールアドレスになります。新しいユーザのパスワードはランダムに生成され、Jira のアカウントについて知らせるメールが新しいユーザに送信されます。このようにして作成されたユーザーは既定の JIRA アプリケーションの既定のグループに追加されます (これにより、このアプリケーションのライセンスを使用します)。詳細は、「グループの管理」ドキュメントを参照してください。注: このオプションは以下の「既定の報告者」フィールドオプションとの互換性はありません。そのため、「ユーザーの作成」オプションを選択すると、「既定の報告者」オプションが非表示となります。
既定の報告者	既定の報告者のユーザー名を指定します。この名前は、受信したメッセージの "From:" フィールドのメールアドレスが既存の Jira ユーザーに関連付けられているアドレスと一致しない場合に使用されます。例: `emailed-reporter` などの Jira ユーザー名注意: このオプションは、「ユーザーの作成」チェックボックスが選択されている場合は利用できません。このフィールドで指定したユーザーに、関連するプロジェクトの課題の作成プロジェクト権限 (上記で指定)、およびメールハンドラーがコメントを追加する他の関連プロジェクトのコメントの作成プロジェクト権限があることを確認してください。
ユーザーの通知	上記の「ユーザーの作成」オプションでアカウントを作成したユーザーに、Jira が通知する電子メールメッセージを送信しないよう設定する場合は、このチェックボックスをオフにします。注: このオプションは、「ユーザーの作成」チェックボックスがオンになっている場合にのみ機能します。

メールハンドラーのテストと保存 (上記)。

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

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

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

メールハンドラーの設定を開始していない場合は、開始します (上記)。

「各メールメッセージから新規課題を作成する」ダイアログボックスで、次のフィールド/オプションを入力します。

プロジェクト	このハンドラーが新しい課題を作成した際の既定のプロジェクトのプロジェクトキーを指定します (`JRA` など)。注意: このフィールドは課題の作成にのみ関連するもので、課題のコメントには関係しません。メールメッセージの件名行に課題キーが含まれ、その課題キーが Jira インストール内に存在する場合、ハンドラーは課題が格納されているプロジェクトにかかわらず、メールメッセージのコンテンツを課題のコメントとして追加します。
課題タイプ	新しい課題の既定の課題タイプを選択します。
メールアドレスのキャッチ	指定した場合、"To:"、"Cc:"、"Bcc:" 行にこのフィールドで指定した受信者を含むメールメッセージのみが処理されます。例: `issues@mycompany.com` メールの送信時には、キャッチするメールアドレスを Bcc ヘッダーではなく To: と Cc: の各ヘッダーに入れるようにしてください。これは、メールサーバーが Bcc ヘッダーを取り除く傾向があるためです。さらに、メールハンドラーはこのヘッダーがメールソースで利用可能な場合にのみ、このヘッダーでキャッチするメールアドレスを検索します。ここでアドレスを指定すると、"To:"、"Cc:"、"Bcc:" 行にキャッチするメールアドレス以外を含むすべてのメールメッセージが無視されます。これは、複数のメールサービス (それぞれが別の Jira プロジェクトで課題を作成する場合など) で、1 つのメールアカウントに複数のエイリアスがある場合 (例: `foo-support@example-co.com` および `bar-support@example-co.com` エイリアスが `support@example-co.com` に使用される) に便利です。注: 実際の本番環境では、このオプションはあまり使われません。より一般的な既定の報告者と混同しないようにしてください。メールハンドラーごとに、キャッチする 1 つのメールアドレスと 1 つの課題タイプのみを指定できます。
一括	このオプションは、ヘッダーで優先順位フィールドが一括に設定されている、または自動送信フィールドがnoに設定されていない「一括」電子メールメッセージにのみ影響します。これらのメッセージは一般的に自動サービスによって送信されます。これらのメールメッセージを受信すると、選択したオプションに応じて次の操作が実行されます。メールを無視して何も行わないメールを転送する ("メールの転送" テキストフィールドで設定されたアドレスへの転送など)。メールを完全に削除するメールを許可して処理する
メール転送	これを指定し、このメールサービスが受信した電子メールメッセージを処理できない場合、この問題を示す電子メールメッセージはこのフィールドで指定した電子メールアドレスに転送されます。注: このオプションが正しく機能するには、SMTP メールサーバーを構成する必要があります。
ユーザーの作成	このチェックボックスを選択すると、受信したメールメッセージの「From:」フィールドのアドレスが既存の Jira ユーザーアカウントに関連付られたアドレスと一致しない場合に、Jira で新しいユーザーアカウントを作成できます。この設定と、関連プロジェクトの通知スキームで更新を報告者に通知する設定で、メールメッセージの作成者は課題に対するその後の更新の通知を受けることができます。新しく作成した Jira ユーザアカウントのこれらのユーザ名とメールアドレスは、メッセージの送信者：フィールドで指定したメールアドレスになります。新しいユーザのパスワードはランダムに生成され、Jira のアカウントについて知らせるメールが新しいユーザに送信されます。このようにして作成されたユーザーは既定の JIRA アプリケーションの既定のグループに追加されます (これにより、このアプリケーションのライセンスを使用します)。詳細は、「グループの管理」ドキュメントを参照してください。注: このオプションは以下の「既定の報告者」フィールドオプションとの互換性はありません。そのため、「ユーザーの作成」オプションを選択すると、「既定の報告者」オプションが非表示となります。
既定の報告者	既定の報告者のユーザー名を指定します。この名前は、受信したメッセージの "From:" フィールドのメールアドレスが既存の Jira ユーザーに関連付けられているアドレスと一致しない場合に使用されます。例: `emailed-reporter` などの Jira ユーザー名注意: このオプションは、「ユーザーの作成」チェックボックスが選択されている場合は利用できません。このフィールドで指定したユーザーに、関連するプロジェクトの課題の作成プロジェクト権限 (上記で指定)、およびメールハンドラーがコメントを追加する他の関連プロジェクトのコメントの作成プロジェクト権限があることを確認してください。課題を作成してこのオプションを指定すると、送信者を特定できるよう、メールメッセージの From: フィールドアドレスは課題の説明フィールドの末尾に短いメッセージとして追加されます。
ユーザーの通知	上記の「ユーザーの作成」オプションでアカウントを作成したユーザーに、Jira が通知する電子メールメッセージを送信しないよう設定する場合は、このチェックボックスをオフにします。注: このオプションは、「ユーザーの作成」チェックボックスがオンになっている場合にのみ機能します。
CC 担当者	Jira が作成された課題を Jira ユーザーに自動的に割り当てるようにする場合はこのチェックボックスを選択します。電子メールアドレス (Jira アカウントで登録したもの) が受信した電子メールメッセージのTo:、および Cc:、Bcc:フィールドで遭遇した最初の照合アドレスと一致します。関連するプロジェクトで割り当て可能なユーザープロジェクト権限も持っているユーザー (上記で指定)。
CC ウォッチャー	作成した課題を Jira が Jira ユーザーに自動的に追加するようにしたい場合はこのチェックボックスを選択します。これらのユーザーの電子メールアドレス (Jira アカウントに登録されているもの) は、受信した電子メールメッセージのTo:、Cc: または Bcc: フィールドのアドレスと一致します。課題を作成する際、ユーザーの作成オプション (上記) で作成された新規 Jira ユーザーをこの CC ウォッチャーオプションで課題のウォッチャーリストに追加することはできません。Jira ユーザーは、Jira のユーザーベースに既に存在し、メールアドレスを持っている必要があります。

メールハンドラーのテストと保存 (上記)。

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

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

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

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

メールの本文中で指定されたマーカーまたはセパレータの前にコメントを追加 メールハンドラーは、受信したメールメッセージに関する次の動作を行います。

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

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

メールハンドラーの設定を開始していない場合は、開始します (上記)。

メールの本文中に指定されたマーカーまたはセパレータの前にコメントを追加ダイアログボックスで、次のフィールド/オプションを入力します。

スプリット正規表現	メールメッセージのメール本文の内容を本文の他の (返信または転送された) 内容から分割する文字列に一致する正規表現を指定します。注意: regex の先頭と末尾に区切り文字 (通常は "`/`" ) を付ける必要があります。各メールハンドラーのフィールド/オプションを分割するためにカンマが使用されるため、正規表現ではカンマを使用できません。これは、メールハンドラーが Jira サービスに統合されていて、エスケープ構文が存在しないためです。例: `/----\sOriginal Message\s----/` または `/_____________*/`
メールアドレスのキャッチ	指定した場合、"To:"、"Cc:"、"Bcc:" 行にこのフィールドで指定した受信者を含むメールメッセージのみが処理されます。例: `issues@mycompany.com` メールの送信時には、キャッチするメールアドレスを Bcc ヘッダーではなく To: と Cc: の各ヘッダーに入れるようにしてください。これは、メールサーバーが Bcc ヘッダーを取り除く傾向があるためです。さらに、メールハンドラーはこのヘッダーがメールソースで利用可能な場合にのみ、このヘッダーでキャッチするメールアドレスを検索します。ここでアドレスを指定すると、"To:"、"Cc:"、"Bcc:" 行にキャッチするメールアドレス以外を含むすべてのメールメッセージが無視されます。これは、複数のメールサービス (それぞれが別の Jira プロジェクトで課題を作成する場合など) で、1 つのメールアカウントに複数のエイリアスがある場合 (例: `foo-support@example-co.com` および `bar-support@example-co.com` エイリアスが `support@example-co.com` に使用される) に便利です。注: 実際の本番環境では、このオプションはあまり使われません。より一般的な既定の報告者と混同しないようにしてください。メールハンドラーごとに、キャッチする 1 つのメールアドレスと 1 つの課題タイプのみを指定できます。
一括	このオプションは、ヘッダーで優先順位フィールドが一括に設定されている、または自動送信フィールドがnoに設定されていない「一括」電子メールメッセージにのみ影響します。これらのメッセージは一般的に自動サービスによって送信されます。これらのメールメッセージを受信すると、選択したオプションに応じて次の操作が実行されます。メールを無視して何も行わないメールを転送する ("メールの転送" テキストフィールドで設定されたアドレスへの転送など)。メールを完全に削除するメールを許可して処理する
メール転送	これを指定し、このメールサービスが受信した電子メールメッセージを処理できない場合、この問題を示す電子メールメッセージはこのフィールドで指定した電子メールアドレスに転送されます。注: このオプションが正しく機能するには、SMTP メールサーバーを構成する必要があります。
ユーザーの作成	このチェックボックスを選択すると、受信したメールメッセージの「From:」フィールドのアドレスが既存の Jira ユーザーアカウントに関連付られたアドレスと一致しない場合に、Jira で新しいユーザーアカウントを作成できます。この設定と、関連プロジェクトの通知スキームで更新を報告者に通知する設定で、メールメッセージの作成者は課題に対するその後の更新の通知を受けることができます。新しく作成した Jira ユーザアカウントのこれらのユーザ名とメールアドレスは、メッセージの送信者：フィールドで指定したメールアドレスになります。新しいユーザのパスワードはランダムに生成され、Jira のアカウントについて知らせるメールが新しいユーザに送信されます。このようにして作成されたユーザーは既定の JIRA アプリケーションの既定のグループに追加されます (これにより、このアプリケーションのライセンスを使用します)。詳細は、「グループの管理」ドキュメントを参照してください。注: このオプションは以下の「既定の報告者」フィールドオプションとの互換性はありません。そのため、「ユーザーの作成」オプションを選択すると、「既定の報告者」オプションが非表示となります。
既定の報告者	既定の報告者のユーザー名を指定します。この名前は、受信したメッセージの "From:" フィールドのメールアドレスが既存の Jira ユーザーに関連付けられているアドレスと一致しない場合に使用されます。例: `emailed-reporter` などの Jira ユーザー名注意: このオプションは、「ユーザーの作成」チェックボックスが選択されている場合は利用できません。このフィールドで指定したユーザーに、関連するプロジェクトの課題の作成プロジェクト権限 (上記で指定)、およびメールハンドラーがコメントを追加する他の関連プロジェクトのコメントの作成プロジェクト権限があることを確認してください。
ユーザーの通知	上記の「ユーザーの作成」オプションでアカウントを作成したユーザーに、Jira が通知する電子メールメッセージを送信しないよう設定する場合は、このチェックボックスをオフにします。注: このオプションは、「ユーザーの作成」チェックボックスがオンになっている場合にのみ機能します。

メールハンドラーのテストと保存 (上記)。

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

独自のプロセスを Jira にうまく統合できるよう、独自のメッセージハンドラを設計できます。これらのカスタムのメールハンドラは上記の標準の手順を使用して構成されます。

カスタムのメールハンドラの作成の詳細については、「メッセージハンドラプラグインモジュール」ドキュメントを参照してください。

課題とコメントの作成

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

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

例えば、Jira サーバーに対して設定された POP または IMAP メールサーバーの foo@example-co.com へのメールメッセージは、次のように処理されます。

課題の作成:
- メールメッセージの件名は課題の概要になります。
  すべての課題には概要が必要なため、課題作成用の各メールメッセージには件名を含める必要があります。
- メールメッセージの本文は課題の説明になります。
- 上記の情報を使用して、プロジェクト「JRA」にバグが作成されます。(基本的には上記のメールハンドラー設定に基づいています。)
- 電子メールメッセージの添付ファイルは課題の添付ファイルとなります (添付ファイルが JIRA で有効化されていると想定します)。
  各種のオペレーティングシステムとの互換性を確保するため、ファイル名に使用された次の文字はアンダースコアに置き換えられます：\、/、 "、%、：、$、?、*、<、|、>。
- 受信メールが高い優先度に設定されている場合、対応する課題は Jira システムで設定されている既定の優先度よりも高い優先度で作成されます。
コメントの作成
- メールの本文は課題のコメントになります。
- 電子メールの添付ファイルは課題の添付ファイルとなります (添付ファイルが Jira で有効化されていると想定します)。

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

Jira ユーザーアカウントを持たない人から送信されたメールメッセージを Jira で処理できるようにするには、次の手順を実行します。

メールサーバー/サービスで「匿名」/「ダミー」メールアカウントを作成します (上記)。
メール フィールドが以前の手順で作成したメールアカウントと一致する、同等の「匿名」/「ダミー」Jira ユーザーアカウントを作成します。
このメールアカウントからのメッセージを処理するようメールハンドラー (上記) を構成する場合、既定報告者をこの「匿名/ダミー」Jira ユーザーアカウントへ設定します。

ベストプラクティス (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 の [ロギングとプロファイリング] ページには、送信および受信メール用の構成オプションがあります。新しいメールハンドラーを作成 (または既存のメールハンドラーを編集) する場合は [テスト] ボタンを使用してメールハンドラーの構成をテストし、期待通り動作するかどうかを確認できます。Jira のメール関連の問題をデバッグする場合、起動時に -Dmail.debug=true プロパティを設定すると便利です。これにより、Jira でのメールのやり取りのプロトコルレベルの詳細を catalina.out (または標準出力) に記録できるようになります。

一般的な問題

Jira が電子メールの作成や送信、または電子メールから課題やコメントを作成していない場合、Jira インストールでOutOfMemory エラーが発生する可能性があります。OutOfMemory エラーでログファイルを確認してください。OutOfMemory エラーが発生した場合、Jira を再起動し、エラーを調査してください。
受信メールが単純に消えているのがわかった場合は、誤ってJira の 2 つ目のコピーを起動 (例: ステージング環境などで) していないかを確認します。これにより、電子メールメッセージがダウンロードおよび削除されます。メールの処理を防ぐために設定する必要があるフラグについては、「メールの送受信の無効化」ページを参照してください。
Jira の通知による返信メールに、構成済みハンドラーの POP アカウントではなく Jira の SMTP サーバーが記載されている場合 (Outlook の「Reply-to」機能を使用した場合など)、プロジェクトを構成して送信通知のヘッダーに 'reply-to' を追加する必要があります。これは、Jira 管理メニューで、対象のプロジェクトのプロジェクトビューで構成できます。
HTML /リッチテキストフォーマットが Jira によって正しく処理されていない場合、これは正常な動作です。メールのコメントハンドラーは、プレーンテキスト変換を行うように設計されています。

Jira を使いこなす

Atlassian Marketplace の次のようなアプリを活用すると、受信トレイから直接課題を作成してコメントを追加できます。

Email This Issue: ワークフロートランジションから社内外のステークホルダーに課題について通知
Outlook App for Jira: Jira 課題をすべてのデバイスのメールに接続

製品

Jira Software

Jira Service Management

Jira Work Management

Confluence

Bitbucket

リソース

関連ドキュメント

コミュニティ

システムステータス

提案とバグ

Marketplace

請求とライセンス情報

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

Jira アプリケーションのメール設定

このページの内容

このセクションの項目

お困りですか?