Event filters
By default Webhook To Jenkins for Bitbucket notifies Jenkins on all git reference changes, pull requests creations and re-openings. If users would like to limit which of these events trigger Jenkins, they can do the following.
Go to Advanced Configuration > Limit Events and select which events you'd like to disable. Each event thats disabled will be highlighted in red.
Here's an explanation of each event:
| Event | Description |
|---|---|
| Pull Request Opened | Is fired whenever a pull request is opened. |
| Pull Request ReOpened | Is fired whenever a declined pull request is re-opened again. |
| Pull Request Approved | Is fired each time when reviewer(s) approves pull request. Disabled by default. |
| Pull Request Merged | Is fired after a pull request is merged. |
| Open Pull Request Refs Changed | Is fired when change happens to any git reference which is a base branch of at least one active Pull Request. This includes commits, pushes, edits, branch creations and more. Note, we filter out all reference deleted events. Doesn't fire when refs are modified in forked repository in back-merge Pull Request. |
| Non-Pull Request Refs Changed | The same as previous, but triggered for changes in references which do not participate in any active Pull Request. |
You can also hover on event name on configuration dialog to get quick in-place event description.
Additional filters
| Filter | Description |
|---|---|
| Trigger job if branch is deleted | Trigger build on branch deletion. Can be useful for cleanup with multi-branch pipeline job. |
| Trigger Pull Request only if mergeable | This is an additional filter which can be used together with event filters. When enabled, all configured Merge Checks will be respected (incl. 3rd-party ones), so that only mergeable PRs will be triggered when updated. |