Presentation used in SharePoint Site Design and Site Script Patterns and Practices (PnP) webcast.Covers key areas around the topic and how to modify the out-of-the-box provisioning logic, including the extensibility story.

1. Introduction to
SharePoint Site Designs
and Site Scripts
Erwin van Hunen
Rencore
Vesa Juvonen
Microsoft

2. and extensible

3. site scripts site designs
Custom scripting of sites
through provisioning
Site designs can be
injected into in-product
provisioning experience
to automate consistent
site creation
Apply site settings and
call custom solutions
Provision select settings
after creation; use
Microsoft Flow to call
apply additional business
logic
Clean & consistently
branded sites
Apply company theme or
custom page designs at
time of creation

4. Site Scripts -
Actions
• Create List
• Apply Theme
• Add to nav
• Trigger Flow
• Join a hub site
Site design selections appear in
site provisioning UX (per base
template)
Execute Site
Design
During site creation we create a parameter in site
property bag – this is used by site design feature to
apply site scripts.
2
3
After site creation script actions are
initialized and processed – as each are
run, they are saved to a local list and
rendered in progress panel
1

5. var listRecipe = {
"$schema": "schema.json",
"actions": [
{
"primary_verb": "List.CreateOrOpen",
"target": "Customer Tracking",
"templateType": 100,
"verbs": [
{
"verb": "SetDescription",
"description": "List of Customers and Orders"
},
{
"verb": "AddFieldIfNotExist",
"fieldType": "Text",
"displayName": "Customer Name",
"isRequired": false,
"addToDefaultView": true
},
{
"verb": "AddFieldIfNotExist",
"fieldType": "DateTime",
"displayName": "Date of Delivery",
"isRequired": true
},
]
},
{
primary_verb: "Theme.Apply",
target: "Contoso Travel Green"
}
],
"bindata": {},
"version": 1
};
JSON syntax of site
configuration actions to be
applied for the site
Script actions can be
concatenated in single file or
multiple files can be used
(and reused)
RestRequest("/_api/Microsoft.Sharepoint.Utilities.WebTemplateExtensions.Scr
iptUtility.CreateSiteDesign", {info:{Title:"Contoso Travel - Legal Case Book",
Description:"Restricted site design to create a legal case book site",
ScriptGuids:["b432a1cd-7e1f-4fb1-9829-633d8MaG1C”], IsDefault:true,
WebTemplate:"68"}});
Site Design attributes
designate display
characteristics and target
template

6. Create lists/libraries (incl. settings)
Add a site navigation link
Apply company themes
Set a site logo
Join a hub site
Trigger logic apps (using Microsoft Flow)
…with more to come
* Create modern pages; set as home page
* Add declarative formatting to a column
* Join site to Hub
* Enable external access
* Set site classification

7. var flowRecipe = {
"$schema": "schema.json",
"actions": [{
"primary_verb": "Flow.Trigger",
"target": “<<http post url>>",
"name": “contoso hr additions",
"parameters": {
"department": "HR",
"cost center": "1023"
}
}
],
"bindata": {},
"version": 1
};
SharePoint
Online
Storage
Queue
Azure Function
Microsoft Flow
Business logic will handle the message
processing. Site URL is used as a parameter to
connect to site using remote APIs. Applies
needed customization using remote
provisioning techniques, for example with PnP
remote provisioning template model.
Script configured to start
previously configured flow,
which will receive the newly
created site URL as parameter.
Flow includes a step to pass
site URL to Azure storage
queue for delegating
processing to Azure side
1 2
3
4

8. Add additional site designs for each template
Scope a site design to a select set of users
Add additional business logic using Microsoft
Flow

9. DEMO
Site designs and site
scripts in practice

10. Thank you
aka.ms/spsitedesigns