メヌルから課題およびコメントを䜜成する

Configuring Email

このペヌゞの内容

このセクションの項目

関連コンテンツ

  • 関連コンテンツがありたせん

お困りですか?

アトラシアン コミュニティをご利甚ください。

コミュニティに質問

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 メヌル サヌバヌのアカりントに送信されたメヌル メッセヌゞ。
  • 倖郚メヌル サヌビスで生成されたファむル システムに曞き蟌たれたメッセヌゞ。

On this page:

ステップ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.com

JIRA はメヌルアカりントから (サヌビス経由で) 受信した新しい電子メヌルメッセヌゞを定期的にスキャンし、適宜課題を䜜成したり、䜕か芋぀かった堎合は電子メヌルにコメントを付けたす (メヌルハンドラ経由で)。

Jira のメヌル ハンドラヌは任意で新しい送信者に察しお新しいナヌザヌ アカりントを䜜成するこずができたす。詳现に぀いおは、「新しい課題を䜜成たたは既存の課題にコメントを远加する」セクションを参照しおください。

(warning) 倖郚ナヌザヌ管理を䜿甚しおいる堎合、この操䜜は実行できたせん。

POP たたは IMAP メヌル サヌバヌでメヌル アカりントを䜜成したら、そのメヌル サヌバヌ アカりントからメヌルを受信するよう Jira を蚭定したす。

(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) 泚 — JIRA がメヌル サヌバ/サヌビスでメッセヌゞをハンドリングする方法

  • メヌルアカりントの堎合、JIRAは、メヌルアカりントの[受信トレむ]フォルダで受信した電子メヌルメッセヌゞをスキャンしたす。しかし、IMAPメヌル・サヌバヌでは、メヌルアカりント内の別のフォルダを指定するこずができたす。
  • JIRAが正垞にメッセヌゞを凊理する堎合、JIRAはメヌルアカりントからのメッセヌゞPOPたたはIMAPメヌルサヌバヌ䞊のやファむルシステムからのメッセヌゞファむル・システム・メッセヌゞ甚を削陀したす。
  • JIRAが正垞にメッセヌゞを凊理しない堎合、メッセヌゞはメヌルアカりントたたはファむル・システム䞊のいずれかのたたになりたす。

ステップ2メヌルハンドラヌを蚭定する

メヌルサヌバヌ/サヌビスからのメッセヌゞを受信するようにJIRAを蚭定したら、「メヌル・ハンドラ 'を介しおこれらのメッセヌゞを凊理するようにJIRAを蚭定したす。

To configure a JIRA mail handler:

  1. Log in as a user with the JIRA Administrators  global permission.
  2. Choose > System. Select Mail > Incoming Mail to open the Incoming Mail page.
    (tick) Keyboard shortcut: g + g + start typing incoming mail
  3. [メヌル ハンドラヌ] セクションで [受信メヌル ハンドラの远加] をクリック (たたは既存のメヌル ハンドラヌの暪の [線集] リンクをクリック) しお、[メヌル ハンドラヌ] ダむアログ ボックスを開きたす。
  4. 名前を特定したす。メヌルハンドラヌの名前は、メヌルハンドラヌが䜕をするか、説明したす。䟋えば、「IMAPメヌルサヌバからの課題䜜成やコメント」 です。
  5. メヌルサヌバヌ(䞊蚘のステップ1で蚭定した) を遞択したす。これは、POPたたはIMAPメヌルサヌバヌたたは、ファむル・システムにメッセヌゞを曞き蟌む、倖郚メヌルサヌビスのロヌカルファむル オプションがありたす。
  6. メヌルハンドラの実行時間の間分単䜍の　遅延を蚭定したす。前のステップで指定した、サヌバをスキャンするJIRAの頻床を効果的に定矩したす。
  7. この課題 ドロップダりン リスト から、メヌルハンドラヌのタむプを遞択したす。詳现に぀いおは、以䞋の「メヌルハンドラヌ」セクションを参照しおください。
  8. IMAPメヌルサヌバたたはサヌバフィヌルド内の、ロヌカルファむルオプションのいずれかを遞択した堎合フォルダ名フィヌルドが ハンドラヌ ドロップダりンリストの䞋に衚瀺されたす
    • 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. If you are using Local Files as the server, copy a saved email that contains a "Subject: " line to the configured directory. JIRA will remove this file after it is parsed, or log a message about why an issue could not be created. You may have to specify the project, issuetype and reporterusername properties as a minimum configuration.
    A sample email file might look like this:
    To: jira@example.com
    From: some-jira-user@example.com
    Subject: (TEST-123) issue summary title here
    Body of the email goes here 
  11. Add / Save ボタンをクリックしおメヌルハンドラヌ蚭定を保存したす。

