INTRODUCING THE OFFICE 365 DEV PNP PARTNER PACK

Transcription

1

2 INTRODUCING THE OFFICE 365 DEV PNP PARTNER PACK PAOLO PIALORSI SENIOR CONSULTANT, PIASYS.COM, ITALY

3 About me Project Manager, Consultant, Trainer About 50 Microsoft certification exams passed MCSM Charter SharePoint MVP Office Servers and Services Office 365 Dev PnP Core Team Member Focused on SharePoint and Office 365 since the beginning Author of many books about XML, SOAP,.NET, LINQ, SharePoint, and Office 365 Speaker at main IT conferences

4 Agenda Introduction to PnP Partner Pack v. 2.0 Architecture Setup Guide Extensibility Model

5 Introduction to PnP Partner Pack v. 2.0

6 What is it? Ready to use reference solution for Office 365 and SharePoint Online Open Source on GitHub Based on PnP samples, guidance, patterns, etc. Based on community efforts (for the community, by the community) Easy to setup and maintain

7 Main Capabilities Save Site as Provisioning Template feature in Site Settings Sub-Site creation with custom UI and PnP Provisioning Template selection Site Collection creation for non-admin users with custom UI and PnP Provisioning Template selection My Site Collections personal view Responsive Design template for Site Collections Governance tools for administrators: apply SharePoint farm-wide branding, refresh site templates, bulk creation of site collections Sample Timer Jobs (implemented as WebJobs) for Governance rules enforcement

8 Requirements A valid Microsoft Office 365 tenant with at least an active subscription A valid Microsoft Azure subscription for hosting components The PnP PowerShell cmdlets (v or later) Visual Studio 2015 (kindly suggested) or Visual Studio Code

9 DEMO: A lap arount PnP Partner Pack v. 2.0

10 Architecture

11 Architectural Pillars Based on Office 365 Application, hosted on Azure App Service Azure Web Site Azure WebJobs Configured to work against Office 365/SharePoint Online Mainly with App-Only token Sometime with user s delegation Uses Infrastructural Site Collection on SharePoint Online Provisioning templates Asynchronous jobs Branding settings Uses Azure blob storage queue for near to real-time jobs

12 Architectural Schema Office 365 Application 2 Office 365/SharePoint 1 3 Storage Queue WebJob 4

13 Infrastructure Library Provides main capabilities and extensibility points like IConfigurable IProvisioningRepository ITemplatesProvider PnPPartnerPackConstants PnPPartnerPackContextProvider PnPPartnerPackSettings PnPPartnerPackUtilities ProvisioningRepositoryFactory SharePointProvisioningRepository Out of the box templates providers

14 Provisioning Repository Templates can be retrieved from external repositories Out of the box support for SharePoint Online at the tenant level SharePoint Online at the current site collection level PnP Templates Gallery The model is extensible (more on this later )

15 DEMO: Architecture Overview

16 Setup Guide

17 Setup Steps Azure Active Directory Application Registration App Only configuration Infrastructural Site Collection Azure Blob Storage creation Azure App Service Web Site provisioning and configuration App Only certificate configuration Web Jobs provisioning

18 How to setup the solution Automatically using a UI based desktop application (for Windows OS only) Manually using PowerShell and some manual steps Pack/blob/master/Documentation/Manual- Setup-Guide.md

19 DEMO: PnP Partner Pack Setup Wizard

20 Extensibility Model

21 Main Extensibility Points Custom Provisioning Repository To customize queue-based async jobs persistence To customize job items persistence By default SharePoint Online and Azure Storage Queue You can replace with SQL Database, MSMQ, etc. Custom Template Providers To consume templates from external repositories Custom Jobs and Job Handlers To create custom jobs and to process them

22 Provisioning Repository Implement ITemplateRepository GetGlobalProvisioningTemplates GetLocalProvisioningTemplates SaveGlobalProvisioningTemplate SaveLocalProvisioningTemplate EnqueueProvisioningJob UpdateProvisioningJob GetProvisioningJobs GetProvisioningJob GetTypedProvisioningJobs<TJob> Or inherit from SharePointTemplateRepository Register the new repository in.config files with <ProvisioningRepository />

23 Templates Providers Implement ITemplatesProvider GetProvisioningTemplate SearchProvisioningTemplates DisplayName Register the provider in.config files with <TemplatesProviders/> Provide any optional XML configuration for the provider

24 Jobs and Job Handlers Create a Job type inheriting from ProvisioningJob JobId Title Owner Status ErrorMessage Create a Job Handler type inheriting from ProvisioningJobHandler Init RunJobInternal Register them in the.config files with <ProvisioningJobs/>

25 DEMO: Extensibility Points

26 THANK YOU