User-Based Access to Loan Quick Menu

Overview

With the Platinum release, you can now see or use the Loan Quick Menu items on the contract page only if you have the necessary permissions to see or use it. The Loan Quick Menu items are rendered based on the permissions assigned to the user. If you use a global method to perform any Loan Quick Menu actions, the system notifies you of any error messages if there are insufficient permissions for that menu. 

What are the APIs that can be used to check if the user has the access to run a feature?

The following APIs can be used to check if the user has access to run a feature:

• isAuthorizedToUseFeature

• hasAccessToFeatureInvocation

isAuthorizedToUseFeature

This global method validates if a user has access to run a feature. It takes the custom permission name as an input parameter and returns the Result object with hasAuthorization and exceptionMessage set.

Custom Permission Names with Quick Menu Names

The following table lists the quick menu names that can be checked for user access with the help of their corresponding custom permission names:

hasAccessToFeatureInvocation

This web service checks if the permissions are granted for the features. It takes a comma-separated list of feature names as input and returns JSON representation of feature name to permission result map.

Update the User's Access Permissions to the Menu Items of the Loan Quick Menu

Prerequisite

Before updating the user-based access for Loan Quick Menu, ensure that the following prerequisite is met:

• Restrict Actions Based On Permissions flag is enabled in Setup > Custom Settings > User Access Setting.

  Note:

  For more information, see the User Access Setting section of the Q2 Loan Servicing Administration Guide.

Steps

You can update the user-based access permissions in the following two ways:

• Update the permissions by updating the custom permissions of the profile.

• Update the permissions by updating the Permission Sets and then assigning the user to it.

Update Permissions by Updating Custom Permissions of the Profile

To assign the Custom Permissions to the Profile of the user for access to the menu items of the Loan Quick Menu:

1. Log in to your Salesforce Account.

2. Go to(Setup) > Setup.

3. In the Quick Find box, search for Profile and then click it.

4. Click the required profile, and then click Custom Permissions.

5. Click Edit.

6. Add the required permission by selecting the item in the Available Custom Permissionsbox and then clicking Add.

   Adding Permission for Reschedule

   Reschedule added in Enabled Custom Permissions

7. ClickSave.

   This adds the required permissions to the profile and the menu will be visible in the Loan Quick Menu.

   Loan Quick Menu

Update the permissions by updating the Permission Sets and then assigning the user to it

If the required profile is to be given access to a certain functionality only, then all the UI elements of only that particular functionality need to be enabled for the profile. To do this:

Step 1: Create a Permission Set for that functionality.

Step 2: Add custom permissions to the created Permission Set.

Step 3: Assign the user to the custom Permission Set.

Step 1: Create a Permission Set for that functionality

1. Go to (Setup) > Setup.

2. In the Quick Find box, search for Permission Sets, and then click it.

   Permission Sets

3. Click New.

4. Provide the details as described in the following table, and then click Save:

   Note:

   You can refer to the Create New Permission Set image as an example.

   Field	Action and Description
   Label	Provide a label name for the object to correctly identify the function of the permission set to be created. This field is mandatory.
   API Name	This field gets updated automatically, but you can update it too. Note: This is a unique name used by the API. This name must begin with a letter and use only alphanumeric characters and underscores. It can't include spaces, end with an underscore, or have two consecutive underscores.
   Description	Provide a description to explain the usage of this permission set.

   The newly created Permission Set for Redraw is added to the list of Permissions Sets.

5. Click Permission Set for Redraw.

   Permission Set for Redraw

Step 2: Add custom permissions to the created Permission Set

1. After clicking the preceding created Permission Set, scroll down and click Custom Permissions.

   Permission Sets > Custom Permissions

2. Click Edit.

3. Select all the Available Custom Permissions for the Redraw-related functionality, and then click Add.

   Add Available Custom Permissions

4. Click Save.

Step 3: Assign the user to the Permission Set

1. After adding the Custom Permissions to the Permission Set in the preceding step, click Manage Assignments.

   Manage Assignments

2. Click Add Assignments.

3. Select the user to assign this permission set to, and then click Assign.

4. Click Done.

   This enables the user of the profile to use only the Redraw-related UI menu as highlighted in the following image, however, the user does not have the permissions to use any other UI menu items of the Loan Quick Menu:

   Note:

   Even if the user does not have permission to use the menu in Custom Permissions, but if the user has been assigned to the permission set, then the menu is available for the user.

   Only Redraw-Related Menu Items Available in Loan Quick Menu

   No Permission to Use Other Menu Items of Loan Quick Menu