Pnp-JS-Core: Create SharePoint Group

PnP-JS-Core library contains the number of extensible methods and properties. By using that we can achieve the various actions in a simple code. To know more about this library component, visit the below links,

• Simplified JavaScript Library for SharePoint
• PnP-JS-Core Library

SharePoint has lot of building blocks in collections which are used to form a SharePoint site. Those are used in manage the contents, generate reports based on contents & settings, etc…

In this post,

How to create a SharePoint Site Group using PnP JavaScript Library.

Syntax:

pnp.sp.web.siteGroups.add(GroupWriteableProperties) - 
Add a new Site Group to the SharePoint site collection based on parameters provided in GroupWritableProperties

GroupWritableProperties:

Note: Title property is mandatory in creating a Site Group and other properties are optional.

Example:

The below steps and code snippets used to new site group to the SharePoint Site Collection using PnP JavaScript library,

1. Download Required files to use PnP-JS-Core library from the below links and upload that to Site Asstes or Style Library
   • Download pnp.js  PnP JS file
   • Download fetch.js Used by PnP js file to handle web requests and responses (Required in IE)
   • Download promise.js Used by PnP js file to handle web requests and responses (Required in IE)
2. Create new web part page and insert Content Editor web part
3. Create a sample.html file in Site Assets or Style library and insert the below code snippet

Create Site Group using Title property

[code language=”js” wraplines=”true”]
<script type="text/javascript" src="/siteassets/scripts/fetch.js"></script>
<script type="text/javascript" src="/siteassets/scripts/promise.min.js"></script>
<script type="text/javascript" src="/siteassets/scripts/pnp.min.js"></script>

<div id="sample"></div>

<script type="text/javascript">
//The below PnP property used to create a new SharePoint Group
$pnp.sp.web.siteGroups.add({
Title: "Group Name"
}).then(function(result) {
var grpInfo = "";
var grp = result.data;
grpInfo += "SharePoint Group ‘<strong>" + grp.Title + "</strong>’ created successfully!<br/>";
grpInfo += "Below are some of the newly created group properties,<br/>";
grpInfo += "Description :" + grp.Description; + "<br/>";
grpInfo += "AllowMembersEditMembership: " + grp.AllowMembersEditMembership + "<br/>";
grpInfo += "OnlyAllowMembersViewMembership: " + grp.OnlyAllowMembersViewMembership + "<br/>";
grpInfo += "AllowRequestToJoinLeave: " + grp.AllowRequestToJoinLeave + "<br/>";
grpInfo += "AutoAcceptRequestToJoinLeave: " + grp.AutoAcceptRequestToJoinLeave + "<br/>";
grpInfo += "RequestToJoinLeaveEmailSetting: " + grp.RequestToJoinLeaveEmailSetting + "<br/>";

document.getElementById("sample").innerHTML = grpInfo
});
</script>
[/code]
Click here to get this code snippet from my github page

Create Site Group using Title and additional properties

[code language=”js”]

$pnp.sp.web.siteGroups.add({
Title: "Group Name 2",
Description: "My description for the new group",
AllowRequestToJoinLeave: true,
AutoAcceptRequestToJoinLeave: true,
RequestToJoinLeaveEmailSetting: "myname@email.com",
AllowMembersEditMembership: true,
}).then(function(result) {
samgrp = result.data;
var grpInfo = "";
var grp = result.data;
grpInfo += "SharePoint Group ‘<strong>" + grp.Title + "</strong>’ created successfully!<br/>";
grpInfo += "Below are some of the newly created group properties,<br/>";
grpInfo += "Description :" + grp.Description; + "<br/>";
grpInfo += "AllowMembersEditMembership: " + grp.AllowMembersEditMembership + "<br/>";
grpInfo += "OnlyAllowMembersViewMembership: " + grp.OnlyAllowMembersViewMembership + "<br/>";
grpInfo += "AllowRequestToJoinLeave: " + grp.AllowRequestToJoinLeave + "<br/>";
grpInfo += "AutoAcceptRequestToJoinLeave: " + grp.AutoAcceptRequestToJoinLeave + "<br/>";
grpInfo += "RequestToJoinLeaveEmailSetting: " + grp.RequestToJoinLeaveEmailSetting + "<br/>";

document.getElementById("sample").innerHTML = grpInfo
});

[/code]
Click here to get this code snippet from my github page

4. Add the URL of sample.html file to the content editor web part
5. Click ok to apply the changes to the web part and save the page.
6. Now the page displays the success message with the newly created group information.

Output: