August 4th, 2016

New SharePoint CSOM version released for SharePoint Online – August 2016

Vesa Juvonen
Principal Program Manager

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. There’s quite a lot of new classes and APIs especially in the Project side. 

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.

Notice that since this NuGet package is targeted to SharePoint Online, you cannot not 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 are looking into moving to monthly cadence around CSOM Nuget updates with locked and consistent release dates. This monthly schedule should start by end of September with known CSOM updates on every 4th Friday of the month. This will mean that you can plan your own activities accordingly based on the delivery dates. 

Version of the newly released CSOM package is 16.1.5521.1200. Previous versions of the NuGet has 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.5521.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 Nuget gallery UI in Visual Studio 2015 with CSOM Nuget package selected

If you like to operate with SharePoint Online rather using PowerShell, we are also looking to update the SharePoint Online Management Shell during upcoming days. Documentation for SharePoint Online Management Shell will be updated accordingly based on the changes in latest version.

New properties and methods cross assemblies

Here’s a raw list of all the changes in the classes, properties and methods within this package. 

Microsoft.SharePoint.Client

  • public property Microsoft.SharePoint.Client.AppTile.LastModifiedDate
  • public property Microsoft.SharePoint.Client.ChangeItem.ListTemplate
  • public property Microsoft.SharePoint.Client.ChangeList.Editor
  • public class Microsoft.SharePoint.Client.FlowSynchronizationResult
  • public enum Microsoft.SharePoint.Client.FlowSynchronizationStatus
  • public method Microsoft.SharePoint.Client.HashtagStoreManager.GetBlockedHashtags
  • public method Microsoft.SharePoint.Client.HashtagStoreManager.SetBlockedHashtags
  • public method Microsoft.SharePoint.Client.List.SyncFlowInstances
  • public method Microsoft.SharePoint.Client.List.SyncFlowTemplates
  • public method Microsoft.SharePoint.Client.ListItem.SetComplianceTagWithHold
  • public method Microsoft.SharePoint.Client.ListItem.SetComplianceTagWithNoHold
  • public property Microsoft.SharePoint.Client.Site.Classification
  • public property Microsoft.SharePoint.Client.Site.GroupId
  • public property Microsoft.SharePoint.Client.Site.StatusBarLink
  • public property Microsoft.SharePoint.Client.Site.StatusBarText
  • public property Microsoft.SharePoint.Client.Web.TenantTagPolicyEnabled

Following properties and methods were also removed from the API. These were not mean to be visible with the previous release and since they really do not have specific functionality currently, removal should not have any impact on your solution.

  • public method Microsoft.SharePoint.Client.List.CreateAppView
  • public method Microsoft.SharePoint.Client.List.EnsureAppViewInfo
  • public method Microsoft.SharePoint.Client.List.PublishAppView
  • public method Microsoft.SharePoint.Client.List.UnpublishAppView
  • public method Microsoft.SharePoint.Client.ListItem.AddHashTag

Microsoft.Online.SharePoint.Client.Tenant

  • public method Microsoft.SharePoint.Client.Taxonomy.TermSet.GetAllTermsIncludeDeprecated
  • public property Microsoft.Online.SharePoint.TenantAdministration.SiteProperties.SharingAllowedDomainList
  • public property Microsoft.Online.SharePoint.TenantAdministration.SiteProperties.SharingBlockedDomainList
  • public property Microsoft.Online.SharePoint.TenantAdministration.SiteProperties.SharingDomainRestrictionMode
  • public method Microsoft.Online.SharePoint.TenantAdministration.Tenant.AddPublicCdnOrigin
  • public property Microsoft.Online.SharePoint.TenantAdministration.Tenant.BlockAccessForUnmanagedDevices
  • public property Microsoft.Online.SharePoint.TenantAdministration.Tenant.DefaultSharingLinkType
  • public property Microsoft.Online.SharePoint.TenantAdministration.Tenant.PreventExternalUsersFromResharing
  • public property Microsoft.Online.SharePoint.TenantAdministration.Tenant.PublicCdnAllowedFileTypes
  • public property Microsoft.Online.SharePoint.TenantAdministration.Tenant.PublicCdnEnabled
  • public property Microsoft.Online.SharePoint.TenantAdministration.Tenant.PublicCdnOrigins
  • public method Microsoft.Online.SharePoint.TenantAdministration.Tenant.RemovePublicCdnOrigin
  • public property Microsoft.Online.SharePoint.TenantAdministration.Tenant.ViewOnlyForGuests
  • public property Microsoft.Online.SharePoint.TenantAdministration.Tenant.ViewOnlyForUnmanagedDevices
  • public method Microsoft.Online.SharePoint.TenantManagement.Office365Tenant.AddPublicCdnOrigin
  • public property Microsoft.Online.SharePoint.TenantManagement.Office365Tenant.BlockAccessForUnmanagedDevices
  • public property Microsoft.Online.SharePoint.TenantManagement.Office365Tenant.DefaultSharingLinkType
  • public property Microsoft.Online.SharePoint.TenantManagement.Office365Tenant.PreventExternalUsersFromResharing
  • public property Microsoft.Online.SharePoint.TenantManagement.Office365Tenant.PublicCdnAllowedFileTypes
  • public property Microsoft.Online.SharePoint.TenantManagement.Office365Tenant.PublicCdnEnabled
  • public property Microsoft.Online.SharePoint.TenantManagement.Office365Tenant.PublicCdnOrigins
  • public method Microsoft.Online.SharePoint.TenantManagement.Office365Tenant.RemovePublicCdnOrigin
  • public property Microsoft.Online.SharePoint.TenantManagement.Office365Tenant.ViewOnlyForGuests
  • public property Microsoft.Online.SharePoint.TenantManagement.Office365Tenant.ViewOnlyForUnmanagedDevices

