SharePoint 2013 introduces a new app model that allows the development of self-contained extensions called apps. There are three types of apps: SharePoint-hosted, provider-hosted, and auto-hosted. SharePoint-hosted apps are developed using only client-side technologies like HTML, CSS, and JavaScript and run within the context of a SharePoint site. The document discusses SharePoint-hosted app architecture, the client-side and server-side object models used to interface with SharePoint, and provides a demonstration of building a basic SharePoint-hosted app.

1. SharePoint 2013:
To App or not to
App?

2. About me

3. Agenda
• Introduction to SharePoint 2013 apps
• Deployment options and design patterns
• Technologies used in app development
• Building a SharePoint-hosted app

4. setting the scene
Introducing the new SharePoint app
framework

5. Introducing apps
In SharePoint 2013 everything is an app …
In strict sense: “Apps are self-contained pieces of functionality
that extend the capabilities of a SharePoint site.”

6. App isolation: App web vs Host web
• Apps live in their own isolated environment called the “app
web”.
• The site in which they function is called the “host web”
APP1UID GUIDAPP1

7. Packaging and deployment options

8. SharePoint 2013 app development
scenarios

9. Demo

10. Getting started with development
• Local development
• Has to be on Windows Server 2008 R2 (or later)
• Memory reqs have gone up – 12 GB RAM seems workable ... But
TechNet recommends 24 GB
• Extra configuration needed for app development
• Visual Studio 2012
• Remote development
• Sign up for Office 365 Developer Site
• Possible to use NAPA – app for building apps

11. SharePoint App UX
• Immersive App - app is shown full screen with
in a separate page
• Part - App is shown as a part on the
SharePoint page – similar experience to web
part
• UI Custom Actions – possible to make the App
available through ribbon or menu actions for
documents and items
See Apps for SharePoint UX design guidelines

12. Demo

14. Basic SharePoint App architecture
• Code runs “Off SharePoint Box”
• Declarative Hooks into
SharePoint
• AppWeb Host in SharePoint

15. Apps – three possible approaches
App Web
Parent
Web
SharePoint-hosted App
Provision an isolated sub web
on a parent web
• Reuse web elements
(lists, files, out-of-box web
parts)
• No server code allowed;
use client JavaScript for
logic, UX
Azure Auto-
Provisioned App
Windows Azure + SQL Azure
provisioned invisibly as apps
are installed
AzureSharePoint
Web
Get remote
events from
SharePoint
Use CSOM/REST
+
OAuth to work
with SPS
Cloud-based
Apps
Developer-Hosted App
“Bring your own server hosting
infrastructure”
Developers will need to isolate
tenants
SharePoint
Web
Your Hosted
Site

16. Hosting: cloud vs SharePoint
Cloud Hosted Apps SharePoint Hosted Apps
Possible hosting model for almost all types
of apps
Good for smaller apps
Choose your own infrastructure &
technology
SharePoint based; no server-side code
May require your own hosting Automatically hosted in SharePoint
May require your own handling of
multitenancy & permission management
Inherent multitenancy & isolation

17. App identity
• Challenge with SPS2010
• Farm solutions – too much privileges - risk of
RunWithElevatedPrivileges
• Sandbox solutions – no RunWithElevatedPrivileges – always under
user context
• In SharePoint 2013 apps have their own identity and
specific permissions
• Installing user either grants or denies permissions to host web
• Permission is explicitly given for a specific scope
• App identity is passed around using oAuth tokens

18. App scopes
• SPSite – site collection
• SPWeb – site
• SPList
• Tenancy
• Other scopes (and rights) for performing search queries,
accessing taxonomy data, user profiles, etc...

19. App rights
• Default rights : Read, Write, Manage and Full Control
• Not possible to customize
• Apps are granted permissions to a scope and all children of
the scope
• Defined in declarative XML

20. Azure Access Control Service (ACS)
• ACS required with oAuth implementation in SharePoint
2013
• How is the ACS server configured as the authentication
server?
• Automatically done for sites in Office 365 Preview
• On-premise farms, a trust to ACS must be configured. Possible to
avoid when using Server-to-server (S2S) trust

21. Demo

23. SharePoint 2013 CSOM and REST API
• Apps connect to SharePoint using
• SharePoint 2013 Client Side Object Model (CSOM)
• SharePoint 2013 REST API
• Javascript cross-domain library (SP.RequestExecutor.js)
• Main investments in 2013
• Client.svc is extended with REST capabilities
• Easier for javascript and non .NET code
• Implemented in accordance with oData protocol
• Programming style is largely unchanged
• New APIs for SharePoint Server functionality
• User Profiles, Search, Taxonomy, Feeds, ....

24. REST URLs in SharePoint 2013
• CSOM URLs can go through _api folder
• Replace
http://sharepoint/_vti_bin/client.svc/web
• With
http://sharepoint/_api/web
• Example REST URLs targeting SharePoint sites
• _api/web/lists
• _api/web/lists/List1
• _api/web/?$select=title,id
• /_api/web/lists/getByTitle('Consultants')/Items
• ....

25. ATOM XML vs JSON
• Response data format selected with ACCEPT header
• XML can be easier to deal with from managed code
• JSON easier to deal with using Javascript
• To get JSON response use “application/json”
http://sharepoint/_vti_bin/client.svc/web

26. Demo
Exploring SPS 2013 REST API

28. SharePoint Hosted App
• App components are SharePoint components
• SharePoint list, site columns, content types
• CSOM and REST API
• Client web part
• Key Developer skills
• HTML5, CSS, Javascript
• Jquery, ASP.NET AJAX
• CSOM and REST API
• Silverlight

29. SharePoint Hosted App
• Installation of App creates child site in target site
• App can add declarative items to App Web
• App Web <-> Host Web communication: CSOM/REST or
Javascript cross-domain library
• Full client-side extension – no server-side code
• Custom Actions
• Client-side web parts
• Lists
• Site Pages
• CSS files
• Javascript files

30. Demo
Building a SharePoint Hosted App with Office 365

32. Summary
Call to action:
• Sign up for Office 365 Developer Preview
• Watch developer videos around building SharePoint
2013 apps
• Register on www.biwug.be as a member to stay up
to date for local SharePoint 2013 sessions
• For more information or questions
• SharePoint 2013 Preview start page
• SharePoint 2013 Preview Developer documentation
• Developing Apps for SharePoint 2013 MSDN forum
• SharePoint 2013 Delicious links
• Yammer – https://www.yammer.com/spyam