Skip to content

Commit cf2325d

Browse files
committed
Updates for the upcoming September release
1 parent dd4c806 commit cf2325d

File tree

3 files changed

+50
-4
lines changed

3 files changed

+50
-4
lines changed

docs/transform/modernize-userinterface-site-pages-configuration.md

Lines changed: 45 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: Options to control the page transformation process
33
description: Explains how to configure the page transformation process
4-
ms.date: 06/24/2019
4+
ms.date: 09/03/2019
55
ms.prod: sharepoint
66
localization_priority: Normal
77
---
@@ -356,6 +356,50 @@ PublishingPageTransformationInformation pti = new PublishingPageTransformationIn
356356
};
357357
```
358358

359+
## SkipDefaultUrlRewrite option (as of September 2019 release)
360+
361+
Type | Default value if not specified
362+
-----|----
363+
Bool | false
364+
365+
The default behavior is to perform default URL rewriting. In case you're using a custom URL mapping file and you do not want to apply the default URL rewrite logic then set this property. See the [URL mapping](modernize-userinterface-site-pages-urlmapping.md) article to learn more.
366+
367+
```Csharp
368+
PageTransformationInformation pti = new PageTransformationInformation(page)
369+
{
370+
SkipDefaultUrlRewrite = true,
371+
};
372+
```
373+
374+
```Csharp
375+
PublishingPageTransformationInformation pti = new PublishingPageTransformationInformation(page)
376+
{
377+
SkipDefaultUrlRewrite = true,
378+
};
379+
```
380+
381+
## AddTableListImageAsImageWebPart option (as of September 2019 release)
382+
383+
Type | Default value if not specified
384+
-----|----
385+
Bool | false
386+
387+
As of the September 2019 release images that are embedded inside tables/lists are not anymore created as separate image web parts underneath those tables/lists. The reason is that the modern text editor is not dropping these images anymore on page edit. If you prefer the pre September 2019 model you can set the AddTableListImageAsImageWebPart property.
388+
389+
```Csharp
390+
PageTransformationInformation pti = new PageTransformationInformation(page)
391+
{
392+
AddTableListImageAsImageWebPart = true,
393+
};
394+
```
395+
396+
```Csharp
397+
PublishingPageTransformationInformation pti = new PublishingPageTransformationInformation(page)
398+
{
399+
AddTableListImageAsImageWebPart = true,
400+
};
401+
```
402+
359403
## HandleWikiImagesAndVideos option
360404

361405
Type | Default value if not specified

docs/transform/modernize-userinterface-site-pages-powershell.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: Transform classic pages to modern client-side pages using PowerShell
33
description: Explains how to transform classic wiki and web part pages into modern client side pages using the SharePoint PowerShell
4-
ms.date: 06/24/2019
4+
ms.date: 09/03/2019
55
ms.prod: sharepoint
66
localization_priority: Priority
77
---
@@ -50,6 +50,8 @@ PageLayoutMapping (as of April 2019 release, version 3.8.1904.*) | | Publishing
5050
PublishingTargetPageName (as of May 2019 release, version 3.9.1905.*) | | Publishing pages | Use the `-PublishingTargetPageName` parameter to override the name for the modern page
5151
SkipUrlRewriting (as of May 2019 release, version 3.9.1905.*) | $false | Cross site transformation | During publishing page transformation URL's are rewritten to be valid in the target site collection, but using the `-SkipUrlRewriting` you can disable the URL rewriting. See the [URL mapping](modernize-userinterface-site-pages-urlmapping.md) article to learn more.
5252
UrlMappingFile (as of July 2019 release, version 3.11.1907.*) | | Cross site transformation | File with custom URL mapping definitions allow you to do more than just the default URL mapping. See the [URL mapping](modernize-userinterface-site-pages-urlmapping.md) article to learn more.
53+
SkipDefaultUrlRewriting (as of September 2019 release, version 3.13.1909.*) | | Cross site transformation | When you use a custom URL mapping and you want to disable the default URL rewrite logic then set the `-SkipDefaultUrlRewriting` parameter.
54+
AddTableListImageAsImageWebPart (as of September 2019 release, version 3.13.1909.*) | | All page types | Before the September 2019 release images living inside a table/list were also created as separate image web parts underneath that table/list. Since these images inside tables/lists now are not dropped anymore from the modern page on edit the default behavior has changed to not add separate image web parts anymore. Use the `-AddTableListImageAsImageWebPart` parameter to revert back the pre September 2019 default behavior.
5355

5456
(`*`) Mandatory command line parameter / (`**`) Mandatory when the `-PublishingPage` parameter was set (either `-TargetWebUrl` or `-TargetConnection`)
5557

docs/transform/modernize-userinterface-site-pages-urlmapping.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: URL mapping during cross site page transformation
33
description: Explains how to the default URL mapping works when transforming pages cross site collection + also explains how to use a custom URL mapping file
4-
ms.date: 06/24/2019
4+
ms.date: 09/03/2019
55
ms.prod: sharepoint
66
localization_priority: Priority
77
---
@@ -50,5 +50,5 @@ To use this custom URL mapping file you simply point the page transformation eng
5050
When you use custom URL mapping it's important to understand how it works together with the default URL mapping:
5151

5252
- Custom URL mapping is executed **before** the default URL mapping, which allows you to change the default URL mapping behavior by specifying a custom mapping for the default rewritten urls
53-
- When you disable URL mapping you also disable custom URL mapping
53+
- When you disable URL mapping you also disable custom URL mapping. If you only want to use your custom URL mapping then use the `-SkipDefaultUrlRewriting` parameter of the `ConvertTo-ClientSidePage` cmdlet or the `SkipDefaultUrlRewrite` attribute of the .Net page transformation configuration objects (`PageTransformationInformation` and `PublishingPageTransformationInformation`).
5454

0 commit comments

Comments
 (0)