Teams
Stay up to date with real-time test results delivered directly to your Microsoft Teams channel.
This is a premium feature.
Configuration on the Microsoft Teams side
Create a team and a channel in Microsoft Teams where you want to receive notifications.
Then, create a webhook for the channel:
- Open the target channel in Microsoft Teams.
- Select "More channel options" (...) next to the channel name.
- Select "Workflows".
- Search for and select the "Send webhook alerts to a channel" template.
- Select the team and channel.
- Copy the generated webhook URL.
Webhook can be used to create notification rules in ReportPortal.
Configuration on ReportPortal side
Upload plugin
- Log in to ReportPortal as Admin.
- Navigate to Plugins page.
- Click "Upload" button at the top of the page.
- Add .jar file and click "Upload" button.
Create notification rule
- Go to the Project settings -> Notifications.
- Choose Teams Notification Group.
- Click "Create Rule" button.
- Fill the form:
Rule name – from 1 to 55 characters, mandatory field. The name must be unique per plugin.
Webhook URL – mandatory field (it is configured on the Microsoft Teams side).
In case – optional field, dropdown with the options:
- Always – notification will be sent in any case.
- 10% of items have issues – notification will be sent, if more than 10% of items have issues.
- 20% of items have issues – notification will be sent, if more than 20% of items have issues.
- 50% of items have issues – notification will be sent, if more than 50% of items have issues.
- Launch has issues – notification will be sent, if at least 1 item has issues
- Launch has "To Investigate" items – notification will be sent, if at least 1 item has "To Investigate"
Launch names – optional field
You can select only existing launch name. The field allows multi select.
Attributes – optional checkbox
When the "Attributes" checkbox is checked, you can provide key/value for attributes and select the necessary radio button:
- "All attributes should match"
- "Any attribute should match"
- Click on "Create" button.
Admin, Manager, and user with edit permissions can create, update, delete, and duplicate Teams notification rules.
User with view permissions can view the list of rules.
You can edit, copy, enable, or disable a notification rule by clicking the appropriate controls on the rule.
How to receive notifications in Teams
When you have the plugin installed and Teams notification rules configured, you can start receiving notifications to the channel configured. For this you need to report a launch which matches the notification rule and after the launch is finished you will receive a corresponding message in the Teams channel with details on the Launch results, including:
- Launch name and number of execution
- Start time and finish time
- ID and UUID
- Description
- Attributes
- Execution statistics
- Defect statistics
- Link to open the launch in ReportPortal
Disable Teams notifications
- Go to the Project settings -> Notifications.
- Turn OFF for Teams.
Disable plugin
- Log in to ReportPortal as Admin.
- Navigate to Instance plugins page.
- Find Teams plugin.
- Click the toggle to turn it off.
Uninstall plugin
- Log in to ReportPortal as Admin.
- Navigate to Instance plugins page.
- Find Teams plugin and click on it.
- Click "Uninstall" button and confirm your choice.