Flosum is excited to offer enhanced functionality in our Pull Request feature. The enhancements are available in package version 2.463 and later. Please contact your Customer Success Manager to schedule an upgrade to the latest version of Flosum.
What is a Pull Request?
A pull request is a feature that allows a Flosum user to request that a branch be reviewed by one or more team members. The feature is most commonly used for code reviews.
- Sending workflow notifications when a pull request has been approved or rejected.
- The ability to restrict which users can approve pull requests.
- Allowing users to be added to an existing pull request.
- The ability to require that a pull request be approved before merging, committing to the repository or adding to a deployment.
- An option to suspend or re-open a pull request.
How to create a Pull Request
Click the "Pull Request" button.
Then enter the details for this pull request.
In the Available Users section, only those users who have permission to review a pull request will be visible. Select one or more users. Then click "Create Pull Request".
When a pull request is created, an email will be sent to all selected reviewers. The reviewers can then click the link in the email approve or reject the pull request.
Whenever a reviewer approves or rejects a pull request, Flosum sends an email to the pull request owner. If the pull requests are mandated, an approved pull request will be required before the user is able to move forward in the application development process.
How to configure permissions
In this upgraded version of the feature, we have created four custom permissions:
1. Create Pull Request: This permission is required to create a pull request.
2. Disable/Enable Pull Request for the Branch: This permission is required to enable/disable a pull request for a branch. Pull requests are enabled or disabled by selecting or unselecting the “Enforce Pull Request at Branch” checkbox.
3. Review Pull Request: This permission is required to review a pull request and/or add new reviewers to a pull request. Only the users with this permission will be visible in the reviewer list when creating a pull request.
4. Update Pull Request: This permission is required to add new reviewers to a pull request.
There are two ways to assign these permissions to a user:
- By creating different permission sets for different users and assigning custom permission to these profiles.
- By creating different profiles for different users and assigning custom permission to these profiles.
For example, you could create 4 permission sets with the following names:
- Create a Pull Request
- Update Pull Request
- Review Pull Request
- Enable/Disable Pull Request
After creating these permissions, add custom permissions to these permission sets accordingly and assign these permissions sets to users.
Pull Request Settings
You can access the pull request settings on the Settings Tab.
You can now mandate that a pull request be approved before completing any of the following actions:
- Commit to Repository
- Add to Deployment
- Merge Branch
To ignore the pull request setting, you can select the “Ignore the pull request settings” radio button and then click "Save". To mandate pull requests, select “Mandate the pull request settings”. This will need to be done for each action.
To disable pull requests for a specific branch, a user with the appropriate permissions can select the "Disable/Enable Pull Request for the Branch” checkbox.
By selecting a function (ex. "Add to Deployment"), you can define which users are required to obtain an approved pull request before performing that function.
If pull requests are required and there is no pull request for the branch or the latest pull request is not approved, the user will not be able to perform that particular function.