Interpretieren des Bewertungsberichts für klassische Seiten

Eine klassische Bewertung exportiert seitenspezifische und freigegebene CSV-Dateien. Unter Windows erstellt ClassicAssessmentReport.pbitder Standardbefehl report auch .

Dieser Leitfaden behandelt die Seiten - und Scanabdeckungsansichten. Die freigegebene klassische Vorlage enthält weitere Komponenten- und Kompatibilitätsregisterkarten, die sich jedoch außerhalb dieses Seitenbewertungsbereichs befinden.

Überprüfungsabdeckung zuerst überprüfen

Vergewissern Sie sich vor dem Interpretieren der Seitenbereitschaft, dass der erwartete Bereich abgeschlossen wurde:

1. Verwenden Sie Die Überprüfungsübersicht, scans.csvund history.csv , um den Bewertungsstatus und die Meldungen zu überprüfen.
2. Verwenden Sie sitecollections.csv und webs.csv , um fehlerhafte, nicht abgeschlossene oder ungewöhnlich langsame Speicherorte zu identifizieren.
3. Überprüfen Sie, ob für die Bewertung ein vollständiger Mandantenbereich , --siteslistoder --sitesfileverwendet wurde.
4. Überprüfen Sie classicpageauditusage.csv die Abdeckung status, bevor Sie die Aktivitätsanzahl verwenden.

Eine abgeschlossene Bewertung kann weiterhin Website- oder Webfehler enthalten. Behandeln Sie fehlende Speicherorte als Abdeckungslücke, nicht als Feststellung, dass keine klassischen Inhalte vorhanden sind.

Informationen zu den allgemeinen Dateischemas und Joinschlüsseln finden Sie unter Allgemeine CSV-Referenz zur Bewertung.

Priorisieren von Seiten

Auf der aktuellen Registerkarte Seiten in Power BI werden die grundlegenden Felder für den Seitenbestand verwendet, z. B. Seitentyp, URL, Änderungsdatum und Wartungscode.

Verwenden Sie classicpages.csv für die erweiterten Bereitschaftsfelder und zum Segmentieren von Seiten nach:

• Seitentyp.
• Homepage-status.
• Datum und Modifizierer der letzten Änderung.
• Webpartanzahl.
• Zuordnungsprozentsatz.
• Nicht zugeordnete Webparttypen.

Kombinieren Sie diesen Bestand mit classicpageauditusage.csv , um häufig verwendete Seiten von veralteten oder wenig genutzten Inhalten zu unterscheiden.

Das aktuelle eingebettete Power BI-Modell enthält keine erweiterten Rollupfelder für Startseite, Webpart, Zuordnung, Überwachung oder Seitenbereitschaft. Analysieren Sie diese Felder direkt in den CSV-Dateien, oder erweitern Sie das Power BI-Modell, bevor Sie sie in Visuals verwenden.

Die Nutzungsüberwachung ist ein Planungssignal, kein unformatierter Webanalysezähler. Überprüfen Sie QueryStatusimmer:

Status	Bedeutung
succeeded	Das angeforderte Überwachungsfenster wurde abgeschlossen.
partial	Mindestens eine Überwachungsunterabfrage ist fehlgeschlagen. Die Anzahl ist eine untere Grenze.
failed	Fehler bei der Überwachungssammlung. Die Anzahl kann nicht verwendet werden.
skipped	Die Überwachungssammlung wurde nicht für die Website ausgeführt, z. B. in einer nicht unterstützten Cloud.
error	Nach der Überprüfung ist eine unerwartete Ausnahme aufgetreten. Überprüfen Sie SkipReason und das Bewertungsprotokoll.

Wichtig

Sovereign-Cloud-Bewertungen bieten keine Seite Nutzung überwachen. Interpretieren Sie fehlende oder übersprungene Nutzungszeilen nicht als Nullaktivität. Priorisieren Sie mit ModifiedAt, bekannter Seitenrelevanz und Eingaben des Geschäftsbesitzers.

