220 likes | 352 Views
Building Autohosted Apps for SharePoint 2013. Jerry Yasir SharePoint MVP, MCT. Who Am I?. SharePoint Server MVP Since 2010 SharePoint Practice Lead at US TECH Solutions (Jersey City, NJ)
E N D
Building Autohosted Apps for SharePoint 2013 Jerry Yasir SharePoint MVP, MCT
Who Am I? • SharePoint Server MVP Since 2010 • SharePoint Practice Lead at US TECH Solutions (Jersey City, NJ) • Founder of the Largest SharePoint User Group in Middle East Riyadh SharePoint User Group RSUG Co-Lead SharePoint Pakistan User Group • Microsoft Certified Trainer (MCT) since 2008. • MCSE SharePoint 2013 • MCITPSharePoint Admin 2010, MCPD SharePoint Developer 2010 & MCTS SharePoint 2010 Configuration & Development • MCTS WSS 3.0, SharePoint Server 2007, MCITP, MCTS Silverlight 4 Development, Project Server 2007 & 2010, MCTS Project Professional 2007 & 2010, MCPD.NET, MCSD.NET MCAD.NET • Email: yasir.attiq@gmail.com, MSN: yasi_butt@hotmail.com • Twitter: @jerry_yasir Facebook: yasir.attiq (Jerry Yasir) • Blog: http://jerryyasir.wordpress.com
Evolution of SharePoint Development 2010 2007 2013 SharePoint SharePoint SharePoint IIS Sandbox IIS with _api App IIS Code runs from GAC on same w3wp.exeas SharePoint web application Code runs on SPUCWorkerProcess.exe or calls client.svc (CSOM) Code runs outside of SharePoint but has trust to leverage capabilities exposed in _api
App Hosting Options Cloud SharePoint Your Hosted Site SharePoint Host Web Provider-Hosted App “Bring your own server hosting infrastructure and technology platform” App Web* (separate SharePoint domain) Cloud-based Apps Get remote events from SharePoint Use CSOM/REST + OAuth to work with SP AutohostedApp Windows Azure + SQL Azure provisioned invisibly as apps are installed Azure SharePoint Host Web App Web* (separate SharePoint domain) • SharePoint-Hosted App • Provision an isolated sub web on a parent web (separate domain) • Reuse web elements (lists, files, out-of-box web parts) • No server code allowed; use client JavaScript for logic, UX SharePoint Host Web App Web (separate SharePoint domain) *App Webs are optional in Cloud-Hosted Apps
Autohosted Capability Quiz Custom Actions Client Web Part Managed Code Web Part Page Lists/Libraries Database Modules Workflow Host Web App Web Azure
App Lifecycle Tenant A Web Site Workflow SQL DB Site Owner Tenant Admin App Developer App Catalog .app .app Web Site Workflow SQL DB Site Owner .app Tenant B Web Site SQL DB Workflow Site Owner SQL DB Web Site Workflow SharePoint Store (Office Marketplace) Site Owner
Demo • Autohosted App Debug vs. Deploy
App UX Options Full-Screen Navigating to the app takes the user out of the SharePoint site and to the app host (ex: Azure, separate SharePoint domain, etc) The app uses the full real estate of the browser viewing area (can leverage SharePoint chrome) SharePoint Dialog Similar to Full-screen, but displayed in a dialog window Typically launched through custom action or script (ex: context menu or ribbon button) App Parts Displays app as an element in an existing web part or wiki page Very similar to Page Viewer Web Part, but with better communication capabilities
Optimizing UX Leverage chrome control Chrome control allows full-screen apps to be framed in the chrome and styles similar to the host web (including placeholders for icons, breadcrumbs, and menus) Import styles from host web Add reference to http://<host web domain>/_layouts/15/defaultcss.ashx in the head of app page The chrome control automatically adds styles from the host web, so this approach is only required for pages displayed in app parts or modal windows Optimize apps part size with post message Host web listens for post message and resizes based on dimensions passed from the app part Still imperative to design around a predictable rendering size (challenging without knowing the styles that will be applied)
App Permissions App permissions are configured in the app manifest Developers specify the permissions the app needs to be able to run Apps request permissions during installation Granting app permission is all or nothing (installer can’t pick a chose what to grant from the request) Apps must be granted permissions by the user executing the app Users can only grant the permissions they have Azure Access Control Service (ACS) plays the role of the authorization server Azure ACS stores basic information about the app and provides apps access tokens for calling SharePoint APIs
AppManifest.xml Dissected General Information Title, version, icon, start page and query string Permissions Permission levels at specific scopes (ex: write access to profiles, read access to site collection) Prerequisites Define feature dependencies for the app (ex: publishing features) Supported Locales Defines locales the application will support (ex: en-US, fr-FR, etc) Remote Endpoints A list of remote endpoints the SharePoint App may access through SP.WebProxy.invoke()
App Storage Options SharePoint Lists Great for SharePoint-hosted apps, but requires CAML Requires an app web SQL Azure Package app with SQL Package (.dacpac) or by referencing SQL Database project SQL Azure components are provisioned invisibly when the app is installed by a tenant Connection information in available through specific APIs (both SqlConnection class and raw connection string) Others, but be careful with latency
SQL Azure Using SqlConnection object Specify connection string in web.config using name LocalDBInstanceForDebuggingand the API will dynamically use this connection when debugging Using raw connection string The API for retrieving the raw connection string will NOT automatically work when debugging
Demo • Supplier App
App Roles/Admins Leverage SharePoint permissions from app web The app web inherits permissions from the host web Great for simple permissions models (ex: App Administrator = Host Site Administrator) Be careful…checking permission on the host web would require the app to have full control of the host web Store app permissions in the app’s storage (ex: SQL Azure) Very flexible…can use almost any data/permission model Need a way to seed the permissions table with administrators
Demo - Employee Recognition Part 1 Requirements Allow users to send recognition to other users Submission should post to the SharePoint Newsfeed App should be profile aware (user pictures, titles, managers, etc) App should send email to submitter, recipient, and both managers (if applicable) No administrative settings (static settings) Design Decisions Hosting: Autohosted UX: full-screen and app part APIs: mixture of CSOM and SSOM Storage: SharePoint List App Roles/Admin: Not Applicable
Demo - Employee Recognition Part 2 Requirements (same as previous, except the following) Allow users to select badges to go with the recognition (ex: Going Green, Community Ninja, etc) Allow app administrators to configure quotas and notification settings Provide reports of recognition history Design Decisions Hosting: Autohosted UX: full-screen and app part APIs: mixture of CSOM and SSOM Storage: SQL Azure (much better for reporting) for data and SharePoint Library for badges App Roles/Admin: User permissions from SharePoint app web
Demo • Advanced Employee Recognition
Usage Model and Licensing Microsoft-owned Azure account All autohosted apps for SharePoint are provisioned into a Microsoft-owned Azure account that only Microsoft has access to Licensing through Tenant Azure hosting costs passed through to tenant…developer doesn’t pay for hosting App Catalog Great for company-specific customizations 1 app hosting license = 1 user / app / month Initial number of free licenses, but more available for purchase by tenant admins SharePoint Store Great for ISVs or developers looking capitalize on the app model Support for autohosted apps is coming soon to the SharePoint store
Usage Quotas/Throttling *Usage quotas can be monitored from SharePoint Online admin portal
Key Takeaways Easy to Develop Developing autohosted apps leverages familiar tools, simple deployment, and automatic DR Simplified Upgrade Autohosted apps provide a reliable upgrade path and do not impede farm upgrades/patches Cloud Ready Autohosted apps were developed to provide an uncompromised cloud experience in Office 365 Rich SharePoint Integration New APIs allow autohosted apps to run from Azure but richly integrate with SharePoint Low Cost of Entry for Developers No more bulky development environment…Visual Studio and a tenant