Vue d’ensemble du mappage des composants WebPart utilisées

Quand une page classique est transformée en une page moderne, les composants WebPart les plus couramment utilisés sont transformés aussi. Les composants WebPart classiques (par exemple, XSLTListView) sont remplacées par leurs OOB modernes correspondants (par exemple, le composant WebPart List), en supposant qu’ils existent. Le chapitre suivant fournit une vue d’ensemble des composants WebPart classiques qui sont transformés et comment.

Liste de la transformation d’un composant WebPart

La transformation de page utilise un mappage de composant web par défaut lorsque il transforme des pages classiques en pages modernes. Le mappage par défaut utilisé pour cette modernisation est décrit ici, mais sachez que vous pouvez mettre à jour le mappage pour, par exemple, ajouter vos propres composants WebPart tiers personnalisés en tant que cible de transformation. L’articleModèle de transformation de page décrit comment étendre le modèle de mappage de composant WebPart.

Propriétés de mappage

Les propriétés de mappage permettent de définir le comportement lors de l’utilisation du fichier de mappage OOB. Un exemple typique est l’activation de l’utilisation d’un éditeur de script communautaire. Le tableau ce-dessous définit les propriétés de mappage disponibles.

Détails de la transformation d’un composant WebPart

Activation de l’utilisation du composant WebPart Éditeur de script communautaire à utiliser pendant la transformation

Il n’existe aucun composant WebPart Éditeur de script moderne OOB, car il est déconseillé d’utiliser un script d’incorporation en raison de ses risques inhérents concernant la sécurité. Si vous souhaitez toutefois transformer des composants WebPart script editor classique, vous pouvez toujours le faire avec un éditeur de script communautaire open source moderne.

Installation de l’éditeur de script communautaire

Suivez les instructions pour installer le composant WebPart Éditeur de script open source (https://github.com/SharePoint/sp-dev-fx-webparts/tree/master/samples/react-script-editor) sur votre locataire.

Définissez l’indicateur de mappage UseCommunityScriptEditor

Vous devez indiquer au moteur de transformation de page que vous avez installé l’éditeur de script communautaire et que vous voulez l’utiliser pendant la transformation. Lorsque vous utilisez l’applet ConvertTo-PnPPage de commande PowerShell PnP, vous pouvez spécifier l’indicateur -UseCommunityScriptEditor . Lorsque vous utilisez .Net, vous pouvez définir l’indicateur comme illustré dans l’exemple ci-dessous

PageTransformationInformation pti = new PageTransformationInformation(page)
{
    // If target page exists, then overwrite it
    Overwrite = true,
};

pti.MappingProperties["UseCommunityScriptEditor"] = "true";

pageTransformator.Transform(pti);

Composants WebPart XsltListViewWebPart et ListViewWebPart

Ces composants WebPart sont relativement flexibles dans la version classique et sont par conséquent remplacés par des composants WebPart modernes plus spécifiques. Le remplacement fonctionne comme suit :

• Bibliothèque de documents : composant WebPart Library
• Liste : composant WebPart List
• Calendrier : composant WebPart Event
• Liste de problèmes : composant WebPart List
• Liste de tâches : composant WebPart Text expliquant que cela n’a pas pu être mappé
• Forum de discussion : composant WebPart Text expliquant que cela n’a pas pu être mappé
• Liste d’enquêtes : composant WebPart Text expliquant que cela n’a pas pu être mappé

Pendant la transformation vers un composant WebPart liste ou bibliothèque, le moteur de transformation tente de détecter l’affichage utilisé pour configurer le composant WebPart et configurer le composant WebPart liste ou bibliothèque moderne pour afficher le même affichage.

Composant WebPart ContentEditorWebPart

Le composant WebPart Éditeur de contenu peut être utilisé en pointant vers un fichier à un autre emplacement dans SharePoint ou il peut également avoir du contenu incorporé. Selon le mode utilisé, la logique suivante est appliquée :

• Lien vers le fichier :
  • lorsque le fichier est un fichier ASPX, cela peut être affichée avec le composant WebPart Embed
  • Lorsque le contenu est un autre type de fichier, le contenu du fichier est lu et analysé :
    • Si le fichier ne contient pas de JavaScript, il est transformé en composant WebPart Éditeur de script tiers (si configuré ainsi) ou un composant WebPart Text est affiché avec le code HTML du fichier, nettoyé
    • Si le fichier contient du JavaScript, il est soit transformé en composant WebPart Éditeur de script tiers (si configuré ainsi) ou remplacé par un composant WebPart Text expliquant que le contenu ne peut pas être mappé
• Contenu incorporé :
  • Si le contenu incorporé ne contient pas de JavaScript, il est transformé en composant WebPart Éditeur de script tiers (si configuré ainsi) ou un composant WebPart Text est affiché avec le code HTML incorporé, nettoyé
  • Si le contenu incorporé contient du JavaScript, il est soit transformé en composant WebPart Éditeur de script tiers (si configuré ainsi) ou remplacé par un composant WebPart Text expliquant que le contenu ne peut pas être mappé

Composant WebPart ScriptEditorWebPart

Par défaut, un composant WebPart Text est affiché pour expliquer que le contenu n’est pas transformé. En alternative, vous pouvez également utilisé un composant WebPart éditeur de script communautaire si configuré ainsi (comme illustré dans l’exemple ci-dessus).

Composant WebPart SummaryLinks

Le code HTML de liens de synthèse est transformé en QuickLinks par défaut, mais vous pouvez également générer du code HTML puis est alors affiché avec le composant WebPart Text. Pour utiliser du code HTML, vous devez définir la propriété de mappage nécessaire : lors de l’utilisation de l’applet ConvertTo-PnPPage de commande PowerShell PnP, vous pouvez spécifier l’indicateur-SummaryLinksToHtml. Lorsque vous utilisez .Net, vous pouvez définir l’indicateur comme illustré dans l’exemple ci-dessous

PageTransformationInformation pti = new PageTransformationInformation(page)
{
    // If target page exists, then overwrite it
    Overwrite = true,
};

pti.MappingProperties["SummaryLinksToQuickLinks"] = "false";

pageTransformator.Transform(pti);