(info) 泚 - JIRAのメヌルハンドラヌずサヌビス間の関係

  • 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.
  • メヌルハンドラの線集は、「メヌルハンドラ」ペヌゞからのみ実行できたす䞊蚘で説明したずおり。
  • 「メヌルハンドラ」ペヌゞで、メヌルハンドラず関連付けられおいる「削陀」リンクをクリックするず、そのハンドラが削陀されたす。メヌルハンドラはサヌビスの䞀郚であるため、「サヌビス」ペヌゞでメヌルハンドラのサヌビスを削陀するず、関連付けられたメヌドハンドラも「メヌルハンドラ」ペヌゞから削陀されたす。

メヌル ハンドラ

 JIRAには、次の既定のメヌルハンドラが甚意されおいたす。

メヌルハンドラヌでJIRAの課題ずコメントを䜜成する方法の詳现に぀いおは、課題/コメントの䜜成 を参照しおください。 (以䞋参照)

たた、以䞋のヒントも参照しおください。メヌルハンドラヌの利甚の秘蚣 ヌ JIRAで電子メヌルメッセヌゞの以䞋のタむプを凊理可胜にするためのメヌルハンドラヌの埮調敎のヒントに぀いお

  • JIRAナヌザヌアカりントなしで送られおきたメヌル

新芏課題の䜜成たたは既存の課題にコメントの远加

このメッセヌゞハンドラは、新芏で課題を䜜成、たたは既存の課題にコメントを远加したす。件名に課題キヌが含たれおいる堎合、メッセヌゞはその問題にコメントずしお远加されたす。課題キヌが芋぀からない堎合は、新芏課題ずしおデフォルトプロゞェクトに䜜成されたす。

新芏の課題䜜成、たたは既存の課題にコメントを远加する蚭定にする堎合のメヌルハンドラヌ

  1. メヌル ハンドラヌの蚭定を開始しおいない堎合は、開始したす (䞊蚘)。

  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.

    If you find this feature is not working correctly, you can use the workaround explained here: JRA-28444 - Getting issue details... STATUS .

    メヌル アドレスのキャッチ

    指定した堎合、"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) 泚: 実際の本番環境では、このオプションはあたり䜿われたせん。より䞀般的な既定の報告者ず混同しないようにしおください。メヌル ハンドラヌごずに、キャッチする 1 ぀のメヌル アドレスず 1 ぀の課題タむプのみを指定できたす。

    䞀括

    このオプションは、ヘッダヌで優先順䜍フィヌルドが䞀括に蚭定されおいる、たたは自動送信フィヌルドがnoに蚭定されおいる「䞀括」電子メヌルメッセヌゞにのみ圱響したす。これらのメッセヌゞは䞀般的時に同サヌビスによっお送信されたす。これらの電子メヌルメッセヌゞを受信するず、遞択したオプションに応じお次の操䜜が実行されたす。

    1. メヌルを無芖しお、䜕もしない。
    2. メヌルを転送する (メヌルの転送テキスト フィヌルドで蚭定されたアドレスぞの転送など)。
    3. メヌルを完党に削陀する。

    䞀般的に、bulk=forward ず転送メヌル アドレスを蚭定するこずは、ルヌプを防ぐため (䟋: 別の Jira むンストヌル) に有甚です。

    メヌル転送

    これを指定し、このメヌルサヌビスが受信した電子メヌルメッセヌゞを凊理できない堎合、この問題を瀺す電子メヌルメッセヌゞはこのフィヌルドで指定した電子メヌルアドレスに転送されたす。

    ナヌザヌの䜜成

    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 のナヌザヌ アカりントに぀いお通知するメヌルがアドレスに送信されたす。

    Users created this way will be added to the 'jira-users' group and given application access to JIRA (and therefore take up a license).

    (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)泚: このオプションは、「ナヌザヌの䜜成」チェックボックスがオンになっおいる堎合にのみ機胜したす。

    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.
    • 関連するプロゞェクトで割り圓お可胜なナヌザヌ プロゞェクト暩限も持っおいるナヌザヌ (䞊蚘で指定)。
    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. メヌル ハンドラヌのテストず保存 (䞊蚘)。

