Monday
To install the Monday plugin, see Upload plugin section.
Integration with the Monday Bug Tracking System (BTS) can be helpful for projects which are already using Monday BTS as a tracking tool. The integration provides an exchange of information between our test results reporting service and the Monday Server, such as posting issues and linking issues, getting updates on their statuses.
Admin, Manager, and user with edit permissions can create/edit/delete Monday integration.
User with view permissions can only view the list of available integrations.
Monday BTS integration can be configured on the global level (for all projects on the instance) or on the project level (only for one project).
Global Monday BTS integration
Add new global Monday BTS integration
You might want to configure global integrations which will be applied on all projects if all projects in your instance are using the same Monday BTS projects.
- Log in to ReportPortal as Admin.
- Navigate to Instance plugins page.
- Click on "Monday" 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>
'Board ID in BTS': <board ID in bug tracking system>
'API Token': <your personal Access Token from Monday>
How to find API Token in Monday:
- Click on the user icon at the top right corner.
- Open ‘Developers’ section.
- Open ‘My access tokens’ tab.
After you have created a connection with the Monday project, you can choose predefined Monday ticket fields. These fields will be shown to you all the time when you post the issue in Monday.
Now team members on all your projects will be able to submit issues in Monday. Options for Post Issue/Link issue are activated.
You can add more integrations by clicking on ‘Add integration’ button.
Update global Monday BTS integration
If you need to edit Monday BTS integration parameters, perform actions described below:
- Log in to ReportPortal as Admin.
- Navigate to Instance plugins page.
- Click on "Monday" panel.
- Click on the tab with existing integration.
- Click on ‘Edit’ icon.
- Change ‘Integration name’.
- Type your API Token.
- Click ‘Save’ button.
If you need to edit fields which should be posted in Monday BTS, perform actions described below:
- Log in to ReportPortal as Admin.
- Navigate to Instance plugins page.
- Click on "Monday" panel.
- Click on the tab with existing integration.
- Click on ‘Edit’ button in Configuration section.
- Check the needed fields and fill them in if necessary.
- Click on ‘Submit’ button.
Remove global Monday BTS integration
If you need to remove Monday BTS integration, perform actions described below:
- Log in to ReportPortal as Admin.
- Navigate to Instance plugins page.
- Click on "Monday" panel.
- Click on the tab with existing integration.
- Click on ‘Remove’ icon.
- Click ‘Delete’ button.
Project Monday BTS integration
Add new project Monday BTS integration
If any project needs different Monday BTS configurations, you can add a project configuration. This means that when a new global integration is added, 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 "Monday" panel.
- Click on ‘Add Project Integration’ button.
- Fill in the necessary fields and 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>
'Board ID in BTS': <board ID in bug tracking system>
'API Token': <your personal Access Token from Monday>
After you have created a connection with the Monday project, you can choose predefined Monday ticket fields. These fields will be shown to you all the time when you post the issue in Monday.
Now team members on this project will be able to submit issues in Monday. Options for Post Issue/Link issue are activated.
You can add more integrations by clicking on ‘Add Project Integration’ button.
Post issue to Monday BTS
Posting an issue to Monday BTS means creating a new issue in Monday BTS from ReportPortal.
If you want to post a new issue to Monday BTS, you need to have a project or global integration with Monday.
Post issue via Step view
- Log in to ReportPortal as Admin, Manager, or user with edit permissions.
- Go to a Step view.
- Click on the pencil icon near a needed item to open ‘Make decision’ modal.
- Set defect type, add comment, select ‘Post issue’ option and then ‘Apply & Continue’.
- Fill in the ‘Post issue’ form with valid data.
- Click ‘Post issue’ button.
A new issue will be posted in Monday BTS with information from ReportPortal.
A label with issue ID will be added to the test item.
Link an issue with an issue in Monday BTS
Linking an issue with an issue in Monday BTS means adding a clickable link to an existing issue in Monday BTS from ReportPortal that will show a status of this issue.
Link issue via Step view
- Log in to ReportPortal as Admin, Manager, or user with edit permissions.
- Go to a Step view.
- Click on the pencil icon near a needed item to open ‘Make decision’ modal.
- Select ‘Link issue’ option and then ‘Apply & Continue ’.
- Fill in the ‘Link issue’ form with valid data.
- Click ‘Link issue’ button.
A label with issue ID will be added to the test item.
Unlink an issue in Monday BTS
You can also unlink an issue.
- Click on the ‘remove’ icon.
- Click ‘Unlink Issue’.
The link to the issue in Monday BTS is removed.