SharePoint Dev Ecosystem / SharePoint Patterns and Practices (PnP) November 2018 update is out with a summary of the latest guidance, samples, and solutions from SharePoint engineering or from the community for the community. This article is a summary of all the different areas and topics around SharePoint Dev ecosystem during the past month.
What is SharePoint Patterns & Practices (PnP)?
SharePoint PnP is a nick-name for SharePoint Dev Ecosystem activities coordinated by SharePoint engineering. SharePoint PnP is community driven open source initiative where Microsoft and external community members are sharing their learning’s around implementation practices for SharePoint and Office 365. Active development and contributions happen in GitHub by providing contributions to the samples, reusable components, and documentation.
PnP is owned and coordinated by SharePoint engineering, but this is work done by the community for the community. The initiative is currently facilitated by Microsoft, but already at this point, we have multiple community members as part of the PnP Core team (see team details in end of the article) and we are looking to extend the Core team with more community members.
Notice that since this is open source community initiative, 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. You can use the SharePoint Developer group in the Microsoft Tech Community for providing input and to ask any questions about the existing materials.
Some key statistics around SharePoint Developer topics from October 2018
- GitHub repository forks at most popular repositories in SharePoint GitHub organization
- SP Dev Docs – 424
- SP Dev FX Web Parts – 879
- SP Dev Fx Extensions – 233
- PnP – 2974
- PnP Sites Core (CSOM) – 519
- PnP PowerShell – 497
- Unique visitors during the past 2 weeks in SharePoint organization repositories – 41,618
- Merged pull requests across SharePoint repositories (cumulative) – 5,377
- Closed issues and enhancements ideas cross SharePoint repositories (cumulative) – 4,778
- SharePoint Online CSOM NuGet package downloads (cumulative) – 754,186
- Page views in SharePoint Dev pages at docs.microsoft.com – 960,499
- Unique tenants using PnP components – 17,874
- Http requests towards SharePoint Online from PnP components (CSOM Core, PowerShell, PnP JS Core) – 10,618,021,685
- SharePoint Dev YouTube channel had 27,552 views with 178,088 minutes of watch time
Most viewed articles in the SharePoint Dev documentation during October 2018.
- Use column formatting to customize SharePoint
- SharePoint Development
- Build your first SharePoint client-side web part (Hello World part 1)
- Overview of the SharePoint Framework (SPFx)
- Complete basic operations using SharePoint REST endpoints
- Working with lists and list items with REST
- Set up your SharePoint Framework development environment
- Get to know the SharePoint REST service
- Complete basic operations using SharePoint client library code
- Set up your Office 365 tenant
Main resources around SharePoint PnP and SharePoint development
- SharePoint development portal and blog – https://developer.microsoft.com/en-us/sharepoint
- SharePoint Dev Documentation – http://docs.microsoft.com/sharepoint/dev
- SharePoint Dev Community – http://aka.ms/sppnp – One location for all the resources and news around PnP
- PnP Community Discussions – http://aka.ms/SPDev-Community
- SharePoint Dev Videos on YouTube – http://aka.ms/SPDev-Videos
November 2018 monthly community call
Agenda for the Tuesday 13th of November 2018 SharePoint Dev Ecosystem / Patterns and Practices community call at 8 AM PST / 5 PM CEST:
- Monthly summary of SharePoint Development topics – Latest SharePoint roadmap and community news – Patrick Rodgers (Microsoft) ~20 min
- Demo – List Formatting deployment and development with VS Code – David Warner II (Catapult) – 15 min
- Demo – How to simplify your JavaScript development towards SharePoint REST APIs with PnPjs latest capabilities – Patrick Rodgers (Microsoft) ~15 min
- Q&A
Monthly community call will get recorded and release to PnP YouTube channel typically within 24 hours after the recording is ended. If you have any questions, comments or feedback, please participate in our discussions in the Microsoft Tech Community under SharePoint developer group.
SharePoint Dev Blog posts
Here are the latest blog posts and announcements around SharePoint development topics from developer.microsoft.com/en-us/sharepoint/blogs
- 9th of November – SharePoint Framework Community Call Recording – 8th of Nov 2018
- 8th of November – Bring your apps to more places with new SharePoint Framework and Microsoft Teams releases – SPFx 1.7 release
- 7th of November – MVP Article – PnP SPFx Yeoman generator v1.4.0 – Angular Elements support is here!
- 6th of November – SharePoint Dev Weekly – Episode 12
- 2nd of November – Announcing Angular Elements support in PnP SPFx generator
- 2nd of November – SharePoint Dev Community (PnP) – General SP Dev SIG recording – 1st of November 2018
- 31st of October – Webcast – Calling Azure AD secured APIs from SharePoint Framework
- 30th of October – SharePoint Dev Weekly – Episode 11
- 30th of October – New SharePoint CSOM version released for SharePoint Online – October 2018
- 26th of October – SharePoint Framework Community Call Recording – 25th of Oct 2018
- 25th of October – Webcast – Introduction to tenant wide deployment of extensions
- 23rd of October – SharePoint Dev Weekly – Episode 10
- 16th of October – SharePoint Dev Weekly – Episode 9
- 10th of October – SharePoint Dev Community (PnP) – October 2018 monthly community call recording
- 9th of October – SharePoint Development Community (PnP) – October 2018 update
- 9th of October – SharePoint Dev Weekly – Episode 8
- 5th of October – SharePoint Dev Community (PnP) – General SP Dev SIG recording – 4th of October 2018
- 4th of October – Opening SharePoint Dev Blog for community posts
- 4th of October – MVP Article – Using Theme Colors in List Formatting
- 3th of October – Webcast – Using MSGraphClient within SharePoint Framework
- 2nd of October – SharePoint Dev Weekly – Episode 7
PnP Community Calls
SharePoint Dev community has 3 different recurrent community calls, which you can choose to participate based on your interest and availability. All calls are recorded and published in the SharePoint Dev YouTube channel typically within the following 24 hours after the call.
- Monthly community call – Second Tuesday of each month at 8 AM Pacific Time. Consists of the latest news, providing credits for all community contributors and live demos.
- Bi-weekly special interest group for SharePoint Framework – Bi-weekly Thursdays at 7 AM Pacific time. Consists from topics around SharePoint Framework and JavaScript-based development in the SharePoint platform.
- Bi-weekly special interest group for SharePoint General Dev – SharePoint dev platform topics which are not around JavaScript development. Site Designs, PnP Provisioning, CSOM, Column formatting, hub sites, branding, architectural designs etc.
If you are interested in doing a live demo of your solution or sample in these calls, please do reach out to the PnP Core Team members (contacts later in this post). These are great opportunities to gain visibility for example for existing MVPs or for community members who would like to be MVPs in the future.
SharePoint Dev Ecosystem in GitHub
There are quite a few different GitHub repositories under the SharePoint brand since we wanted to ensure that you can easily find and reuse what’s relevant to you. We do also combine multiple solutions to one repository so that you can more easily sync and get the latest changes to our released guidance and samples.
- sp-dev-docs – Source for new SharePoint dev center documentation exposed from http://dev.office.com/sharepoint
- sp-dev-fx-webparts – Client-side web part samples from community and engineering
- sp-dev-samples – Samples for add-ins, webhooks, and other API
- sp-dev-fx-extensions – Samples and tutorial code around SharePoint Framework Extensions
- 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-gdpr-activity-hub – Reference solution on the GDPR business case showing SPFx implementation with PowerBI and modern site customization
- sp-dev-solutions – Repository for more polished and fine-tuned reusable solutions build with SharePoint Framework
- 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-starter-kit – Starter kit solution for SharePoint modern experiences
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-Partner-Pack – Packaged guidance with detailed instructions on setting things up in Office 365 and in Azure.
- PnP-Transformation – Material specifically for the transformation process. Currently, includes samples around InfoPath replacement and transformation tooling from farm solutions to add-in model.
- PnP-Provisioning-Schema – PnP Provisioning engine schema repository
- PnP-IdentityModel – Open source replacement of Microsoft.IdentityModel.Extensions.dll
Repositories in the PnP organization
- 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
What’s supportability story around PnP material?
Following statements apply across all of the PnP samples and solutions, including samples, core component(s) and solutions, like SharePoint Starter Kit.
- 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 implementations are reviewed and approved by Microsoft engineering
- 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
Area-specific updates
SharePoint Starter Kit
SharePoint Starter Kit demonstrates how to extend out of the box modern experiences in the SharePoint. It demonstrates multiple different techniques and uses different patterns and practices to build end-to-end demonstration solution which can be provisioned to any Office 365 tenant. It contains for example following capabilities, which you can learn from or use them as your reference:
- How to provision site collections using PowerShell
- How to apply content and layouts to site collections
- How to create and use Site Designs and Site Scripts
- How to build custom web parts and extensions for your deployment
- 15 different ready to use web parts
- 7 different extensions
- Hub site configuration
- 3 site collections
- Automated provisioning of the whole solution with PnP Provisioning engine
- etc. etc. etc.
Following are the key changes in the Starter Kit since the previous monthly summary
- Documentation improvements
- Additional language translations
- Code optimizations
We do welcome contributions on this open-source community project.
SharePoint development samples
These are samples which are available from the SharePoint client-side web part sample repository at https://github.com/SharePoint/sp-dev-fx-webparts or from the SharePoint Framework Extensions repository at https://github.com/SharePoint/sp-dev-fx-extensions.
Web parts
- New sample react-realtime-documents illustrating using the SharePoint Framework List subscription capability introduced in SharePoint Framework v1.7
- New sample react-team-creator illustrates the usage of MS Graph beta APIs to work with Teams
- New sample react-components-dynamicloadig showing how to load React components and third-party packages on-demand
- New sample react-display-hierarchy sample showing to build a web part showing hierarchical information
- Updated react-events-dynamicdata sample to demonstrate how the dynamic data capability works with SharePoint Framework 1.7 release
- Numerous other updates on updating solutions to the latest version and other adjustments
SharePoint Framework Extensions
- New sample js-command-convert-to-pdf demonstrating how to use Azure Function from List View Command set to convert a document to PDF format
- New sample react-aadtokenprovider-bot demonstrating how to integrate a bot within a SharePoint Online portal supporting authentication to access Azure AD protected APIs like Microsoft graph resources
- Numerous other updates on updating solutions to the latest version and other adjustments
Other samples and solutions
- Lot’s of improvements in the SharePoint Modernization Framework which can be used to transform classic wiki and web part pages to client-side modern pages
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 SharePointOnlinee 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.
- Site Designs and Site Scripts – Community contributed samples around SharePoint Site Designs and Site Scripts in GitHub.
SharePoint Dev articles
SharePoint Dev articles are surfaced at docs.microsoft.com/en-us/sharepoint/dev. ´Since the last release, we have now merged also SharePoint PnP Solution guidance to docs.microsoft.com platform, so you’ll only have one location to follow all relevant SharePoint Dev documentation and guidance. 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 the SharePoint Development.
- New article Connect SharePoint Framework components using dynamic data
- New article Building Microsoft Teams Tabs using SharePoint Framework
- New tutorial – Building Microsoft Teams tab using SharePoint Framework
- New article Hosting Microsoft Teams Tabs as a solution in SharePoint
- New article Using single part app pages in SharePoint Online
- New article Isolated web parts
- New article Subscribe to list notifications
- Updated SharePoint Framework client-side web part development tutorials to the SPFx 1.7 level
- Updated SharePoint Framework extensions tutorials to the SPFx 1.7 level
- Updates on the modernization guidance for transforming from classic to modern experiences
- Updates on the Site Designs and Site Script guidance
- And the countless other adjustments and updates on the documentation
SharePoint Dev YouTube video channel
You can find all SharePoint Dev videos on our YouTube Channel at http://aka.ms/spdev-videos. This location contains already a significant amount of detailed training material, demo videos, and community call recordings.
- SharePoint Framework Tutorial – Surfacing your solution as a Microsoft Teams tab
- Preview of page transformation for SharePoint Online users
Key contributors to the November 2018 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 making a difference!
- Albert-Jan Schot (Mavention) – @appieschot
- Alex Terentiev (SharePointalist) – @alexaterentiev
- Alex Thomas – alex–thomas
- Amy – amyegan
- Andrew Connell (Voitanos) – @andrewconnell
- Andrew Koltyakov (ARVO Systems) – @andrewkoltyakov
- Anoop Tatti (Content and Code) – anoopt
- Antti K. Koskela (Valo) – @koskila
- Arjen Bloemsma (motion10) – @arjenbloemsma
- Asish Padhy – @asishpadhy
- Balamurugan Kailasam – @clientbala
- Beau Cameron – @Beau__Cameron
- Chris Kent (DMI) – @theChrisKent
- Daniel Laskewith (Sogeti) – @laskewitz
- David Warner II (Catapult) – @DavidWarnerII
- Devin Prejean – devinprejean
- Dragan Panjkov (K2) – @panjkov
- Elio Struyf – @eliostruyf
- Erwin van Hunen (Rencore) – @erwinvanhunen
- Eric Shupps – @eshupps
- Frank Cornu (aequos) – @FranckCornu
- François-Xavier Cat – lazywinadmin
- freginold – freginold
- Gautam Sheth (Rapid Circle) – @gautamdsheth
- Hugo Bernier – bernierh
- I-question-this – I-question-this
- Jérémy Crestel (Avalon Lab) – @j_crestel
- Jesper Lund Stocholm – jlundstocholm
- João Mendes – @joaojmendes
- Joon du Randt – Joon
- Joel Rodrigues (CPS) – joelfmrodrigues
- kcasamento alias – kcasamento
- Kemal Sinanagic (Ventigrate) – KEMiCZA
- Luis Mañez (ClearPeople) – @luismanez
- Mark Rackley (PAIT Group) – @mrackley
- Mikael Svenson (Puzzlepart) – @mikaelsvenson
- Ole Bergtun (FirstPoint) – trillian74
- Paolo Pialorsi (PiaSys.com) – @PaoloPia
- Paul Bullock (Capa Creative) – @pkbullock
- Paul Schaeflein – @paulschaeflein
- Paul Ewert – paulewert
- Paweł Hawrylak (EG A/S) – phawrylak
- Pedro Pedrosa – pedro-pedrosa
- Radi Atanassov (OneBit Software) – @RadiAtanassov
- Richard Gigan – PooLP
- Riwut Libinuko – cakriwut
- royarin – royarin
- Sean – seanmarthur
- Simon Ågren (Sogeti) – @agrenpoint
- Spencer Harbar (ClearPeople) – @harbars
- sqlsolver – sqlsolver
- Stefan Bauer (n8d) – @StfBauer
- Thaddeus Ferber – thaddeusferber
- Tomas Hallberg (Adiro) – thlbrg
- tommypage777 – tommypage777
- Todd Baginski (Canviz) – @toddbaginski
- Tse Kit Yam (Esquel) – tsekityam
- Vincent Biret (2toLead) – @baywet
- Vardhaman Deshpande (Content and Code) – vrdmn
- Waldek Mastykarz (Rencore) – @waldekm
- Velin Georgiev – @velingeorgiev
- William Haywood – willhaywood
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 PnP initiative. 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.
Microsoft people: Here’s the list of Microsoft people who have been closely involved with the PnP work during last month.
- Adam Ford – ajford76
- Bert Jansen – @O365Bert
- Bob German – @Bob1German
- Chris Hackman
- Junle Li – lijunle
- King Kang – KingKangMSFT
- Koen Zomers – @koenzomersto
- Lincoln DeMaris
- Luca Bandinelli – lucaband
- Mike Ammerlaan – @mikeamm
- Pat Miller – @PatMill_MSFT
- Patrick Rodgers – @mediocrebowler
- Robin Meure – @robinmeure
- Sean Squires – @iamseansquires
- Seiya Su – Seiyasu
- Tom Resing – @resing
- Tone Kristin Larsen – tklarsen
- Vesa Juvonen – @vesajuvonen
SharePoint PnP Core Team
SharePoint PnP Core team manages SharePoint PnP community work in the GitHub and also coordinates different open-source projects around SharePoint development topics. PnP Core Team members have a significant impact on driving adoption of the Office 365 and SharePoint development topics. They have shown their commitment to the open-source and community driven work by constantly contributing for the benefit of the others in the community. Thank you for all that you do!
- Erwin van Hunen (Rencore) – @erwinvanhunen
- Paolo Pialorsi (Piasys.com) – @PaoloPia
- Radi Atanassov (OneBit Software) – @RadiAtanassov
- Elio Struyf (Valo Intranet) – @eliostruyf
- Andrew Connell (Voitanos) – @andrewconnell
- Mikael Svenson (Puzzlepart) – @mikaelsvenson
- Andrew Koltyakov (ARVO Systems) – @andrewkoltyakov
- Chris Kent (DMI) – @theChrisKent
- Stefan Bauer (n8d) – @StfBauer
- Velin Georgiev – @velingeorgiev
- Waldek Mastykarz – @waldekm
Here are the Microsoft Internal PnP Core team members:
- Bert Jansen – @O365Bert
- Patrick Rodgers – @mediocrebowler
- Vesa Juvonen – @vesajuvonen
Next steps
- November 2018 monthly community call is on Tuesday 13th of November at 8 AM PST / 5 PM CEST / 4 PM GMT for latest release details with demos – Download recurrent invite to monthly community call with a detailed schedule for your time zone from http://aka.ms/sppnp-call.
“Sharing is caring”
SharePoint Team, Microsoft – 12th of November 2018