Update User's Role Assignment In SharePoint Using JavaScript Object Model

Security management is a prime concern in SharePoint, as the right content has to be served to the right people with the adequate permissions. SharePoint recommends assigning role-based permissions. All the permissions are managed through the roles. Roles are classified into two sections:

• Role Definition and
• Role Assignment

Role definition, also known as a permission level, is the list of permissions, associated with the role. Full control, contribute, read, design, and limited access are some of the role definitions available. Role assignment is the relationship established between users/groups and the role definition. Hence, when we assign a role programmatically, it is a two-step process: instantiation of the role definition and an implementation of the role assignment to the user/group. You can check out, how to create a new role definition in this article.

Through this article, let’s see how we can add a role to user using JavaScript object model.

Internal Implementation

• Add the reference to jQuery file.
  
  1. <script language="javascript" type="text/javascript" src="//ajax.googleapis.com/ajax/libs/jquery/1.8.1/jquery.min.js"></script>
  2. <script language="javascript" type="text/javascript">
• Within the document ready function, call SP.SOD.executeFunc, so as to load the on demand script SP.js . Call the main starting point function, say: addRoleToUser.
  
  1. SP.SOD.executeFunc('sp.js', 'SP.ClientContext', addRoleToUser);
• Instantiate the client context and get the Web instance.
  
  1. var clientContext = new SP.ClientContext.get_current();
  2. var oWeb = clientContext.get_web();
• Once the Web object is retrieved, get the group to assign the role.
  
  1. //Get current user and role definition object
  2. var oUser = oWeb.get_currentUser();
• Get the role definition and role definition binding collection.
  
  1. var roleDef = oWeb.get_roleDefinitions().getByName("Custom Role Definition");
  2. var collRoleDefinitionBinding = SP.RoleDefinitionBindingCollection.newObject(clientContext);
• Get the role assignment collection for the target Web and assign the user; the new role definition binding collection.
  
  1. collRoleDefinitionBinding.add(roleDef);
  2. oWeb.get_roleAssignments().add(oUser, collRoleDefinitionBinding);
• Load the client context and execute the batch, which will send the request to the Server and perform the entire JavaScript object model operation as a batch.
  
  1. clientContext.executeQueryAsync(Succeeded,Failure);