The SharePoint Patterns and Practices Team is excited to announce the release of the Patterns and Practices Client-side Libraries (PnPJS). 

Introduction

PnPJS is a fluent JavaScript API for consuming SharePoint and Office 365 REST APIs in a type-safe way. You can use it with SharePoint Framework, Nodejs, or JavaScript projects. This an open source initiative complements existing SDKs provided by Microsoft offering developers another way to consume information from SharePoint and Office 365.

PnP Client Libraries

There are nine packages included in the initial release. Each is linked to its specific documentation where you can find more details.

• @pnp/common - Provides shared functionality across all pnp libraries
• @pnp/config-store - Provides a way to manage configuration within your application
• @pnp/graph - Provides a fluent API for working with Microsoft Graph
• @pnp/logging - Light-weight, subscribable logging framework
• @pnp/nodejs - Provides functionality enabling the @pnp libraries within nodejs
• @pnp/odata - Provides shared odata functionality and base classes
• @pnp/pnpjs - Rollup library of core functionality (mimics sp-pnp-js structure in previous version)
• @pnp/sp - Provides a fluent API for working with SharePoint REST
• @pnp/sp-addinhelpers - Provides functionality for working within SharePoint add-ins
  
  

Usage

The libraries have interrelated peer dependencies, so you will need to install these as well as the primary package you wish to use. We will take as an example the task of getting a SharePoint web’s title. First, we need to install the @pnp/sp library as well as the libraries upon which it depends.

npm install @pnp/logging @pnp/common @pnp/odata @pnp/sp --save

Next, we will import and use the functionality from @pnp/sp within our application.

// get the sp variable from the library
// this will serve as the root of our fluent chain
import { sp } from “@pnp/sp”;

// now get the web’s title
sp.web.select(“Title”).get().then(w => {
  console.log(`Title: ${w.Title}`);
});

The above is a basic example of what is possible – please check out the documentation for more details on all of the included libraries.

Get involved

There are several ways to get involved in working on the PnPJS libraries and we encourage anyone who is interested to reach out. You can submit a pull request to the git repository. We try and mark issues as help wanted when possible if you are looking for something to work on. Or join SharePoint Framework and client-side dev bi-weekly community calls where we cover topics related to these libraries as well as latest news on SharePoint framework, community demos, and other SharePoint Dev Patterns and Practices projects.

Feedback on the PnPJS libraries

We always appreciate feedback on our work, and with the launch of the PnPJS libraries, we want to renew our push for community involvement. If you find issues, have suggestions, or would like to submit a feature please open an issue. You can also post on the Microsoft Tech Community SharePoint Dev channel or reach out to us on twitter @officedevpnp if you have questions.

What is SharePoint Patterns and Practices?

SharePoint Patterns and Practices (PnP) is an open source initiative coordinated by SharePoint engineering. It's a channel for the SharePoint engineering to share documentation, guidance, samples and reusable component for the community. PnP initiative coordinates all SharePoint developer documentation and guidance across on-premises and online. Day to day work is coordinated by the PnP Core team, which consists of Microsoft internal people and external MVPs. If you have any input or feedback around SharePoint developer guidance, don't hesitate to start a discussion with the team at Microsoft Tech Community site at http://aka.ms/sppnp-community.

“Sharing is caring”

Patrick Rodgers, Senior Program Manager, Microsoft - 24th of January 2018

We are happy to announce the availability of new SharePoint Client-Side Object Model (CSOM) version targeted for the Office 365 or more specifically for SharePoint and Project Online. This release again contains updates on the existing SharePoint and Project CSOM assemblies. Notice that some of the below new capabilities do NOT work in normal tenants until the capability is truly released and enabled. There will be separate communications around availability fo the new capabilities when they are available.

You can find the latest CSOM package for SharePoint Online, including the Project Online CSOM assembly, from the NuGet gallery with an id of 'Microsoft.SharePointOnline.CSOM'. We are also working on updating the redistributable package at some point, but you can already right now start using some of these new capabilities in your solutions. We do recommend you to use the NuGet Package to gain access to the latest version, rather than downloading the SDK to your machine.

The version of the newly released CSOM package is 16.1.7317.1200. Previous versions of the NuGet have not been removed so that your existing solutions will continue working without issues and you can decide when the new version is taken into use. Notice that even though the NuGet version is increased to 16.1.7317.1200, actual assembly version of the released assemblies is 16.1.0.0. You can also check the version of the assemblies from the File Version attribute, which aligns with the NuGet version.

SharePoint Online Management Shell has been also updated to match with this CSOM release. You can find a new set of cmdlets listed in this article. 

Notice that since this NuGet package is targeted to SharePoint Online, you cannot use it directly in on-premises environments (SharePoint 2013 or 2016). This is because of the server side dependencies of the APIs. CSOM versioning model and dependency to your target environment are clarified in following blog post - Using correct Client-Side Object Model (CSOM) version for SharePoint customizations. We have released separate NuGet packages for on-premises. See following blog post for additional details - SharePoint CSOM versions for on-premises released as NuGet packages.

New properties and methods across assemblies

Here's a raw list of all the changes in the classes, properties and methods within this package. 

Microsoft.SharePoint.Client

Following properties, classes and methods have been added.

• public method Microsoft.SharePoint.Client.ClientContext.ExecuteQueryAsync
  
  
• public property Microsoft.SharePoint.Client.DocumentLibraryInformation.FromCrossFarm
• public method Microsoft.SharePoint.Client.File.RecycleWithETag
  
  
• public enum Microsoft.SharePoint.Client.FlowSynchronizationStatus
• public property Microsoft.SharePoint.Client.Site.ThicketSupportDisabled
  
  
• public property Microsoft.SharePoint.Client.Web.SiteCollectionAppCatalog
• public class Microsoft.SharePoint.Marketplace.CorporateCuratedGallery.SiteCollectionCorporateCatalogAccessor

Declaration has been changed for following method

• public method Microsoft.SharePoint.Client.List.SyncFlowTemplate
  
  

Microsoft.Online.SharePoint.Client.Tenant

Following properties, classes and methods have been added.

• public class Microsoft.Online.SharePoint.TenantAdministration.EmailAdminsFieldsData
  
  
• public method Microsoft.Online.SharePoint.TenantAdministration.Tenant.UpdateSiteDesign
• public method Microsoft.Online.SharePoint.TenantAdministration.Tenant.UpdateSiteScript
  
  
• public method Microsoft.Online.SharePoint.TenantAdministration.Tenant.UpdateUserTypeFromAzureAD
  
  

Microsoft.SharePoint.Client.UserProfiles

Following properties, classes and methods have been added.

• public property Microsoft.SharePoint.Client.UserProfiles.UserProfile.IsDefaultDocumentLibraryBlocked
  
  

New PowerShell cmdlets in SharePoint Online Management Shell release

Following cmdlets have been added to the latest release of SPO Managment Shell. Notice that some of the below commands do NOT work in normal tenants until the capability is truly released and enabled. There will be separate communications around availability fo the new capabilities when they are released. 

• Get-SPOMultiGeoCompanyAllowedDataLocation
• Remove-SPOMultiGeoCompanyAllowedDataLocation
• Set-SPOMultiGeoCompanyAllowedDataLocation
• Set-SPOSiteGroup
• Set-SPOSiteScript

PowerShell documentation has been also moved to docs.microsoft.com platform and will be updated more frequently in the future.

“Sharing is caring”

Vesa Juvonen, Senior Program Manager, SharePoint Engineering, Microsoft - 26th of January 2017

Today we announced new features in Teams that make it an even more powerful hub for teamwork – enabling teams to use apps in new ways and allowing them to take quick actions from wherever they are in Teams. What does this mean for developers? Teams apps will be more visible and accessible than ever! Learn more about these new app features.

Introducing the Teams App Studio:

As we launch this new app experience for Teams users, we also want to introduce the Teams App Studio, a new tool to help you build your own apps. Available in Developer Preview, the Teams App Studio makes it easy to start developing or integrating your own service, whether you develop custom apps for your enterprise or SaaS applications for teams around the world. The Teams App Studio streamlines creation of the manifest for your app, and provides other useful tools like the Card Editor and a React control library.

Learn more about the Teams App Studio. Then get started with Microsoft Teams and install Teams App Studio from the new Store.

Microsoft Reactor

70 Wilson Street

London, EC2A 2DB

Microsoft is pleased to invite you to an exclusive developer event focused on developing next generation Enterprise and Business Applications with Office 365 and Azure. OpenHack is a fun, challenge-based coding event hosted in London, England, 6-8 March 2018.  Register Now!