Wenn die Überwachungsabfrage einer Website erfolgreich war, bedeutet das Fehlen einer Seitenzeile, dass für diese Seite im angeforderten Fenster keine übereinstimmenden Ereignisse zurückgegeben wurden. Behandeln Sie eine fehlende Zeile erst als Nullaktivität, nachdem die erfolgreiche Abdeckung für die Website bestätigt wurde.

Wenn SkipReason mit QueryTimeoutbeginnt, hat Microsoft Purview die Abfrage während der 90-minütigen Wartezeit der Bewertung nicht abgeschlossen. Wenn kein Überwachungsblock erfolgreich ist, weist QueryStatus=faileddie Zeile auf. Behandeln Sie ihre Nullanzahl als fehlgeschlagene Abdeckung, nicht als Beweis für keine Aktivität. Dies unterscheidet sich von NoPermission, was auf eine fehlende Überwachungsberechtigung hinweist.

Grundlegendes zur Seitentypabdeckung

Wiki-, Webpart- und Veröffentlichungsseiten erhalten eine detaillierte Webpartextraktion und Zuordnungsanalyse.

Blog-, ASPX- und Delve-Blogseiten werden ermittelt und aufgezeichnet, erhalten aber nicht die gleiche Zuordnungsbereitschaftsanreicherung. Interpretieren Sie einen standardmäßigen oder leeren Zuordnungswert für diese Seitentypen nicht als abgeschlossene Bereitschaftsanalyse.

Delve Blog-Seiten werden in classicpages.csv angezeigt, sind aber nicht in den aktuellen Rollups für die Seitenanzahl von Websites und Websites enthalten.

Interpretieren von Zuordnungsergebnissen

MappingPercentage ist der Prozentsatz der extrahierten Webparts, die über eine verwendbare Zuordnung im eingebetteten Zuordnungsmodell verfügen:

• Eine Seite ohne extrahierte Webparts ist konventionshalber zu 100 Prozent.
• Ein Ergebnis von 100 Prozent bedeutet, dass alle extrahierten Webparttypen Zuordnungen aufweisen. Es garantiert nach der Transformation keine visuelle, Daten-, Berechtigungs- oder Geschäftsverhaltensparität.
• Ein Wert unter 100 mit WebPartCount einem Wert größer als 0 (null) identifiziert einen oder mehrere Webparttypen, die eine Korrektur, Ersetzung oder eine benutzerdefinierte Zuordnung erfordern.
• Für eine Wiki-, Webpart- oder Veröffentlichungsseite und kann darauf hinweisen, dass bei der Extraktion ein Fehler aufgetreten ist, WebPartCount=0MappingPercentage=0 bevor die Zuordnungsberechnung ausgeführt wurde. Überprüfen Sie das Bewertungsprotokoll für Failed to assess the web parts of classic page.

Verwenden Sie classicpagewebparts.csv für die Entscheidung pro Seite:

• IsMappable bedeutet, dass das Webpart über eine nicht leere verwendbare Zuordnung verfügt.
• WebPartProperties wird nur aufgefüllt, wenn --exportwebpartproperties ausgewählt wurde.
• Zeilen-, Spalten-, Zonen-, Ordnungs-, ausgeblendete und geschlossene Werte helfen, das aktuelle Seitenlayout zu erklären.

Verwenden Sie classicwebpartunique.csv , um Webparttypen zu identifizieren, die sich auf viele Seiten auswirken. InMappingFile ist schwächer als IsMappable: Dies bedeutet nur, dass der Typ über einen Eintrag in der Zuordnungsdatei verfügt.

Die aktuelle Bewertungsimplementierung behandelt die Communityzuordnungen für ScriptEditorWebPart und SimpleFormWebPart als nicht verfügbar. Außerdem wird keine Außerkraftsetzung einer Zuordnungsdatei auf dem Datenträger unterstützt.

Dieses Bewertungsergebnis bedeutet, dass diese Webparts vom Standardbereitschaftsmodell nicht genehmigt werden. Die PnP-Transformation kann optional Skript-Editor- und Simple Form-Inhalte an den Open-Source-Community-Skript-Editor weiterleiten, nachdem diese Lösung installiert und -UseCommunityScriptEditor ausgewählt wurde.

