Working With SharePoint Site Collection Features Using REST API

Introduction

In this article, you will learn how retrieve, enable or disable the site collection features (site scoped) programmatically using REST API on SharePoint 2013 / SharePoint online. There are different ways that we use to work with site collection features. We will see how we can use REST APIs to achieve the functionalities.

Steps Inolved

• Identify the site collection URL and build the REST API URL.
  
  
• In the URL, site denotes the site collection scope and set the necessary parameters to filter out the data. You need to provide select parameters to get the necessary feature properties in get request.
  
  
• Use Ajax jQuery call to accomplish the necessary operation.
  
  
• You can set the return value type in the ajax call request. In my case, I have specified JSON to be return value in the data parameter.
  
  
• In these cases, You can check the result values in browser debugger console. You can change the logic to display results on pages.
  
  
• Place these scripts on page using the web parts (content editor / script editor / any custom web part).

• In the URL, select parameters has necessary properties to be retrieved.
  
  
• Using foreach loop, get and display the results.
• 1. // Retrieves all the site collection features enabled (site scoped features)
  2. function GetSiteCollectionFeatures(){
  3. var featuresURI = sitecollectionURL + "/_api/site/features?$select=DisplayName,DefinitionId";
  4. $.ajax({
  5. url: featuresURI,
  6. method: 'GET',
  7. headers: { "Accept": "application/json; odata=verbose" },
  8. dataType: "json",
  9. success: function (data) {
  10. var siteCollectionFeatures = data.d.results;
  11. for(var i=0;i<siteCollectionFeatures.length;i++){
  12. console.log(siteCollectionFeatures[i].DefinitionId + " - " + siteCollectionFeatures[i].DisplayName);
  13. }
  14. },
  15. error: function(data) {
  16. }
  17. });
  18. }

Get/Check Site Collection Feature Properties/Status (Site scope)

Here we will see how we can get the particular feature and check whether the site collection feature is active or not. You can identify whether the feature is activated at site scope or not.

• Get the feature id from the Microsoft site. The scope of the feature should be site.
  
  
• Get the feature using GetById method with feature id in the REST API.
  
  1. // Retrieves the site collection feature by id enabled (site scoped features)
  2. function GetSiteCollectionFeatureByID(){
  3. var featuresURI = sitecollectionURL + "/_api/site/features/GetByID('151d22d9-95a8-4904-a0a3-22e4db85d1e0')?$select=DisplayName,DefinitionId";
  4. // Cross-Site Collection Publishing Feature ID
  5. $.ajax({
  6. url: featuresURI,
  7. method: 'GET',
  8. headers: { "Accept": "application/json; odata=verbose" },
  9. dataType: "json",
  10. success: function (data) {
  11. if(data.d != null){
  12. console.log(data.d.DefinitionId + " - " + data.d.DisplayName + " feature is active");
  13. }
  14. else{
  15. console.log("Feature is not active");
  16. }
  17. },
  18. error: function(data) {
  19. }
  20. });
  21. }