This topic describes how to use automation rules in Projex to link collaboration activities with development tasks, such as code commits and merge requests.
Background
In Projex, you can use automation rules to link development activities, such as code commits and merge requests, to your work items. This automates state transitions for the work items and any associated objects.
Configure DevOps linkage
Link code commits with work item status
Scenario: When a commit containing a fix ID is associated with a work item, the status of the work item changes to Fixed.
Use keywords in code commit messages to trigger status or field changes in an associated work item.
In the Add Automation Rule dialog box, select the DevOps linkage category from the left pane. Set the trigger condition to When a code commit is associated with a bug, set the additional condition to and Description contains fixed#, and set the action to Change status to Fixed. Select automation rule as the execution account, and then click Add to Rule List.
Link merge requests with work items
Associating a merge request with a work item can change the work item's status or fields.
In DevOps linkage, click Add Automation Rule. Set the condition to "When a product requirement is associated with a merge request", and set the action to "Change status to In Progress". Select automation rule as the execution account, and then click Add to Rule List.
-
For template-level rules, you must configure a project-specific webhook in the code repository to enable the rule.
-
Merge request events require a webhook configuration in the corresponding code repository. Without a configured webhook, the rule will not execute.
In the left navigation pane, select DevOps linkage, and click Add Automation Rule. Set the condition to "When for a product requirement, all associated merge requests have a status of Approved", and set the action to "Change status to Completed". Select automation rule as the execution account, and then click Add to Rule List.
Link branches with work items
Associating a branch with a work item triggers a status or field update. In the Add Automation Rule dialog box, select the DevOps linkage type. Set the condition to "When a product requirement is associated with a branch", and set the action to "Change status to In Progress". Select automation rule as the execution account, and then click Add to Rule List.
Link test cases with work items
Associating a test case with a work item can change the work item's status or fields.
In the Add Automation Rule dialog box, select the DevOps linkage template from the left pane. Set the condition to "When a product requirement is associated with a test case", set the action to "Change status to In Testing", and then click Add to Rule List.