Achtung

Ein Skript-Editor kann benutzerdefinierten Code auf der Seite ausführen. Behandeln Sie dies als erweiterte Lösungsentscheidung mit Sicherheitsüberprüfung und einer separat überprüften Seite. Die bewertungsgesteuerten Batchskripts aktivieren den Community-Skript-Editor nicht.

Siehe Klassische Webpartzuordnungen.

Entscheiden der nächsten Aktion

Werten Sie die Tabelle von oben nach unten aus, und verwenden Sie die erste übereinstimmende Zeile. Zuordnungsbasierte Entscheidungen gelten erst nach Abschluss der Abdeckung und des Seitentyproutings.

Bewertungsergebnis	Decision	Nächste Aktion
Websitesammlung oder Web wurde nicht abgeschlossen	Abdeckung blockiert	Beheben Sie den Überprüfungsfehler, bevor Sie die Seitenanzahl oder Bereitschaft interpretieren.
Seitentyp: Blog, ASPX oder Delve Blog	Zuordnungsbewertung ist nicht umsetzbar	Befolgen Sie die Unterstützungsanleitung für Seitentypen , anstatt den Bereitschaftsprozentsatz zu verwenden.
Seitentyp: Veröffentlichung	Erweiterter Backlog	Überprüfen Sie das Layout und fehlende Eingaben auf Portalebene, bevor Sie ein separates Ziel und eine separate Prozedur definieren.
Wiki- oder Webpartseite ist eine Startseite	Separate Genehmigung erforderlich	Halten Sie es aus der ersten Welle heraus, und definieren Sie url- und navigations- und rollback-Verhalten vor der Transformation.
Wiki- oder Webpartseite weist WebPartCount=0 und MappingPercentage=0 mit einem Anreicherungsfehler auf	Fehler beim Seitenscan	Überprüfen Sie das Protokoll, und führen Sie die Bewertung erneut aus, bevor Sie die Seite auswählen.
Wiki- oder Webpartseite hat WebPartCount=0 und MappingPercentage=100	Manuelle Überprüfung erforderlich	Öffnen Sie die Quellseite, und überprüfen Sie, ob die Bewertung sichtbare Inhalte verpasst hat. Platzieren Sie es nicht in einer automatisierten Welle.
Wiki- oder Webpartseite enthält WebPartCount>0, MappingPercentage=100und keine nicht zugeordneten Webparts	Repräsentativer Pilotkandidat	Gruppieren Sie es nach Layout und geordneter Webpartsignatur, transformieren Sie einen Entwurf, und überprüfen Sie das Ergebnis.
Wiki- oder Webpartseite hat MappingPercentage<100 oder mehrere UnmappedWebParts	Korrektur erforderlich	Ersetzen Sie die blockierenden Webparts, oder definieren Sie eine benutzerdefinierte Zuordnung, und überprüfen Sie sie separat vor der Transformation.

Verwenden von Rollups

Verwenden Sie classicwebsummaries.csv und classicsitesummaries.csv , um Folgendes zu identifizieren:

• Webs und Websitesammlungen mit den klassischsten Seiten.
• Seiten mit vollständig zugeordneten oder nicht zugeordneten Webparts.
• Durchschnittlicher Prozentsatz der Zuordnung auf Seiten, die Webparts enthalten.
• Homepages, die ein separates genehmigtes Backlog für die URL-, Navigations- und Rollbackplanung erfordern.

Rollups sind für die Sequenzierung nützlich, kehren jedoch zu den CSV-Dateien der Seite und des Webparts zurück, bevor Sie eine Korrekturentscheidung treffen.

Überprüfen von Veröffentlichungsportalen

classicpublishingsitesummaries.csv stellt eine Zusammenfassung der Veröffentlichung auf Websitesammlungsebene bereit. Eine detaillierte Konfiguration der Veröffentlichung auf Webebene auf Legacyebene ist nicht enthalten.

