November 12th, 2020

Microsoft 365 Patterns and Practices (PnP) – November 2020 update

Microsoft 365 PnP Team
Microsoft 365 PnP Team

Microsoft 365 Patterns and Practices (PnP) Community November 2020 update is out with a summary of the latest guidance, samples, and solutions from Microsoft or from the community for the community. This article is a summary of all the different areas and topics around the community work we do around Microsoft 365 ecosystem during the past month. Thank you for being part of this success. Sharing is caring!

What is Microsoft 365 Patterns & Practices (PnP)?

Microsoft 365 PnP is a nick-name for Microsoft 365 Ecosystem activities coordinated by numerous teams inside of the Microsoft 365 engineering organizations. PnP is a community-driven open source initiative where Microsoft and external community members are sharing their learning’s around implementation practices for Microsoft 365. Topics vary from Microsoft Graph, Microsoft Teams, OneDrive and SharePoint. Active development and contributions happen in GitHub by providing contributions to the samples, reusable components, and documentation for different areas. PnP is owned and coordinated by Microsoft engineering, but this is work done by the community for the community.

The initiative is facilitated by Microsoft, but we have multiple community members as part of the PnP team (see team details in end of the article) and we are always looking to extend the PnP team with more community members. Notice that since this is open source community initiative, so there’s no SLAs for the support for the samples provided through GitHub. Obviously, all officially released components and libraries are under official support from Microsoft.

Some key statistics around Microsoft 365 PnP initiative from October 2020

Most viewed videos in the Microsoft 365 Community (PnP) YouTube channel during October 2020:

  1. Working with Microsoft Lists (webinar) | Harini Saladi, Miceile Barrett, Chakkaradeep Chandran and Mark Kashman | 4,601
  2. Getting started with Site Designs in SharePoint Online – Laura Kokkarinen (Sulava) | 4,136
  3. SharePoint Syntex at Microsoft Ignite 2010 | Jeff Teper | 3,760
  4. SharePoint Framework Tutorial 1 – HelloWorld WebPart | 1,637
  5. Latest on Power Automate integration within SharePoint Online | Chakkaradeep Chandran (Microsoft) | 1,349
  6. PnP Webcast – SharePoint Framework Modern Search Web Part – Tarald Gåsbackk (Puzzlepart), Franck Cornu (aequous) | 1,243
  7. Getting started on using custom search result page in SharePoint Online | 1,210
  8. List and column formatting magic – Out-of-the-box UX design mode wizards | Chris Kent (DMI) | 1,190
  9. Architecting Your Intranet | Melissa Torres (Microsoft) | 1,091
  10. Microsoft Lists – Share and track information across Microsoft 365 | Lincoln DeMaris (Microsoft) | 1,018

Main resources around Microsoft 365 Community:

Latest Dev Blog posts

Here are the latest blog posts and announcements around Microsoft 365 development topics from https://developer.microsoft.com/en-us/microsoft-365/blogs.

Community call recording blog posts

PnP Weekly video blog / podcast shows

We highly recommend also subscribing on the Microsoft 365 Developer Podcast show, which is a great show covering also latest development in the Microsoft 365 platform from developer and extensibility perspective.

Community Calls

There are numerous different community calls on different areas. All calls are being recorded and published either from Microsoft 365 Developer or Microsoft 365 Community (PnP) YouTube channels. Recordings are typically released within the following 24 hours after the call. You can find a detailed agenda and links to specific covered topics on blog post articles at the Microsoft 365 developer blog when the videos are published.

If you are interested in doing a live demo of your solution or sample in these calls, please do reach out to the PnP  Team members (contacts later in this post) and they are able to help with the right setup. These are great opportunities to gain visibility for example for existing MVPs, for community members who would like to be MVPs in the future or any community member who’d like to share some of their learnings.

Microsoft 365 PnP community  Ecosystem in GitHub

