New SharePoint CSOM version released for SharePoint Online - February 2017

We are happy to announce availability of new SharePoint Client Side Object Model (CSOM) version targeted for the Office 365 or more specifically for SharePoint and Project Online. This release again contains few updates on the existing SharePoint CSOM assemblies and some maintenance changes. Key changes in this release is the updates around the CSOM alert APIs.

You can find the latest CSOM package for SharePoint Online, including the Project Online CSOM assembly, from the NuGet gallery with an id of ‘Microsoft.SharePointOnline.CSOM‘. We are also working on updating the redistributable package at some point, but you can already right now start using some of these new capabilities in your solutions. We do recommend you to use the NuGet Package to gain access on latest version, rather than downloading the SDK to your machine.

Version of the newly released CSOM package is 16.1.6216.1200. Previous versions of the NuGet have not been removed, so that your existing solutions will continue working without issues and you can decide when the new version is taken into use. Notice that even though the Nuget version is increased to 16.1.6216.1200, actual assembly version of the released assemblies is 16.1.0.0. You can also check the version of the assemblies from the File Version attribute, which aligns with the NuGet version.

Screenshot of the CSOM NuGet package at Visual Studio Nuget Gallery view

SharePoint Online Management Shell will be also updated around the 1st of March to match on the CSOM version. We are also working on getting the MSDN reference API documentation updated with the latest release with additional documentation on new APIs, so that you can more easily see all the latest and supported APIs for SharePoint Online.

Notice that since this NuGet package is targeted to SharePoint Online, you cannot use it directly in on-premises environments (SharePoint 2013 or 2016). This is because of the server side dependencies of the APIs. CSOM versioning model and dependency to your target environment is clarified in following blog post – Using correct Client Side Object Model (CSOM) version for SharePoint customizations. We have released separate NuGet packages for on-premises. See following blog post for additional details – SharePoint CSOM versions for on-premises released as NuGet packages.

Creating Alerts using CSOM

We released original support for creating Alerts in the SharePoint Online with the January 2017 release of the CSOM, but unfortunately this release had a bug related on the defining the alert details and only way you could create them, was not optimal, like explained in Todd Baginski’s blog post. Here’s updated example on how to create Alerts using CSOM in SharePoint Online.


   // Load needed information from SharePoint Online
   User currentUser = ctx.Web.CurrentUser;
   ctx.Load(currentUser);
   ctx.Load(currentUser.Alerts);
   ctx.Load(currentUser.Alerts,
       lists => lists.Include(
           list => list.Title,
               list => list.ListID));

   ctx.ExecuteQuery();

   // Create new alert using CSOM for the user
   AlertCreationInformation newAlert = new AlertCreationInformation();
   newAlert.List = ctx.Web.Lists.GetByTitle("Documents");
   newAlert.AlertFrequency = AlertFrequency.Daily;
   newAlert.AlertTime = DateTime.Today.AddDays(1);
   newAlert.AlertType = AlertType.List;
   newAlert.AlwaysNotify = false;
   newAlert.DeliveryChannels = AlertDeliveryChannel.Email;
   newAlert.Status = AlertStatus.On;
   newAlert.Title = "New alert created at : " + DateTime.Now.ToString();
   newAlert.User = currentUser;
   newAlert.EventType = AlertEventType.All;
   newAlert.Filter = "0"; 
   // 0 = Anything Changes
   // 1 = Someone else changes a document
   // 2 = Someone else changes a document created by me
   // 3 = Someone else changes a document modified by me

   // add the alert for the user
   var newAlertGuid = currentUser.Alerts.Add(newAlert);
   currentUser.Update();
 
   //Execute creation request to the SPO
   ctx.ExecuteQuery();