OpenHack developers will learn how to build key scenarios using Microsoft Graph, Microsoft Teams, and Azure Serverless technologies across three days of immersive, structured, hands-on hacking. Web development experience (particularly in NodeJS or ASP.NET) is helpful and experience with the bot framework and/or Azure AD is a big plus. However, don’t worry if you’re not familiar with these development platforms, documentation will be provided that will assist any developer in completing the challenges.  

During the three days of hands-on hacking you will team up with Microsoft Engineers and community peers to leverage the power of the data in the Microsoft Graph as well as utilizing the extensibility of Microsoft Teams along with highly scalable and economical Azure Serverless technologies.    

OpenHack is FREE for registered attendees! Food, refreshments, prizes and fun will be provided.  Please bring your own development laptop. If travelling, attendees are responsible for their own travel expenses and evening meals. 

After the 3 Day Event, you’ll have mastered a set of developer challenges, increased your expertise in development with Office 365 and Azure as well as building some great relationships with other Professional Developers and Microsoft Engineers.  

Below are some helpful resources:

Microsoft Graph

Microsoft Teams

Azure Functions

Logic Apps

Event Grid

We look forward to seeing you at the OpenHack! 

In this PnP Webcast, we concentrated on Dialog Framework, which is part of the SharePoint Framework. This dialog framework can be used to present alerts, prompts or you can design your own custom dialog. You can take advantage of the Dialog Framework in your custom web parts and extensions.

Presentation covers following discussion points:

• Introduction
• Key components / types
• Out-of-the-box dialogs - Alert and Prompt
• Building Custom Dialog Boxes

Webcast demo shows following things:

• Demonstration of the Discuss Now sample which uses a custom dialog box
• Walkthrough of the actual implementation of the solution
• Demonstration of the out-of-the-box Alert and Prompt methods 

Webcast presenters: Paolo Pialorsi, Vesa Juvonen

The presentation used in this webcast is available from new PnP SlideShare locations at https://www.slideshare.net/SharePointPnP.

Video on YouTube.

Additional resources

See following resources on the covered topics.

• Discuss Now sample demonstrated in the webcast
• Use custom dialog boxes with SharePoint Framework Extensions tutorial in official SharePoint dev documentation
• @microsoft/sp-dialog package API reference
  
  
• SharePoint Framework documentation
• SharePoint Framework Tutorials
• PnP Webcast - Reusable controls for your SharePoint Framework solutions
• PnP Webcast - Site collection app catalog
• PnP Webcast - Including assets in SharePoint Framework solution packages
• PnP Webcast - Migrating to SharePoint Framework Extensions
• PnP Webcast - ALM APIs for SharePoint Framework solutions and SharePoint add-ins (apps)
• PnP Webcast - Defining an icon for client-side web part
• PnP Webcast - Working with Tenant Properties in SharePoint Online
• PnP Webcast - Deployment options for SharePoint Framework solutions
• PnP Webcast - SharePoint Framework in SharePoint 2016 Feature Pack 2
• PnP Webcast - VSTS Build and Release Pipelines for SharePoint Framework Solutions
• PnP Webcast - Common (mis)conceptions about SharePoint Framework
• PnP Webcast – Introduction to Visual Studio Extension for SharePoint Framework
• PnP Webcast - Calling external APIs securely from SharePoint Framework
• PnP Webcast - SharePoint Framework and organizational considerations
• PnP Webcast - Provisioning SharePoint assets for your SharePoint Framework solution
• PnP Webcast - Validating SharePoint Framework client-side web part property values
• PnP Webcast - Getting started with SharePoint Framework
  
  

What is SharePoint / Office Dev Patterns & Practices (PnP) webcast series?

SharePoint / Office Dev Patterns & Practices (PnP) webcast series covers different patterns, practices and topics around development with Office 365 and SharePoint. The majority of the topics are valid for the Office 365 and SharePoint on-premises. Our objective is to release a new webcast weekly or bi-weekly with few slides and a live demo of the covered topic. All webcasts are published at the PnP YouTube channel with additional references to the existing materials.

PnP is a community-driven open source project where Microsoft and external community members are sharing their learning's around implementation practices for Office 365 and SharePoint on-premises (add-in model). Active development and contributions happen in our GitHub repositories under dev branch and each month there will be a master merge (monthly release) with more comprehensive testing and communications. Latest activities and future plans are covered in our monthly community calls which are open to anyone from the community. Download invite from http://aka.ms/SPPnP-Call. 

This is work done by the community for the community without any actual full-time people. It’s been great to find both internal and external people who are willing to assist and share their learning's for the benefit of others. This way we can build on the common knowledge of us all. Currently, the program is facilitated by Microsoft, but already at this point, we have multiple community members as part of the Core team and we are looking to extend the Core team with more community members.

If you have any questions, comments or feedback on SharePoint Development topics, PnP program or this blog post, please use the Microsoft Tech Community (SharePoint Developer group).

“Sharing is caring”

Vesa Juvonen, Senior Program Manager, SharePoint, Microsoft - 5th of February 2018

SharePoint Dev Ecosystem / SharePoint Patterns and Practices (PnP) February 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 around 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 on 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 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 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 Dev topics from January 2018

• GitHub repository forks at most popular repositories in SharePoint GitHub organization 
  • SP Dev Docs - 298
  • SP Dev FX Web Parts - 451
  • SP Dev Fx Extensions - 67
  • PnP - 2660
  • PnP Sites Core - 449
  • PnP PowerShell - 415
  • PnP JS Core - 195
• Unique visitors during past 2 weeks in SharePoint organization repositories - 29,053
• Merged pull requests across SharePoint repositories (cumulative) - 4,573
• Closed issues and enhancements ideas cross SharePoint repositories (cumulative) - 3,006
• SharePoint Online CSOM NuGet package downloads (cumulative) - 368,687
• PnP Core component NuGet package downloads (cumulative) - 145,962
• Page views in SharePoint Dev pages at docs.microsoft.com - 743,359
• Unique tenants using PnP components - 9,117
• Http requests towards SharePoint Online from PnP components (CSOM Core, PowerShell, PnP JS Core) - 8,428,601,575
• SharePoint Dev YouTube channel had 25,178 views with 156,569 minutes watch time

Main resources around SharePoint PnP and SharePoint development

• SharePoint development portal - http://dev.office.com/sharepoint
• SharePoint Dev Documentation - http://docs.microsoft.com/sharepoint/dev
• PnP under dev.office.com – http://aka.ms/SPPnP - One location for all the resources and news around PnP
• PnP GitHub - http://aka.ms/SPPnP-GitHub - main repository
• PnP MSDN pages - http://aka.ms/SPPnP-MSDN
• PnP Community Discussions - http://aka.ms/SPPnP-Community
• PnP Videos on YouTube - http://aka.ms/SPPnP-Videos
• Presentations at docs.com - http://aka.ms/SPPnP-Docs - moving gradually to SlideShare
  
  

February 2018 monthly community call

Agenda for the Tuesday 13th of February 2018 SharePoint Dev Ecosystem / Patterns and Practices community call at 8 AM PST / 5 PM CEST:

• Monthly summary of SharePoint Development topics - Engineering update and community news - Vesa Juvonen (Microsoft) ~20 min
• Improved export/import capabilities in PnP provisioning engine around modern pages - Bert Jansen (Microsoft) ~20 min
• Introduction to Office 365 CLI - Andrew Connell (Voitanos) ~20 min
  
  

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 dev.office.com/blogs.

• 26th of January - New SharePoint CSOM version released for SharePoint Online - January 2017
• 24th of January - Introducing PnPJS client-side libraries for Office 365
• 10th of January - New version of Office 365 CLI (v0.4.0)
  
  

PnP Webcasts

We started new PnP Webcasts are typically 15-30 min long conversational webcasts around a specific topic. This series was started in October 2015 and have continued releasing new videos since. All new webcasts are released on PnP YouTube Channel. Here are the new webcasts released after the last monthly release. We are looking into continuing the releases of the webcast in the future using weekly or bi-weekly schedule depending on the topics to be covered.

• 5th of February - SharePoint Framework Dialog Framework
• 22nd of January - Introduction to SharePoint Site Designs and Site Scripts
• 8th of January - Asynchronous Pattern for Creating Modern SharePoint Sites
• 2nd of January - Reusable controls for your SharePoint Framework solutions
  
  

General Dev, CSOM, PnP Core, PnP PowerShell SIG Bi-Weekly Call Special Interest Group (SIG)

