# Integration

Integration is the process of enabling individual applications each designed for its own specific purpose to work with one another. We can configure project management tool.

This configuration will be used to connect to project management tool to create issues. Like an user can create a Jira ticket from the Qyrus platform.

## Contents

* [Integration](#integration)
  * [Get started with Integration](#get-started-with-integration)
  * [Process of generating API tokens](#the-process-of-generating-api-tokens-is-shown-below)
  * [Editing a Integration](#editing-a-integration)
  * [Deleting a Integration](#deleting-a-integration)
  * [Process of creating a Jira](#the-process-of-creating-a-jira)
  * [Related topics](#related-topics)

***

## Get started with Integration:

Step-1: Select a project.

Step-2: Under any Functional, Performance or API Process service, click on Project Setup.

Step-3: Under Project Setup, click on the **Integration** tab.

![Alt text](/files/iyvaeHePKK3DizCwcp3y)

Step-4: There will be a list of all the integrations or if not we can create as required.

Step-5: Click on **New Configuration** & popup window will displayed.

![Alt text](/files/0aZPpSLNkA3Ktx50hRDV)

Step-6: Provide **New Jira Configuration Name**.

Step-7: Required information by the user:

* **Domain URL** : The user has to provide the Domain URL of Jira. (Example - <https://cogcloud.atlassian.net/>)
* **API Token** : Using the attached link, generate the API token. API tokens are secure similar to any password: <https://id.atlassian.com/manage-profile/security/api-tokens>

Step-8: Enter an user **Email address**.

Step-9: Click on the **Test Connection** button in order to check if the connection is successful or not. ![Alt text](/files/g3S33luKHNbd1XWOpGu1)

Step-10: Click on **Save Configuration**.

Step-11: Created configuration will display in the list in the Integration page.

***

## The process of generating API tokens is shown below:

1. Launch the link : <https://id.atlassian.com/manage-profile/security/api-tokens> and the below-shown screen will be displayed:

![Alt text](/files/MjffXww0hbRtkkAi8dEj)

2. Click on Create API token Button, enter the *label* and click on **create** button.

![Alt text](/files/ToZUDlHb477z1lTqIp23)

3. A new token will be generated; the User can **copy** and paste it in the Qyrus → API Testing → Project Setup → Jira configuration → API Token field.

   ![Alt text](/files/HqbRezPoDehWPaA4KsC5)

***

## Editing a Integration

Step-1: Within the Integration section, find the configuration you wish to edit.

Step-2: Click on the configuration's Edit button.

![Alt text](/files/vkjd8pZLaL9vAWDwEPV8)

Step-3: Once you've made the necessary modifications to the configuration, proceed by clicking on the "Update" button.

![Alt text](/files/61NHVQMW8RvzsdbBPJIk)

***

## Deleting a Integration

Step-1: Within the Integration section, find the configuration you wish to delete.

Step-2: Select the Delete button linked with that configuration.

![Alt text](/files/LpX1JusRCivW4XsDR33v)

Step-3: Confirm the deletion.

![Alt text](/files/ZFDw7MBd52l6Wmqx8LkF)

***

## The process of creating a Jira :

Step-1: Navigate to reports page(Functional report/ Performance report/ API Process report/ Prerequisite API report).

![Result Page](/files/O7KJzRLP1FYSFRMMVh0w)

Step-2 : On clicking **create a ticket** icon, it will display a screen as shown below.

![Create Jira](/files/r6iBuA3Xrd3DAH7Xyq04)

Step-3: **Select configuration**: The list of configurations will be displayed based on the configurations created on the Jira integration page. The user can select the required configuration.

Step-4: After selecting the configuration, the list of Jira Projects will be shown for selection in the dropdown. Users can select the project based on the service they want to raise the ticket. It will also allow the user to choose the Issue type and Priority before creating the ticket along with Summnary & Description.

![Result Page](/files/MhSJAxrMaMgRqTfqX3Sz)

Step-5: Click on **Create Ticket**.

* Note : Post creation, the user can verify it in the particular project in the registered project management tool (Jira backlog)

***

### Related topics

* [Certificate](/api-testing/project-setup/certificate.md)
* [Database Configuration](/api-testing/project-setup/database-configuration.md)
* [Global & Environment](/api-testing/project-setup/global-and-environment.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.qyrus.com/api-testing/project-setup/integration.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.
