Create a Jira Issue

Once the installation and configuration of the add-in is completed, Jira issues can created directly from emails in Microsoft Outlook.

To create an issue, do the following:

1. Select 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 body's text, only the selected text is used as issue description.

2. Then select Create JIRA Issue from the Outlook menu or from the email's context menu (right click on the e-mail). A splitted context menu will be shown if there are at least 2 profiles configured. Otherwise you will only have one single entry for the configured Jira system.

The following dialog will appear:

3. From the Profile pull-down menu, select a server where the issue is created. If you use the email's context menu to open the dialog, the appropiate profile is already selected, otherwise you have to select it.

The Profile pull-down menu is only shown, is there are at least 2 profiles configured.

4. From the Project pull-down menu, select a project where the issue is created. The content of the menu depends on the selected profile. This menu displays all Jira projects that are visible for you.

To automate the selection of the project based on the sender's email address, setup rules at Settings > Project Mapping. If no mapping applies the last used profile and issue type will be used.

5. From the Issue type pull-down menu, select the issue type of the new issue. The content of the menu depends on the selected project. By default the last used issue type based on the last used project is selected.

6. To add the header information of the email to the issue description, select Add header information.

By default the email header information is not copied into the Jira issue. When you select this option, the header information is also used for the Jira issue description.

7. To assign the new issue to yourself, select Assign issue to me.

8. To add optional information to the new issue, select Open internal browser.

9. Enter the subject of the new Jira issue in the Subject textbox. By default the subject of the email is used.

10. Enter the description of the new Jira issue in the Description textbox. By default the text body of the email is used.

11. A list of the files that are attached to the email is displayed in the Attachments frame. Select the files, you want to attach to the Jira issue. Use Select All to un/select all attachments. The attachments are uploaded after the issue is created successfully.

12. To add the email as attachment to the Jira issue, select Add e-mail as attachment.

13. Click Create Issue to continue.

If the issue does not need any additional mandatory information and the Open embedded browser option is not selected, the Jira issue is created. If the issue needs more mandatory information or the Open embedded browser option is selected, an embedded IE browser dialog opens.

Enter the optional information you want to add and all mandatory information in the embedded browser dialog.

Select Create in the internal browser dialog to create the issue. To abort and close the dialog, select Cancel or just close the window.