Skip to main content
Version: 26.1

Atlassian Jira Cloud

To install the Jira Cloud plugin, see Upload plugin section.

Integration with the JIRA Cloud can be required for projects that collect defects in a separate tracking tool. The integration provides an exchange of information between our centralized test automation tool and the JIRA Cloud, such as posting issues and linking issues, getting updates on their statuses.

info

Admin, Manager, and user with edit permissions can create/edit/delete Jira Cloud integration.
User with view permissions can only view the list of available integrations.

Global JIRA Cloud integration​

Add new global Jira Cloud integration​

If all projects on your instance are using the same Jira projects, you will be able to configure global integrations which will be applied on all projects.

  1. Log in to ReportPortal as Admin.
  2. Navigate to Instance plugins page.
  3. Click on "Jira Cloud" panel.
  4. Click "Add integration" button.
  5. Fill and confirm the authorization form.
'Integration Name': <The name which you want to give to your integration> - should be unique
'Link to BTS': <valid URL of bug tracking system>
'Project key in BTS': <project key in bug tracking system>
'Email': <user email>
'API Token': <user API Token>

After you have created a connection with the JIRA project, you can choose predefined JIRA ticket fields. These fields will be shown to you all the time when you post the issue in Jira Cloud.

This feature gives you the ability to choose which type you will post a ticket.

To select a needed issue type and predefined fields for the chosen issue, you should perform the following actions:

  1. In the Configuration section, choose issue type from the dropdown.
  2. Check the required fields and complete them.
  3. Click on "Submit" button.

Now team members on all your projects will be able to submit issues in Jira Cloud. Options for Post Issue / Link issue are activated.

You can add more integrations by clicking on "Add integration" button.

User can add several integrations, but with a different name to the one JIRA project.

Use case:

Situation: User wants to post to JIRA Cloud issues with type Defect and Task to the project NNN-MMM in Jira. Is it possible? Yes!

Solution: Add two integrations to the project NNN-MMM in Jira with names f.e. "Project -1" and "Project -2". Add to the "Project -1" issue type Defect and for "Project -2" - issue type Task. While posing issue procedure, choose integration with needed type.

Update global Jira Cloud integration​

If you need to edit Jira Cloud integration authorization parameters, please perform actions:

  1. Log in to ReportPortal as Admin.
  2. Navigate to Instance plugins page.
  3. Click on "Jira Cloud" panel.
  4. Click on a tab with existing integration.
  5. Click on "Edit" icon.
  6. Change "Integration name"
  7. Submit the form
note

You can edit the "Integration name" only. If you need other changes, please submit new integration.

If you need to edit fields which should be posted in Jira Cloud, please perform actions:

  1. Log in to ReportPortal as Admin.
  2. Navigate to Instance plugins page.
  3. Click on "Jira Cloud" panel.
  4. Click on the tab with existing integration.
  5. Click on "Edit" button in Configuration section.
  6. Choose issue type from the drop-down.
  7. Check the needed fields and fill them in if necessary.
  8. Click on "Submit" button.

Remove global Jira Cloud integration​

If you need to remove Jira Cloud integration, please perform actions:

  1. Log in to ReportPortal as Admin.
  2. Navigate to Instance plugins page.
  3. Click on "Jira Cloud" panel.
  4. Click on the tab with existing integration.
  5. Click on "Remove" icon.
  6. Click "Delete" button.

Project JIRA Cloud integration​

Add new project Jira Cloud integration​

If any project needs different Jira Cloud configurations, you can add a project configuration. This means that when a new global integration is added to our test automation results dashboard, it will no longer be applied to this project.

For that,

  1. Log in to ReportPortal as Admin, Manager, or user with edit permissions.
  2. Go to the Project settings -> Integrations tab.
  3. Click on "Jira Cloud" panel.
  4. Click on "Add Project integration" button.
  5. Fill in the necessary fields.
  6. Click "Create" button.
'Integration Name': <The name which you want to give to your integration> - should be unique
'Link to BTS': <valid URL of bug tracking system>
'Project key in BTS': <project key in bug tracking system>
'Email': <user email>
'API Token': <user API Token>

After you have created a connection with the JIRA project, you can choose predefined JIRA ticket fields. These fields will be shown to you all the time when you post the issue in Jira Cloud.

This feature gives you the ability to choose which type you will post a ticket.

To choose a needed issue type and predefined field for the chosen issue, you should perform the following actions:

  1. Click on "Configure" button.
  2. Choose issue type from the dropdown.
  3. Check the needed fields and fill them in if necessary.
  4. Click on "Submit" button.

Now team members on this project will be able to submit issues in Jira Cloud. Options for Post Issue / Link issue are activated.

You can add more integrations by clicking on "Add integration" button.

Post issue to Jira Cloud​

Posting an issue to Jira Cloud means to create a new issue in Jira from ReportPortal and upload logs and attachments from an execution.

If you want to post a new issue to Jira, you need to have a project or global integration with Jira Cloud.

Post issue via Step view

  1. Log in to ReportPortal as Admin, Manager, or user with edit permissions.
  2. Go to a Step view.
  3. Click on the pencil icon near a needed item to open "Make decision" modal.
  4. Select "Post issue" option and then "Apply & Continue".
  5. Fill in the "Post issue" form with valid data.
  6. Click "Post issue" button.
`BTS`: if you have configured BTS integrations, you will be able to choose between them
`Integration name`: from the drop-down, you can choose any of integrations for chosen earlier BTS
`Predefined fields`: fields which you choose on Project Settings/ or Plugins
`Included data`: which data should be posted to BTS (attachments, logs, comments)

A new issue will be posted in BTS with information from ReportPortal.

A label with issue ID will be added to the test item.

You can also link ReportPortal item to already existing issue in Jira.

Link issue via Step view

  1. Log in to ReportPortal as Admin, Manager, or user with edit permissions.
  2. Go to a Step view.
  3. Click on the pencil icon near a needed item to open "Make decision" modal.
  4. Select "Link issue" option and then "Apply & Continue".
  5. Fill in the "Link issue" form with valid data.
  6. Click "Link issue" button.
`BTS`: if you have configured BTS integrations, you will be able to choose between them
`Integration name`: from the drop-down, you can choose any of integrations for chosen earlier BTS
`Link to issue`: a full link to the item in BTS
`Issue ID`: information which will be displayed on the label in ReportPortal