Create a New Defect
1. Click on the 
button towards the top right of the defect tracking interface.
- A pop-up/modal will appear prompting the user for a project and issue type.
2. Choose a project to create the defect for using the project drop-down list.
3. Choose an issue type for the issue that you are creating by selecting "Bug" in the issue type drop-down list and then click "Next"
4. Fill in the following mandatory fields:
- Summary and Description
- Priority - If the priority is not selected for the new defect, the priority will be set to "Medium" by default.
5. Fill in any of the following optional fields for creating a bug if need be:
- Components, Fixed Version(s), Assignee, Sprint, Labels, Environment, Links, and Affected Versions.
The Sprint and Jira Epic Links fields are cached and will only update every two hours unless an administrative user clears the defect admin cache within the administration section of Zephyr. You may need to clear the cache for the Jira fields if there was a new Sprint or Epic Link that was recently added in Jira and it not appearing in Zephyr as there is a two hour caching period.
- To clear the cache, use the Defect Admin page in the Administration section of Zephyr.
6. Simply click on the "Create" button at the bottom right of the interface.
- This will create the defect and will refresh the pop-up/modal with the information for the defect.
7. If you scroll to the bottom, you can add any additional attachments that you may see fit for the defect and then click on the "Update" button to finalize creating the new defect.
- The maximum size limit for attachments is 20MB
Creating Defects using Wiki Markup
You can create defects for your Jira instance and use wiki markup for the description directly within Zephyr.
When creating a defect with wiki markup in Zephyr, be sure to select "As wiki markup" in the drop-down for the description. This allows you use create the description using wiki markup and it will be transferrable to Jira. When viewing the defect in Jira, it will contain the proper wiki markup formatting that you created for the defect.
Navigate to the defect in your Jira to view the wiki markup formatting that you set up for the defect. The wiki markup should reflect the wiki markup formatting you had when initially creating the defect in Zephyr.
If your wiki markup isn't displaying correctly, we recommend you double check your wiki markup formatting for the defect in Zephyr.
Remote Issue Links in JIRA
If the Remote Issue Links configuration has been set up in JIRA Customizations, then a remote link is sent to that particular defect in JIRA indicating that a Zephyr test case has been linked to it. It shows the test case ID, the summary, the test cycle in which it was executed and the status of that test case execution.
This shows up in the "Issue Links" section of that defect in JIRA (see below). Clicking on the test case ID transfers the user back to the test case in Zephyr.