Most of the community driven repositories are in the PnP GitHub organization as samples are not product specifics as they can contain numerous different solutions or the solution works in multiple different applications.

  • PnPjs – PnPjs Framework repository
  • o365 CLI – Cross-OS command line interface to manage Office 365 tenant settings
  • generator-spfx – Open-source Yeoman generator which extends the out-of-the-box Yeoman generator for SharePoint with additional capabilities
  • generator-teams – Open-source Microsoft Teams Yeoman generator – Bots, Messaging Extensions, Tabs, Connectors, Outgoing Webhooks and more
  • teams-dev-samples – Microsoft Teams targeted samples from community and Microsoft engineering
  • Sharing is Caring – Getting started on learning how to contribute and be active on the community from GitHub perspective.
  • pnpcore – The PnP Core SDK is an SDK designed to work against Microsoft 365 with Microsoft Graph API first approach
  • powershell –  PnP PowerShell module which is PowerShell Core module targeted for Microsoft 365
  • pnpframework – PnP Framework is a .Net Standard 2.0 library targeting Microsoft 365 containing the PnP Provisioning engine and a ton of other useful extensions
  • sp-dev-fx-webparts – Client-side web part samples from community and Microsoft engineering
  • sp-dev-fx-extensions – Samples and tutorial code around SharePoint Framework Extensions
  • sp-dev-fx-library-components – Samples and tutorial code around the SharePoint Framework library components
  • sp-starter-kit – Starter kit solution for SharePoint modern experiences
  • sp-dev-fx-vs-extension – Open source Visual Studio IDE extension for creating SharePoint Framework solutions in the Visual Studio 2015 or 2017
  • sp-dev-build-extensions – Different build extensions like gulp tasks and gulp plugins from the community and engineering around SharePoint development
  • sp-dev-solutions – Repository for more polished and fine-tuned reusable solutions build with SharePoint Framework
  • sp-dev-samples – Repository for other samples related on the SharePoint development topics – WebHooks etc.
  • sp-dev-fx-controls-react – Reusable content controls for SharePoint Framework solutions build with React
  • sp-dev-fx-property-controls – Reusable property pane controls to be used in web parts
  • sp-dev-list-formatting – Open-source community-driven repository for the column and view formatting JSON definitions
  • sp-dev-site-scripts – Open-source community-driven repository for community Site Designs and Site Scripts
  • sp-dev-modernization – Tooling and guidance around modernizing SharePoint from classic to modern
  • sp-power-platform-solutions – Solution and sample code for SharePoint Power Platform solutions

All SharePoint specific repositories or services supported directly by Microsoft are located in the SharePoint GitHub organization

PnP specific repositories – solution designs and tooling

  • PnP – Main repository for SP add-in, Microsoft Graph etc. samples
  • PnP-Sites-Core – Office Dev PnP Core component
  • PnP-PowerShell – Office Dev PnP PowerShell Cmdlets
  • PnP-Tools – Tools and scripts targeted more for IT Pro’s and for on-premises for SP2013 and SP2016
  • PnP-Provisioning-Schema – PnP Provisioning engine schema repository
  • PnP-IdentityModel – Open source replacement of Microsoft.IdentityModel.Extensions.dll

Repositories in the GitHub Microsoft Search organization controlled by the PnP initiative

Other related resources from GitHub

What’s supportability story around PnP material?

Following statements apply across all of the community lead and contributed samples and solutions, including samples, core component(s) and solutions, like SharePoint Starter Kit or PnP PowerShell. All Microsoft released SDKs and tools are supported based on the specific tool policies.

  • PnP guidance and samples are created by Microsoft & by the Community
  • PnP guidance and samples are maintained by Microsoft & community
  • PnP uses supported and recommended techniques
  • PnP is an open-source initiative by the community – people who work on the initiative for the benefit of others, have their normal day job as well
  • PnP is NOT a product and therefore it’s not supported by Premier Support or other official support channels
  • PnP is supported in similar ways as other open source projects done by Microsoft with support from the community by the community
  • There are numerous partners that utilize PnP within their solutions for customers. Support for this is provided by the Partner. When PnP material is used in deployments, we recommend being clear with your customer/deployment owner on the support model

Please see the specifics on the supportability on the tool, SDK or  component repository or download page.

Microsoft 365 PnP team model

PnP Team announcement

In April we announced our new Microsoft 365 PnP team model and grew the MVP team quite significantly. PnP model exists for having more efficient engagement between Microsoft engineering and community members. Let’s build things together. Your contributions and feedback is always welcome! During August, we also crew the team with 5 new members. PnP Team coordinates and leads the different open-source and community efforts we execute in the Microsoft 365 platform. We welcome all community members to get involved on the community and open-source efforts. Your input do matter!

Got feedback, suggestions or ideas? – Please let us know. Everything we do in this program is for your benefit. Feedback and ideas are more than welcome so that we can adjust the process for benefitting you even more.

Area-specific updates

These are different areas which are closely involved on the community work across the PnP initiative. Some are lead and coordinated by engineering organizations, some are coordinated by the community and MVPs.

Microsoft Graph Toolkit

