This document discusses the Client-Side Object Model (CSOM) for SharePoint. It provides an overview of CSOM and its advantages over Server-Side Object Model (SSOM) and Representational State Transfer (REST). CSOM resembles SSOM, uses strongly typed objects, supports batch requests, handles connection authentication and remote errors. It covers more of the SharePoint API than REST. Examples are provided for creating sites using CSOM in C# and JavaScript. New features in CSOM for SharePoint 2013 and Online are also mentioned.

1. Wonderful CSOM
Sonja Madsen
September 26th, 2015
Barcelona

2. @sonjamadsen sp2013.blogspot.com
dev@sonjasapps.com www.sonjasapps.com
Best International
Developer

3. CSOM
2007
SSOM
2010 2013
CSOM
2016 -

4. Client-Side Object Model
_API
CSOM in SharePoint 2013

5. CSOM advantages over REST
SSOM, JSOM, CSOM with PowerShell
What’s new
CSOM

6. DEMO, MVC, the app

7. REST
CSOM
_API

9. Resembles SharePoint Server API, SSOM
Strongly typed
Batch requests
Connection authentication to the server
Remote error handling
Lambda expressions
Object Browser
Covers more SharePoint API than REST
CSOM Advantages

10. using (var clientContext = spContext.CreateUserClientContextForSPHost())
{
if (clientContext != null)
{
WebCreationInformation creation = new WebCreationInformation();
creation.Url = webTitle;
creation.Title = webTitle;
Web newWeb = clientContext.Web.Webs.Add(creation);
clientContext.Load(newWeb);
clientContext.ExecuteQuery();
}
}
Strongly Typed CSOM

11. Query.ajax({ url: "http://<site url>/_api/web/webinfos/add",
type: "POST",
data: JSON.stringify(
{'parameters': { '__metadata': {
'type': 'SP.WebInfoCreationInformation' },
'Url': 'RestSubWeb',
'Title': 'RestSubWeb',
'Description': 'REST created web',
'Language':1033, 'WebTemplate':'sts',
'UseUniquePermissions':false} } ),
headers: { "accept": "application/json; odata=verbose",
"content-type":"application/json;odata=verbose",
"content-length": <length of post body>,
"X-RequestDigest": $("#__REQUESTDIGEST").val() },
success: doSuccess, error: doError });
Create site with REST

12. Batch Requests
CSOM
REST
_API

13. REST call form digest value expires after 30 min.
Connection Authentication to the server

14. Connection Authentication to the server
$.ajax({
url: _spPageContextInfo.siteAbsoluteUrl + "/_api/web/,,,",
method: "POST",
headers: {
"Accept": "application/json; odata=verbose",
"X-RequestDigest": $('#__REQUESTDIGEST').val()
},
success: function (data) {},
error: function (data, errorCode, errorMessage) {}
});

15. Structured Remote Exception Handling

17. context.Load(web);
.Where()
.Include()
.OrderBy()
Lambda Expressions

18. Object Browser

20. Server Side SSOM CSOM
using (SPSite site = new SPSite(projectweburl))
{
using (SPWeb web = site.RootWeb)
{
web.AllowUnsafeUpdates = true;
…
SPWebTemplatewebTemplate =
webTemplates[TemplateI];
…
//create project site
web.Webs.Add(webUrl,webTitle,"",
uint.Parse(lcid), webTemplate,false,false);
web.Update();
}
}
using (var clientContext =
spContext.CreateUserClientContextForSPHost())
{
if (clientContext != null)
{
WebCreationInformation creation = new
WebCreationInformation();
creation.Url = webTitle;
creation.Title = webTitle;
Web newWeb =
clientContext.Web.Webs.Add(creation);
clientContext.Load(newWeb);
clientContext.ExecuteQuery();
}
}

21. SSOM CSOM
ThmxTheme.SetThemeUrlForWeb(
siteWeb,currentweb.ServerRelativeUrl
+ "/_catalogs/theme/SK.thmx");
siteWeb.Update();
siteWeb.ApplyTheme(
colorPaletteFile.ServerRelativeUrl,
fontSchemeFile.ServerRelativeUrl,null, true);
siteWeb.Update();
clientContext.ExecuteQuery();

22. CSOM with JavaScript = JSOM
using (var context =
spContext.CreateUserClientContextForSPHost())
{
if (clientContext != null)
{
WebCreationInformation creation = new
WebCreationInformation();
creation.Url = webTitle;
creation.Title = webTitle;
Web newWeb =
clientContext.Web.Webs.Add(creation);
context.Load(newWeb);
context.ExecuteQuery();
}
}
var context = new SP.ClientContext();
var creation = new
SP.WebCreationInformation();
creation.set_title(webTitle);
creation.set_url(webTitle);
creation.set_webTemplate('STS#0');
var newWeb=
context.get_web().add(creation);
context.executeQueryAsync(Function.create
Delegate(this,this.onQuerySucceeded),
Function.createDelegate(this,
this.onQueryFailed));
}
C#JavaScript

23. ClientContext context= new
ClientContext("http://SiteUrl");
WebCreationInformation creation = new
WebCreationInformation();
creation.Url = "webTitle";
creation.Title = "webTitle";
Web newWeb =
context.Web.Webs.Add(creation);
context.Load(newWeb);
context.ExecuteQuery();
CSOM with PowerShell
using (var context =
spContext.CreateUserClientContextForSPHost())
{
if (clientContext != null)
{
WebCreationInformation creation = new
WebCreationInformation();
creation.Url = webTitle;
creation.Title = webTitle;
Web newWeb =
clientContext.Web.Webs.Add(creation);
context.Load(newWeb);
context.ExecuteQuery();
}
}
C#PowerShell

24. CSOM Online
What’s New

25. Visual Studio 2015

26. Summary
REST
CSOM
_API

27. Get stamps from all the sponsors
Deposit the passport to enter
the prize raffle
Good luck!
The SPSBCN Passport

28. FREE BEER!
Get your ticket at the registration
desk
Network and have fun with your
colleagues!
SharePint sponsored by
Michael Collins Pub
Plaça de Sagrada
Família
Starts at 19:30h

29. They help us improve
for SharePoint Saturday
2016!
Remember to fill your evaluation forms

30. Thanks to our Sponsors