Skip to content

Commit f4c599c

Browse files
committed
Doc Formatting for site design story
1 parent 81425f2 commit f4c599c

File tree

1 file changed

+14
-1
lines changed

1 file changed

+14
-1
lines changed

docs/declarative-customization/site-design-pnp-provisioning.md

Lines changed: 14 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -35,17 +35,20 @@ This requires that you open 2 different pages on your tenant, one located in a n
3535
1. Enter **https://localhost** as the Redirect URI
3636

3737
![Create App](images/pnpprovisioning-createapponly.png)
38+
3839
1. Click **Create** and copy the values for **Client Id** and **Client Secret** as you will need them later
3940

4041
Now we will trust this app to have the appropriate access to your tenant:
4142
1. Navigate to https://[yourtenant]-admin.sharepoint.com/_layouts/appinv.aspx (notice the -admin in the URL)
4243
1. Paste in the Client Id you copied above into the **App Id** field and select **Lookup**
4344
1. Paste the following XML in the **Permission Request XML** field:
45+
4446
```xml
4547
<AppPermissionRequests AllowAppOnlyPolicy="true" >
4648
<AppPermissionRequest Scope="http://sharepoint/content/tenant" Right="FullControl" />
4749
</AppPermissionRequests>
4850
```
51+
4952
1. Select **Create**
5053
1. You will receive a question if you want to trust this app. Confirm this by selecting **Trust It**
5154

@@ -72,6 +75,7 @@ In order to put a message on the queue we have to create a flow.
7275
1. Click **Search hundreds of connectors and triggers** to select your trigger
7376
1. Search for **Request** and select **Request - When a HTTP Request is received**
7477
1. Enter the following JSON as your request body:
78+
7579
```json
7680
{
7781
"type": "object",
@@ -93,6 +97,7 @@ In order to put a message on the queue we have to create a flow.
9397
}
9498
}
9599
```
100+
96101
1. Select **+ New Step** and select **Add an action**
97102
1. Search for **Azure Queues** and select **Azure Queues - Put a message on a queue**
98103
1. Enter a name for the connection, this can be anything descriptive
@@ -147,7 +152,8 @@ Copy the following XML to a new file and save the file as FlowDemoTemplate.xml
147152
</pnp:Provisioning>
148153
```
149154

150-
>Notice that the template adds a custom action to the the web it is being applied to. It refers to ClientSideComponentId which is the one coming from the SPFX Solution you provisioned earlier. If you run this demo with your own SPFX Solution you will have to change the ClientSideComponentId and optionally the ClientSideComponentProperties attribute values in the XML.
155+
> [!NOTE]
156+
> The template adds a custom action to the the web it is being applied to. It refers to ClientSideComponentId which is the one coming from the SPFX Solution you provisioned earlier. If you run this demo with your own SPFX Solution you will have to change the ClientSideComponentId and optionally the ClientSideComponentProperties attribute values in the XML.
151157
152158
## Create the Azure Function
153159

@@ -178,18 +184,22 @@ Now it is time to upload those files so your Azure Function can make use of the
178184
1. Navigate to the main page of your Function App and select **Platform Features**
179185
180186
![Navigate to Platform Features](images/pnpprovisioning-platform-features.png)
187+
181188
1. Select **Advanced tools (Kudu)**
182189
183190
![Select Advanced Tools (Kudu))](images/pnpprovisioning-select-kudu.png)
191+
184192
1. On the main Kudu page, select **Debug Console** and pick either **CMD** or **PowerShell**
185193
1. In the upper part of the page you see a file explorer. Navigate to **site\wwwroot\\[nameofyourazurefunction]**
186194
1. Create a new folder and call that folder **modules**
187195
188196
![Create new folder](images/pnpprovisioning-kudu-create-folder.png)
197+
189198
1. In that folder create another folder called **SharePointPnPPowerShellOnline** and navigate to the folder
190199
1. In your File Explorer on your computer navigate to the folder where you downloaded all the PnP PowerShell Module files. Open the
191200
**SharePointPnPPowerShellOnline\2.20.1711.0** folder (notice that depending on when you follow this walkthrough the version number can be different).
192201
1. Upload all files in that folder by dragging and dropping all the files from this folder into the folder in Kudu.
202+
193203
![Create new folder](images/pnpprovisioning-module-files-uploaded.png)
194204
195205
## Finishing the Azure Function
@@ -257,14 +267,17 @@ In order to create a Site Design you first need to create a Site Script. Think o
257267

258268
1. After modifying the JSON by inserting the correct URL to trigger your flow, select it all and copy it again to your clipboard
259269
1. Open PowerShell and enter the following to copy the script into a variable and create the site script
270+
260271
```powershell
261272
$script = Get-Clipboard -Raw
262273
Add-SPOSiteScript -Title "Apply PnP Provisioning Template" -Content $script
263274
Get-SPOSiteScript
264275
```
276+
265277
1. You should be presented with a list of one or more site scripts, including the site script you just created
266278
1. Select the ID of the Site Script you just created and copy it to the clipboard
267279
1. Create the Site Design:
280+
268281
```powershell
269282
Add-SPOSiteDesign -Title "Site with footer" -SiteScripts [Paste the ID of the Site Script here] -WebTemplate "64"
270283
```

0 commit comments

Comments
 (0)