【Jira】メールから課題を作成できない時の受信設定確認

Jiraでメールから課題を作成する機能は、チームの業務効率を大きく向上させる便利な仕組みです。しかし、設定が正しく行われていないと、メールを送信しても課題が作成されず、原因の特定に時間を要することがあります。本記事では、メールから課題を作成できない場合に確認すべき受信設定のポイントを、原因の切り分け方とともに具体的に解説します。特に、プロジェクト設定、メールハンドリング設定、メールサーバー設定の三つの軸で確認を進めることで、迅速に問題を解決できるようにします。

1. メールからの課題作成機能の基本動作を理解する

Jiraがメールから課題を作成する仕組みは、指定したメールボックス(例: support@company.com)に届いたメールを定期的にチェックし、メールの件名や本文をもとに新しい課題を自動生成するというものです。この機能を使用するには、Jira管理画面で「メールハンドリング」機能を有効にし、受信用のメールボックスを設定する必要があります。また、プロジェクトごとに受信メールの処理ルールを定義できます。

一般的な流れは以下の通りです。

1. ユーザーが設定されたメールアドレス宛にメールを送信します。
2. Jiraのメールハンドリングサービス(バックグラウンド処理)が一定間隔でメールボックスに接続し、未読メールを取得します。
3. メールの内容を解析し、プロジェクトと課題タイプを特定します。送信元アドレスや件名のプレフィックスなどが判断材料になります。
4. 該当プロジェクトの受信設定に基づいて課題を作成し、送信元に確認メールを返信します。
5. エラーが発生した場合、Jiraのログに記録されるか、送信者にエラーメールが返送されます。

この流れのどこかに問題があると、メールから課題が作成されません。管理者は各段階を個別に確認する必要があります。

2. プロジェクト設定の受信設定を確認する

2.1 プロジェクトのメールタブを開く

まず、課題を作成したいプロジェクトの設定を確認します。プロジェクト管理画面から「プロジェクト設定」>「メール」を開いてください。ここで設定されている内容が、メール受信時の動作に直接影響します。確認すべき項目は以下の通りです。

• 受信メールアドレス: プロジェクト固有のメールアドレスが設定されているかを確認します。このアドレスにメールを送信することで課題が作成される仕組みです。
• 送信者許可リスト: 特定のメールアドレスまたはドメインからのメールのみを受け付ける設定が行われている場合、許可リストにない送信者からのメールは無視されます。
• 転送設定: メールを転送して課題を作成する場合、転送元のメールアドレスが正しく設定されているか確認します。
• デフォルトの課題タイプ: メールの件名などから課題タイプが特定できない場合、どのタイプで作成されるかが設定されています。

特に、許可リストが空白の場合、すべての送信者からのメールを受け付けますが、セキュリティ上の理由から制限している企業もあります。意図せず許可リストが有効になっていないか、管理者に確認してください。

2.2 メール件名プレフィックスと転送の設定

プロジェクトの受信設定では、メール件名に特定のプレフィックス(例: “[PROJ]”)を付けることで、どのプロジェクトに属するかを自動判別できます。このプレフィックスが正しく設定されていない、またはメールの件名に含まれていないと、正しくプロジェクトが特定されず課題作成に失敗する可能性があります。また、メール転送機能を使っている場合は、転送時に件名が変更されていないかを確認します。例えば、転送サービスが自動で「Fwd:」を付加する場合、プレフィックスの前に余計な文字が入り、ルールが適用されないことがあります。

3. Jira全体のメールハンドリング設定を確認する

3.1 メールボックス設定の確認

グローバル設定として、Jira管理画面の「システム」>「メール」>「メールボックス」で受信用メールボックスが正しく設定されているかを確認します。ここでは以下の項目をチェックします。

• メールサーバーのホスト名とポート: IMAP(通常143、SSL時993)またはPOP3(110、SSL時995)の設定が正しいか。会社のメールサーバー情報と照合します。
• 認証情報: ユーザー名とパスワードが正しいか。パスワードが変更された場合、この設定も更新する必要があります。
• フォルダ指定: どのフォルダ(例: INBOX)のメールを処理するかが設定されています。指定フォルダにメールが届いているか確認します。
• SSL/TLS: 接続の暗号化設定がメールサーバーと一致しているか。

3.2 メールルール設定の確認

同じ管理画面の「メールルール」または「メールハンドリングルール」では、受信メールをどのプロジェクトに割り当てるかのルールを定義します。ルールは順序に従って評価されるため、最初に一致したルールが適用されます。ルールが意図通りに設定されていない、またはルールが多すぎて優先順位が混乱している場合、メールが正しく処理されないことがあります。以下の点を確認します。

• ルールに一致する条件(送信者、件名、本文など)が適切か。
• ルールの実行順序が正しいか。特に、全プロジェクトにマッチするキャッチオールルールがある場合、それより前に特定のルールを配置する必要があります。
• ルールの有効/無効状態。無効になっていると処理されません。

4. メールサーバーとネットワークの確認

4.1 Jiraサーバーからメールサーバーへの接続確認