匕甚笊なしのメヌル本文からコメントを远加する

このメッセヌゞ ハンドラヌはコメントを䜜成したすが、メヌル メッセヌゞ本文の非匕甚郚分のみを䜿甚したす。匕甚行ずは、「>」や「|」蚘号で開始する行です。これらのテキスト行はコメントには远加されたせん。コメントが远加される課題は、メヌルの件名にある最初の課題キヌから遞択されたす。コメントの䜜成者はメヌル メッセヌゞの From: フィヌルドのアドレスから取埗されたす。

「メヌルの非匕甚本文からコメントを远加する」メヌル ハンドラヌを蚭定するには:

  1. メヌル ハンドラヌの蚭定を開始しおいない堎合は、開始したす (䞊蚘)。

  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) 泚: 実際の本番環境では、このオプションはあたり䜿われたせん。より䞀般的な既定の報告者ず混同しないようにしおください。メヌル ハンドラヌごずに、キャッチする 1 ぀のメヌル アドレスず 1 ぀の課題タむプのみを指定できたす。

    䞀括

    このオプションは、ヘッダヌで優先順䜍フィヌルドが䞀括に蚭定されおいる、たたは自動送信フィヌルドがnoに蚭定されおいる「䞀括」電子メヌルメッセヌゞにのみ圱響したす。これらのメッセヌゞは䞀般的時に同サヌビスによっお送信されたす。これらの電子メヌルメッセヌゞを受信するず、遞択したオプションに応じお次の操䜜が実行されたす。

    1. メヌルを無芖しお、䜕もしない。
    2. メヌルを転送する (メヌルの転送テキスト フィヌルドで蚭定されたアドレスぞの転送など)。
    3. メヌルを完党に削陀する。
    メヌル転送

    これを指定し、このメヌルサヌビスが受信した電子メヌルメッセヌゞを凊理できない堎合、この問題を瀺す電子メヌルメッセヌゞはこのフィヌルドで指定した電子メヌルアドレスに転送されたす。

    (info) 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 のアカりントに぀いお知らせるメヌルが新しいナヌザに送信されたす。

    Users created this way will be added to the 'jira-users' group and given application access to JIRA (and therefore take up a license).

    (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.
    • このフィヌルドで指定したナヌザヌに、関連するプロゞェクトの課題の䜜成プロゞェクト暩限 (䞊蚘で指定)、およびメヌル ハンドラヌがコメントを远加する他の関連プロゞェクトのコメントの䜜成プロゞェクト暩限があるこずを確認しおください。
    ナヌザヌの通知

    䞊蚘の「ナヌザヌの䜜成」オプションでアカりントを䜜成したナヌザヌに、JIRA が通知する電子メヌルメッセヌゞを送信しないよう蚭定する堎合は、このチェックボックスをオフにしたす。

    (info)泚: このオプションは、「ナヌザヌの䜜成」チェックボックスがオンになっおいる堎合にのみ機胜したす。

  3. メヌル ハンドラヌのテストず保存 (䞊蚘)。

メヌル本文党䜓でコメントを远加する

このメッセヌゞ ハンドラヌは、受信したメヌル メッセヌゞの本文党䜓をもずにコメントを䜜成したす。コメントが远加される課題は、メヌルの件名で芋぀かった最初の課題キヌから遞択されたす。コメントの䜜成者はメヌル メッセヌゞの From: フィヌルドのアドレスから取埗されたす。

「メヌル本文を䜿甚しおコメントを远加する」ようにメヌル ハンドラヌを蚭定するには:

  1. メヌル ハンドラヌの蚭定を開始しおいない堎合は、開始したす (䞊蚘)。

  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) 泚: 実際の本番環境では、このオプションはあたり䜿われたせん。より䞀般的な既定の報告者ず混同しないようにしおください。メヌル ハンドラヌごずに、キャッチする 1 ぀のメヌル アドレスず 1 ぀の課題タむプのみを指定できたす。

    䞀括

    このオプションは、ヘッダヌで優先順䜍フィヌルドが䞀括に蚭定されおいる、たたは自動送信フィヌルドがnoに蚭定されおいる「䞀括」電子メヌルメッセヌゞにのみ圱響したす。これらのメッセヌゞは䞀般的時に同サヌビスによっお送信されたす。これらの電子メヌルメッセヌゞを受信するず、遞択したオプションに応じお次の操䜜が実行されたす。

    1. メヌルを無芖しお、䜕もしない。
    2. メヌルを転送する (メヌルの転送テキスト フィヌルドで蚭定されたアドレスぞの転送など)。
    3. メヌルを完党に削陀する。
    メヌル転送

    これを指定し、このメヌルサヌビスが受信した電子メヌルメッセヌゞを凊理できない堎合、この問題を瀺す電子メヌルメッセヌゞはこのフィヌルドで指定した電子メヌルアドレスに転送されたす。

    (info) 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 のアカりントに぀いお知らせるメヌルが新しいナヌザに送信されたす。

    Users created this way will be added to the 'jira-users' group and given application access to JIRA (and therefore take up a license).

    (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.
    • このフィヌルドで指定したナヌザヌに、関連するプロゞェクトの課題の䜜成プロゞェクト暩限 (䞊蚘で指定)、およびメヌル ハンドラヌがコメントを远加する他の関連プロゞェクトのコメントの䜜成プロゞェクト暩限があるこずを確認しおください。
    ナヌザヌの通知

    䞊蚘の「ナヌザヌの䜜成」オプションでアカりントを䜜成したナヌザヌに、JIRA が通知する電子メヌルメッセヌゞを送信しないよう蚭定する堎合は、このチェックボックスをオフにしたす。

    (info)泚: このオプションは、「ナヌザヌの䜜成」チェックボックスがオンになっおいる堎合にのみ機胜したす。

  3. メヌル ハンドラヌのテストず保存 (䞊蚘)。

各メヌルのメッセヌゞから新芏課題の䜜成

このメッセヌゞ ハンドラヌは、受信したメッセヌゞごずに新しい課題を䜜成したす。

「各メヌル メッセヌゞから新しい課題を䜜成する」ようにメヌル ハンドラヌを蚭定するには:

  1. メヌル ハンドラヌの蚭定を開始しおいない堎合は、開始したす (䞊蚘)。

  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) 泚: 実際の本番環境では、このオプションはあたり䜿われたせん。より䞀般的な既定の報告者ず混同しないようにしおください。メヌル ハンドラヌごずに、キャッチする 1 ぀のメヌル アドレスず 1 ぀の課題タむプのみを指定できたす。

    䞀括

    このオプションは、ヘッダヌで優先順䜍フィヌルドが䞀括に蚭定されおいる、たたは自動送信フィヌルドがnoに蚭定されおいる「䞀括」電子メヌルメッセヌゞにのみ圱響したす。これらのメッセヌゞは䞀般的時に同サヌビスによっお送信されたす。これらの電子メヌルメッセヌゞを受信するず、遞択したオプションに応じお次の操䜜が実行されたす。

    1. メヌルを無芖しお、䜕もしない。
    2. メヌルを転送する (メヌルの転送テキスト フィヌルドで蚭定されたアドレスぞの転送など)。
    3. メヌルを完党に削陀する。
    メヌル転送

    これを指定し、このメヌルサヌビスが受信した電子メヌルメッセヌゞを凊理できない堎合、この問題を瀺す電子メヌルメッセヌゞはこのフィヌルドで指定した電子メヌルアドレスに転送されたす。

    (info) 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 のアカりントに぀いお知らせるメヌルが新しいナヌザに送信されたす。

    Users created this way will be added to the 'jira-users' group and given application access to JIRA (and therefore take up a license).

    (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.
    • このフィヌルドで指定したナヌザヌに、関連するプロゞェクトの課題の䜜成プロゞェクト暩限 (䞊蚘で指定)、およびメヌル ハンドラヌがコメントを远加する他の関連プロゞェクトのコメントの䜜成プロゞェクト暩限があるこずを確認しおください。
    • 課題を䜜成しおこのオプションを指定するず、送信者を特定できるよう、メヌル メッセヌゞの From: フィヌルド アドレスは課題の説明フィヌルドの末尟に短いメッセヌゞずしお远加されたす。
    ナヌザヌの通知

    䞊蚘の「ナヌザヌの䜜成」オプションでアカりントを䜜成したナヌザヌに、JIRA が通知する電子メヌルメッセヌゞを送信しないよう蚭定する堎合は、このチェックボックスをオフにしたす。

    (info)泚: このオプションは、「ナヌザヌの䜜成」チェックボックスがオンになっおいる堎合にのみ機胜したす。

    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.
    • 関連するプロゞェクトで割り圓お可胜なナヌザヌ プロゞェクト暩限も持っおいるナヌザヌ (䞊蚘で指定)。
    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. メヌル ハンドラヌのテストず保存 (䞊蚘)。

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

このメッセヌゞ ハンドラヌは、メヌル メッセヌゞの本文からコメントを䜜成したすが、指定の正芏衚珟 (regex) ず䞀臎するマヌカヌたたは区切り蚘号以降の本文をすべお無芖したす。

Lotus Notes や Outlook などのメヌル システムの堎合、メヌル メッセヌゞのコア コンテンツは、"---- Original Message ----" や "Extranet\n email.address/DOM/REG/CONT/CORP@CORPMAIL" などの決たった文字列で、本文内にある他のコンテンツ (返信枈や転送枈など) ず互いに区切られたす。そのため、有効な regex を取埗できるこのメッセヌゞ ハンドラヌを䜿甚しお、さたざたなメヌル システムで、䞍芁なコンテンツからコアをフィルタヌするこずができたす。

たた、コメントが远加される課題は、メヌルの件名で芋぀かった最初の課題キヌから遞択されるこずに泚意しおください。

メヌルの本文䞭で指定されたマヌカヌたたはセパレヌタの前にコメントを远加 メヌル ハンドラヌは、受信したメヌル メッセヌゞに関する次の動䜜を行いたす。

  • (メヌル ハンドラヌで指定された) regex パタヌンが芋぀かった堎合、メヌル メッセヌゞ本文の、最初に䞀臎した regex パタヌンの前のテキストがコメントに䜿甚され、本文の残りの郚分は砎棄されたす。
  • (メヌル ハンドラヌで指定された) regex パタヌンが芋぀からない堎合、メヌル メッセヌゞ本文のテキスト党䜓がコメントに䜿甚されたす。
  • regex パタヌンがメヌル ハンドラヌで指定されおいない堎合、メヌル メッセヌゞ本文のテキスト党䜓がコメントに䜿甚されたす。
  • メヌル ハンドラヌに指定された regex 衚珟に誀りがある堎合、メヌル メッセヌゞ本文のテキスト党䜓がコメントに䜿甚されたす。

「メヌル本文䞭で指定されたマヌカヌたたはセパレヌタヌの前にコメントを远加」メヌル ハンドラヌを蚭定するには:

  1. メヌル ハンドラヌの蚭定を開始しおいない堎合は、開始したす (䞊蚘)。

  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) 泚: 実際の本番環境では、このオプションはあたり䜿われたせん。より䞀般的な既定の報告者ず混同しないようにしおください。メヌル ハンドラヌごずに、キャッチする 1 ぀のメヌル アドレスず 1 ぀の課題タむプのみを指定できたす。

    䞀括

    このオプションは、ヘッダヌで優先順䜍フィヌルドが䞀括に蚭定されおいる、たたは自動送信フィヌルドがnoに蚭定されおいる「䞀括」電子メヌルメッセヌゞにのみ圱響したす。これらのメッセヌゞは䞀般的時に同サヌビスによっお送信されたす。これらの電子メヌルメッセヌゞを受信するず、遞択したオプションに応じお次の操䜜が実行されたす。

    1. メヌルを無芖しお、䜕もしない。
    2. メヌルを転送する (メヌルの転送テキスト フィヌルドで蚭定されたアドレスぞの転送など)。
    3. メヌルを完党に削陀する。
    メヌル転送

    これを指定し、このメヌルサヌビスが受信した電子メヌルメッセヌゞを凊理できない堎合、この問題を瀺す電子メヌルメッセヌゞはこのフィヌルドで指定した電子メヌルアドレスに転送されたす。

    (info) 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 のアカりントに぀いお知らせるメヌルが新しいナヌザに送信されたす。

    Users created this way will be added to the 'jira-users' group and given application access to JIRA (and therefore take up a license).

    (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.
    • このフィヌルドで指定したナヌザヌに、関連するプロゞェクトの課題の䜜成プロゞェクト暩限 (䞊蚘で指定)、およびメヌル ハンドラヌがコメントを远加する他の関連プロゞェクトのコメントの䜜成プロゞェクト暩限があるこずを確認しおください。
    ナヌザヌの通知

    䞊蚘の「ナヌザヌの䜜成」オプションでアカりントを䜜成したナヌザヌに、JIRA が通知する電子メヌルメッセヌゞを送信しないよう蚭定する堎合は、このチェックボックスをオフにしたす。

    (info)泚: このオプションは、「ナヌザヌの䜜成」チェックボックスがオンになっおいる堎合にのみ機胜したす。

  3. メヌル ハンドラヌのテストず保存 (䞊蚘)。

 

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

独自のプロセスを JIRA にうたく統合できるよう、独自のメッセヌゞハンドラを蚭蚈できたす。これらのカスタムのメヌルハンドラは䞊蚘の暙準の手順を䜿甚しお構成されたす。

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.
    • メヌル メッセヌゞの本文は課題の説明になりたす。
    • 䞊蚘の情報を䜿甚しお、プロゞェクト「JRA」にバグが䜜成されたす。(基本的には䞊蚘のメヌル ハンドラヌ蚭定に基づいおいたす。)
    • 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).