General SP Dev, CSOM PnP Sites Core, PowerShell and Provisioning Special Interest Group (SIG) have bi-weekly meetings to cover the general SharePoint topics, CSOM and latest in the PnP CSOM core component, PnP PowerShell and in the PnP remote provisioning engine. These calls have also free Q&A section if you have any questions about SharePoint development in on-premises or in the cloud. Need to get a recommendation for your design or having a hard time with some APIs? - Drop by, ask a question and we'll help you.

You can download invite for the bi-weekly meeting from the following location. 

• Invite to bi-weekly call - https://aka.ms/sppnp-core-sig-call

All SIG meetings are being recorded and are available for view from PnP YouTube Channel. Here are the latest recordings of the SIG calls.

• 25th of January - General announcements and SP Dev roadmap update. Modern page API handling updates. Groupify / modernization scanner.
• 11th of January - Deep dive to Site Designs and Site Scripts with Q&A with SharePoint Engineering.
  
  

Interested in doing a community demo in these community calls? - Please let us know!

SharePoint Framework (SPFX) and JavaScript Special Interest Group (SIG)

SharePoint Framework and JavaScript Special Interest Group (SIG) has bi-weekly meetings to cover latest changes in the SharePoint Framework side, from the engineering perspective and to cover also latest development related to the PnP JS Core library. These calls are designed to have 50%/50% of content and demos and there has been already great community demos on the new SharePoint Framework Client-side web parts. If you're interested in showing your code, just let us know.

• Invite to bi-weekly call - https://aka.ms/sppnp-js-sig-call
• Gitter (Around the PnP JS Core) - https://gitter.im/OfficeDev/PnP-JS-Core

All SharePoint Framework and JS SIG meetings are recorded, so that you can check the demos and discussions if you can't make the actual call. You can find the latest recordings from the PnP YouTube Channel. Here are the latest recordings.

• 1st of February - SharePoint Framework engineering update, PnP JS Core update, Office 365 CLI update, SPFx controls update - Live demos around @pnp/sp and community samples.
• 18th of January - PnP JS Core library update, Office 365 CLI update, SPFx reusable controls update - Live community demos on SPFx extensions and bot framework integration.
• 4th of January - PnP JS Core library updates, SharePoint Framework update, Reusable controls for SPFx - Live demos on upcoming Graph capabilities with SPFx, reusable controls and async with JSOM.
  
  

Interested in doing a community demo in these community calls? - Please let us know!

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 latest changes of 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-column-formatting - New open-source community driven repository for column formatting JSON definitions
• sp-dev-site-scripts - New open-source community driven repository for community Site Designs and Site Scripts

• PnP - Main repository for SP add-in, Microsoft Graph etc. samples
• PnP-Guidance - Guidance, presentations, and articles which are partly synced to MSDN
• PnP-Sites-Core - Office Dev PnP Core component
• PnP-JS-Core - Office Dev PnP Core component for JavaScript
• PnP-PowerShell - Office Dev PnP PowerShell Cmdlets
• PnP-Tools - New repository for 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-Templates - Source for templates available from PnP Template Gallery at http://templates-gallery.sharepointpnp.com
• PnP-Provisioning-Schema - PnP Provisioning engine schema repository
• PnP-IdentityModel - Open source replacement of Microsoft.IdentityModel.Extensions.dll
  
  

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 PnP Partner Pack.

• 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 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
  
  

Latest changes

SharePoint Framework 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.  

• Multiple web parts updated to use latest SharePoint 1.4 version and cleaning existing SharePoint Framework client-side web part samples
  
  
• Multiple extensions updated to use latest SharePoint Framework 1.4 version and cleaning in existing SharePoint Framework extension samples
  
  

Reusable open source controls for SharePoint Framework

New reusable controls initiative was announced in Ignite 2017 during September. There are two new npm packages and source code repositories for the reusable controls which you can use in your SharePoint Framework solutions. We do welcome community contributions to these initiatives as well. There are two different repositories: sp-dev-fx-property-controls and sp-dev-fx-controls-react. Here are the changes on these repositories.

• New Field controls added to the project - Helping on rendering field values in standard ways with FieldCustomizers
• PropertyFieldTermPicker improved with a save and a cancel button
• PropertyFieldTermPicker improved with `onClick` event on input field
  
  

Community column formatting definitions

SharePoint Columns Formatting capability was released for First Release customers during October 2017. As part of the availability, we also announced the availability of open source repository for sharing different column formatting definitions. Following lists the changes in the column formatting area.

• Numerous updates on existing samples in the open-source repository
  
  

Office 365 CLI 

Office 365 CLI was released in November 2017. This is an open source tool which enables you to controls tenant level properties in SharePoint Online or in Office 365 without the need of using PowerShell. SharePoint Online Management Shell is only available for Windows operating system. Changes since last monthly summary are following.

v0.5.0 release available with following changes

• spositescript add - adds site script for use with site designs #65
• spositescript list - lists site script available for use with site designs #66
• spositescript get - gets information about the specified site script #67
• spositescript remove - removes the specified site script #68
• spositescript set - updates existing site script #216
• spositedesign add - adds site design for creating modern sites #69
• spositedesign get - gets information about the specified site design #86
• spositedesign list - lists available site designs for creating modern sites #85
• spositedesign remove - removes the specified site design #87
• spositedesign rights grant - grants access to a site design for one or more principals #88
• spositedesign rights revoke - revokes access from a site design for one or more principals #89
• spositedesign rights list - gets a list of principals that have access to a site design #90
• spo list get - gets information about the specific list #199
• spocustomaction remove - removes the specified custom action #21
• spo site classic list - lists sites of the given type #122
• spo list list - lists all available list in the specified site #198
• spohubsite list - lists hub sites in the current tenant #91
• spohubsite get - gets information about the specified hub site #92
• spohubsite register - registers the specified site collection as a hub site #94
• spohubsite unregister - unregisters the specified site collection as a hub site #95
• spohubsite set - updates properties of the specified hub site #96
• spohubsite connect - connects the specified site collection to the given hub site #97
• spohubsite disconnect - disconnects the specifies site collection from its hub site #98
• spohubsite rights grant - grants permissions to join the hub site for one or more principals #99
• spohubsite rights revoke - revokes rights to join sites to the specified hub site for one or more principals #100
• spocustomaction set - updates a user custom action for site or site collection #212
  
  
• fixed issue with prompts in non-interactive mode #142
• added information about the current user to status commands #202
• fixed issue with completing input that doesn’t match commands #222
• fixed issue with escaping numeric input #226
• changed the aad oauth2grant list, spo app list, spocustomaction list, spo site list commands to list all properties for output type JSON #232, #233, #234, #235
• fixed issue with generating clink completion file #252
• added user guide#236, #237, #238, #239
  
  

PnP CSOM Core and Provisioning Engine

PnP CSOM Core component is a wrapper on top of native SharePoint CSOM and REST API, which simplifies complex scenarios with remote APIs, one of the example is the PnP Provisioning Engine for remote templates. The first version of the PnP remote provisioning engine was released with the May 2015 release. This list contains the main updates in this release:

• The provisioning engine default schema now is the 2018-01 version
• Improved tokenization of client-side pages via the following new tokens: FileUniqueIdToken, FileUniqueIdEncodedToken, PageUniqueIdToken, PageUniqueIdEncodedToken, HostUrlToken, SiteCollectionConnectedOffice365GroupId, SiteCollectionIdEncodedToken and SiteIdEncodedToken
• Improved handling of dependent files during export of client-side home page: if the engine can detect a file being used by one of the web parts on the page and that file lives in the current site then it will be included in the export (assuming the PersistBrandingFiles flag was set)
• Improved handling of 1st party web parts by reading and writing the serverProcessedContent properties as part of the control's properties
• Enabled Navigation object handler to work with NoScript enabled sites like communication sited and modern team sites
• Refactored ObjectClientSidePageContents handler to make it easy for extensibility providers to export more than just the default site's home page
• Some new 1st party client-side web parts are added (CustomMessageRegion, Divider, MicrosoftForms, Spacer) to the client side pages API
• Extensibility handlers can now also run at "apply time" by only specifying them as part of the PnP-PS command...previously they had to be defined in the provisioning template as well
• List object handler will now not try to create a webhook which is already defined as expired in the template
• Base templates are updated and now all are based on the 2018-01 schema
• Test case improvements and stability changes (edited)

See also https://testautomation.sharepointpnp.com for day-to-day results and executed tests.

PnP JavaScript Core Library

No actual updates on the Patterns and Practices JavaScript Core Library, but there have been active discussions on the package in Gitter channel. Here are the changes since last monthly communications. 

