JIRA Integration

Froth TestOps seamlessly integrates with JIRA, one of the most popular issue and defect tracking tools.

This integration enables real-time synchronization of updates between the two platforms, helping teams stay aligned throughout the testing and development lifecycle.

TestOps supports both one-way (TestOps to JIRA) and two-way synchronization, allowing you to choose the integration method best suited for your project requirements.

Steps to set up JIRA integration in TestOps:

STEP 1 - Obtain JIRA API Token

1. Log in to your JIRA account.

2. Navigate to Settings > Atlassian Account Settings or User Profile Icon > Account Settings

1. Select Security.

2. Under the API token section, click Create and manage API tokens.

1. Click Create API token.

1. Enter a descriptive name for the token and click Create.

1. Copy the generated API token securely. (Note: This token will not be shown again.)

STEP 2 - Access TestOps Settings

1. Navigate to the Settings section within your TestOps workspace in left menu.

2. Select Integration Tab

3. Click Create

STEP 3 - Create JIRA Integration

1. Select JIRA from the list of available products.

2. Enter the required JIRA credentials:

   • JIRA Email: Your JIRA account email address.

   • JIRA API Token: Paste the token generated in Step 1.

   • JIRA URL: The base URL of your JIRA instance.

3. Use the following actions as needed:

   • Submit to save and finalize the integration.

   • Cancel to discard changes.

   • Go Back to return to the previous screen

STEP 4 - Map JIRA Projects with TestOps

Once the integration is configured, map your JIRA projects to TestOps projects for defect and issue synchronization:

1. Select Integration Type: Choose either Basic or Custom mapping.

2. Select Synchronization Type: Choose One-way (TestOps to JIRA) or Two-way synchronization.

3. Select Module: Choose the relevant module (e.g., Defect).

4. Select JIRA Project: Choose the desired JIRA project from the dropdown.

5. Select TestOps Project: Select the corresponding TestOps project.

6. Click Save to complete the mapping.

Integration Mapping Types

Basic Mapping

Basic mapping provides a direct, hard-coded field-to-field synchronization between TestOps and JIRA. Each field in TestOps corresponds exactly to a field in JIRA.

To complete the integration setup, map your JIRA project with a TestOps project by following the steps below:

1. Click on the “Map Project” button.

2. In the mapping form:

   • Select the Integration Type as Basic.

   • Fill in the remaining required fields, such as Synchronization Type, Module as Defect, required JIRA Project, and TestOps Project.

3. Click Submit to finalize the mapping.

Once submitted, an entry will be listed displaying:

• The selected integration type

• A view icon (eye) to preview mapped fields

• A delete icon to remove the integration mapping

Viewing Default Mapped Fields

To view the default field mappings between JIRA and TestOps:

• Click on the eye icon associated with your mapping entry.

• A dialog will appear displaying the default field-to-field mapping between JIRA and TestOps.

Important: Ensure the issue type in JIRA is set to BUG for proper synchronization under Basic Mapping. Other issue types may not be supported in this mapping mode.

---

Custom Mapping

Custom mapping allows greater flexibility by enabling you to define field mappings tailored to your project needs. Ensure that the fields and dropdown values in TestOps have matching counterparts in JIRA.

Steps to Create Custom Mapping

1. Click on the “Map Project” button.

2. In the mapping form:

   • Select the Integration Type as Custom.

   • Choose the appropriate Synchronization Type (One-way or Two-way).

   • Fill in the required fields such as Module as Defect , required JIRA Project, and TestOps Project.

3. Click Submit to complete the custom mapping setup.

After submission, the mapping entry will appear in the integration list. It will include:

• Integration details (e.g., type, project names)

• Edit and delete icons for managing the mapping

Viewing and Editing Custom Mappings

• Click on the edit icon to preview the custom field mappings.

• You can edit the mapping at any time to adjust the fields as per your JIRA/TestOps configurations.

• Ensure that each field mapped in TestOps has a corresponding field in JIRA, including matching dropdown values where applicable.

Note: Custom Mapping is ideal for teams using custom issue types or additional metadata in their JIRA workflows.

Note: Each JIRA project can be mapped to only one TestOps project and vice versa. Once mapped, these associations cannot be changed.

Basic mappings can be viewed and deleted but cannot be edited.

Custom mappings are editable and can be deleted as needed.

Your JIRA account is now successfully integrated with Froth TestOps. Defects and updates can now be seamlessly synchronized between both platforms, enabling end-to-end traceability and efficient test management across your projects.