Workzone’s automated pull request merge control is easy and straightforward to configure by defining some simple merge conditions:
For a simple merge condition all or a subset of the following criteria are AND combined to allow a merge to happen or block it:
- Reviewers approval quota/count – how many percent or number of reviewers must approve.
- Reviewers group quota – how many members of a reviewer group must approve
- Required mandatory approvals – How many approvals must be given from mandatory reviewers
- Required digital signatures – how many approvals must have a digital signatures for CFR Part 11 compliance
- Required successful builds – how many successful build results must be associated with the pull request’s source branch HEAD
Advanced Merge Conditions #
Often the required merge condition can’t be expressed in a simple AND combination. Workzone features a powerful boolean expression parser that allows you to configure any boolean merge condition using the above criteria.
Use ‘approvalQuota‘, ‘groupQuota‘, ‘approvalCount‘, ‘mandatorApprovalCount‘, ‘requiredBuildsCount‘, ‘requiredSignaturesCount‘ and ‘< > = ( )‘ to build an expression. For example
"requiredBuildsCount > 1 & ( approvalQuota >= 50% | groupQuota >= 2 ) &
requiredSignaturesCount > 2"
The pull request will be automatically merged if: more than 2 digital signature and more than 1 successful build and 50% or more of reviewers have approved
OR
More than 2 digital signature and more more than 1 successful build and 2 or more members per reviewer-group have approved.
Set required file/path approvals in reviewer configuration #
File/Path quotas will be evaluated as merge-checks along with all other Workzone merge conditions for matching pull requests.