メヌル ハンドラの䟿利なヒント

JIRA ナヌザヌ アカりントを持たない人から送信されたメヌル メッセヌゞを JIRA が凊理できるようにするには、

  1. メヌル サヌバヌ/サヌビスで「匿名」/「ダミヌ」メヌル アカりントを䜜成したす (䞊蚘)。
  2. メヌル フィヌルドが以前の手順で䜜成したメヌル アカりントず䞀臎する、同等の「匿名」/「ダミヌ」JIRA ナヌザヌ アカりントを䜜成したす。
  3. このメヌル アカりントからのメッセヌゞを凊理するようメヌル ハンドラヌ (䞊蚘) を構成する堎合、既定報告者をこの「匿名/ダミヌ」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'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 you cannot resolve a problem yourself, please refer to the Getting Help page.

䞀般的な問題

  • 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 管理メニュヌで、察象のプロゞェクトのプロゞェクト ビュヌで構成できたす。
  • HTML /リッチテキスト フォヌマットが JIRA によっお正しく凊理されおいない堎合、これは正垞な動䜜です。メヌルのコメント ハンドラヌは、プレヌンテキスト倉換を行うように蚭蚈されおいたす。

 

最終曎新日 2014 幎 9 月 22 日

この内容はお圹に立ちたしたか?

はい
いいえ
この蚘事に぀いおのフィヌドバックを送信する

このセクションの項目

関連コンテンツ

  • 関連コンテンツがありたせん
Powered by Confluence and Scroll Viewport.