Add Email as Jira Comment

Once the installation and configuration of the add- on is completed , you can add emails in Thunderbird directly to Jira issue.  

To comment an issue, do the following:

  1. Right-click the email you want to create a Jira issue from.

    By default the body of the email is used as issue description. If you select a part of the email's body text, only the selected text is used as comment.

    At the end of the context menu, you can find the Thunderbird Integration menu items.

  2. Select Add as Jira comment from the email's context menu.
    The "Add a Jira comment" wizard is displayed.

  3. In the first dialog of the " Add a Jira comment " wizard , you have to specify the issue you want to add the email as comment. To search for the issue, the dialog has five tabs for different search strategies:
    1. Full text: Enter a string that is part of the issue's summary or description.
    2. Issue key: Enter the issue key you want to search for.

        Search for issue key...

    3. Filter favorites: Select a Jira JQL filter from the pull-down menu.

        Search using filter favorites...

    4. JQL: Enter a JQL statement to search for issues.

        JQL search...

    5. Recent Issues: Search in the list of the recently selected issues

        Search for recent issues...

      In some cases, you will see an error message in this tab in the bottom right corner.

      This happens due to errors in the list of recent issues in the Thunderbird configuration. Probably there is an issue in the list, that does not exist (anymore).

        Fix list of recent issues...

       To fix the list of recent issues in the Thunderbird configuration, do the following:

      1. From the Thunderbird menu, select Edit > Preferences.
        The "Thunderbird Preferences" dialog appears.
      2. Select the Advanced tab.
      3. Click Config Editor.
        A warning message is displayed.
      4. Click I'll be careful, I promise!
        The list of preferences is displayed.
      5. Enter Jira in the "Search" textbox.
        You should see the entry "extensions.createJiraissue.lastissues" in the list.
      6. Double-click the "extensions.createJiraissue.lastissues" entry.
        The "Enter string value" dialog is displayed.
      7. Check if the listed issue keys exist or if there are double-commas or a single comma at the end of the list of issue keys.
        Edit the list and click OK.
      8. Close the list of preferences dialog.
      9. Clock Close to close the "Thunderbird Preferences" dialog.

    In the "Other" tab of the "Thunderbird Integration for Jira preferences" dialog, you can specify which tab is selected first by default.

    The search results are displayed in the "Search results" frame.

  4. Select an entry in the "Search results" frame and click Next.
    The second dialog of the "Add a Jira comment" wizard is displayed.
  5. The second dialog of the " Add a Jira comment " wizard displays the following options:
    1. Issue: The selected issue to add the comment to.
    2. Add the email headers: Details see Auto add header information.
    3. Comment: The email body that should be added as comment.
    4. Restrict the visibility of the comment: Select if the comment should be viewable for a single group or all users.
    5. Attachments: Select the email attachments, you want to add to your to your comment.

      A known bug in Thunderbird Integration is that the attachments of the email are not displayed correctly in the Thunderbird Integration user interface. If you need to add an attachment to the Jira issue it is currently recommended to add it manually after the issue is created. Click Open Issue in the third dialog of the "Add Email as Jira Comment" wizard (see below).

      (info) Sometimes you can open the create dialog, choose any project and issue type, wait for the attachments to not appear. Close the dialog and reopen it again, now choosing the desired project and issue type. Chances are good, the attachments have now been downloaded already from the server and are now displayed promptly.

      (warning) Inline attachments are currently not working due to a lacking interface in Thunderbird.

    Enter the additional information and edit – if necessary – the displayed information.
    When done, click Next to create the issue.
    The third dialog of the " Add a Jira comment " wizard is displayed.
  6. In the third dialog of the "Add Email as Jira Comment" wizard you can do the following:
    • Click Open Issue to start your web browser and display the created issue in Jira.
    • Click Answer Mail to reply on the selected email.
      Defaults for the email subject and body can be defined in the "Reply" tab of the "Thunderbird Integration for Jira preferences" dialog.
    • Click Open Issue and a nswer Mail to start your web browser (and display the created issue in Jira) and reply on the selected email.
    • Click Mail settings to display the "Reply" tab of the "Thunderbird Integration for Jira preferences" dialog.
    • Click Finish to finish the "Add Email as Jira comment" wizard .