Fehlerbehebung beim Experience Modernization Agent troubleshooting
Finden Sie das Symptom und folgen Sie dann seinem Abschnitt. Die meisten Probleme rühren vom Zugriff auf die Quell-Site, von den Konten, die Code und Inhalte auf Ihre Adobe Experience Manager Edge Delivery Services-Site schreiben, oder von einem Unterschied zwischen Ihrem Konsolenarbeitsbereich und dem, was in Git und in Ihrer Inhaltsquelle gespeichert ist.
Bevor Sie etwas zurücksetzen, verwerfen, ersetzen oder überschreiben, behalten Sie die betroffenen Arbeiten bei. Code und Inhalt werden separat wiederhergestellt (siehe , Wiederherstellen und Übergeben.
Wenn das Problem auf dieser Seite nicht behoben werden kann, Sie den Support der Konsole an oder wählen Sie Hilfe anfordern auf den Seiten für den Automatikmodus aus.
Import schlägt fehl import-fails
Behalten Sie den Fehler und die genaue Quell-URL bei und überprüfen Sie, ob die URL in einem Browser geöffnet wird. Wenn für Seiten eine Anmeldung erforderlich ist oder bei einer Erfassung anstelle des Inhalts eine Anmeldeseite angezeigt wird, richten Sie die Authentifizierung für geschützte Websites ein. Wenn die Quell-Site den automatischen Zugriff blockiert, lesen Sie Source Sites mit Bot-Schutz. Wenn die Quelle erreichbar ist, geben Sie dem Agenten den Fehler und bitten Sie ihn, den Import dieser Seite zu korrigieren. Wiederholen Sie den Vorgang für eine betroffene Seite, bevor Sie einen Batch wiederholen.
Source Sites mit Bot-Schutz bot-protection
Der Bot-Schutz in einem Content Delivery Network (CDN) oder einer Firewall in der Web-Anwendung (WAF) kann die Anforderungen des Agenten an eine Quell-Site in jedem Workflow blockieren oder infrage stellen: URL-Erkennung, Website-Katalog, Seitenerfassung und Import. Typische Anzeichen sind Fehler, bei denen der Zugriff verweigert wird, z. B. HTTP 403, 429 oder 503, nach Erkennung fehlende URLs, fehlgeschlagene Seiten oder eine Herausforderung- oder Verifizierungsseite, die anstelle des Seiteninhalts erfasst wird.
Migrieren Sie nur Sites, die Sie besitzen oder zu deren Migration Sie berechtigt sind. Vereinbaren Sie den Zugriff mit dem Administrator der Site, anstatt den Schutz zu umgehen:
- Bitten Sie den Administrator, den Zugriff für den Migrationszeitraum zuzulassen, z. B. durch Zulassungsauflistung der Backend-Adressen im CDN oder WAF.
- Wenn der Schutz stattdessen eine Berechtigung akzeptiert, z. B. einen Header für geheime Anfragen, geben Sie diese in die von Ihrem Workflow angebotenen Authentifizierungskontrollen ein, z. B. Authentifizierung einer geschützten Site in den Konsoleneinstellungen. Verwenden Sie eine Berechtigung im Umfang und entfernen Sie sie, wenn die Migration abgeschlossen ist.
- Wenn der Administrator einen zugänglichen Staging- oder Ursprungs-Host mit demselben Inhalt bereitstellt, verwenden Sie ihn als Quelle und zeichnen auf, von welchem Host der Inhalt stammt.
- Wenn nur die Erkennung blockiert wird, geben Sie stattdessen die Liste der zu migrierenden Seiten-URLs an.
Überprüfen Sie eine Seite, einschließlich der Bilder und anderen Assets, bevor Sie eine Katalog- oder Batch-Ausführung starten. Wiederholen Sie nach Zugriffsänderungen die fehlgeschlagenen Seiten und überprüfen Sie die Aufzeichnungen auf Herausforderungen oder Seiten mit Zugriffsverweigerung, bevor Sie den Inhalt akzeptieren.
Zulassungsliste von IP-Adressen allowlist-ip-addresses
Mit Genehmigung des Administrators der Quell-Site können Sie diese Backend-Adressen für die Quell-Extraktion ändern:
34.228.136.11254.90.51.393.224.194.242
Durch die Zulassungsauflistung wird nur Netzwerkzugriff gewährt: Die Quelle muss weiterhin über das Internet erreichbar sein, und geschützte Seiten benötigen weiterhin Authentifizierung für geschützte Sites.
Eine Änderung fehlt missing-change
Code und Inhalte werden an verschiedenen Stellen gespeichert. Überprüfen Sie daher jede Seite: den Konsolen-Arbeitsbereich, den hochgeladenen Inhalt, die Push-Verzweigung und die Vorschau der Seite. Ein Reimport überschreibt lokale Inhaltsänderungen, sodass Bearbeitungen hochgeladen oder abgestimmt werden, bevor Sie eine Seite erneut importieren. Einen Vergleich der Konsolenvorschau mit der Vorschau-Site finden Sie unter Konsolenvorschau unterscheidet sich von der Site.
Konsolenvorschau unterscheidet sich von der Site preview-differs
Die Konsolenvorschau und die Vorschau-Site rendern verschiedene Kopien des Inhalts und des Codes, wie Wissen, welches Ergebnis Sie anzeigen erklärt. Suchen Sie nach einer der folgenden Ursachen:
- Inhalt nicht hochgeladen: Seiten, die in der Konsole geändert wurden, befinden sich noch nicht in Experience Workspace. Laden Sie sie mit Synchronisieren > Push > Inhalt hoch.
- An anderer Stelle bearbeitete Inhalte: In Experience Workspace geänderte Seiten sind noch nicht im Konsolenarbeitsbereich verfügbar. Rufen Sie sie mit Sync > Pull > Content ab, wodurch lokale Bearbeitungen auf diesen Seiten überschrieben werden; Refresh lädt nur das Rendering neu.
- Anderer Code: Der Code wird nicht gepusht oder die Vorschau-URL verwendet eine andere Verzweigung. Pushen Sie den Code und öffnen Sie die Vorschau-URL der Verzweigung, die ihn enthält.
- Unterschiedliche Breite Die Konsolenvorschau füllt standardmäßig das Bedienfeld aus. Vergleichen Sie mit der gleichen Breite mithilfe des Menüs Viewport.
- Markup, das die Vorschau-Site entfernt: Edge Delivery Services speichert nur Abschnitte, Blöcke und Standardinhalte, sodass die Formatierung innerhalb des Seiten-Markups verloren geht. Bitten Sie den Agenten, es in das CSS des Projekts zu verschieben. Siehe Funktionsweise der Vorschau.
Fehler beim Schreiben von Inhalten write-errors
Code und Inhalt verwenden verschiedene Konten. Der Code wird mit Ihrer GitHub-Verbindung oder Ihrer Cloud Manager-Verbindung für andere Git-Hosts gepusht. Inhalte werden mit dem Adobe-Konto, mit dem Sie sich angemeldet haben, in Experience Workspace geschrieben. Ein Code-Push kann daher erfolgreich sein, wenn ein Inhalts-Upload fehlschlägt, oder umgekehrt.
Wenn beim Hochladen, Abrufen oder Übertragen angegeben wird, dass Ihre Dokumenterstellungssitzung abgelaufen sein könnte, melden Sie sich erneut an und versuchen Sie es erneut. Die Konsole zeigt dieselbe Meldung an, wenn die Sitzung gültig ist, Ihr Adobe-Konto jedoch keinen Schreibzugriff auf den Inhalt der Site hat. Wenn er weiterhin besteht, bitten Sie den Administrator der Site, zu bestätigen, dass Ihr Konto mit der E-Mail-Adresse und dem Unternehmen, die Sie in der Konsole verwenden, auf die Site in Experience Workspace schreiben kann. Der Zugriff auf Experience Manager in Adobe Admin Console gewährt allein keinen Schreibzugriff auf den Inhalt einer Site. Wenn in der Konsole eine Ratenbeschränkung angezeigt wird, warten Sie eine Minute und versuchen Sie es dann erneut.
Git-Verbindungsprobleme git-connection
Weitere Informationen zu den Funktionen der einzelnen GitHub-Apps finden Sie unter Von einem Repository starten.
https://{branch}--{site}--{organization}.aem.page folgt.Informationen zu widersprüchlichen Änderungen und geschützten Verzweigungen finden Sie unter Push-Code-Änderungen.
Workspace-Setup benötigt Zeit oder schlägt fehl workspace-setup
Die Vorbereitung eines Arbeitsbereichs dauert bei der ersten Anmeldung und nach einem Zurücksetzen bis zu 10 Minuten. Wenn alle Arbeitsbereiche verwendet werden, werden Sie von der Konsole darauf hingewiesen und Sie richten Ihren Arbeitsbereich ein, sobald einer verfügbar ist. Sie müssen es nicht erneut versuchen. Wenn Sie es früher benötigen, wählen Sie Support anfordern. Wenn die Einrichtung fehlschlägt, bietet die Konsole einen erneuten Versuch an. Wenn der Vorgang weiterhin fehlschlägt, verwenden Sie den Link Support anfordern auf dem Installationsbildschirm. Wenn in der Konsole festgestellt wird, dass Ihr Konto sie nicht verwenden kann, wenden Sie sich an Ihr Adobe-Accountteam. Informationen zu einem Arbeitsbereich, der Ihr Arbeitsbereich wurde angehalten finden Sie unter Öffnen der Experience Modernization Console.
Projekt scheint zu fehlen missing-workspace
Wenn Sie mehreren Adobe-Organisationen angehören, befindet sich das Projekt möglicherweise im „Konsolen-" einer anderen Organisation. Melden Sie sich ab und melden Sie sich mit demselben Konto an und wählen Sie das Profil der Organisation aus, die Sie zuvor verwendet haben. Setzen Sie Arbeitsbereich nicht zurück während Sie Nachforschungen anstellen: Ein Zurücksetzen löscht Arbeiten, die Sie nicht gepusht haben. Wenn das Projekt noch fehlt, fordern (Support anfordern mit dem Projektnamen und der Vorschau-URL an. Push-Code und hochgeladene Inhalte sind in beiden Fällen in Ihrem Git-Repository und Ihrer Inhaltsquelle sicher.
Nachricht konnte nicht gesendet werden send-failed
Nachricht konnte nicht gesendet werden. Bitte erneut versuchen. bedeutet, dass die Konsole Ihre Eingabeaufforderung nicht an den Agenten senden konnte. Die Nachricht gibt nicht die Ursache an. Dies kann Ihre Netzwerkverbindung, eine abgelaufene Anmeldung oder ein vorübergehendes Dienstproblem sein.
- Überprüfen Sie Ihre Netzwerkverbindung und senden Sie die Eingabeaufforderung erneut. Die Konsole versucht es nicht automatisch erneut.
- Wenn der Vorgang erneut fehlschlägt, kopieren Sie die Eingabeaufforderung, laden Sie die Seite neu und melden Sie sich an, wenn Sie dazu aufgefordert werden. Ihr Chat-Verlauf wird gespeichert.
- Wenn der Vorgang nach einigen Minuten immer noch fehlschlägt, verwenden Sie Support anfordern in Einstellungen, mit dem Zeitpunkt des Fehlers und Ihrem Projektnamen.
Wenn die Konsole stattdessen angibt, dass sie ausgelastet ist, lesen Sie Workspace-Setup benötigt Zeit oder schlägt fehl.
Seiten entfernen remove-pages
Durch eine Sicherung in der Konsole wird verhindert, dass der Agent Dateien im Inhaltsordner des Projekts löscht, sodass migrierte Inhalte nicht versehentlich entfernt werden. Den Agenten zum Löschen von Seiten aufzufordern, funktioniert daher nicht. Entfernen Sie sie selbst an jedem Ort, an dem sie existieren:
- Konsolenarbeitsbereich: Wählen Sie in einer Inhaltsansicht die Seite aus und verwenden Sie Löschen Seite für Seite. Dadurch wird nur die Kopie des Arbeitsbereichs der Konsole entfernt.
- Inhaltsquelle: Hochgeladene Seiten in Experience Workspace oder in der Autoreninstanz löschen. Bis dahin wird eine in der Konsole gelöschte Seite erneut in der Inhaltsansicht mit einem Cloud-Symbol angezeigt.
- Vorschau und Live-Sites: Sie die Veröffentlichung von in der Vorschau angezeigten und veröffentlichten Seiten mit der AEM Sidekick auf oder löschen Sie sie.
Wenn Seiten in den falschen Pfad importiert wurden, importieren Sie sie erneut in den richtigen Pfad, überprüfen Sie sie und löschen Sie dann die Kopien im falschen Pfad.