• Preparations for the new library version from the @pnp scope
• Improved docs for the new @pnp scope version
• Various smaller improvements and fixes

This is a similar effort as what PnP initiative previously has done with the PnP CSOM Core Component together with the community. 

PnP PowerShell

PnP PowerShell providers more than two hundred additional PowerShell cmdlets, which can be used to manipulate content in SharePoint Online and in on-premises (SP2013, SP2016). These cmdlets are additive for SharePoint Online management shell, which concentrate more on the administrative tasks with SharePoint Online. 

Here are the latest changes in the PnP PowerShell

• Various small bug fixes, improvements and documentation updates
• New cmdlet Set-PnPSiteDesign
• New cmdlet Set-PnPSiteScript 
• Numerous other updates cross existing commands
• Overall quality improvements and bug fixes
• Updated automatically generated PnP PowerShell cmdlet documentation at docs.microsoft.com
  
  

PnP sample library

Here are updates across the PnP code sample library by the community on the code and documentation, which is a great way to contribute as well.

• New SharePoint Modernization Scanner for preparing your classic team sites for modernization by analyzing readiness of your existing sites
• Updates to AspNetCore.Authentication solution sample to run with .net core 2.0 authentication changes
• Updates to Business.StarterIntranet solution sample, which is a generic, enterprise intranet publishing solution, compatible with SharePoint 2013, 2016 and SharePoint Online.
  
  

SharePoint Dev articles 

SharePoint Dev articles are surfaced currently in 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. 

• Use the Office 365 content delivery network (CDN)
• Updates on the column formatting functionality documentation
• Updates on the Site Design and Site Script documentation
  
  • SharePoint Site Design and Site Script Overview
  • Get started creating site designs and site scripts
  • Scoping access to site designs
  • Customize a default site design
  • Site design JSON schema
  • PowerShell cmdlets for SharePoint site designs and site scripts
  • Site design and site script REST API
  • Calling the PnP Provisioning Engine from a Site Script
• Updates on numerous other articles on ensuring that the guidance is up to date where possible
  
  

PnP Guidance videos 

You can find all SharePoint Dev videos on our YouTube Channel at http://aka.ms/sppnp-videos. This location contains already a significant amount of detailed training material, demo videos, and community call recordings. 

• Migrate from sp-pnp-js to @pnp/sp
  
  

Key contributors to the February 2017 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 the behalf of the community. You are making a difference!

• Alex Terentiev (SharePointalist) - @alexaterentiev
• Andrew Connell (Voitanos) - @andrewconnell
• Andrew Koltyakov (ARVO Systems) - @andrewkoltyakov
• Aquila Sands - AquilaSands
• Chris Kent (DMI) - @theChrisKent
• Daniel Laskewitz (Sogeti) - @laskewitz
• Elio Struyf - @eliostruyf 
• Erwin van Hunen (Rencore) - @erwinvanhunen 
• Eric Shupps - @eshupps
• Franck Cornu (aequos) - @FranckCornu
• Gautam Sheth (Rapid Circle) - gautamdsheth
• Giuliano De Luca - @giuleon
• Joel Rodrigues (CPS) - joelfmrodrigues
• Kyle Schaeffer - @kyleschaeffer
• Lee Dale (A Thousand Threads Ltd) - leedale1981
• Luis Mañez (ClearPeople) - @luismanez
• Mikael Svenson (Puzzlepart) - @mikaelsvenson
• Ole Marting Pettersen (Puzzlepart) - olemp
• Paolo Pialorsi (PiaSys.com) - @PaoloPia
• Paul Schaeflein - @paulschaeflein
• Radi Atanassov (OneBit Software) - @RadiAtanassov
• Rodrigo Silva (Storm Technology) - @RodResendeSilva 
• Robert Schouten (Wortell) - @rfjschouten
• S Merchant - sohailmerchant
• Sergei Sergeev - @sergeev_srg
• Spencer Harbar - @harbars
• Stefan Bauer (n8d) - @StfBauer
• Steve Beaugé (Solutions pour SharePoint) - stevebeauge
• Velin Georgiev - @velingeorgiev
• Waldek Mastykarz (Rencore) - @waldekm
  
  

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.

 

 

 

 

 

 

 

 

 

On the first Tuesday of every month join us for the Microsoft Graph API community call. You can download a recurring monthly calendar invite at https://aka.ms/microsoftgraphcall.

In this month's call, we reviewed API changes and examined three topics:

• Dave Randall from the Intune product team presented an introduction to the newly released Intune APIs available via Microsoft Graph
• Microsoft MVPs Martina Grom and Toni Pohl demonstrated Groups orchestration workflows using PowerApps, SharePoint Lists, Azure Functions and Microsoft Graph
• Dmitry Pimenov from the Microsoft Graph team walked through different options for storing custom data in the Microsoft Graph API

Special thanks to:

• Presenters: Martina Grom and Toni Pohl from @atwork
• Community contributors: Peter Daalmans, Nik Patel, Paolo Pialorsi, David Lavenda, Serge Luca, Elliot Munro, John Liu and Mayur Tendulkar

Watch the call here.

View the presentation here.

Resources:

From February’s call

• Intune API documentation – Working with Intune in Microsoft Graph
• Intune-specific suggestions - Intune UserVoice
• Microsoft Graph sample storage requests - GitHub Gist

 Microsoft Graph Community call

• Recurring monthly community call calendar invite - https://aka.ms/microsoftgraphcall
• Monthly community call topic requests and questions - https://aka.ms/ybuw2i
• Previous monthly call recordings – Office Development YouTube Channel

 Microsoft Graph feedback

• Microsoft Graph issues and technical questions - StackOverflow
• Microsoft Graph recommendations and suggestions - Microsoft Graph UserVoice

SharePoint monthly community call is our monthly event for SharePoint developers to stay up to date on the latest changes to SharePoint Dev topics from engineering and community perspective. This monthly community call is on every second Tuesday of each month where we go through a summary of SharePoint Development engineering news, latest guidance, status in UserVoice, community contributions and other relevant topics. 

You can also check the latest updates from the monthly summary at dev.office.com/blogs. You can download a recurrent invite for these monthly calls from http://aka.ms/spdev-call.

This is the recording of SharePoint Dev Ecosystem / Patterns and Practices (PnP) community call from Tuesday 13th of February 2018. Here's used agenda with direct links to specific sections, if you want to directly jump to a specific topic (will redirect your browser to SharePoint Dev YouTube Channel).

• Latest PnP component usage and GitHub metrics -  5:03
• Quick look at the SharePoint Developer roadmap - 10:54
• Top 10 UserVoice entries for SharePoint Dev and quick status - http://aka.ms/spdev-uservoice - 12:09
• Summary on February 2018 Release - Summary on released materials around SharePoint Development since last monthly call - 14:03
• Latest SharePoint Development videos - 16:01
• Community contributors and companies which have been involved - 16:23
  
  
• Demo - Preview of new provisioning schema and engine support status - Paolo Pialorsi (Piasys.com) - 18:35
• Demo - Introduction to Office 365 CLI - Andrew Connell (Voitanos) - 33:09
• Demo - APIs to modify modern page content and controls - Bert Jansen (Microsoft) - 49:23

Full recording - available from SharePoint Developer YouTube channel - http://aka.ms/spdev-videos.

Presentation slides used in the call

Additional resources

Additional resources on covered topics and discussions.

• February 2018 monthly summary
• Recurrent invite to SharePoint Development monthly calls - http://aka.ms/spdev-call
• SharePoint Developer documentation - http://aka.ms/spdev-docs
• SharePoint Development Issues - http://aka.ms/spdev-issues
• SharePoint GitHub organization - http://github.com/SharePoint
• SharePoint Development UserVoice - new feature requests - http://aka.ms/spdev-uservoice
  
  

“Sharing is caring”

Vesa Juvonen, Senior Program Manager, SharePoint, Microsoft  - 14th of February 2018

Build 2018, May 7^th– 9^th

Block your calendars for Build 2018, Seattle WA, USA. Registration starts February 15th.

SXSW, Austin TX, USA. March 11^th  

Come see us at SXSW. We’re partnering with Datica to offer a full day of sessions on how to use Teams, Bots and other Microsoft technologies to solve hard healthcare problems, like HIPAA compliance, data interoperability, and clinical adoption. 

OpenHack, London UK. Mar 6^th - 8^th

Microsoft is pleased to invite you to an exclusive developer event focused on developing next generation Enterprise and Business Applications with Office 365 and Azure. OpenHack is a fun, challenge-based coding event.  Register Now!

Spotlight

Microsoft Graph

