# Auto Defect Creation

Auto Defect Creation in Avo Assure automatically logs defects into JIRA whenever a Test Step fails during execution. It captures failure details like step info, logs, and screenshots, and links the JIRA defect ID back to the Test Step.  

## Prerequisites

User must ensure the following requirements are fulfilled before proceeding with Jira integration in Avo Assure. 

### Cloud Authentication Prerequisites

For the cloud authentication, here are the prerequisites:

* **Jira Credentials:** Keep Jira login credentials ready to use during authentication.
* **Jira API token:** Generate the Jira API token and store it securely for use during authentication.
* **Jira Instance URL:** Ensure the Jira URL is correct and accessible to use during authentication.
* **Avo Integrator:** Ensure the Avo Integrator extension is downloaded in the browser. This required for Login, Mapping, and Execution Configuration in Avo Assure.

{% hint style="info" %}
**Note:** To integrate with Jira without using the Avo Assure Client, user can install the Avo Integrator Extension in user's browser and perform the integration. For installation steps, refer to [Avo Integrator](/avo-assure/integrations-in-avo-assure/avo-integrator-extension.md).
{% endhint %}

* **Avo Assure Client:** Ensure Avo Assure client is connected and it's required for executing the test case and update status in Jira**.**
* **Mapping Zephyr Scale/Xray Test case:** Ensure to map Zephyr Scale/Xray Test Case to auto create defect for failed Test step while execution.

{% hint style="info" %}
**Note:** Refer to the document below to learn more about Zephyr Scale and Xray Integration.

* For **Zephyr Scale**, refer to [Zephyr Scale](/avo-assure/integrations-in-avo-assure/test-management/zephyr-scale.md)
* For **Xray**, refer to [Xray](/avo-assure/integrations-in-avo-assure/test-management/xray.md)
  {% endhint %}

### Data Center Authentication Prerequisites

For the data center authentication, here are the prerequisites:

* **Username:** Ensure the Jira Username is ready to use during authentication.
* **PAT token:**  Generate the PAT (Personal Access token) token and store it securely for use during integration.
* **URL for Jira instance:**  Ensure the Jira URL is correct and accessible to use during authentication.
* **Avo Integrator:** Ensure the Avo Integrator extension is downloaded in the browser. This required for Login, Mapping, and Execution Configuration in Avo Assure.

{% hint style="info" %}
**Note:** To integrate with Jira without using the Avo Assure Client, user can install the Avo Integrator Extension in user's browser and perform the integration. For installation steps, refer to [Avo Integrator](/avo-assure/integrations-in-avo-assure/avo-integrator-extension.md)
{% endhint %}

* **Mapping Zephyr Scale/Xray Test case:** Ensure to map Zephyr Scale/Xray Test Case to auto create defect for failed Test step while execution. 

{% hint style="info" %}
**Note:** Refer to the document below to learn more about Zephyr Scale and Xray Integration.

* For **Zephyr Scale**, refer to [Zephyr Scale](/avo-assure/integrations-in-avo-assure/test-management/zephyr-scale.md)
* For **Xray**, refer to [Xray](/avo-assure/integrations-in-avo-assure/test-management/xray.md)
  {% endhint %}

### This document includes:

1. [Template Creation](/avo-assure/integrations-in-avo-assure/test-management/jira-integration/auto-defect-creation/template-creation.md)
2. [Configuration and Execution Test Cases](/avo-assure/integrations-in-avo-assure/test-management/jira-integration/auto-defect-creation/configuring-and-executing-test-case.md)
3. [View Defect ID in Avo Assure Reports](/avo-assure/integrations-in-avo-assure/test-management/jira-integration/auto-defect-creation/view-defect-id-in-avo-assure-reports.md)
4. [View Auto Created Defect in Jira](/avo-assure/integrations-in-avo-assure/test-management/jira-integration/auto-defect-creation/view-auto-created-defect-in-jira.md)

 


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.avoautomation.com/avo-assure/integrations-in-avo-assure/test-management/jira-integration/auto-defect-creation.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.