課題やコメントをメールから作成する
メールから課題やコメント作成を行う設定をする
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 を設定します。
ヒント: Jira のメールサーバーを設定し、電子メール通知の受信者がこれらのメッセージに簡単に返信し、関連する課題に対するコメントとして返信の本文を追加できます。これを行うには、Jira の SMTP メールサーバーの送信先アドレスで、監視対象の POP または IMAP サーバーのアカウントと照合するよう設定します。ほとんどの場合、これらは Jira の SMTP と POP/IMAP メールサーバーで同じメールアカウントを使用することを意味します。これらの電子メールで送信された返信を処理するよう Jira を設定する方法については、以下を参照してください。
ファイル システム メッセージ
外部メール サービスからファイルシステムに書き込まれたメッセージからの課題およびコメントの作成をセットアップするには、外部メール サービスが 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.comFrom: some-jira-user@example.comSubject: (TEST-123) issue summary title hereBody 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 ユーザー名 注意:ユーザーの通知 上記の「ユーザーの作成」オプションでアカウントを作成したユーザーに、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 サービスに統合されていて、エスケープ構文が存在しないためです。
例:
/----\s*Original 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 が通知する電子メールメッセージを送信しないよう設定する場合は、このチェックボックスをオフにします。
注: このオプションは、「ユーザーの作成」チェックボックスがオンになっている場合にのみ機能します。- regex の先頭と末尾に区切り文字 (通常は "
- メール ハンドラーのテストと保存 (上記)。
カスタム メール ハンドラー
独自のプロセスを 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 課題をすべてのデバイスのメールに接続