In this month’s call, we reviewed API changes and examined three focus topics. 1) Newly released Intune APIs available via Microsoft Graph. 2) Groups orchestration workflows using PowerApps, SharePoint Lists & Azure Functions - presented by our MVP's Martina Grom and Toni Pohl from AtWork. 3) Microsoft Graph and different options for storing custom data in the Microsoft Graph API.

• The video can be found here.
• The presentation can be found here.

Hack Productivity 3

Congratulations to the winners of Hack Productivity 3, who built really cool Office 365 integrations and took home over $40K in cash and prizes! Hackers were asked to make smart Office 365 productivity solutions by building integrations, add-ins, web apps, mobile apps, or bots using resources from the Office 365 Dev Center. Check out the winning apps from our Hackers.

Content Updates

Outlook

• Announcing add-in support for Gmail accounts in mac outlook
• An improved add-in store experience inside outlook

Microsoft Graph

• New Python developer content for Microsoft Graph

 SharePoint

• SharePoint PnP Webcast – Reusable controls for your SharePoint Framework solutions
• SharePoint PnP Webcast – Asynchronous Pattern for Creating Modern SharePoint Sites
• SharePoint Patterns & Practices – January 2018 update
• New version of Office 365 CLI (v0.4.0)
• SharePoint Dev Ecosystem / Patterns and Practices - January 2018 monthly community call recording
• SharePoint PnP Webcast – Introduction to SharePoint Site Designs and Site Scripts
• Introducing PnPJS client-side libraries for Office 365

Microsoft Teams

• New ways to use apps in Microsoft Teams and a tool to help you build them

Excel

• Excel Add-in Tutorial
• How-to article on working with events using the Excel JavaScript API
• How-to article for calling built-in functions using the Excel JavaScript API
• Excel, Word, PowerPoint, and Outlook QuickStarts
• Significant update to the Convert an Office Add-in project in Visual Studio to TypeScript
• Added XML Parts to Office Add-ins Settings Persistence - storing custom settings with Office documents
• Single Sign-on documentation
• Excel Add-in SalesLeads code sample showing how to programmatically add data analysis to Excel

Meet the Community

Meet Jakub. Jakub along with his team Karolina, Mateusz, & Jacek won the Hack Productivity 3 this month.

1. What is the coolest Office 365 developer feature for you? Microsoft Graph API as a single endpoint for interacting with SharePoint Lists, Excel files, emails from Exchange and Azure AD users!
2. What school did you graduate from? University of Science and Technology (AGH) in Cracow
3. What’s your favorite city to live in? Cracow!
4. What did you want to be when you were a kid? A Radio News Anchor.
5. Which words or phrases do you most over-use? Super & Premium!
6. Which talent would you most like to have? To be more optimistic!
7. Where would you most like to live? Poland remains great, but New Zealand or Switzerland are strong candidates!
8. What is your most treasured possession? A collection of gadgets and figurines from Blizzard games.
9. What is your most marked characteristic? I like to optimize things!
10. Spaces or tabs? Tabs. Cleaner!

Subscribe to the newsletter here

Join the developer program here

Enjoy!

Microsoft Reactor

70 Wilson Street

London, EC2A 2DB

Microsoft is pleased to invite you to an exclusive developer event focused on developing Enterprise and Business Applications with Azure and Office 365. OpenHack is a fun, challenge-based coding event hosted in London, England, 6-8 March 2018.  Register Now!

Enterprise Developers will learn how to build Business Apps using Bots, Azure Functions, Event Grid and Logic Apps, Microsoft Graph and Office 365 across three days of immersive, structured, hands-on hacking. Web development experience (particularly in NodeJS or ASP.NET) is helpful and experience with the bot framework and/or Azure AD is a big plus. However, don’t worry if you’re not familiar with these development platforms.

During the three days of hands-on hacking you will team up with Microsoft Engineers and community peers to leverage the power of Azure and the Microsoft Graph.    

OpenHack is FREE for registered attendees! Food, refreshments, prizes and fun will be provided.  Please bring your own development laptop. If travelling, attendees are responsible for their own travel expenses and evening meals. 

After the 3 Day Event, you’ll have mastered a set of developer challenges, increased your expertise in development with Azure and Office 365 as well as building some great relationships with other Professional Developers and Microsoft Engineers.  

Below are some helpful resources:

Microsoft Graph

Microsoft Teams

Azure Functions

Logic Apps

Event Grid

We look forward to seeing you at the OpenHack!

With SharePoint Framework, you can build client-side web parts and extensions across Team and Communication Sites. Microsoft Graph provides API access to an ever-widening set of services across Microsoft, and Azure Active Directory lets you secure additional custom enterprise web services. With recent updates, you can bring these capabilities together, making it possible to build solutions that pull together workloads like calendars, tasks, and group information in one location – your SharePoint sites. This capability has been available in preview since September and based on your feedback, we’re expanding the scenarios and scopes you can use within your SharePoint Framework based projects.

Updates to support these new capabilities are being rolled out across Office 365. In earlier previews, a more limited set of Microsoft Graph permissions was available. Now, tenant administrators have new tools to authorize and grant additional permissions for a script running within sites, which includes SharePoint Framework (SPFx). Via PowerShell and new portal tools, tenant administrators can discover and manage permissions that script has for Microsoft Graph and for enterprise applications. In addition, developers can add a suggested set of permissions into their application packages so that administrators can approve specific permissions as they add new SPFx components. This new administration experience is now available to Targeted Release (First Release) tenancies, in preview.

Tenant Administrator user experience for management of permissions

To get started, a new version of SharePoint Framework script libraries (version 1.4.1) is also now available which features evolved APIs for accessing Microsoft Graph and 3rd party enterprise Azure Active Directory services: MSGraphClient and AadHttpClient, respectively. These APIs automate the process of authenticating and retrieving an API token that you can use to make subsequent web service calls. For developers, you can read more about the new APIs and application permission packaging capabilities.

With the extended preview for Microsoft Graph and Azure Active Directory-authenticated services, the full breadth of Graph capabilities is available for your solutions. It’s now much easier to build out SharePoint sites as the hub of collaboration across Office 365. We look forward to your feedback on this preview, via Github Issues, on github.com/sharepoint.

Update: SharePoint Framework v.1.4.1 also includes support for Node v8 (LTS) and npm v5. Please see the release notes for more information about this and other specific topics.

In this PnP Webcast, we concentrated on covering steps on how to upgrade your SharePoint Framework solutions which are using older SharePoint Framework packages to latest updates. There are numerous ways to upgrade your solutions and exact steps always depend on the technical details of the solution. This webcast talks about the general process and high-level steps to be taken with a step-by-step demo on the upgrade actions.

Presentation covers following discussion points:

• Steps to update packages in your SharePoint Framework solution
• Updating Yeoman templates in your development environment
• Things to keep in mind

Webcast demo shows following things:

• Step-by-step upgrade of a solution from v1.3 to v1.4.1

Webcast presenters: Paolo Pialorsi, Vesa Juvonen

The presentation used in this webcast is available from new PnP SlideShare locations at https://www.slideshare.net/SharePointPnP.

Video on YouTube.

Additional resources

See following resources on the covered topics.

• SharePoint Framework documentation
• SharePoint Framework Tutorials
• PnP Webcast - SharePoint Framework Dialog Framework
• PnP Webcast - Reusable controls for your SharePoint Framework solutions
• PnP Webcast - Site collection app catalog
• PnP Webcast - Including assets in SharePoint Framework solution packages
• PnP Webcast - Migrating to SharePoint Framework Extensions
• PnP Webcast - ALM APIs for SharePoint Framework solutions and SharePoint add-ins (apps)
• PnP Webcast - Defining an icon for client-side web part
• PnP Webcast - Working with Tenant Properties in SharePoint Online
• PnP Webcast - Deployment options for SharePoint Framework solutions
• PnP Webcast - SharePoint Framework in SharePoint 2016 Feature Pack 2
• PnP Webcast - VSTS Build and Release Pipelines for SharePoint Framework Solutions
• PnP Webcast - Common (mis)conceptions about SharePoint Framework
• PnP Webcast – Introduction to Visual Studio Extension for SharePoint Framework
• PnP Webcast - Calling external APIs securely from SharePoint Framework
• PnP Webcast - SharePoint Framework and organizational considerations
• PnP Webcast - Provisioning SharePoint assets for your SharePoint Framework solution
• PnP Webcast - Validating SharePoint Framework client-side web part property values
• PnP Webcast - Getting started with SharePoint Framework
  
  

What is SharePoint / Office Dev Patterns & Practices (PnP) webcast series?

