User-Based Access to Tabs

Overview

With the Platinum release, you can now see or use the tabs on the contract page only if you have the necessary permissions to see or use it.

Each tab on the contract page corresponds to a single object. In every tab object, there is a new field added called Tab Visibility. Depending on the READ access to this field, the tab is either visible or hidden. Thus the Tab Visibility field is added to objects to control the visibility of the tabs on the CL Contract page based on the permissions set of the user who is using it.

What are the APIs that can be used to check the user-based access permissions?

The following APIs can be used to check the user-based access permissions:

• isAuthorizedToViewTab
• hasAccessToFeatureInvocation

isAuthorizedToViewTab

This global method validates if a user has access to view a tab.

It takes the following as input parameters:

• The object type whose tab you are checking.
• The API name of the field for the corresponding tab.
• The user-friendly name of the tab.

It returns the Result object with hasAuthorization and exceptionMessage set.

Tabs and their Corresponding Objects that are Modified for Visibility Control

The following is a list of the tabs and their respective objects that have the new field, Tab Visibility, in them:

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-Based Access to Tabs

Prerequisite

Before updating the user-based access to tabs, ensure that the following prerequisite is met:

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

  Note:

  For more information, see the Salesforce Setup > User Access Setting section of theQ2 Loan Servicing Administration Guide.

Steps

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

• Update the permissions by updating the object settings of the tab in the profile.
• Update the permissions by updating the Permission Sets and then assigning the user to it.

Update the Permissions by Updating the Object Settings of Tab in the Profile

To update the permissions of the Profile:

1. Go to (Setup) > Setup.

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

3. Click the required profile, such as System Administrator.

4. Click Object Settings.

   Profile > Object Settings

   

5. Search for the required object for the tab, for example, Brokers, and then click it.

   Brokers

   

6. Click Edit.

   The Brokers Object

   

7. Scroll down and Search for Tab Visibility and clear the Read Access checkbox corresponding to the Field Name, Tab Visibility.

   Note:

   By default, this checkbox is selected.

   The Tab Visibility Checkbox

   

8. Click Save.

   This disables the visibility of the Broker tab in the CL Contract page of the user.

   Broker Tab Not Visible After Tab Visibility is False

   

   Broker Tab Is Visible When Tab Visibility Is Enabled

   

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

If the required user 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 user. To do this:

Step 1: Create a Permission Set for that functionality.

Step 2: Update the Object Settings of the created Permission Set.

Step 3: Assign the user to the Permission Set.

Step 1: Create a Permission Set

To create a Permission Set:

1. Log in to your Salesforce Account.
2. Go to (Setup) > Setup.
3. In the Quick Find box, search for Permission Sets and then click it.
4. Click New.

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

   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.

   

Step 2: Update the Object Settings of the created Permission Set

1. Click Object Settings.

   Object Settings

   

2. Click the Object Name, for example, Disbursement Plans.

   Note:

   You can click any object name one after the other to include it in this Permission Set.

   Disbursement Plan

   

3. Click Edit.

   Edit Disbursement Plans Object

   

4. Scroll Down and search for the Tab Visibility field, and then clear the checkboxes Read Access and Edit Access corresponding to this field.

   Note:

   By default, they are not selected.

   Tab Visibility field of the Disbursement Plans object

   

5. Click Save.

Step 3: Assign the user to the Permission Set

1. Click Manage Assignments.

   Manage Assignments

   

2. Click Add Assignments.

   Add Assignments

   

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

4. Click Done.

   Assign the User

   

   This assigns this permission set to the selected user and the user will not be able to see the Disbursement Plans tab on the CL Contract page.

   Disbursement Plans Not Visible

   

   Disbursement Plan is Visible When Tab Visibility is enabled