Transformer des pages SharePoint classiques en pages modernes

Ce flux de travail principal transforme les pages wiki et de composants WebPart classiques dans la bibliothèque par défaut SitePages dans SharePoint Online. Utilisez l’outil d’évaluation Microsoft 365 pour identifier les pages et leurs composants WebPart, puis utilisez PnP PowerShell pour transformer les pages approuvées et valider chaque résultat avant de traiter une vague plus importante.

Les pages de publication, les pages de blog, les pages en dehors SitePagesde , les pages d’accueil et les sources SharePoint Server nécessitent des procédures avancées distinctes et ne sont pas acceptées par les scripts d’onde de page.

Ce workflow utilise PnP PowerShell comme chemin d’exécution principal. Le moteur de transformation de page fait partie de l’infrastructure PnP open source et n’a pas de contrat SLA de support Microsoft.

Flux de travail de transformation de page

  1. Sélectionnez une vague de page représentative à partir de la couverture d’évaluation terminée.
  2. Résolvez les composants WebPart bloquants et choisissez une cible sur place ou intersites.
  3. Préparez une application PowerShell PnP appartenant au locataire et les autorisations requises.
  4. Transformez la vague représentative avec les valeurs par défaut de conservation de la source et la journalisation.
  5. Validez chaque page générée avant de développer la vague.

1. Sélectionner les candidats de page

Commencez par une évaluation des pages classiques terminée. Confirmez la couverture de l’analyse avant de sélectionner les pages.

Pour la première vague :

  • Sélectionnez WikiPage des lignes ou WebPartPage à partir des analyses de site et web réussies.
  • Préférez les pages sans composants WebPart non mappés et un pourcentage de mappage élevé.
  • Passez en revue classicpagewebparts.csv les types et mappages de composants WebPart exacts.
  • Inspectez manuellement n’importe quelle page avec WebPartCount=0. Un pourcentage de mappage de 100 pour une page sans composant signifie uniquement que l’évaluation n’a extrait aucun composant WebPart.
  • Évitez une page d’accueil jusqu’à ce que le processus de transformation et de validation soit prouvé.
  • Enregistrez le texte visible, les composants WebPart, les liens, les images et la disposition qui doivent être présents après la transformation.

MappingPercentage=100 est un signal de planification. Cela ne garantit pas que la transformation s’exécutera correctement ou conservera le contenu attendu.

Créer une vague représentative

Traitez les pages comme le même modèle de transformation que lorsque ces dimensions correspondent :

Dimension Pourquoi il définit un modèle distinct
PageType Sépare le comportement de transformation du wiki et du composant WebPart.
Layout Contrôle les sections et les colonnes générées.
Signature de composant WebPart ordonné Les pages avec différents types de composants WebPart, ordre, état masqué ou état fermé peuvent se transformer différemment.
Résultat du mappage Les composants WebPart non mappés ou mappés différemment nécessitent une correction et une validation distinctes.
Approche cible Les transformations sur place et intersites ont un comportement de dépendance et d’URL différent.
Gestion spéciale Les pages d’accueil, les mises en page de publication personnalisées et les pages en partie nulle nécessitent une révision distincte.

Utilisez classicpagewebparts.csv pour générer la signature de composant WebPart ordonnée pour chaque page. Ne regroupez pas uniquement par MappingPercentage ou UnmappedWebParts; les pages entièrement mappées peuvent toujours contenir des types de composants WebPart et un comportement d’exécution différents.

Pour la première vague :

  1. Excluez la couverture ayant échoué, les types de pages non pris en charge, les pages d’accueil, les pages nulles et les mappages non résolus.
  2. Regroupez les pages restantes par type de page, disposition et signature de composant WebPart ordonné.
  3. Sélectionnez au moins une page dans chaque modèle que vous envisagez de migrer.
  4. Ajoutez un autre représentant lorsque les pages du même modèle utilisent des propriétés de composant WebPart ou des dépendances de contenu fondamentalement différentes.
  5. Préférez une page avec une ligne de base de contenu claire et un propriétaire d’entreprise qui peut valider le résultat.

Utilisez les dates d’activité et de modification pour hiérarchiser le modèle à traiter en premier, et non pour remplacer la couverture du modèle.

Consultez Créer des groupes de pages représentatifs avec PowerShell.

Pour obtenir un mappage de champ à commande et un exemple de page sélectionnée, consultez Interpréter le rapport d’évaluation des pages classiques.

2. Résoudre les blocages et choisir la cible

Regroupez les pages candidates par type de page, disposition et combinaison de composants WebPart non mappés. Résolvez les blocages courants avant de transformer une onde.

  • Pour les pages wiki et de composants WebPart, la transformation sur place est le point de départ préféré, car les dépendances restent dans le site source.
  • Les transformations wiki et de composants WebPart intersites nécessitent une validation supplémentaire pour les liens, les fichiers, les listes, les utilisateurs et la taxonomie.

Consultez Choisir une transformation sur place ou intersites et Passer en revue les mappages de composants WebPart classiques.

3. Préparer PnP PowerShell

PnP PowerShell nécessite une application Microsoft Entra appartenant au locataire. Utilisez une application de transformation distincte de l’application Assessment en lecture seule.

Pour le flux interactif principal, utilisez SharePoint AllSites.Managedélégué , ainsi que les autorisations de site existantes de l’utilisateur connecté. La copie d’autorisations uniques au niveau de l’élément nécessite AllSites.FullControl; sinon, ignorez explicitement cette copie.

Suivez Transformer les pages sélectionnées avec PnP PowerShell pour inscrire l’application, vous connecter et exécuter la première transformation.

4. Transformer une onde représentative

Transformer une petite vague qui représente les types de pages, les mises en page et les combinaisons de composants WebPart que vous envisagez de traiter.

Pour la première vague :

  • Laissez la page générée utiliser le préfixe par défaut Migrated_ .
  • N’utilisez -TakeSourcePageNamepas , -Overwriteou les options de remplacement de la page d’accueil.
  • Activez la journalisation des fichiers et conservez le journal avec le manifeste de vague.
  • Arrêtez en cas de première défaillance inattendue ou d’incompatibilité de contenu.

Activez uniquement le changement de nom ou le comportement de remplacement de la source une fois que les pages générées ont été approuvées et qu’un plan de restauration existe.

Utilisez les scripts incorporés de la référence de script d’onde de page pour traiter chaque page représentative approuvée via le même contrat de sécurité et de résultat.

5. Valider et développer

L’ouverture sans erreur n’est pas une validation suffisante. Une page générée peut exister et être vide ou incomplète.

Validez la source et la page générée, le journal de transformation, le contenu, les composants WebPart, la disposition, les liens, les images, les métadonnées, les autorisations et l’état de publication. Développez l’onde uniquement lorsque chaque page sélectionnée répond aux critères d’acceptation.

Consultez Valider les pages classiques transformées.

Une fois que chaque résultat représentatif est marqué Passed, utilisez Convert-SelectedPages.ps1 pour traiter toutes les lignes supplémentaires approuvées par l’utilisateur. Le script rejette les pages dont le modèle de transformation n’a pas de représentant passé.

Étapes suivantes

  1. Transformez les pages sélectionnées avec PnP PowerShell.
  2. Validez les pages transformées.

Informations de référence avancées

  • Last updated on