SharePoint / Office Dev Patterns & Practices (PnP) webcast series covers different patterns, practices and topics around development with Office 365 and SharePoint. The majority of the topics are valid for the Office 365 and SharePoint on-premises. Our objective is to release a new webcast weekly or bi-weekly with few slides and a live demo of the covered topic. All webcasts are published at the PnP YouTube channel with additional references to the existing materials.

PnP is a community-driven open source project where Microsoft and external community members are sharing their learning's around implementation practices for Office 365 and SharePoint on-premises (add-in model). Active development and contributions happen in our GitHub repositories under dev branch and each month there will be a master merge (monthly release) with more comprehensive testing and communications. Latest activities and future plans are covered in our monthly community calls which are open to anyone from the community. Download invite from http://aka.ms/SPPnP-Call. 

This is work done by the community for the community without any actual full-time people. It’s been great to find both internal and external people who are willing to assist and share their learning's for the benefit of others. This way we can build on the common knowledge of us all. Currently, the program is facilitated by Microsoft, but already at this point, we have multiple community members as part of the Core team and we are looking to extend the Core team with more community members.

If you have any questions, comments or feedback on SharePoint Development topics, PnP program or this blog post, please use the Microsoft Tech Community (SharePoint Developer group).

“Sharing is caring”

Vesa Juvonen, Senior Program Manager, SharePoint, Microsoft - 19th of February 2018

We are happy to announce the availability of new SharePoint Client-Side Object Model (CSOM) version targeted for the Office 365 or more specifically for SharePoint and Project Online. This release again contains updates on the existing SharePoint and Project CSOM assemblies, mainly on Site Designs and upcoming Hub Sites capabilities. Notice that some of the below new capabilities do NOT work in normal tenants until the capability is truly released and enabled. There will be separate communications around availability fo the new capabilities when they are available.

You can find the latest CSOM package for SharePoint Online, including the Project Online CSOM assembly, from the NuGet gallery with an id of 'Microsoft.SharePointOnline.CSOM'. We are also working on updating the redistributable package at some point, but you can already right now start using some of these new capabilities in your solutions. We do recommend you to use the NuGet Package to gain access to the latest version, rather than downloading the SDK to your machine.

The version of the newly released CSOM package is 16.1.7414.1200. Previous versions of the NuGet have not been removed so that your existing solutions will continue working without issues and you can decide when the new version is taken into use. Notice that even though the NuGet version is increased to 16.1.7414.1200, actual assembly version of the released assemblies is 16.1.0.0. You can also check the version of the assemblies from the File Version attribute, which aligns with the NuGet version.

SharePoint Online Management Shell has been also updated to match with this CSOM release. You can find a new set of cmdlets listed in this article. 

Notice that since this NuGet package is targeted to SharePoint Online, you cannot use it directly in on-premises environments (SharePoint 2013 or 2016). This is because of the server side dependencies of the APIs. CSOM versioning model and dependency to your target environment are clarified in following blog post - Using correct Client-Side Object Model (CSOM) version for SharePoint customizations. We have released separate NuGet packages for on-premises. See following blog post for additional details - SharePoint CSOM versions for on-premises released as NuGet packages.

New properties and methods across assemblies

Here's a raw list of all the changes in the classes, properties and methods within this package. 

Microsoft.SharePoint.Client

Following properties, classes and methods have been added.

• public property Microsoft.SharePoint.Client.Site.SocialBarOnSitePagesDisabled
  
  

Microsoft.Online.SharePoint.Client.Tenant

Following properties, classes and methods have been added.

• public class Microsoft.Online.SharePoint.TenantAdministration.HubSitePermission
• public property Microsoft.Online.SharePoint.TenantAdministration.HubSiteProperties.Permissions
  
  
• public property Microsoft.Online.SharePoint.TenantAdministration.SiteProperties.HubSiteId
• public property Microsoft.Online.SharePoint.TenantAdministration.SiteProperties.IsHubSite
• public property Microsoft.Online.SharePoint.TenantAdministration.SiteProperties.OwnerName
• public property Microsoft.Online.SharePoint.TenantAdministration.SiteProperties.SetOwnerWithoutUpdatingSecondaryAdmin
• public property Microsoft.Online.SharePoint.TenantAdministration.SiteProperties.SocialBarOnSitePagesDisabled
  
  
• public class Microsoft.Online.SharePoint.TenantAdministration.SPOTenantInstance
• public property Microsoft.Online.SharePoint.TenantAdministration.Tenant.ApplyAppEnforcedRestrictionsToAdHocRecipients
  
  
• public method Microsoft.Online.SharePoint.TenantAdministration.Tenant.ApplySiteDesign
• public method Microsoft.Online.SharePoint.TenantAdministration.Tenant.GetTenantInstances
• public method Microsoft.Online.SharePoint.TenantAdministration.Tenant.SetWebTheme
  
  
• public property Microsoft.Online.SharePoint.TenantAdministration.Tenant.SocialBarOnSitePagesDisabled
• public method Microsoft.Online.SharePoint.TenantAdministration.Tenant.UpdateUserTypeFromAzureADForAllSites
• public method Microsoft.Online.SharePoint.TenantAdministration.Tenant.UpdateUserTypesFromAzureADForSite
  
  
• public enum Microsoft.Online.SharePoint.TenantAdministration.TenantSiteScriptActionOutcome
• public class Microsoft.Online.SharePoint.TenantAdministration.TenantSiteScriptActionResult
  
  
• public property Microsoft.Online.SharePoint.TenantAdministration.Internal.SPOWebAppServicePrincipalPermissionRequest.PackageApproverName
• public property Microsoft.Online.SharePoint.TenantAdministration.Internal.SPOWebAppServicePrincipalPermissionRequest.PackageName
• public property Microsoft.Online.SharePoint.TenantAdministration.Internal.SPOWebAppServicePrincipalPermissionRequest.PackageVersion
• public property Microsoft.Online.SharePoint.TenantAdministration.Internal.SPOWebAppServicePrincipalPermissionRequest.TimeRequested
  
  
• public property Microsoft.Online.SharePoint.TenantManagement.Office365Tenant.ApplyAppEnforcedRestrictionsToAdHocRecipients
• public property Microsoft.Online.SharePoint.TenantManagement.Office365Tenant.SocialBarOnSitePagesDisabled
  
  

New PowerShell cmdlets in SharePoint Online Management Shell release

Following cmdlets have been added to the latest release of SPO Managment Shell. Notice that some of the below commands do NOT work in normal tenants until the capability is truly released and enabled. There will be separate communications around availability fo the new capabilities when they are released. 

• Add-SPOHubSiteAssociation - Associating a site to a hub site
• Invoke-SPOSiteDesign - Apply Site Design to existing site
• Remove-SPOHubSiteAssociation - Remove hub association
• Set-SPOWebTheme - Set theme to existing site
• Update-UserType
  
  

PowerShell documentation has been also moved to docs.microsoft.com platform and will be updated more frequently in the future.

“Sharing is caring”

Vesa Juvonen, Senior Program Manager, SharePoint Engineering, Microsoft - 23rd of February 2018

In this PnP Webcast, we concentrated on the Office 365 CLI, which is cross-platform command line tool to Office 365 settings. This initiative was first started to address challenges for the SharePoint Framework developers to manage tenant level settings, like Office 365 CDN in their tenant in non-Windows, since those configuration options were only exposed using Windows PowerShell. Since the initial release, it has grown significantly with community contributions to address many configuration options in Office 365 tenants.

Office 365 CLI is community driven open-source initiative. Feedback, contributions and other ideas are always welcome. You can use for example Office 365 CLI Gitter conversation to start a discussion with the people who coordinate this effort.

Office 365 CLI it not targeted to replace PowerShell, rather provide an alternative option for tenant management with CLI style implementation, which is more natural for certain developers and administrators. 

Presentation covers following discussion points:

• What is Office 365 CLI?
• How to get started with Office 365 CLI?

Webcast demo shows following things:

• Installing Office 365 CLI to your environment
• Connecting to Office 365 tenant
• Different command available for tenant configuration
• Runtime help and documentation

Webcast presenters: Waldek Mastykarz, Vesa Juvonen

The presentation used in this webcast is available from new PnP SlideShare locations at https://www.slideshare.net/SharePointPnP.

Video on YouTube.

Additional resources

See following resources on the covered topics.

• Office 365 CLI documentation
• Office 365 CLI in GitHub - Contributions are welcome. Check issue list for open tasks and ideas
• Office 365 Gitter - Discussion on the Office 365 CLI and the open-source development around it
• Announcing Office 365 CLI for managing your Office 365 tenant on any platform
  
  

