Mappage d’URL pendant la transformation de page entre sites

Lorsque vous effectuez une transformation de page entre sites, le mappage d’URL par défaut est utilisé. La transformation de page entre sites est obligatoire lorsque vous modernisez vos pages de publication, car vous créez toujours les pages modernes dans un site moderne (communication). Lorsque vous procédez à la modernisation d’un site d’équipe sur place, il n’y a pas de raison de mapper les URL, lors de l’utilisation entre sites le mappage d’URL est appliqué. Le mappage d’URL remplace automatiquement les emplacements «source» par URL, avec des URL similaires, mais pointant vers des emplacements «cibles». Il y a un composant de mappage d’URL par défaut qui est actif par défaut (mais qui peut être désactivé), et un composant facultatif de mappage d’URL personnalisé peut être utilisé.

Où s’applique le mappage d’URL?

Le mappage d’URL/la réécriture s’applique aux emplacements suivants :

• Tout le contenu se terminant par des parties de texte dans la page moderne (à la publication de mai 2019)
• Transformation de SummaryLinks en contenu de texte ou le composant WebPart Modern QuickLinks (à la publication de mai 2019)
• Balises d’ancrage d’images (à compter de la version de novembre 2019)

Logique de mappage d’URL par défaut

Comme indiqué ci-dessus, chaque fois que vous appliquez une transformation entre sites par défaut, le mappage d’URL est appliqué. Le mécanisme de mappage d’URL par défaut mappe les URL complètes et relatives de la version du site Web actuel + il traite la mise à jour de la bibliothèque «pages» de publication classique vers la nouvelle bibliothèque SitePages moderne. L’exemple ci-dessous illustre le fonctionnement du mappage d’URL par défaut. En supposant que le site source est le suivanthttp://contoso.com/sites/portal/hret que le site de communication cible se trouve danshttps://contoso.sharepoint.com/sites/hr, les réécritures d’URL suivantes sont appliquées :

• http://contoso.com/sites/portal ->https://contoso.sharepoint.com/sites/hr
• http://contoso.com/sites/portal/pages ->https://contoso.sharepoint.com/sites/hr/sitepages
• /sites/portal -> /sites/hr
• /sites/portal/pages -> /sites/hr/sitepages
• http://contoso.com/sites/portal/hr ->https://contoso.sharepoint.com/sites/hr
• http://contoso.com/sites/portal/hr/pages ->https://contoso.sharepoint.com/sites/hr/sitepages
• /sites/portal/hr -> /sites/hr
• /sites/portal/hr/pages -> /sites/hr/sitepages

Désactivation du mappage d’URL

Si vous ne voulez pas que le mappage d’URL se produise, vous pouvez le désactiver via -SkipUrlRewritingl’indicateur dans l’onglet PNP PowerShell ou via l’attributSkipUrlRewrite des objets de configuration de la transformation de page .net (PageTransformationInformationetPublishingPageTransformationInformation).

Mappage d’URL personnalisé :

Si vous voulez effectuer des mappages supplémentaires par rapport à ceux de la logique de mappage par défaut, vous devez fournir un fichier répertoriant vos définitions de mappage d’URL personnalisées. Il s’agit d’un simple fichier CSV sans en-tête indiquant les valeurs d’URL source et cible. Vous pouvez utiliser une virgule (,) ou un point-virgule (;) comme délimiteur dans votre fichier CSV.

https://contoso.com/intranet,https://contoso.sharepoint.com/sites/intranet
/sites/hr,/sites/myhrportal

Pour utiliser ce fichier de mappage d’URL personnalisé, il vous suffit de pointer le moteur de transformation de page vers votre fichier. Lorsque vous utilisez PowerShell PNP, vous pouvez utiliser le paramètre-UrlMappingFile de l’applet de commandeConvertTo-ClientSidePage (par exemple,-UrlMappingFile "c:\temp\urlmap.csv") ou utiliser l’attribut UrlMappingFile des objets de configuration de la transformation de page .net (PageTransformationInformationetPublishingPageTransformationInformation).

Mappage d’URL personnalisée et mappage d’URL par défaut

Lorsque vous utilisez le mappage d’URL personnalisée, il est important de comprendre le fonctionnement combiné avec le mappage d’URL par défaut:

• Le mappage d’URL personnalisée est exécuté avant le mappage d’URL par défaut, ce qui vous permet de modifier le comportement de mappage d’URL par défaut en spécifiant une correspondance personnalisée pour les URL réécrites par défaut.
• Lorsque vous désactivez le mappage d’URL, vous désactivez également le mappage d’URL personnalisée. Si vous souhaitez seulement utiliser votre mappage d’URL personnalisée, utilisez le paramètre -SkipDefaultUrlRewriting de l’applet de commande ConvertTo-ClientSidePage ou l’attribut SkipDefaultUrlRewrite des objets de configuration de la transformation de page .Net (PageTransformationInformation et PublishingPageTransformationInformation).