Rally
To install the Rally plugin, see Upload plugin section.
Global RALLY integration
Add new global RALLY integration
If all projects on your instance are using the same RALLY projects, you will be able to configure global integrations which will be applied on all projects.
-
Log in as ADMIN
-
Go to Administrative > Plugins
-
Click on RALLY plugin panel
-
Click on "Add integration" button
-
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 ID in BTS': <project ID in bug tracking system>
'Authorization Type': ApiKey (predefined)
'ApiKey': <RALLY user apikey>
After you have created a connection with the RALLY project, you can choose predefined RALLY ticket fields. These fields will be shown to you all the time when you post the issue in the RALLY.
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:
-
Click on "Configure" button
-
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 all your projects will be able to submit issues in RALLY. 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 RALLY project.
Use case:
Situation: User wants to post to RALLY issues with type Defect and Task to the project NNN-MMM in RALLY. Is it possible? Yes!
Solution: Add two integrations to the project NNN-MMM in RALLY 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 RALLY integration
If you need to edit RALLY integration authorization parameters, please perform actions:
-
Log in as ADMIN
-
Go to Administrative > Plugins
-
Click on RALLY plugin panel
-
Click on a tab with existing integration
-
Click on "Edit authorization" link
-
Change "Integration name"
-
Type your RALLY 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 RALLY, please perform actions:
-
Log in as ADMIN
-
Go to Administrative > Plugins
-
Click on RALLY plugin panel
-
Click on a tab with existing integration
-
Click on "Configure" button
-
Choose issue type from the drop-down
-
Check the needed fields and fill them in if necessary
-
Click on "Submit" button
Remove global RALLY integration
If you need to remove RALLY integration, please perform actions:
-
Log in as ADMIN
-
Go to Administrative > Plugins
-
Click on RALLY plugin panel
-
Click on a tab with existing integration
-
Click on "Remove integration"
-
Submit the action
Project RALLY integration
Add new project RALLY integration
If any project needs different RALLY configurations, you should unlink a project from Global configurations and add a project configuration. It means that now when a new global integration is added to the ReportPortal, it won't be applied to the unlinked project.
For that,
-
Log in as an ADMIN or Project Manager
-
Go to Project Settings > Integrations
-
Click on the RALLY integration panel
-
Click on "Unlink and setup manually" button
-
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 ID in BTS': <project ID in bug tracking system>
'Authorization Type': Basic (predefined)
'BTS Username': <RALLY user name>
'BTS Password': <RALLY user password>
After you have created a connection with the RALLY project, you can choose predefined RALLY ticket fields. These fields will be shown to you all the time when you post the issue in the RALLY.
This feature gives you the ability to choose which type you will post a ticket with.
To choose a needed issue type and predefined field for the chosen issue, you should perform the following actions:
-
Click on "Configure" button
-
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 RALLY. Options for Post Issue / Link issue are activated.
You can add more integrations by clicking on "Add integration" button.
Reset to project RALLY Integrations
If you want to delete project integrations with RALLY and link your project with global configurations, please perform actions described below:
-
Log in as an ADMIN or Project Manager
-
Go to Project Settings > Integrations
-
Click on the RALLY integration panel
-
Click on "Reset to global settings" button
-
Confirm the action
Post issue to Rally
Posting an issue to Rally means to create a new issue in Rally from ReportPortal and upload logs and attachments from an execution.
If you want to post a new issue to Rally, you need to have a project or global integration with Rally.
Post issue via Step view
-
Log in to ReportPortal as Admin, PM, Member, Customer or Operator
-
Go to a Step view
-
Choose a needed item
-
Click on "Actions" button
-
Choose "Post issue" option
-
Fill in the "Post issue" form with valid data
`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)
`ApiKey`: user apikey
-
Submit the form
-
A new issue will be posted in BTS with information from ReportPortal
-
A label with issue ID will be added to the test item
Link an issue with an issue in Rally
Linking an issue with an issue in Rally means adding a clickable link to an existing issue in Rally from ReportPortal that will show a status of this issue.
Link issue via Step view
-
Log in to ReportPortal as Admin, PM, Member, Customer or Operator
-
Go to a Step view
-
Choose a needed item
-
Click on "Actions" button
-
Choose "Link issue" option
-
Fill in the "Link issue" form with valid data
`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
-
Submit the form
-
A label with issue ID will be added to the test item