Following properties and methods were also removed from this API. 

  • public property Microsoft.Online.SharePoint.TenantAdministration.Tenant.AllowExternalUsersToReshare
  • public property Microsoft.Online.SharePoint.TenantManagement.Office365Tenant.AllowExternalUsersToReshare

Microsoft.ProjectServer.Client

  • public class Microsoft.ProjectServer.Client.Engagement
  • public class Microsoft.ProjectServer.Client.EngagementComment
  • public class Microsoft.ProjectServer.Client.EngagementCommentCollection
  • public enum Microsoft.ProjectServer.Client.EngagementContourType
  • public class Microsoft.ProjectServer.Client.EngagementCreationInformation
  • public class Microsoft.ProjectServer.Client.EngagementSaveConflictException
  • public enum Microsoft.ProjectServer.Client.EngagementStatus
  • public class Microsoft.ProjectServer.Client.EngagementTimephasedPeriod
  • public class Microsoft.ProjectServer.Client.EngagementTimephasedPeriodCreationInformation
  • public class Microsoft.ProjectServer.Client.ProjectEngagement
  • public class Microsoft.ProjectServer.Client.ProjectEngagementCollection
  • public class Microsoft.ProjectServer.Client.ProjectEngagementComment
  • public class Microsoft.ProjectServer.Client.ProjectEngagementCreationInformation
  • public class Microsoft.ProjectServer.Client.ProjectEngagementTimephasedCollection
  • public class Microsoft.ProjectServer.Client.ProjectEngagementTimephasedPeriod
  • public class Microsoft.ProjectServer.Client.ResourceEngagement
  • public class Microsoft.ProjectServer.Client.ResourceEngagementCollection
  • public class Microsoft.ProjectServer.Client.ResourceEngagementComment
  • public class Microsoft.ProjectServer.Client.ResourceEngagementTimephasedCollection
  • public class Microsoft.ProjectServer.Client.ResourceEngagementTimephasedPeriod
  • public property Microsoft.ProjectServer.Client.EnterpriseResource.Engagements
  • public property Microsoft.ProjectServer.Client.EnterpriseResource.RequiresEngagements
  • public enum value Microsoft.ProjectServer.Client.EnterpriseResourceType.Cost
  • public property Microsoft.ProjectServer.Client.Project.Engagements

Microsoft.SharePoint.Client.Publishing

  • public class Microsoft.SharePoint.Client.Publishing.SitePageFieldsData

 

“Sharing is caring”


Vesa Juvonen, Senior Program Manager, OneDrive-SharePoint Engineering, Microsoft – 4th of August 2016

Author

Vesa Juvonen
Principal Program Manager

Vesa Juvonen works as a Principal Product Manager focusing on the community and ecosystem across Microsoft 365. He leads the Microsoft 365 Patterns and Practices initiative which is providing tooling, guidance and assistance on adopting recommended patterns for using Microsoft 365. He has worked in different roles at Microsoft engineering helping on building capabilities in Microsoft 365 and to help customers and partners to use the different capabilities across the platform. Prior moving to ...

More about author