What is SharePoint / Office Dev Patterns & Practices (PnP) webcast series?

SharePoint / Office Dev Patterns & Practices (PnP) webcast series covers different patterns, practices and topics around development with Office 365 and SharePoint. The majority of the topics are valid for the Office 365 and SharePoint on-premises. Our objective is to release a new webcast weekly or bi-weekly with few slides and a live demo of the covered topic. All webcasts are published at the PnP YouTube channel with additional references to the existing materials.

PnP is a community-driven open source project where Microsoft and external community members are sharing their learning's around implementation practices for Office 365 and SharePoint on-premises (add-in model). Active development and contributions happen in our GitHub repositories under dev branch and each month there will be a master merge (monthly release) with more comprehensive testing and communications. Latest activities and future plans are covered in our monthly community calls which are open to anyone from the community. Download invite from http://aka.ms/SPPnP-Call. 

This is work done by the community for the community without any actual full-time people. It’s been great to find both internal and external people who are willing to assist and share their learning's for the benefit of others. This way we can build on the common knowledge of us all. Currently, the program is facilitated by Microsoft, but already at this point, we have multiple community members as part of the Core team and we are looking to extend the Core team with more community members.

If you have any questions, comments or feedback on SharePoint Development topics, PnP program or this blog post, please use the Microsoft Tech Community (SharePoint Developer group).

“Sharing is caring”

Vesa Juvonen, Senior Program Manager, SharePoint, Microsoft - 26th of February 2018

Java developers have spoken, and we’ve listened. We’re excited to announce a preview of our new Java SDK for Microsoft Graph.Java developers can use the SDK to integrate with data, relationships and intelligence of the Microsoft Graph API in both client and server-side applications. This client library simplifies API integration by providing request builders, class definitions and convenience functions for common operations such as chunked file upload.  

Create requests with confidence 

The Java SDK simplifies Microsoft Graph integration by allowing you to incrementally build up requests with objects. Find the data you're looking for by traversing relationships between resources in the Microsoft Graph API. 

Build with strongly typed objects 

By using the Java SDK, you’ll have access to classes that represent the resources exposed in the Microsoft Graph API. Property annotations provide human-readable descriptions and hints about what data they represent.  

Get started  

Try the SDK

Tune in to the March Microsoft Graph community call to learn more and see the Java SDK in action 

Special thanks  

Dave Moten for his numerous contributions to the Java SDK 

We are happy to announce additional community members being included in the SharePoint Patterns and Practices (PnP) team. We are really excited to grow the team, which will help us to address growing interest in the SharePoint community and development topics. Starting from this week, SharePoint PnP team has been extended with Mikael Svenson (Puzzlepart), Andrew Connell (Voitanos), and Andrew Koltyakov (ARVO Systems). They are all well-known MVPs who have been active in different areas of the SharePoint PnP community effort for a long time. 

SharePoint Patterns and Practices Team coordinates the open-source and community driven work for SharePoint development topics in Github. This work is supervised by the SharePoint engineering, but SharePoint development community MVPs are closely involved in the day-to-day activities. SharePoint PnP has numerous open source components and controls, which are being built together with the community. SharePoint PnP team also coordinates SharePoint development samples, documentation, and other guidance. 

Existing SharePoint PnP team community members are Erwin van Hunen (Rencore), Paolo Pialorsi (Piasys.com), Radi Atanassov (OneBit), Waldek Mastykarz (Rencore) and Elio Struyf (Valo Intranet). We are further looking into extending the team from the people who have been active and closely involved in the SharePoint Dev community activities under the SharePoint Patterns and Practices initiative. 

Introduction of new SharePoint PnP team members

Meet Andrew Connell

Here’s Andrew C. with his own words.

Andrew Connell is a full stack web developer with a focus on Microsoft Azure & Office 365, specifically the Office 365 APIs, SharePoint, Microsoft's .NET Framework / .NET Core, Angular, Node.js and Docker that enjoys development, writing & teaching… if it’s cutting edge web you will find Andrew there! He has received Microsoft’s MVP award every year since 2005 and has helped thousands of developers through the various courses he’s authored and taught both in-person & in online courses. Recently he launched his own on-demand video platform, Voitanos to deliver his on-demand video training.