Graph toolkit Microsoft Graph Toolkit is engineering lead initiative, which works closely with the community on the open-source areas. The Microsoft Graph Toolkit is a collection of reusable, framework-agnostic web components and helpers for accessing and working with Microsoft Graph. The components are fully functional right of out of the box, with built in providers that authenticate with and fetch data from Microsoft Graph.

All the latest updates on the Microsoft Graph Toolkit is being presented in our bi-weekly Microsoft 365 Generic Dev community call, including the latest community contributors.

Microsoft 365 Community docs

Community docs model was announced in the April 2020 and it’s great to see the interest for community to help each other by providing new guidance on the non-dev areas. See more on the announcement from the SharePoint blog – Announcing the Microsoft 365 Community Docs. You might be interested on following assets to learn amore on this area: Here are the new articles on the Microsoft 365 Community Docs after the previous update

New articles

Updated articles

  • Maturity Model for Microsoft 365 – Introduction – by Emili Mancini (Sympraxis Consulting)
  • Follow Microsoft 365 on Social Media – Christophe Humbert (User Managed Solutions LLC)
  • Maturity Model for Microsoft 365 – Staff & Training Competency – by Emili Mancini (Sympraxis Consulting)
  • Small adjustments on other articles

Here are also some additional resources explaining the model more detailed.

Get involved! All contributors will be also called out in our quarterly summary released soon as a separate post in SharePoint blog at https://aka.ms/sp-blog.

Microsoft Look Book – Provisioning service

