Pages

Showing posts with label Rating. Show all posts
Showing posts with label Rating. Show all posts

Friday, August 26, 2011

Working with SharePoint Ratings – Part 2

How to enable and disable SharePoint 2010 rating programmatically

If you have referred the details in the previous post on Working with the SharePoint 2010 Rating – Part 1 for theoretical explanation on what happens in the background, now let’s do something interesting in Visual Studio.
When you visit the list settings page and click on rating settings link , you gets redirected the application page called as “RatingSettings.aspx” with the query string as the list GUID and on this page you can decide the setting about enabling and disabling ratings on that list.
I didn’t see any other way to achieve this with programmatic approach in the server object model in SPList class and so for curiosity I opened up the reflector to see what Microsoft has done.
And so here are the ways to programmatically enable the ratings on list
1.       Using the reflection
typeof(Microsoft.SharePoint.Portal.RatingsSettingsPage).
GetMethod("EnableRatings", System.Reflection.BindingFlags.Static | System.Reflection.BindingFlags.NonPublic).
Invoke(null, new object[] { _objectofSPList, true });

There is a method “EnableRatings” in class “RatingSettingsPage” and method is internal and static. So I am just invoking the method here. This method takes two parameters.
a.    object of SPList on which you need to enable the ratings
b.    a Boolean value (true/false) – keep true to prorogating rating on list items
There is one more method of this class, which allows us to disable the rating
typeof(Microsoft.SharePoint.Portal.RatingsSettingsPage).
GetMethod("DisableRatings", System.Reflection.BindingFlags.Static | System.Reflection.BindingFlags.NonPublic).
Invoke(null, new object[] { _objectOfSPList });

This method accepts a single parameter which is as the SPList and this is the target list.
2. Using the actual code
      Rating can also be enabled without using the reflection, but in this case you write much more code than in previous method.
This method is used for enabling the rating settings on a list. You can see that there are two fields which are being add in the list.
  private void EnableRatingSetting(SPList _list)
  {
    SPFieldCollection _allfields = _list.Fields;
    SPFieldCollection _availFields = _list.ParentWeb.AvailableFields;
    if (!_allfields.Contains(FieldId.AverageRatings))
    {
       SPField field = _availFields[FieldId.AverageRatings];
_list.Fields.AddFieldAsXml(field.SchemaXmlWithResourceTokens, true, SPAddFieldOptions.AddFieldToDefaultView | SPAddFieldOptions.AddFieldInternalNameHint | SPAddFieldOptions.AddToAllContentTypes);
    }
    if (!_allfields.Contains(FieldId.RatingsCount) && _availFields.Contains(FieldId.RatingsCount))
    {
      SPField field2 = _availFields[FieldId.RatingsCount];
      _list.Fields.AddFieldAsXml(field2.SchemaXmlWithResourceTokens, false, SPAddFieldOptions.AddFieldInternalNameHint | SPAddFieldOptions.AddToAllContentTypes);
    }
      _list.Update();

   }

And this is the method to propagate the changes to the list items.
There is a method available with the SocialRatingManager class called as PropogateRating which takes care of this.
private void PropogateChanges(SPList _list)
{
SocialRatingManager _socialRatingMgr = new   SocialRatingManager(SPServiceContext.Current);
   string _baseUrl = _list.ParentWeb.Url;
   if (_baseUrl.EndsWith("/", StringComparison.OrdinalIgnoreCase))
   {
      _baseUrl = _baseUrl.TrimEnd(new char[] { '/' });
   }
   foreach (SPListItem item in _list.Items)
   {
     string _itemUrl = item.Url;
     if (_itemUrl.StartsWith("/", StringComparison.OrdinalIgnoreCase))
     {
        _itemUrl = _itemUrl.TrimStart(new char[] { '/' });
     }
     SPSecurity.RunWithElevatedPrivileges(delegate()
     {
        _socialRatingMgr.PropagateRating(new Uri(_baseUrl + "/" + _itemUrl));
     });
    }

   }

   private static SPField GetField(Guid id, SPFieldCollection fieldColl)
   {
      return fieldColl[id];
   }

This method is used to disable the rating on a list
private void DisableRatingSetting(SPList _list)
    {
       SPField _field1 = GetField(FieldId.AverageRatings, _list.Fields);
       if (_field1 != null)
       {
         _list.Fields.Delete(_field1.InternalName);
       }
       SPField _field2 = GetField(FieldId.RatingsCount, _list.Fields);
       if (_field2 != null)
       {
          _list.Fields.Delete(_field2.InternalName);
       }
        _list.Update();

    }

Thursday, August 25, 2011

Working with SharePoint Ratings – Part 1

Recently I was doing some R&D with the SharePoint Ratings and so thought to share my thoughts.
As we know that with the launch of SharePoint 2010 version, we got new social features like content tagging and content rating. For content ratings, we can rate the different contents in the list and libraries in range of 0 to 5.
For example: I have a publishing site and the pages library, so I need to have functionality such that the end users should be able to rate the pages inside the pages library.
How to do this?
For any list or library, there is a link to set the rating capability. When you go to the List and then in its settings, there you can see the link named as “Rating Settings”. After you click on that, a page opens where you can enable and disable this setting.
Ok so far so good. ? But what happens in the background?
Well, I have observed that when you enable ratings on any list or library, the two Site Columns/Fields gets added to the SharePoint list. Obviously those get added to hold this rating as a metadata.
Which are those fields?
Field names are:
    Display Name                          Internal Name                                        GUID
1. Rating (0-5)                           AverageRating               {5a14d1ab-1513-48c7-97b3-657a5ba6c742}        
2. Number of Ratings                  RatingCount                   {b1996002-9167-45e5-a4df-b2c41c6723c7}         

And here is the screen shot after enabling the rating on pages list



Rating is the asynchronous event and we talk about social features, they gets saved in social database which gets created when you have activated the user profile service application. So in short, to use rating you should have a user profile service running in your farm.
There is one timer job “User Profile Service Application – Social Rating Synchronization” job which by default runs after every hour and aggregates all the ratings.


Why ratings disappear after page refresh?
I was also puzzled by a question that when we try to rate a page in pages library and then refresh the page, ratings given were disappearing. Why?
So answer is the Timer Job. As this job runs every hour, so unless and until the job has run and aggregated the ratings, we don’t see the ratings which were given. So I changed the job schedule to run every minute to have immediate effects.
But wait, there might be the case that If you have provisioned all the sites hierarchies very fine in the production environment and now request is to enable the ratings on all the lists and libraries in each site and subsites. Of course not manually right? So How to do that?
Yes you are right, you can write a feature, or a console application or any other approach which will enable rating setting recursively on each list and library within the site.
But again question now is how to do this programmatically?
I will be posting this in part 2 of this post.