Planen einer Migration mit dem Site-Katalog site-catalog-skill
Der Site-Katalog des Experience Modernization Agent listet die Seiten einer Site auf, zu deren Migration Sie berechtigt sind, und gruppiert sie, bevor etwas importiert wird. Seiten mit einem Layout von Blöcken aus einer Vorlage. Ähnliche seitenübergreifende Blöcke bilden eine Blockvariante: eine Version eines Blocks, der sich in der Inhaltsstruktur oder dem Look unterscheidet. Beim Import wird eine Variante, deren Felder sich unterscheiden, zu einem Block. Mit dieser Gruppierung migrieren und überprüfen Sie eine Beispielseite pro Vorlage und importieren dann den Rest der Vorlage in Batches. Die Vorlagen, Blöcke und Gebietsschemata, die der Katalog findet, bieten Ihnen auch Schätzung des Projekts und der zugehörige Bericht kann für Stakeholder freigegeben werden, die die Konsole nicht verwenden.
Der Katalog liest die Quell-Site und importiert nichts. Den gesamten Migrations-Workflow finden Sie unter Migrieren einer Produktions-Site.
Planung starten invoking
Vergewissern Sie sich, dass Sie zum Lesen der Quell-Site berechtigt sind und dass die Konsole darauf zugreifen kann. Beginnen Sie dann mit der Planung in Experience Modernization Console auf eine der folgenden Arten:
-
Öffnen Sie die Planungsansicht. Wenn das Projekt noch keinen Plan hat, wird Migration planen angezeigt. Geben Sie die Adresse der Site ein und wählen Sie Meine Migration planen. Beginnen Sie mit der Startseite. Der Agent findet die anderen Seiten.
-
Fragen Sie den Agenten im Chat:
scope site https://www.example.com
Während der Ausführung der Planung zeigt Ansicht Planung den aktuellen Schritt, Anzahl der gefundenen und gelesenen Seiten und die verstrichene Zeit an. Sie können die Ergebnisse vor Abschluss des Durchgangs überprüfen.
Der Agent analysiert jede erkannte Seite. Wenn es mehr als 1.000 Seiten findet, sagt es Ihnen grob, wie lange die Analyse dauern wird und wird fortgesetzt. Bitten Sie bei einer sehr großen Website den Agenten, vorzuschlagen, wie die Migration geteilt werden soll, und katalogisieren Sie dann die ausgewählten Abschnitte.
Um einen Lauf zu stoppen, verwenden Sie die Stopp-Steuerung im Chat. Die Planning-Ansicht zeigt dann Planning Stopped before it completed an, und Sie können dort weitermachen, wo es aufgehört hat oder von vorne anfangen. Der Chat-Thread zeigt, was vor dem Anhalten passiert ist.
Die Planung erfolgt in vier Phasen:
- Analysieren Der Agent lädt jede Seite, erstellt einen Screenshot und unterteilt die Seite basierend auf ihrem vom Autor bearbeitbaren Inhalt in Blöcke. Screenshots lassen Cookie-Banner und andere große Dialogfelder, die die Seite bedecken, unberücksichtigt. Bei der Analyse werden Kopf- und Fußzeile der Site ausgelassen, da eine Edge Delivery Services-Site sie einmal aus separaten Navigations- und Fußzeileninhalten erstellt.
- Blockkatalogisierung: Agent gruppiert ähnliche Blöcke über Seiten hinweg in Blockvarianten, ordnet jede Variante einem Block aus der Blockbibliothek zu und benennt sie.
- Vorlage: Agent gruppiert Seiten, die dasselbe Layout von Blöcken aufweisen, in Vorlagenkandidaten.
- Benennung: Der Agent führt Vorlagenkandidaten zusammen, die strukturell identisch sind, und gibt jeder Vorlage einen aussagekräftigen Namen.
Ergebnisse und Status output
Nach Abschluss des Durchgangs veröffentlicht der Agent eine Zusammenfassung im Chat: die Anzahl der Seiten, Vorlagen und Blockvarianten, eine Aufschlüsselung nach Gebietsschema und den Status des Durchgangs. Die Planning-Ansicht zeigt denselben Status an.
Ein vollständiger-Durchgang kann immer noch fehlgeschlagene Seiten enthalten. Überprüfen Sie daher die fehlgeschlagenen URLs trotzdem. Vergleichen Sie die entdeckten URLs mit Ihrem vereinbarten Umfang: Seiten, die nicht auf einen Link verweisen, benötigen eine eigene Entscheidung. Halten Sie die Anzahl der erkannten, analysierten, importierten und abgemeldeten Seiten auseinander.
Die Planungsansicht planning-ui
Die Planning-Ansicht im Arbeitsbereich zeigt die Vorlagen, Seiten und Blöcke an, die vom Agenten identifiziert wurden, einschließlich Screenshots, damit Sie sie vor der Migration korrigieren können. Jeder weitere Schritt baut auf dieser Gruppierung auf. Überprüfen Sie sie daher vor dem Importieren von Seiten. Die Ansicht hat nichts mit dem Plan-Modus des Chats zu tun, in dem der Agent seinen Ansatz für eine Anfrage vorschlägt, bevor er Dateien ändert.
Planungsansicht öffnen accessing-planning-ui
- Öffnen Sie in der Kopfzeile des Arbeitsbereich-Bedienfelds die Ansichtsauswahl und wählen Sie Planung unter Projekt aus. Sie ist immer da, man muss sie nicht einschalten.
- Öffnen Sie das
https://aemcoder.adobe.io/chat/project/plan. - Wenn ein Durchlauf abgeschlossen ist, wählen Plan anzeigen in der Benachrichtigung Ihr Migrationsplan ist.
Wenn Sie eine Site im aktuellen Projekt nicht katalogisiert haben, werden Sie in der Ansicht nach der Site-Adresse gefragt, damit Sie mit der beginnen .
Die Ansicht zeigt einen Migrationsplan pro Konsolen-Arbeitsbereich aus den Dateien im catalog/-Ordner . Es ist nicht möglich, mehrere Pläne nebeneinander zu führen, z. B. einen pro Länderseite. Planen und migrieren Sie die Sites nacheinander und laden Sie das Berichtspaket jedes Plans herunter, wenn Sie es aufzeichnen möchten.
Dashboard dashboard
Das Dashboard fasst die katalogisierte Site zusammen. Die Kopfzeile zeigt den Site-Titel, Ausführungsstatus und das Analysedatum an. Wählen Sie Site öffnen in der Kopfzeile von Workspace aus, um die Quell-Site in einer neuen Registerkarte zu öffnen.
Die Dashboard-Karten zeigen:
- Inhalt Die gefundenen URLs, Vorlagen, analysierten Seiten und gefundenen Dokumente.
- Seiten: Die Seiten wurden analysiert und sind fehlgeschlagen, und wie die URLs erkannt wurden, z. B. von der Sitemap oder durch folgende Links. Wählen Sie die Anzahl der Fehler aus, um die ( URLs) öffnen.
- Blöcke: Die identifizierten Blöcke und Blockvarianten.
- Locales: Die Seiten pro Gebietsschema. Diese Karte wird nur für eine Site mit mehr als einem Gebietsschema angezeigt.
Unter den Karten wechselt ein Umschalter die Tabelle zwischen Vorlagen mit der Beschreibung und Anzahl der Seiten jeder Vorlage und Blöcke mit jedem Block und seinen Varianten. Wählen Sie einen Vorlagennamen aus, um seine Vorlagendetails zu öffnen, oder eine Variante, um ihre Instanzen anzuzeigen. Beide Tabellen können durchsucht und sortiert werden. Wählen Sie Tabelle erweitern, um die Karten auszublenden und der Tabelle mehr Platz zu geben.
Blocktabelle blocks-table
Die Blocktabelle zeigt eine erweiterbare Zeile pro Block an, wobei die Varianten des Blocks darunter verschachtelt sind. Für jeden Block werden die Anzahl der Varianten, Seiten und Vorlagen, in denen er gefunden wird, sowie der Code-Status angezeigt.
Jeder Block zeigt seinen Namen und den Blocktyp aus der Blockbibliothek an, auf der er basiert, z. B. einen cards-story vom Typ cards. Die zugehörigen Varianten werden unten nach ihrer Variantenklasse aufgelistet, z. B. .with-button. Eine Variante ohne Klasse ist der Standard des Blocks. Die Kopfzeile, die Fußzeile und der Standardinhalt, wie z. B. einfache Überschriften und Text, werden nicht als Blöcke aufgeführt.
Die Spalte Code zeigt an, ob Code für den Block generiert wurde.
Bereit bedeutet nur, dass der Code vorhanden ist. Ob Autorinnen und Autoren den Block bearbeiten können und ob er funktioniert, wird in Prüfungen vor der Freigabe geprüft.
Die Spalte Konfidenz zeigt an, wie sicher der Agent ist, dass eine Blockvariante korrekt gruppiert und klassifiziert wurde:
- Hoch oder Niedrig wird durch Katalogisierung festgelegt. Klicken Sie auf das Informationssymbol neben der Ebene, um den Grund zu lesen. Überprüfen Sie Low zuerst.
- Benutzer bedeutet, dass eine Person die Variante bestätigt oder geändert hat, z. B. durch eine geführte Überprüfung oder eine Verfeinerungsaktion.
Nachdem der Code mit Beispielinhalten generiert wurde, wählen Sie Beispiel anzeigen im Aktionsmenü eines Blocks aus, um die Beispielseite des Blocks in der Vorschau zu öffnen.
Vorlagen- und Seitendetails zeigen dieselbe Blocktabelle an, die auf diese Vorlage oder Seite beschränkt ist.
Vorlagendetails template-details
Wählen Sie eine Vorlage aus, um alle Seiten anzuzeigen, die sie verwenden, einschließlich Seitenpfad, Titel und Anzahl der Blöcke. Wählen Sie einen Seitenpfad aus, um seine Seitendetails zu öffnen. Verwenden Sie den Umschalter Seiten / Blöcke, um zu den von der Vorlage verwendeten Blöcken zu wechseln.
Sobald Seiten einer Vorlage migriert wurden, zeigt die Vorlage an, wie viele Seiten importiert wurden und wie viele fehlgeschlagen sind. Jede Seite zeigt den Importstatus an. Der Status wird während der Ausführung des Imports aktualisiert.
Ein Bindestrich bedeutet, dass die Vorlage der Seite nicht Teil der aktuellen Migration ist.
Seitendetails page-details
Seitendetails : Listet die auf der Seite gefundenen Blöcke mit Details aus der Analyse auf, wie z. B. die Anzahl der Abschnitte und Blöcke. Wählen Screenshot anzeigen in der Kopfzeile aus, um den Vollbild-Screenshot der Seite anzuzeigen. Wählen Sie Auf Seite suchen auf einer Blockvariante aus, um den Screenshot mit diesem Block hervorzuheben.
Varianteninstanzen variant-instances
Wählen Sie eine Blockvariante aus, um jede Instanz auf der gesamten Site nebeneinander mit der Anzahl der Instanzen, Seiten und Vorlagen anzuzeigen, auf denen sie angezeigt wird. Eine Instanz in der falschen Gruppe fällt auf.
Im Menü Aktionen jeder Instanz können Sie den zugehörigen Screenshot anzeigen, ihn auf der zugehörigen Seite suchen, die zugehörigen Seitendetails öffnen oder die Quellseite öffnen.
Um die Gruppierung zu korrigieren, wählen Sie eine oder mehrere Instanzen und eine der folgenden Aktionen aus:
- Aufspaltung in eine neue Variante: Verschiebt die ausgewählten Instanzen in eine neue Variante.
- In eine andere Variante verschieben: Verschiebt die ausgewählten Instanzen in eine vorhandene Variante.
Mindestens eine Instanz muss in der ursprünglichen Variante verbleiben. Um jede Instanz einer Variante zu verschieben, verwenden Sie stattdessen Diese Variante erhält einen eigenen Block oder Als Variante eines anderen Blocks festlegen auf der Variante. Die Aufspaltungs- und Verschiebungsänderungen werden beibehalten, wenn der Katalog neu generiert wird.
Fehlgeschlagene URLs failed-urls
Die Liste Fehlgeschlagene URLs zeigt jede Seite, die nicht analysiert werden konnte, mit dem Grund und der Uhrzeit. Dateien, bei denen es sich nicht um Seiten handelt, z. B. Bilder und Dokumente, werden übersprungen, separat gezählt und nicht aufgeführt.
Katalog überprüfen review-catalog
Nach Abschluss der Planung bietet der Agent an, die Ergebnisse der Umfangsberechnung“. Verwenden Sie ihn als Ausgangspunkt für die Überprüfung des Katalogs, insbesondere für große Sites.
- Wählen Sie "Schritt überprüfen um die Fragen des Agenten zu beantworten, oder Autopilot, um ihn entscheiden zu lassen.
- Der Agent behebt zunächst Probleme, die nur eine vernünftige Antwort haben, und teilt Ihnen mit, was sich geändert hat. Beispielsweise werden Ausreißer in die Variante verschoben, in die sie passen, einzelne Links und Schaltflächen in Seitentext umgewandelt, Lookalike-Varianten kombiniert und ungültige Namen korrigiert.
- Anschließend werden Sie nach den verbleibenden Punkten einzeln gefragt, beginnend mit klaren Fehlern. Jede Frage zeigt die Screenshots und den Vorschlag des Agenten, und Sie antworten in einem Schritt. Fragen Sie, warum, wenn Sie ihre Begründung wollen.
- Wählen Sie Für mich beenden, damit der Agent die restliche Überprüfung ohne weitere Fragen abschließen kann.
- Die Überprüfung endet mit einem kurzen Bericht darüber, was sich geändert hat und was im Plan überprüft werden sollte. Elemente, bei denen sich der Agent noch nicht sicher ist, bleiben unverändert und werden gekennzeichnet. Wählen Sie Verbleibende Elemente überprüfen, um mit ihnen fortzufahren, oder Site-Migration beginnen wenn der Katalog bereit ist.
Durch die Überprüfung wird nur der Katalog geändert. Es importiert keine Seiten und generiert keinen Code.
Site-Migration starten migriert jeweils eine Vorlage. Der Agent fragt, mit welcher Vorlage er beginnen soll, und verwendet dann die Seiten und Blöcke des Katalogs dafür. Überprüfen Sie die Seiten dieser Vorlage, bevor Sie mit der nächsten fortfahren, und erwarten Sie, einige davon zu korrigieren.
Verfeinern des Katalogs planning-actions
Aktionsmenü öffnen (…) von beliebigen Vorlagen, Seiten, Blöcken oder Varianten und wählen Sie KI-Aktionen, um die für sie verfügbaren Aktionen anzuzeigen. Sie können auch bis zu 20 Elemente auswählen, um sie gemeinsam zu bearbeiten.
Wenn Sie eine Aktion auswählen, fügt die Konsole die ausgewählten Elemente mit einer Anfrage zum Chat hinzu. Überprüfen Sie den Umfang und alle vorgeschlagenen Änderungen, bevor Sie sie bestätigen. Sie können auch "zum Chat hinzufügen auswählen und Ihre eigene Eingabeaufforderung schreiben, einschließlich der Änderungen, die nicht möglich sind, und der Frage, ob der Agent Inhalte hochladen darf.
Einige Aktionen zeigen nur an, wo sie gelten. Beispielsweise sind Block-Code generieren und Block umbenennen nur für Blöcke verfügbar, deren Typ klassifiziert wurde. Weisen Sie dieser Variante einen eigenen Block zu nur für Varianten mit einer Variantenklasse.
In Seite nach AEM migrieren und Vorlage nach AEM migrieren bezieht sich AEM auf das Projekt, das mit der Konsole verbunden ist. Der importierte Inhalt bleibt im Konsolenarbeitsbereich, bis Sie ihn hochladen: in Experience Workspace für dokumentbasierte Projekte oder in die Autoreninstanz für das Experience Manager-Authoring.
Durch Gruppierungs- und Benennungskorrekturen wird der Katalog geändert, nicht die bereits importierten Seiten. Block-Code generieren ändert den Code, und die Migrationsaktionen importieren Inhalte. Überprüfen Sie daher ihre Ausgabe separat. Ein Strukturrefaktor im Katalog ist kein Refaktor des Blockcodes. Weitere Informationen hierzu finden Sie unter Refaktorieren ohne Änderung des Ergebnisses.
Phase erneut ausführen additional-prompts
Um eine Phase erneut auszuführen, z. B. nachdem die Quellseite geändert wurde, bitten Sie den Agenten, sie mit dem Namen zu wiederholen:
repeat block cataloging
Der Agent führt außerdem jede spätere Phase erneut aus und behält die früheren Phasen bei. Änderungen, die Sie in der Planning-Ansicht vorgenommen haben, z. B. das Aufteilen oder Verschieben von Blockinstanzen, werden beibehalten.
Wenn die Planung-Ansicht Blockkatalog ist veraltet anzeigt, wurde der Katalog in einem früheren Format erstellt, das die aktuelle Version nicht lesen kann. Führen Sie die Planung erneut aus dem Chat mit scope site und der Adresse der Website aus. Wenn die Planung vor dem Abschluss angehalten wurde startet in der Ansicht Planung auch eine neue Ausführung für dieselbe Site.
Massenimport-Workflow bulk-import
So migrieren Sie eine vollständige Site-Vorlage anhand einer Vorlage:
- Führen Sie den Site-Katalog aus, um die Vorlagen und Blockvarianten abzurufen.
- Überprüfen Sie sie in der Planungsansicht und korrigieren Sie alle falsch identifizierten . Die Geführte Überprüfung ist der schnellste Einstieg.
- Generieren Sie Code für die benötigten Blöcke. Sie können mehrere Blöcke auswählen und nur für diese Code generieren.
- Öffnen Sie für jede Vorlage ihre Vorlagendetails und verwenden Sie Seite nach AEM migrieren auf einer oder zwei Beispielseiten. Importieren verfeinern, bis die Ausgabe korrekt ist.
- Verwenden Sie Vorlage nach AEM migrieren um die verbleibenden Seiten dieser Vorlage zu importieren. Befolgen Sie den Importstatus“ jeder Seite wiederholen Sie fehlgeschlagene Seiten, nachdem Sie die Ursache behoben haben.
- Wiederholen Sie den Vorgang für jede Vorlage.
Wenn die Ausgabe einer Vorlage falsch ist, korrigieren Sie sie auf einer Beispielseite, bevor Sie weitere Seiten importieren. Wenn die Analyse fehlschlägt, überprüfen Sie die fehlgeschlagenen URLs, korrigieren Sie den Quellzugriff und versuchen Sie es dann erneut. Durch das Importieren einer Seite werden Änderungen, die seitdem von Autoren vorgenommen wurden, erneut überschrieben. Siehe In Batches importieren.
Katalogdateien catalog-files
Die meisten Benutzer benötigen nur die Planungsansicht. Um einen Offline-Bericht freizugeben oder die Daten in anderen Tools zu verwenden, suchen Sie die Rohausgabe im catalog/ Ordner Ihres Projekts.
template-catalog-report-bundle.zipsummary.jsontemplate-catalog.jsonblock-catalog.jsonurls-all.jsoncatalog.logDer Ordner enthält auch Zwischendateien, einschließlich Seitenanalyse und Screenshots in .pages/ und Metadaten pro Variante in .blocks/.
Einschränkungen limitations
- Zugriff auf Source: Der Agent liest die Quelle aus der gehosteten Umgebung, sodass er keinen Zugriff erhält, wenn er in seinem eigenen Browser bei der Quelle angemeldet ist. Konfigurieren Sie für Seiten, für die eine Anmeldung oder ein geheimer Header erforderlich ist, die Authentifizierung einer geschützten Site und überprüfen Sie eine geschützte Seite, bevor Sie eine vollständige Ausführung starten. Gehen Sie nicht davon aus, dass die für den Automatikmodus eingerichtete Authentifizierung auch für die Katalogisierung gilt. Wenn die Quelle automatisierte Besucher blockiert, lesen Sie Source Sites mit Bot-Schutz.
- Inhalt hinter Interaktionen: Der Katalog lädt jede Seite in einem Browser, wie beim Import, sodass Inhalte, die nur angezeigt werden, nachdem ein Besucher auf oder klickt, nicht erfasst werden. Überprüfen Sie die Screenshots mit der Quelle. Siehe Einschränkungen.
- Abdeckung: Die verwendet die Sitemap oder folgt Links von der Startseite, sodass keine Seiten gefunden werden, die weder auflisten noch zu denen verlinkt sind, z. B. Landingpages in Kampagnen. Vergleichen Sie das Ergebnis mit Ihrer eigenen URL-Liste und erfassen Sie Fehler, fehlende URLs und genehmigte Ausschlüsse.
Um die Analyse zu übergeben, notieren Sie ihr Datum, den Quellumfang, den Bericht, Ihre Korrekturen, die nicht aufgelösten URLs und die Beispielseiten, die Sie in der Projektübergabe“ eingecheckt .