Azure DevOps
To install the Azure DevOps (ADO) plugin, see Upload plugin section.
Integration with our centralized test automation tool can be helpful for projects which are already using Azure DevOps BTS (Bug Tracking System) as a tracking tool. This feature allows posting issues and linking/unlinking issues, getting updates on their statuses. For example, just a few clicks – and bug with detailed logs is created!
Azure DevOps BTS integration can be configured on the global level (for all projects on the instance) or on the project level (only for one project).
Admin, Manager, and user with edit permissions can create/edit/delete Azure DevOps integration.
User with view permissions can only view the list of available integrations.
Global Azure DevOps BTS integration
Add new global Azure DevOps BTS integration
You might want to configure global integrations which will be applied on all projects if all projects on your instance are using the same Azure DevOps BTS projects.
- Log in to ReportPortal as Admin.
- Navigate to Instance plugins page.
- Click on "Azure DevOps" panel.
- Click on the “Add integration” button.
- Fill and Save the authorization form.
Please, follow the steps below to get a token for Azure DevOps integration:
You can choose predefined Azure DevOps ticket fields after you have created a connection with the Azure DevOps BTS project. These fields will be shown to you all the time when you post an issue to the Azure DevOps BTS.
This feature also gives you the ability to choose proper issue type for newly created issues in Azure DevOps BTS.
To choose a needed issue type and predefined field for the chosen issue, you should perform the following actions on the opened Configuration form:
- Choose issue type from the drop-down.
- Check the fields needed and fill them in if necessary.
- Click on “Submit” button.
Now team members on all your projects will be able to submit issues in Azure DevOps BTS. Options for Post Issue/Link issue are activated.
You can add more integrations by clicking on “Add integration”.
User can add several integrations, but with a different name to the one Azure DevOps BTS project.
Use case:
Situation: User wants to post to Azure DevOps BTS issues with type Issue and Task to the project NNN-MMM in Azure DevOps BTS. Is it possible? Yes!
Solution: Add two integrations to the project NNN-MMM in Azure DevOps BTS with names e.g., “Project -1” and “Project -2”. Add to the “Project -1” issue type Issue and for “Project -2” - issue type Task. While posing issue procedure, choose integration with needed type.
Update global Azure DevOps BTS integration
If you need to edit Azure DevOps BTS integration authorization parameters, please perform actions:
- Log in to ReportPortal as Admin.
- Navigate to Instance plugins page.
- Click on "Azure DevOps" panel.
- Click on a tab with existing integration.
- Click on "Edit" icon.
-
Change “Integration name”.
-
Type your Azure DevOps credentials.
-
Submit the form.
You can edit only “Integration name”. If you need other changes, please submit new integration.
If you need to edit fields which should be posted in Azure DevOps BTS, please perform actions:
- Log in to ReportPortal as Admin.
- Navigate to Instance plugins page.
- Click on "Azure DevOps" panel.
- Click on the tab with existing integration.
- Click on "Edit" button in Configuration section.
-
Choose issue type from the drop-down.
-
Check the fields needed and fill them in if necessary.
-
Click on “Submit” button.
Remove global Azure DevOps BTS integration
If you need to remove Azure DevOps BTS integration, please perform actions:
- Log in to ReportPortal as Admin.
- Navigate to Instance plugins page.
- Click on "Azure DevOps" panel.
- Click on the tab with existing integration.
- Click on "Remove" icon.
- Click "Delete" button.
Project Azure DevOps BTS integration
Add new project Azure DevOps BTS integration
If any project needs different Azure DevOps BTS configurations, you can add a project configuration. This means that when a new global integration is added to ReportPortal, it will no longer be applied to this project.
For that,
- Log in to ReportPortal as Admin, Manager, or user with edit permissions.
- Go to the Project settings -> Integrations tab.
- Click on "Azure DevOps" panel.
- Click on "Add Project integration" button.
- Fill in the necessary fields.
- Click "Create" button.
Please, have a look at Global Azure DevOps BTS integration for detailed configuration steps.
You can choose predefined Azure DevOps ticket fields after you have created a connection with the Azure DevOps BTS project. These fields will be shown to you all the time when you post an issue to the Azure DevOps BTS.
This feature also gives you the ability to choose proper issue type for newly created issues in Azure DevOps BTS.
To choose a needed issue type and predefined field for the chosen issue, you should perform the following actions on the opened Configuration form:
- Choose issue type from the drop-down.
- Check the needed fields and fill them in if necessary.
- Click on “Submit” button.
Now team members on this project will be able to submit issues in Azure DevOps BTS. Options for Post Issue/Link issue are activated.
You can add more integrations by clicking on “Add integration” button.
Post issue to Azure DevOps BTS
Posting an issue to Azure DevOps BTS means creating a new issue in Azure DevOps BTS from ReportPortal and uploading logs and attachments from an execution.
If you want to post a new issue to Azure DevOps BTS, you need to have a project or global integration with Azure DevOps BTS.
- Log in to ReportPortal as Admin, Manager, or user with edit permissions.
- Go to Launches.
- Choose a needed item.
- Click on the pencil icon to open “Make decision” modal.
- Choose “Post issue” option and then “Apply & Continue”.
- Fill in the “Post Issue” form with valid data and submit the form.
- A new issue will be posted in Azure DevOps BTS with information from ReportPortal.
- A label with issue ID will be added to the test item.
Link an issue with an issue in Azure DevOps BTS
Linking an issue with an issue in Azure DevOps BTS means adding a clickable link to an existing issue in Azure DevOps BTS from ReportPortal that will show a status of this issue.
- Log in to ReportPortal as Admin, Manager, or user with edit permissions.
- Go to Launches.
- Choose a needed item.
- Click on the pencil icon to open “Make decision” modal.
- Choose “Link issue” option and then “Apply & Continue”.
- Fill in the “Link issue” form with valid data and submit the form.
- A label with issue ID will be added to the test item.
- Link is redirected to this issue in Azure DevOps BTS.
Unlink an issue in Azure DevOps BTS
You can also unlink an issue.
- Click on the “remove” icon.
- Click “Unlink Issue”.
- Link to the issue in Azure DevOps BTS is removed.
Custom issue type in Azure DevOps BTS
You can configure any custom issue type (e.g., Bug for Adam) in Azure DevOps BTS and then choose it as predefined Azure DevOps ticket field. So, developer Adam will see on the Azure DevOps BTS all issues from ReporPortal which assigned to him.
Follow the steps below to configure custom issue type:
-
Log in to Azure portal.
-
Go to Organization settings.
- Click on the “Process” menu item.
- Select three dots near the current process and create a new one.
- Click on the name of the just created process.
- Create custom issue type.
- Click on the project quantity and change the process for your project.
- Change Issue Type for Azure DevOps BTS integration on ReportPortal.
-
Post issues to Azure DevOps BTS.
-
Now you can see issues with custom issue type on Azure DevOps BTS.