Valider les pages classiques transformées

Validez chaque page dans une vague de transformation représentative avant de traiter d’autres pages. Une commande réussie ou une réponse HTTP 200 ne prouve pas que la page générée a conservé le contenu attendu.

Capture le résultat attendu

Avant la transformation, enregistrez :

  • URL source et cible attendues.
  • Type de page et mise en page.
  • Texte et titres visibles.
  • Composants WebPart et leur configuration importante.
  • Liens, images, fichiers, listes et contenu incorporé.
  • Métadonnées, autorisations, état de publication et si la page est une page d’accueil.

Conservez la ligne d’évaluation et classicpagewebparts.csv les lignes avec cette base de référence.

Pour le chemin délégué AllSites.Manage de première vague, sélectionnez les pages qui héritent des autorisations de leur bibliothèque et conservent les pages générées comme brouillons. Si les autorisations sources uniques doivent être conservées, utilisez le chemin d’accès révisé AllSites.FullControl au lieu d’ignorer la copie des autorisations.

Passer en revue le résultat de la transformation

Pour chaque page :

  1. Passez en revue le journal de transformation PnP pour les erreurs, les composants WebPart ignorés, les mappages de secours et les messages de copie d’autorisation.
  2. Vérifiez que la page source classique existe toujours et conserve son nom attendu.
  3. Vérifiez que la page moderne attendue existe et s’ouvre.
  4. Comparez le texte visible, les composants WebPart, les sections, les colonnes et l’ordre.
  5. Tester des liens, des images, des documents, des affichages de liste et d’autres dépendances.
  6. Comparez les métadonnées requises, les valeurs d’auteur et modifiées, les autorisations, les commentaires et l’état de publication.
  7. Enregistrez le résultat et la preuve avant de traiter la page suivante.

Détecter une sortie incomplète

Traitez la page comme ayant échoué dans les cas suivants :

  • La page cible est vide ou contient uniquement un titre.
  • Le texte attendu ou un composant WebPart requis est manquant.
  • Un composant WebPart est présent, mais pointe vers une liste, un fichier, un site, un utilisateur ou un terme incorrects.
  • La mise en page ou l’en-tête de page empêche la page d’atteindre son objectif métier.
  • Les métadonnées ou autorisations requises n’ont pas été conservées.
  • Le journal de transformation contient une erreur non résolue.

Inspectez manuellement les pages où Assessment a signalé WebPartCount=0, même lorsque MappingPercentage=100. Validez également les pages signalées comme entièrement mappées, car les données d’exécution ou les fonctions de mappage peuvent toujours provoquer un échec de transformation.

Enregistrer le résultat de l’onde

Utilisez un enregistrement par page tentée :

Field Objectif
ScanId Lie la page à la preuve d’évaluation.
SiteUrl, WebUrl, PageUrl Identifie la page source.
PlannedTargetPageUrl, TargetPageUrl Identifie le plan révisé et la cible créée.
PageType, Layout Regroupe des résultats comparables.
MappingPercentage, UnmappedWebParts Conserve le signal de planification.
TransformationStatus Skipped, PreflightPassed, Createdou Failed.
LogPath Pointe vers le journal de transformation PnP exact pour la page.
ValidationStatus Pending, Passedou Failed.
ValidationNotes Enregistre le contenu manquant, les problèmes de mappage et le travail de suivi.
ValidatedBy, ValidatedAt Enregistre la propriété d’approbation.

Décider s’il faut développer

Développez l’onde uniquement dans les cas suivants :

  • Chaque page source représentative reste disponible.
  • Chaque page cible approuvée passe la validation du contenu et du comportement.
  • Les brouillons de cibles sont publiés uniquement après approbation.
  • Les bloqueurs courants ont une correction ou un mappage documenté.
  • Les pages ayant échoué ou partielles sont exclues de la prochaine vague.
  • La prochaine vague a un propriétaire, un plan de restauration et des journaux conservés.

En cas d’échec d’une page, arrêtez le traitement des pages comparables. Passez en revue les composants WebPart de journal et source, mettez à jour le mappage ou la règle candidate le cas échéant, puis réessayez une seule page représentative avant de reprendre.

Une fois qu’une page brouillon est approuvée, publiez-la via l’expérience de modification de page ou avec l’option Set-PnPPage-Publish actuelle.

Développer l’onde

Après avoir validé chaque page représentative :

  1. Définissez chaque résultat représentatif sur ValidationStatus=Passed.
  2. Remplissez ValidationNotes, ValidatedByet l’horodatage ISO-8601 ValidatedAt .
  3. Créez approved-pages.csv à partir des lignes groupées supplémentaires approuvées par l’utilisateur.
  4. Exécutez Convert-SelectedPages.ps1 -PreflightOnly avec le manifeste représentatif d’origine et les résultats validés.
  5. Exécutez l’expansion en direct uniquement après chaque passage de ligne préliminaire.
  6. Validez chaque page générée dans la vague développée avant de la publier.

Le script bloque l’expansion si un résultat représentatif est manquant, obsolète, non passé ou basé sur un profil PowerShell Ou script PnP différent.

Étapes suivantes

  1. Retourne les pages ayant échoué au backlog de correction.
  2. Ajoutez les modèles de page passés à approved-pages.csv et exécutez le script d’extension.

Référence

  • Last updated on