Throughout the years Andrew has been fortunate enough to share what he has learned at conferences like Microsoft’s TechEd, Build, Ignite & SharePoint conferences, Angular’s ngConf & AngularU, SPTechCon, SP Live 360, and Techorama among many others all around the world in North America, Europe, Asia & Australia. You can find Andrew on his popular blog (http://www.andrewconnell.com), follow him on Twitter @andrewconnell, check out some of the numerous projects he’s involved in on GitHub (http://www.github.com/andrewconnell) or listen to his popular weekly podcast, The Microsoft Cloud Show (http://www.microsoftcloudshow.com), which is focused on Microsoft cloud services such as Azure and Office 365 as well as the competitive cloud landscape.

• Andrew at Twitter - @AndrewConnell
  
  

Meet Andrew Koltyakov

Here’s Andrew K. with his own words.

I am a developer, consultant, and entrepreneur at ARVO Systems. I’ve been engaged with SharePoint for years now (since 2010), delivering custom solutions for our customers. I always try adopting new technologies and tools which I consider perspective keeping in mind some strategical ideas such as “will it make my team more effective” and “what our clients will get” by starting using a specific change in a workflow and techs. In a modern world tech, people should be on bleeding edge and start adopting things which are “new today for a business” but might already become legacy tomorrow. That’s why I drive my own team being first where appropriate and never stop learning.

As a result of such approaches, I’ve been investing a lot of my time in sister technologies and automation routines, like Node.js tools ecosystem for SharePoint. These investments then are adopted by a team. I’m also an active, sometimes very active, opensource contributor. You’ll never lose by sharing your knowledge and practices, we’re are not the medieval artisans, only things driven by a community evolve and reliable on the long terms.

I consider this brought me to Office 365 Developer Patterns & Practices (PnP), a combination of SharePoint and opensource ecosystem and the desire of sharing experience and help folks. Sometimes I reach people with blog posts: https://www.linkedin.com/in/koltyakov/detail/recent-activity/posts/, but I would say that the main platform of my presence is GitHub https://github.com/koltyakov.

• Andrew at Twitter - @AndrewKoltyakov
  
  

Meet Mikael Svenson

Here’s Mikael with his own words.

I am the CTO at Puzzlepart, an Office 365 consultancy and have worked in the enterprise search field for over 15 years implementing solutions for major international corporations and for several Nordic governmental institutions, though I don't primarily do the search on a day by day basis anymore. Being pegged a search guy has resulted in two books “SharePoint Search Queries Explained” and “Working with FAST Search Server 2010 for SharePoint”. I also enjoy speaking at the occasional conferences locally and abroad to validate my random blogging live :)

I've been an Office Server and Services MVP since 2011, I help Microsoft Norway locally as a P-TSP role, and I'm on the board of the Norwegian Office 365 User Group, spreading the gospel in the local community.
Being a developer at heart I love hackathons and solving code challenges. Contributing to PnP over the years has been a very good experience in this aspect and has also increased my productivity due to re-use of what others have made.

You can read my tech musings at techmikael.com.

• Mikael at Twitter - @mikaelsvenson
  
  

What is SharePoint PnP initiative?

SharePoint Patterns and Practices (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 on 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 and we are looking to extend the SharePoint PnP Team with more community members. 

“Sharing is caring”

Vesa Juvonen, Senior Program Manager, SharePoint Engineering, Microsoft - 28th of February 2018

Today we are releasing a new set of templates that extend the Office 365 platform for an industry specific scenario. These templates were designed to let you build your own solutions and to demonstrate how Office Extensibility can create end-to-end business scenarios.

The templates use Microsoft Teams as the collaboration canvas, and include other Office 365 services including Microsoft Graph, Power BI, SharePoint and Planner.

In many industries – including healthcare – teams regularly sync on status, track issues and metrics, and build plans. In healthcare, these regular meetings are referred to as “huddles.”

Within Microsoft Teams, our new templates use SharePoint lists to track issues and their causes, Power BI tabs to visualize metrics and their impact, and Bot Framework to capture new ideas – allowing information to be managed in one space for the next huddle.

Using example solutions, frameworks and samples from other Office Extensibility projects to tie together a full business scenario – and one that has specific industry relevance.

Several partners have already started working with these templates. To understand the business opportunity of this scenario, visit the Resources on our partner page and start building for your own scenarios.   

We're excited to make these templates available and look forward to continued feedback and contributions from our developer community in the coming weeks. 

Get started on your own projects today.

Also, you don’t have to start from zero! Download our sample app Microsoft Teams Sample App (Node.js) / Microsoft Teams Sample App (C#)from GitHub that implements all of our latest features. 

Read more about the huddle template release on the Office Blog.

Find the templates here. 

In this PnP Webcast, we concentrated on how to use MSGraphClient component in the SharePoint Framework. Starting from the SharePoint Framework v1.4.1, tenant administrators can configure and manage which permissions or scopes are available for 3rd party SharePoint Framework solutions. SharePoint Framework solutions can request needed permissions directly from the solution package. Tenant administrators will approve or reject these permissions either using PowerShell or by using modern Admin UI.

Notice. It's important to notice that these Graph permissions are granted to all SharePoint Framework solutions as the permission grants are not solution specific. 

Presentation covers following discussion points:

• Steps on using MSGraphClient in SharePoint Framework
• Considerations on using MSGraphClient - Things to be aware

Webcast demo shows following things:

• Importing MSGraphClient to your SPFx solution to be used in the code
• Using MSGraphClient in SPFx solution
• Requesting needed permissions (scopes) using the package-solution.json file
• Managing and approving additional permissions for SPFx solutions using new Admin UI

Webcast presenters: Waldek Mastykarz Vesa Juvonen

The presentation used in this webcast is available from new PnP SlideShare locations at https://www.slideshare.net/SharePointPnP.

Video on YouTube.

Additional resources

See following resources on the covered topics.

• SharePoint Framework documentation
• SharePoint Framework Tutorials
• PnP Webcast – Upgrading Packages in SharePoint Framework Solutions
• PnP Webcast - SharePoint Framework Dialog Framework
• PnP Webcast - Reusable controls for your SharePoint Framework solutions
• PnP Webcast - Site collection app catalog
• PnP Webcast - Including assets in SharePoint Framework solution packages
• PnP Webcast - Migrating to SharePoint Framework Extensions
• PnP Webcast - ALM APIs for SharePoint Framework solutions and SharePoint add-ins (apps)
• PnP Webcast - Defining an icon for the client-side web part
• PnP Webcast - Working with Tenant Properties in SharePoint Online
• PnP Webcast - Deployment options for SharePoint Framework solutions
• PnP Webcast - SharePoint Framework in SharePoint 2016 Feature Pack 2
• PnP Webcast - VSTS Build and Release Pipelines for SharePoint Framework Solutions
• PnP Webcast - Common (mis)conceptions about SharePoint Framework
• PnP Webcast – Introduction to Visual Studio Extension for SharePoint Framework
• PnP Webcast - Calling external APIs securely from SharePoint Framework
• PnP Webcast - SharePoint Framework and organizational considerations
• PnP Webcast - Provisioning SharePoint assets for your SharePoint Framework solution
• PnP Webcast - Validating SharePoint Framework client-side web part property values
• PnP Webcast - Getting started with SharePoint Framework
  
  

What is SharePoint / Office Dev Patterns & Practices (PnP) webcast series?

SharePoint / Office Dev Patterns & Practices (PnP) webcast series covers different patterns, practices and topics around development with Office 365 and SharePoint. The majority of the topics are valid for the Office 365 and SharePoint on-premises. Our objective is to release a new webcast weekly or bi-weekly with few slides and a live demo of the covered topic. All webcasts are published at the PnP YouTube channel with additional references to the existing materials.

PnP is a community-driven open source project where Microsoft and external community members are sharing their learning's around implementation practices for Office 365 and SharePoint on-premises (add-in model). Active development and contributions happen in our GitHub repositories under dev branch and each month there will be a master merge (monthly release) with more comprehensive testing and communications. Latest activities and future plans are covered in our monthly community calls which are open to anyone from the community. Download invite from http://aka.ms/SPPnP-Call. 

This is work done by the community for the community without any actual full-time people. It’s been great to find both internal and external people who are willing to assist and share their learning's for the benefit of others. This way we can build on the common knowledge of us all. Currently, the program is facilitated by Microsoft, but already at this point, we have multiple community members as part of the Core team and we are looking to extend the Core team with more community members.

If you have any questions, comments or feedback on SharePoint Development topics, PnP program or this blog post, please use the Microsoft Tech Community (SharePoint Developer group).

“Sharing is caring”

Vesa Juvonen, Senior Program Manager, SharePoint, Microsoft - 5th of March 2018

The Microsoft Teams community call is our regular event for developers to stay in sync with Microsoft Teams. We’ll share updates, tips, and connect you to the product teams behind Microsoft Teams. In addition, we’ll have a technical deep dive on a specific topic: from tooling, to practical use cases, (e.g. Authentication, Teams App Studio) to highlighting how organizations leverage Microsoft Teams. At the end of each call, there’s an opportunity to ask us questions and share feedback.

In our first call, we featured Microsoft Teams Platform Architect Bill Bliss, who gave a Teams Platform overview and highlighted Line of Business (LOB) App Scenarios with a live demo of a sample HR recruiting tool app to demonstrate possibilities in the LOB space. A lively Q&A followed with discussion about deeper Teams integration with SharePoint and feedback regarding guest sign in/out in Teams.

Watch the call 

View the deck

Microsoft Teams resources and feedback:

• Yeoman generator to build Teams apps - https://github.com/OfficeDev/generator-teams
• Microsoft Teams developer documentation - https://aka.ms/teamsdevdocs
• Microsoft Teams issues and technical questions - StackOverflow
• Microsoft Teams recommendations and suggestions - Microsoft Teams User Voice

Additional resources:

• Office Developer repository - https://github.com/OfficeDev
• Join the Microsoft Office 365 Developer Program - https://dev.office.com/devprogram

In this PnP Webcast, we concentrated on available actions or operations in the Microsoft Graph towards SharePoint Online. SharePoint has a massive API surface, but the most common operations are also exposed from the Microsoft Graph so that you can also easily access SharePoint operations through this one unified end-point. Microsoft Graph standardizes operations cross different services by exposing the actions and methods through unified end-point without the need to understand product specific APIs. 

Presentation covers following discussion points:

• What are the available actions or APIs exposed in Microsoft Graph towards SharePoint Online?
• How to consume the API?

Webcast demo shows following things:

• Using Fiddler to demonstrate the API usage
• App permissions for the used Azure AD application
• Getting access token from the Azure AD for your HTTP requests
• Graph URL structure for accessing information of a site 
• Accessing lists on a specific site using Microsoft Graph requests
• Creating a new list to a site using Microsoft Graph 
• A quick look at sample MVC application for demonstrating Microsoft Graph operations towards SharePoint Online

Webcast presenters: Paolo Pialorsi, Vesa Juvonen

The presentation used in this webcast is available from new PnP SlideShare locations at https://www.slideshare.net/SharePointPnP.

Video on YouTube.

Additional resources

See following resources on the covered topics.

• Microsoft Graph development portal
• Graph Explorer
• Microsoft Graph SharePoint Documentation
• OneDrive and SharePoint in Microsoft Graph

Notice. ASP.NET MVC sample demonstrated in the webcast is not yet available in the GitHub, but will be released soon.

What is SharePoint / Office Dev Patterns & Practices (PnP) webcast series?

SharePoint / Office Dev Patterns & Practices (PnP) webcast series covers different patterns, practices and topics around development with Office 365 and SharePoint. The majority of the topics are valid for the Office 365 and SharePoint on-premises. Our objective is to release a new webcast weekly or bi-weekly with few slides and a live demo of the covered topic. All webcasts are published at the PnP YouTube channel with additional references to the existing materials.

PnP is a community-driven open source project where Microsoft and external community members are sharing their learning's around implementation practices for Office 365 and SharePoint on-premises (add-in model). Active development and contributions happen in our GitHub repositories under dev branch and each month there will be a master merge (monthly release) with more comprehensive testing and communications. Latest activities and future plans are covered in our monthly community calls which are open to anyone from the community. Download invite from http://aka.ms/SPPnP-Call. 

This is work done by the community for the community without any actual full-time people. It’s been great to find both internal and external people who are willing to assist and share their learning's for the benefit of others. This way we can build on the common knowledge of us all. Currently, the program is facilitated by Microsoft, but already at this point, we have multiple community members as part of the Core team and we are looking to extend the Core team with more community members.

If you have any questions, comments or feedback on SharePoint Development topics, PnP program or this blog post, please use the Microsoft Tech Community (SharePoint Developer group).

“Sharing is caring”

Vesa Juvonen, Senior Program Manager, SharePoint, Microsoft - 12th of March 2018