Jiraが動作しているサーバー(オンプレミス、またはクラウドの場合はAtlassianのインフラ)から、設定したメールサーバーに接続できる必要があります。ファイアウォールやプロキシの設定で接続がブロックされていないか確認します。簡単な確認方法として、Jiraサーバー上でtelnetコマンドを使用してメールサーバーのポートに接続できるか試します(例: telnet mail.company.com 993)。接続できない場合は、ネットワークチームに連絡し、Jiraサーバーからメールサーバーへの通信を許可するよう依頼します。

4.2 メールアカウントの状態確認

受信用のメールアカウント自体が正常に機能しているかも重要です。Webメールやメールクライアントでそのアカウントにログインし、テストメールを送信して実際に受信できるか確認します。また、メールボックスの容量が上限に達していないか、自動転送やフィルタリングルールがJiraの処理を妨げていないかも確認します。特に、迷惑メールフィルターがONになっていると、送信したテストメールが迷惑メールフォルダに振り分けられ、Jiraがそれを読み取れない可能性があります。

5. トラブルシューティングと失敗パターン比較表

原因を特定するために、以下の表に典型的な失敗パターンと確認ポイントをまとめました。

現象	考えられる原因	確認すべき設定	対処例
メール送信後に何も起こらない	Jiraのメールハンドリングサービスが停止している、またはメールボックスに接続できない	Jira管理画面のメールボックス状態(最終チェック時刻)	サービス再起動、接続設定の再確認、ネットワーク疎通確認
「送信者に返信」されたエラーメールが届く	プロジェクト設定の許可リストに送信者が含まれていない、またはルールで処理対象外	プロジェクトの送信者許可リスト、ルール条件	送信者アドレスを許可リストに追加、ルールを修正
メールが届いているのに課題が作成されない(ログにエラーなし)	件名プレフィックスが間違っている、または転送時に件名が変更された	プロジェクトの件名プレフィックス設定、メール転送ルール	プレフィックスをメール件名に正確に含める、転送時の件名変更を無効化
特定のユーザーのメールだけ作成されない	そのユーザーがJiraのユーザーとして存在しない、またはライセンスがない	送信者のJiraアカウント状態、権限	ユーザーをJiraに追加、適切なプロジェクト権限を付与
メールは処理されたが課題が不完全	メール本文の解析に失敗、または必須フィールドが不足	メールハンドリングルールのフィールドマッピング	ルールでフィールドのデフォルト値を設定、またはメール形式を調整

6. 管理者に確認すべき情報と伝え方

問題解決には、Jira管理者やメールサーバー管理者の協力が必要な場合があります。以下の情報を整理して伝えると、スムーズに原因を特定できます。

• 問題発生日時と頻度: いつから、どのくらいの頻度で発生しているか。停止しているのか、断続的なのか。
• 送信したメールの詳細: 送信元アドレス、送信先アドレス、件名、本文、添付ファイルの有無。
• エラーメッセージの有無: 送信者にエラーメールが届いた場合、その内容。Jiraのログ(管理画面>システム>ログ&メトリクス)を確認し、関連エラーをスクリーンショットで共有。
• 過去の変更履歴: 最近、メールサーバーの設定変更、パスワード変更、ネットワーク機器の更新などがあったか。
• 動作している設定例: 同様の設定で正常に動作しているプロジェクトやメールボックスがあれば、その差分を確認する。

管理者に依頼する際は、「Jiraのメールボックス設定でエラーが発生しています。メールサーバーへの接続テストを実施していただけますか?」など具体的なアクションを提示すると良いでしょう。

7. よくある質問

7.1 メールから課題を作成するのに送信元はJiraユーザーである必要がありますか?

必ずしも必要ではありませんが、プロジェクトの送信者許可リストで制限している場合や、課題作成後に自動で送信者をレポーターとして割り当てる設定になっている場合は、Jiraユーザーアカウントが必要です。許可リストが空であれば、外部からのメールでも課題作成は可能です。

7.2 POP3とIMAP、どちらを選べば良いですか?

Jiraがメールを削除しても良い場合はPOP3、メールボックスに残したい場合はIMAPを推奨します。ただし、多くの環境ではIMAPが使われ、フォルダ指定や複数クライアントからの同時アクセスに優れています。メールプロバイダの仕様に合わせて選択してください。

7.3 メールハンドリングの実行間隔は変更できますか?

はい、Jiraの管理画面「システム」>「メール」>「メールボックス」で各メールボックスの「メールチェック間隔」を分単位で設定できます。デフォルトは数分程度ですが、即時性が要求される場合は1分に短縮することも可能です。ただし、サーバー負荷に注意してください。

7.4 メールの添付ファイルは課題に添付されますか?

はい、通常の設定では添付ファイルは課題の添付ファイルとして追加されます。ただし、ファイルサイズの上限や許可される拡張子がJira全体の設定に依存するため、大きなファイルや特定の形式は添付できない場合があります。

8. まとめ

メールからJiraに課題を作成できない場合、まずプロジェクト設定とメールボックス設定の二つを同時に確認することが基本です。特に送信者許可リストやメール件名プレフィックスは、意図せず制限がかかっているケースが多いため、優先的にチェックしてください。また、メールサーバーへの接続状態や認証情報が最新であるかの確認も忘れずに行います。問題が解決しない場合は、Jiraのログとメールサーバーのログを突き合わせることで、切り分けが容易になります。本記事を参考に、体系的に確認を進めてください。