Überprüfen von transformierten klassischen Seiten

Überprüfen Sie jede Seite in einer repräsentativen Transformationswelle, bevor Sie weitere Seiten verarbeiten. Ein erfolgreicher Befehl oder eine HTTP 200-Antwort beweist nicht, dass die generierte Seite den erwarteten Inhalt beibehalten hat.

Mitschreiben des erwarteten Ergebnisses

Notieren Sie sich vor der Transformation Folgendes:

  • Quell- und erwartete Ziel-URLs.
  • Seitentyp und Layout.
  • Sichtbarer Text und Überschriften.
  • Webparts und ihre wichtige Konfiguration.
  • Links, Bilder, Dateien, Listen und eingebettete Inhalte.
  • Metadaten, Berechtigungen, Veröffentlichungsstatus und Ob die Seite eine Startseite ist.

Behalten Sie die Zeile "Bewertung" und classicpagewebparts.csv die Zeilen mit dieser Baseline bei.

Wählen Sie für den delegierten AllSites.Manage Pfad der ersten Welle Seiten aus, die Berechtigungen von ihrer Bibliothek erben und generierte Seiten als Entwürfe beibehalten. Wenn eindeutige Quellberechtigungen beibehalten werden müssen, verwenden Sie den überprüften AllSites.FullControl Pfad, anstatt die Berechtigungskopie zu überspringen.

Überprüfen des Transformationsergebnisses

Für jede Seite:

  1. Überprüfen Sie das PnP-Transformationsprotokoll auf Fehler, übersprungene Webparts, Fallbackzuordnungen und Meldungen zum Kopieren von Berechtigungen.
  2. Vergewissern Sie sich, dass die klassische Quellseite noch vorhanden ist und ihren erwarteten Namen beibehält.
  3. Vergewissern Sie sich, dass die erwartete moderne Seite vorhanden ist und geöffnet wird.
  4. Vergleichen Sie sichtbaren Text, Webparts, Abschnitte, Spalten und Reihenfolgen.
  5. Testen Sie Links, Bilder, Dokumente, Listenansichten und andere Abhängigkeiten.
  6. Vergleichen Sie erforderliche Metadaten, Autoren- und geänderte Werte, Berechtigungen, Kommentare und den Veröffentlichungsstatus.
  7. Notieren Sie sich das Ergebnis und den Beweis, bevor Sie die nächste Seite verarbeiten.

Erkennen einer unvollständigen Ausgabe

Behandeln Sie die Seite in folgenden Fällen als fehlgeschlagen:

  • Die Zielseite ist leer oder enthält nur einen Titel.
  • Erwarteter Text oder ein erforderliches Webpart fehlt.
  • Ein Webpart ist vorhanden, verweist aber auf die falsche Liste, Datei, Website, Benutzer oder Begriff.
  • Das Layout oder die Seitenüberschrift verhindert, dass die Seite ihren Geschäftszweck erfüllt.
  • Erforderliche Metadaten oder Berechtigungen wurden nicht beibehalten.
  • Das Transformationsprotokoll enthält einen nicht behobenen Fehler.

Überprüfen Sie manuell Seiten, auf denen die Bewertung gemeldet hat WebPartCount=0, auch wenn MappingPercentage=100. Überprüfen Sie außerdem Seiten, die als vollständig zugeordnet gemeldet werden, da Laufzeitdaten oder Zuordnungsfunktionen weiterhin einen Transformationsfehler verursachen können.

Aufzeichnen des Wellenergebnisses

Verwenden Sie einen Datensatz pro versuchter Seite:

Feld Zweck
ScanId Verknüpft die Seite mit dem Bewertungsbeweis.
SiteUrl, WebUrl, PageUrl Identifiziert die Quellseite.
PlannedTargetPageUrl, TargetPageUrl Identifiziert den überprüften Plan und das erstellte Ziel.
PageType, Layout Gruppiert vergleichbare Ergebnisse.
MappingPercentage, UnmappedWebParts Behält das Planungssignal bei.
TransformationStatus Skipped, PreflightPassed, Createdoder Failed.
LogPath Zeigt auf das genaue PnP-Transformationsprotokoll für die Seite.
ValidationStatus Pending, Passedoder Failed.
ValidationNotes Zeichnet fehlende Inhalte, Zuordnungsprobleme und Nachverfolgung auf.
ValidatedBy, ValidatedAt Zeichnet den Genehmigungsbesitz auf.

Entscheiden, ob erweitert werden soll

Erweitern Sie die Welle nur in folgenden Fällen:

  • Jede repräsentative Quellseite bleibt verfügbar.
  • Jede genehmigte Zielseite besteht die Inhalts- und Verhaltensüberprüfung.
  • Entwurfsziele werden erst nach genehmigung veröffentlicht.
  • Allgemeine Blocker verfügen über eine dokumentierte Korrektur oder Zuordnung.
  • Fehlerhafte oder partielle Seiten werden von der nächsten Welle ausgeschlossen.
  • Die nächste Welle verfügt über einen Besitzer, einen Rollbackplan und beibehaltene Protokolle.

Wenn eine Seite fehlschlägt, beenden Sie die Verarbeitung vergleichbarer Seiten. Überprüfen Sie die Protokoll- und Quellwebparts, aktualisieren Sie ggf. die Zuordnungs- oder Kandidatenregel, und wiederholen Sie eine einzelne repräsentative Seite, bevor Sie den Vorgang fortsetzen.

Nachdem eine Entwurfsseite genehmigt wurde, veröffentlichen Sie sie über die Bearbeitungsoberfläche der Seite oder mit der aktuellen Option Set-PnPPage-Publish .

Erweitern der Welle

Nach der Überprüfung jeder repräsentativen Seite:

  1. Legen Sie jedes repräsentative Ergebnis auf fest ValidationStatus=Passed.
  2. Füllen Sie ValidationNotes, ValidatedByund den ISO-8601-Zeitstempel ValidatedAt aus.
  3. Erstellen Sie approved-pages.csv aus den zusätzlichen gruppierten Zeilen, die der Benutzer genehmigt hat.
  4. Führen Sie Convert-SelectedPages.ps1 -PreflightOnly mit dem ursprünglichen repräsentativen Manifest und überprüften Ergebnissen aus.
  5. Führen Sie die Liveerweiterung erst aus, nachdem jede Preflightzeile erfolgreich war.
  6. Überprüfen Sie jede generierte Seite in der erweiterten Welle, bevor Sie sie veröffentlichen.

Das Skript blockiert die Erweiterung, wenn ein repräsentatives Ergebnis fehlt, veraltet, nicht übergeben wird oder auf einem anderen PnP PowerShell- oder Skriptprofil basiert.

Nächste Schritte

  1. Gibt fehlerhafte Seiten an den Wartungsbacklog zurück.
  2. Fügen Sie übergebene Seitenmuster hinzu, approved-pages.csv und führen Sie das Erweiterungsskript aus.

Referenz

  • Last updated on