Learn about the various SharePoint 2013 APIs, CSOM, SOM, OData/REST and WCF Data Services, and how to call them from your web applications, line-of-business systems, and back-end services, to leverage all the power of SharePoint 2013 without having to target and deploy code into SharePoint 2013.

1. SharePoint 2013 APIs
Leverage SharePoint 2013 from websites,
LOB systems and back-end services

2. Agenda
• Intro
• APIs and Integration Points
• REST/oData
• CSOM
• JavaScript
• SOM
• Conclusion

3. Thank you to my sponsor
• http://www.cloudshare.com/

4. Intro
Who am I?
• .NET / SharePoint solution architect
• Over 18 years experience developing business solutions for
private industry & government
• Recent clients include Justice Canada, NRC, NSERC,
DFAIT, CFPSA, OSFI, MCC
• Specialize in Microsoft technologies
• Speaker at user groups and conferences

5. Development Models
• As a service
 Web / Phone / Desktop / Server / Mashup
• As a framework
 SharePoint Web Page
 App Model
 Farm Solution
 Sandbox Solution
5

6. Client Protocols
Browser Windows ASP.NET
Workflows
Event
Receivers
[7] Application
[4] Transport
[3] Network
Industry
Standard
OSI
Model
Microsoft
Open
Specification

7. Sharing Social Taxonomy Search Publishing
eDiscovery Workflow IRM BCS Analytics
JavaScript
Library
Silverlight
Library
.NET CLR
Library
Client APIs
Client
Code
Client
Server
REST
oData
JSON
CSO
M
_api (_vti_bin/client.svc)

8. Integration Points
8

9. Development IDEs & Languages
• Any web or cloud IDE
• “Napa” Cloud-Based Development
• SharePoint Designer
 HTML, CSS, JavaScript
• Visual Studio
 .NET, etc
• PowerGUI or any PS command shell
 PowerShell
9

10. Coding to SP APIs
• oData / REST
 http://localhost/_api/web/
 http://localhost/_vti_bin/ListData.svc (still supported)
• Client-Side Object Model (CSOM)
 ClientContext.ExecuteQuery();
• JavaScript
 ClientContent.executeQueryAsync();
10

11. Coding to SP APIs
• Server App Model
 CSOM, oData/REST, JavaScript
• Server Object Model (SOM)
 SPSite site = new SPSite("http://localhost/")
• Web Services
 http://localhost/_vti_bin/Lists.asmx
11

12. Web Dev
• Using .NET, JavaScript, PHP, Ruby, etc
• Address an oData / REST end point
• Address CSOM .NET API
• Address CSOM JavaScript API
• Address CSOM Silverlight API
12

13. REST API (JavaScript)
$.ajax({
url: "http://localhost/_api/web/lists/getbytitle('Documents')/items",
type: "GET",
headers: { "accept": "application/json;odata=verbose",},
success: function (data) {
$.each(data.d.results, function (index, item) {
$('#docs').append("<li>" + item.Id + " / " + item.Title + "</li>");
},
error: function (error) {
alert(JSON.stringify(error));
}
});
13

14. oData (.NET)
Uri u =
new Uri("http://localhost/_vti_bin/ListData.svc/", UriKind.Absolute);
TeamSiteDataContext ctx = new TeamSiteDataContext(u);
ctx.Credentials = System.Net.CredentialCache.DefaultCredentials;
DataServiceQuery<DocumentsItem> qry = ctx.Documents;
IEnumerable<DocumentsItem> docs = qry.Execute();
14

15. JavaScript API
var context = SP.ClientContext.get_current();
var user = context.get_web().get_currentUser();
$(document).ready(function () {
getUserName();
});
function getUserName() {
context.load(user);
context.executeQueryAsync(onSuccess, onFailure);
}

16. .NET Desktop Dev
• Using WPF/WCF, WinForms or Silverlight
• Address an oData / REST end point
• Address CSOM or SOM .NET API
• Address Silverlight API
16

17. Client-Side Object Model (.NET)
using (ClientContext ctx = new ClientContext("http://localhost/"))
{
Web web = ctx.Web;
ListCollection lists = web.Lists;
List list = web.Lists.GetByTitle(libraryname);
CamlQuery qry = new CamlQuery();
ListItemCollection items = list.GetItems(qry);
ctx.Load(items, li => li.Include(pi => pi["LinkFilename"]));
ctx.ExecuteQuery();
return items;
}
17

18. Server Object Model (.NET)
using (SPSite site = new SPSite("http://localhost/"))
{
using (SPWeb web = site.RootWeb)
{
SPList list = web.Lists["Documents"];
SPListItemCollection items = list.Items;
return items;
}
}
18

19. SharePoint Farm Dev
• Using .NET and HTML/CSS/JavaScript
• Use webparts
• Address SOM .NET API
• Address an oData / REST end point
19

20. Resources for Attendees
• SharePoint 2013 development overview (MSDN)
• What’s new for developers in SharePoint 2013
• Choose the right API set in SharePoint 2013 (MSDN)
• SPC407 - Deep dive into the SharePoint 2013 CSOM API's
(Microsoft SharePoint Conference 2012)
21

21. Contact Me
• John Calvert, Chief Architect
• Software Craft, Inc.
• john at softwarecraft dot ca
• softwarecraft dot ca
• at softwarecraft99