Weitere Informationen finden Sie unter Grundlegendes zur Abdeckung des Veröffentlichungsportals , bevor Sie die Transformation der Veröffentlichungsseite planen.

Wechseln von der Bewertung zur Transformation

Wandeln Sie den Bericht in einen Transformationsbacklog um:

1. Schließen Sie fehlerhafte oder unvollständige Scanspeicherorte aus.
2. Priorisieren Sie aktive Seiten und wichtige Startseiten.
3. Gruppierung von Seiten nach Seitentyp, Layout und nicht zugeordneter Webpartkombination.
4. Lösen Sie häufige Blocker auf, bevor Sie eine große Welle transformieren.
5. Ordnen Sie die CSV-Seitenidentität den PnP-PowerShell-Quellverbindungs- und Cmdlet-Parametern zu.
6. Transformieren Sie eine repräsentative Stichprobe, und überprüfen Sie das Ergebnis vor dem horizontalen Hochskalieren.

Zuordnen von CSV-Feldern zu PnP PowerShell

CSV-Feld	Transformationsverwendung
SiteUrl + WebUrl	Erstellen Sie die Quellweb-URL für Connect-PnPOnline.
PageUrl + ListUrl	Leiten Sie den Seitendateinamen ab, der die Bibliothek und den optionalen Ordner enthält.
PageName	Verwenden Sie den Seitentitel als -Identity für eine klassische Blogseite.
PageType	Weiterleiten zum Wiki-/Webpart-, Veröffentlichungs- oder Blogtransformationspfad.
Layout	Wählen Oder überprüfen Sie die Seitenlayoutzuordnung für Veröffentlichungsseiten.

Die Bewertungs-App ist schreibgeschützt. Verwenden Sie eine separate PnP PowerShell-Verbindung mit der Berechtigung zum Erstellen oder Aktualisieren von Seiten im Quell- oder Zielweb.

Fahren Sie mit der Transformationsaufgabe fort.

Verwenden Sie die Feldzuordnung, um die genaue Bewertungszeile zu genehmigen und den erwarteten Inhalt aufzuzeichnen. Folgen Sie dann Den Anweisungen zum Transformieren ausgewählter klassischer Seiten mit PnP PowerShell für die aktuellen Sicherheitsvorkehrungen für Anwendung, Berechtigung, Quellidentität, Entwurfsausgabe, Protokollierung und Validierung.

Leiten Sie andere Seitentypen absichtlich weiter:

• PublishingPage: Verwenden Sie -PublishingPage, ein Zielweb und das Veröffentlichungsseitenlayoutmodell.
• BlogPage: verwenden Sie -BlogPageals PageName Blogtitelidentität und als Zielweb. Blogzeilen erhalten nicht die detaillierte Anreicherung der Zuordnungsbereitschaft, die für Wiki-, Webpart- und Veröffentlichungsseiten beschrieben wird.
• ASPXPage und DelveBlogPage: Schließen Sie sie aus dieser automatisierten Transformationswarteschlange aus. Die Seitenbewertung bietet keinen entsprechenden Bereitschaftspfad für sie.

Beginnen Sie mit Transformieren ausgewählter klassischer Seiten mit PnP PowerShell, und überprüfen Sie dann jede transformierte Seite. Verwenden Sie das Seitentransformationsmodell für benutzerdefinierte Webpartzuordnungen und das Veröffentlichungsmodell zum Veröffentlichen von Seitenlayouts.

Power BI und CSV

Die Power BI-Vorlage ist eine Visualisierungsebene über der CSV-Ausgabe. Die CSV-Dateien bleiben die Quelle für:

• Automatisierung.
• Überprüfung auf Schemaebene.
• Verknüpfen von Seiten-, Webpart-, Nutzungs-, Web- und Websitedatensätzen.
• Beibehalten eines überprüfbaren Nachweises Momentaufnahme.

Für die Power BI-Vorlagengenerierung ist Windows erforderlich. Die CSV-Generierung funktioniert unter Windows, macOS und Linux.

Referenz

• CSV-Referenz zur Bewertung klassischer Seiten
• Allgemeine CSV-Referenz zur Bewertung