We have been releasing numerous updates for the SharePoint Look Book (http://lookbook.microsoft.com) within past month. Look book exposes numerous new templates which are demonstrating the possibilities of modern SharePoint designs. Typically you will need to be a tenant administrator to apply the template, but we are also soon enabling basic templates for normal users. All the hosted templates are also provided as an open-source solutions from the sp-dev-provisioning-templates repository, which means that you can also modify them based on your interest and use them option directly using PnP PowerShell.

Look Book site source code is also released as an open-source solution at sp-provisioning-service GitHub repository and we keep on evolving the experience further.

yo Teams – Yeoman generator for Microsoft Teams

PnP Team announcement Yo teams is a Yeoman Generator for Microsoft Teams Apps projects. This generator is for developers who prefers to use TypeScript, React and node as their primary technologies. The generator allows you to simply create and scaffold projects that includes one or more Microsoft Teams features such as: Bots, Messaging Extensions, Tabs, Connectors, Outgoing Webhooks. You can easily get started by following the guidance available from the official Microsoft Teams platform documentation. Latest changes on the project:

  • Latest version is 2.16
  • Updated to @microsoft/teams-js version 1.8.0
  • Updated core node packages of generator and generated solution, some related to security notifications
  • Schema 1.8 is the default option for new projects
  • Default app icons changed to PnP Parker
  • Switched to jwt-decode, from jsonwebtoken to reduce bundle size
  • Updated to use Typescript 4+
  • Updated Webpack to 5.0.0
  • Updated misc dependencies
  • Using module=es6 for client side TypeScript to improve tree shaking (#156)
  • For testing upgraded jest and moved from custom TypeScript preprocessor to ts-jest

Upcoming features

  • React Hooks
  • Meeting extensibility
  • Closer integration with Microsoft Teams Toolkit
  • What do you need?

We are also working on having better integration and story between yo teams and the Microsoft Teams Toolkit – more on this integration later this autumn. Got ideas and suggestions on this side? Please let us know!

PnP Sites Core and PnP PowerShell move to .NET Standard 2.0 versions

PnP Sites Core component, which has existed for numerous years, have been updated to use .NET Standard version and is getting fully modernized. As part of the October 2020 release, there was now numerous changes on the release model and a new NuGet and PowerShell packages for the modern direction. We are continuing on this path with the November 2020 release.

All of the new components are implemented using the Microsoft Graph first model and they fall back only to classic APIs when needed in the case of SharePoint Online. You should always prefer to use the Microsoft Graph and the standard SDKs for accessing the Microsoft 365 APIs, but if you have existing investments on the provisioning automation or other complex scenarios, which is not yet available in Microsoft Graph, you can use the PnP components to increase your productivity (see https://aka.ms/m365pnp for full list of standard and open-source components and tools). Key changes on the direction:

  • New PnP Framework component released for SharePoint Online – This is .NET Standard 2.0 SDK containing the classic PnP Site Core features for SharePoint Online
    • This component uses Microsoft Graph SDK behind the scenes for all Graph targeted operations
    • This component is still in preview status, but intended to go GA in December 2020
    • You can find the PnP Framework component from NuGet gallery
    • Component code is in new GitHub repository to differentiate it from the on-premises version
  • PnP Core SDK is a new Microsoft Graph first SDK targeted to bridge the gap for SharePoint Online between the Microsoft Graph and classic APIs – it’s targeted to enable customers to use Microsoft Graph operations where possible, but then seamlessly fall back to classic APIs on those areas where feature team has not yet provided Microsoft Graph API surface
  • PnP PowerShell has been released as new cross-platform version, targeted for SharePoint Online
  • Classic PnP Sites Core v3 will be targeted only for on-premises deployment and will remain in the .NET 4.6.1 level

We are also working on full convergence around the SDKs with Microsoft Graph team, so that there is a clear path to transition from the legacy API usage towards the Microsoft Graph APIs. This is a journey we want to do with our partners and customers. This will take a while and we will be providing guidance and components on addressing the gaps until full convergence can be achieved so that our partners and customers can more seamlessly transition their existing investments to modern world. More on this work within upcoming months. PnP component roadmap

Modernization tooling

SharePoint Online is continuously evolving and improving, which is a great thing for you as a consumer of the service. One of the key improvements is the availability of modern sites, which are modern Office 365 group-connected team sites or communication sites, combined with improved functionality that can be consumed from a beautiful modern user interface. There are however plenty of customers who have already existing content in the classic sites and in classic pages, which would be great to get moved on the modern experience. This is where the open-source modernization tooling will help you.

Following are the key changes in modernization tooling and guidance since the last monthly summary

Notice that the SharePoint 2010 Workflows will be going away in SharePoint Online. Take advantage of the SharePoint Modernization Scanner to understand if any are used in your environment.

SharePoint Framework development samples

These are the updated samples which are available from the the different repositories around the Microsoft 365 area samples.

How to find what’s relevant for you? Take advantage of our SharePoint Framework web part and extension sample galleries – includes also solutions which work in Microsoft Teams

Microsoft Teams community samples

These are samples which have been contributed on the community samples since last summary. We do welcome all Microsoft Teams samples to this gallery. They can be implemented using in any technology.

  • New sample msgext-search-giphy by Rabia Williams (Microsoft) showing how to build a search based Messaging extensions which allows users to interact with your web service through buttons and forms in the Microsoft Teams client. 
  • New sample tab-spfx-me-experience by Rabia Williams (Microsoft) showing how to build a Me-experience in Microsoft Teams using SharePoint Framework and Microsoft Graph Toolkit

If you are interested on Microsoft Teams samples, we have just released also new Microsoft Teams sample gallery. Contributions to Microsoft Teams samples is also more than welcome. This gallery already surfaces all Microsoft samples, Microsoft Teams app templates and community samples.

Teams sample gallery

Sharing is Caring initiative

The “Sharing Is Caring” repository is targeted for learning the basics around making changes in GitHub, submitting pull requests to the PnP repositories and in GitHub in general. Take advantage of this instructor lead training for learning how to contribute to docs or to open-source solutions.

  • See more from the guidance documentation – including all upcoming instructor lead sessions which you can participate

Sharing is caring

PnP Modern Search solution

PnP Modern Search solution allows you to build user friendly SharePoint search experiences using SPFx in the modern interface. The main features include:

  • Fully customizable SharePoint search query like the good old Content Search Web Part.
  • Can either use a static query or be connected to a search box component using SPFx dynamic data.
  • Live templating system with Handlebar to meet your requirements in terms of UI + built-in layouts. Can also use template from an external file.
  • Search results including previews for Office documents and Office 365 videos.
  • Customizable refiners supporting multilingual values for taxonomy based filters.
  • Sortable results (unique field).
  • Refiners Web Part.
  • Pagination Web Part.
  • SharePoint best bets support.
  • Search query enhancement with NLP tools (like Microsoft LUIS).
  • Extensibility model allowing to write your own components.
  • New v4 version is now available as a preview release with significant changes on the overall architecture

See more details from the documentation.

Other open-source projects and assets

  • Reusable SharePoint Framework controls – Reusable controls for SharePoint Framework web part and extension development. Separate projects for React content controls and Property Pane controls for web parts. These controls are using Office UI Fabric React controls under the covers and they are SharePoint aware to increase the productivity of developers.
  • Office 365 CLI – Using the Office 365 CLI, you can manage your Microsoft Office 365 tenant and SharePoint Framework projects on any platform. See release notes for the latest updates.
  • PnPJs – PnPJs encapsulates SharePoint REST APIs and provides a fluent and easily usable interface for querying data from SharePoint sites. It’s a replacement of already deprecated pnp-js-core library. See changelog for the latest updates.
  • PnP Provisioning Engine and PnP CSOM Core – PnP provisioning engine is part of the PnP CSOM extension. They encapsulate complex business driven operations behind easily usable API surface, which extends out-of-the-box CSOM NuGet packages. See changelog for the latest updates.
  • PnP PowerShell – PnP PowerShell cmdlets are open-source complement for the SharePoint Online cmdlets. There are more than 300 different cmdlets to use and you can use them to manage tenant settings or to manipulate actual SharePoint sites. They See changelog for the latest updates.
  • List formatting definitions – Community contributed samples around the column and view formatting in GitHub.
  • SharePoint Starter Kit v2 – Building modern experiences with Microsoft Teams flavors for SharePoint Online and SharePoint 2019 – reference solution in GitHub.
  • Site Designs and Site Scripts – Community contributed samples around SharePoint Site Designs and Site Scripts in GitHub.
  • DevOps tooling and scripts – Community contributed scripts and tooling automation around DevOps topics (CI/CD) in GitHub.
  • Teams provisioning solution – Set of open-source Azure Functions for Microsoft Teams provisioning. See more details from GitHub.

 

SharePoint Dev articles

SharePoint Dev articles are surfaced at docs.microsoft.com/en-us/sharepoint/dev. You can provide contributions to these documents by submitting documentation improvements using GitHub tooling. All of the SharePoint Dev docs are stored and surfaced from the sp-dev-docs repository. Here are new/updated articles on SharePoint Development.

 

Microsoft 365 Dev and Microsoft 365 Community (PnP) YouTube video channels

You can find all Microsoft 365 related videos on our YouTube Channel at http://aka.ms/m365pnp-videos or at Microsoft 365 Dev. These channels contains already a significant amount of detailed training material, demo videos, and community call recordings.

Here are the new Microsoft demo or guidance videos released since the last monthly summary:

Community demos as following:

PnP Weekly sessions – Community visitors and latest articles from Microsoft and community on Microsoft 365 topics.

Since last summary we also published following web services on The Intelligent Intranet story

Key contributors to the November 2020 update

Here’s the list of active contributors (in alphabetical order) since last release details in SharePoint Dev repositories or community channels. PnP is really about building tooling and knowledge together with the community for the community, so your contributions are highly valued across the Office 365 customers, partners and obviously also at Microsoft. Thank you for your assistance and contributions on behalf of the community. You are truly making a difference! If we missed someone, please let us know.

Companies: Here’s the companies, which provided support for PnP initiative for this month by allowing their employees working for the benefit of others in the community. There were also people who contributed from other companies during last month, but we did not get their logos and approval to show them in time for these communications. If you still want your logo for this month’s release, please let us know and share the logo with us. Thx.

 

  AddIn365     aequos      Arvo Systems      Canviz    Capa Creative    Catapult Systems   ClearPeople    CPS     DMI     DQC Sverige AB       Monday Coffee    N8D NTT Ltd   piasys     PixelMill    Portiva   onebit software     Pramerica     PVX Solutions     SharePointalist      Sherpas Group    Strom Technology    Sulava      Sympraxis Consulting    Valo   Voitanos

 

Microsoft people: Here’s the list of Microsoft people who have been closely involved with the PnP work during last month.

PnP Team

PnP Team manages the PnP community work in the GitHub and also coordinates different open-source projects around SharePoint development topics. PnP Team members have a significant impact on driving adoption of Office 365 and SharePoint development topics. They have shown their commitment to the open-source and community-driven work by constantly contributing to the benefit of the others in the community. Thank you for all that you do!

Here are the Microsoft Internal PnP Core team members:

Next steps

  • See all of the available community calls, tools, components and other assets from https://aka.ms/m365pnp. Get involved!

Got ideas or feedback on the topics to cover, additional partnerships, product feature capabilities? – let us know. Your input is important for us, so that we can support your journey in Microsoft 365.

“Sharing is caring”

Microsoft 365 Community (PnP) – November 9th 2020

Category
Office Add-ins
Topics
Microsoft Bot Framework

Author

Microsoft 365 PnP Team

We coordinate the Microsoft 365 Patterns and Practices (PnP) open-source and community activities.

Read next