Handbuch zur alten Benutzeroberfläche - weitere Informationen

Allgemeine Fehlerbehebung

Letzte Aktualisierung: 5. Mai 2025
  • Themen:

Erstellt für:

  • Benutzende

Beim Arbeiten mit AEM Guides können Fehler auftreten, während Sie Ihr Dokument veröffentlichen oder öffnen. Solche Fehler können in der DITA-Zuordnung, im Thema oder im AEM Guides-Prozess selbst auftreten. Dieser Abschnitt enthält Informationen zum Zugriff auf und zum Analysieren von Informationen in der Protokolldatei für die Ausgabegenerierung. Wenn Ihr DITA-Thema zu groß ist, wird möglicherweise der JSP-Kompilierungsfehler angezeigt. Dieser Abschnitt enthält auch Informationen zum Beheben des JSP-Kompilierungsfehlers.

Protokolldatei anzeigen und überprüfen

Führen Sie die folgenden Schritte aus, um die Protokolldatei für die Ausgabegenerierung anzuzeigen und zu überprüfen:

  1. Nachdem Sie die Generierung der Ausgabe initiiert haben, klicken Sie in der DITA Zuordnungskonsole auf Ausgaben“.

    Die Spalte Allgemein der Generierte Ausgaben zeigt die Symbole, die einen visuellen Hinweis auf den Erfolg oder Misserfolg der Ausgabegenerierung geben.

    Im obigen Screenshot zeigen die Symbole 1 und 3 eine fehlgeschlagene Ausgabegenerierung. Das zweite Symbol zeigt eine erfolgreiche Ausgabegenerierung an, jedoch mit Meldungen. Die letzte Variante ist eine erfolgreiche Ausgabegenerierung ohne Meldung.

  2. Klicken Sie auf den Link in der Spalte Generiert unter nachdem der Vorgang abgeschlossen ist.

    Die Protokolldatei wird auf einer neuen Registerkarte geöffnet.

  3. Verwenden Sie die folgenden Filter, um den Text in der Protokolldatei hervorzuheben:

    • Schwerwiegend: Markiert schwerwiegende Fehler in der Protokolldatei in rosa.
    • Fehler: Markiert die Fehler in der Protokolldatei in orangefarbener Farbe.
    • Warnung: Markiert die Warnungen in der Protokolldatei in violetter Farbe.
    • Info: Hebt die Informationsmeldungen in der Protokolldatei mit blauer Farbe hervor.
    • Ausnahme: markiert die Ausnahmen in der Protokolldatei mit gelber Farbe.

  4. Verwenden Sie die Navigationsschaltflächen nach oben und unten, um zum hervorgehobenen Text in der Protokolldatei zu springen.

    Alternativ können Sie durch die Protokolldatei scrollen und die Meldungen überprüfen.

Kopieren und überprüfen Sie die Protokolldatei in einem Texteditor

Führen Sie die folgenden Schritte aus, um die Protokolldatei für die Ausgabegenerierung in einen Texteditor zu kopieren und zu überprüfen:

  1. Nachdem Sie die Generierung der Ausgabe initiiert haben, klicken Sie in der DITA Zuordnungskonsole auf Ausgaben“.

  2. Klicken Sie auf den Link in der Spalte Generiert unter nachdem der Vorgang abgeschlossen ist.

    Die Protokolldatei wird auf einer neuen Registerkarte geöffnet.

  3. Klicken Sie auf Schaltfläche Protokoll kopieren“. Die Protokolldatei wird in die Zwischenablage kopiert.

  4. Öffnen Sie einen Texteditor und fügen Sie die Protokolldatei in den Editor ein.

  5. Scrollen Sie durch die Protokolldatei und suchen Sie nach Meldungen.

    Anhand der folgenden Informationen können Sie feststellen, ob im DITA-Datei- oder AEM Guides-Prozess ein Fehler vorliegt:

    • DITA-Zuordnungsdatei-bezogener Fehler: Falls in der DITA-Zuordnungsdatei oder einer anderen in der DITA-Zuordnung enthaltenen Datei ein Fehler gefunden wird, enthält die Protokolldatei die Zeichenfolge „BUILD FAILED“ (BUILD FEHLGESCHLAGEN). Sie können die in der Protokolldatei angegebenen Informationen überprüfen, um die fehlerhafte Datei zu finden und das Problem zu beheben.

    Im folgenden Beispiel-Protokolldatei-Snippet wird die BUILD FAILED-Meldung zusammen mit dem Grund für den Fehler angezeigt.

    • AEM Guides-bezogener Fehler: Die andere Fehlerart, die Sie in der Protokolldatei identifizieren können, ist mit dem AEM Guides-Prozess selbst verbunden. In diesem Fall wird die DITA-Zuordnungsdatei erfolgreich geparst, aber der Ausgabegenerierungsprozess schlägt aufgrund eines internen Fehlers in AEM Guides fehl. Bei Fehlern dieser Art müssen Sie Hilfe vom technischen Support-Team anfordern.

    Im folgenden Beispiel-Protokolldatei-Snippet wird die BUILD SUCCESSFUL angezeigt, gefolgt von einem anderen technischen Fehler.