Debugging von HTML5-Formularen

VORSICHT

AEM 6.4 hat das Ende der erweiterten Unterstützung erreicht und diese Dokumentation wird nicht mehr aktualisiert. Weitere Informationen finden Sie in unserer technische Unterstützung. Unterstützte Versionen suchen here.

Dieses Dokument enthält verschiedene Fehlerbehebungsszenarien. Für jedes Szenario werden einige Schritte bereitgestellt, um das Problem zu beheben. Führen Sie diese Schritte aus und, falls das Problem weiterhin besteht, konfigurieren Sie den Logger, um Protokolle auf Fehler/Warnungen abzurufen und zu überprüfen. Weitere Informationen zu Protokollen für HTML5 finden Sie unter Generieren von Protokollen für HTML5-Formulare.

Problem: Wenn ich das Formular rendere, erscheint die Ausnahmeseite „org.apache.sling.api.SlingException“.

Suchen Sie in den Ausnahmedetails nach dem Begriff „caused by“.

Die wahrscheinliche Ursache ist, dass mindestens ein Parameter in der URL falsch ist.

Überprüfen Sie die folgenden Parameter:

Parameter Beschreibung
template Dateiname der Vorlage
contentRoot Der Pfad, in dem sich Vorlage und zugehörige Ressourcen befinden
dataRef Absoluter Pfad der Datendatei, die mit der Vorlage zusammengeführt werden soll.
Hinweis: Der Pfad definiert den absoluten Pfad der Datendatei.
data UTF-8-kodierte Datenbytes, die mit der Vorlage zusammengeführt werden sollen.

Problem: Formular kann nicht gerendert werden (eine Fehlermeldung wird angezeigt)

  1. Stellen Sie sicher, dass die angegebenen Parameter korrekt sind. Detaillierte Informationen zu Parametern finden Sie unter Render-Parameter.

  2. Melden Sie sich bei CRX Package Manager an (unter http://<server>:<port>/crx/packmgr/index.jsp) und überprüfen Sie, ob die folgenden Pakete ordnungsgemäß installiert sind:

    • adobe-lc-forms-content-pkg-<version>.zip
    • adobe-lc-forms-runtime-pkg-<version>.zip
  3. Melden Sie sich bei CQ Web Console (Felix Console) an unter http://<server>:<port>/system/console/bundles.

    Stellen Sie sicher, dass der Status der folgenden Pakete „active“ lautet:

    • scala-lang.bundle [osgi]

    (com.adobe.livecyclescala-lang.bundle)

    • Adobe XFA Forms Renderer

    (com.adobe.livecycle.adobe-lc-forms-core)

    • Adobe XFA Forms LC Connector

    (com.adobe.livecycle.adobe-lc-forms-lc-connector)

Problem: Formular wird ohne Stile gerendert

  1. Öffnen Sie im Browser Developer Tools. Vergewissern Sie sich, dass „profile.css“ verfügbar ist.

  2. Wenn die Datei „profile.css“ nicht verfügbar ist, melden Sie sich unter http://<Server>:<Port>/crx/de bei CRX DE an.

  3. Navigieren Sie in der Ordnerhierarchie auf der linken Seite zu /etc/clientlibs/fd/xfaforms/. Öffnen Sie die in den Ordnern aufgelisteten css.txt-Dateien.

    • Profil
    • runtime
    • scrollnav
    • toolbar
    • xfalib
  4. Vergewissern Sie sich, dass die in der Datei css.txt erwähnten Dateien in CRX DE Lite unter /libs/fd/xfaforms/clientlibs/xfalib/css vorhanden sind.

    #base=css
    application.css
    dialog.css
    datepicker.css
    scribble.css
    listboxwidget.css
    
  5. Wenn die genannten Dateien nicht verfügbar sind, installieren Sie adobe-lc-forms-runtime-pkg-<version>.zip-Paket erneut.

Problem: Unerwarteter Fehler gefunden

  1. Fügen Sie in die Formular-URL den Abfrageparameter „debugClientLibs“ ein und legen Sie seinen Wert auf „true“ fest (z. B. http://<Server>:<Port>/content/xfaforms/profiles/test.html?contentRoot=<eine Pfadangabe>&template=<Name der xdp-Datei>&log=1-a9-b9-c9&debugClientLibs=true)

  2. Navigieren Sie im Desktop-Browser wie Chrome zu "Developer Tools"-> "Console".

  3. Öffnen Sie die Protokolle, um den Fehlertyp zu identifizieren. Detaillierte Informationen zu Protokollen finden Sie unter Protokolle für HTML5-Formulare.

  4. Navigieren Sie zu Entwicklertools > Konsole . Verwenden Sie die Stapelablaufverfolgung, um den Code zu finden, der den Fehler verursacht. Debuggen Sie den Fehler, um das Problem zu beheben.

    HINWEIS

    Wenn Skriptfehler vorliegt, überprüfen Sie, ob das gleiche Problem auch bei der PDF-Wiedergabe des Formulars auftritt. Falls ja, besteht ein Problem mit der Skriptlogik des Formulars.

Problem: Formular kann nicht gesendet werden

  1. Stellen Sie sicher, dass Sie über Zugriffsberechtigungen für den AEM-Server verfügen und mit dem Server verbunden sind.
  2. Überprüfen Sie, ob der Parameter „submitUrl“ korrekt ist.
  3. Aktivieren Sie clientseitige Protokolle, wie unter Protokolle für HTML5-Forms beschrieben, und verwenden Sie als Debug-Option 1-a5-b5-c5. Rendern Sie das Formular erneut und klicken Sie auf „Senden“. Öffnen Sie die Debug-Console im Browser und prüfen Sie, ob Fehler vorliegen.
  4. Suchen Sie die Serverprotokolle, die erwähnt werden unter Protokolle für die HTML5-Formulare. Überprüfen Sie, ob in den Serverprotokollen während der Übermittlung ein Fehler aufgetreten ist.

Problem: Lokalisierte Fehlermeldungen werden nicht angezeigt

  1. Formular mit zusätzlichem Abfrageparameter rendern debugClientLibs=true im Desktop-Browser, navigieren Sie zu "Developer Tools"-> "Ressourcen"und suchen Sie nach der Datei "I18N.css".

  2. Wenn die Datei nicht verfügbar ist, melden Sie sich unter http://<server>:<port>/crx/de bei CRX DE an.

  3. Navigieren Sie in der Ordnerhierarchie auf der linken Seite zu /libs/fd/xfaforms/clientlibs/I18N und stellen Sie sicher, dass die folgenden Dateien und Ordner vorhanden sind:

    • Namespace.js
    • LogMessages.js
    • Ordner für Sprachen
  4. Wenn eine der oben genannten Dateien oder Ordner nicht vorhanden ist, installieren Sie die adobe-lc-forms-runtime-pkg-<version>.zip Paket erneut.

  5. Navigieren Sie zu dem Ordner, der denselben Namen wie das Gebietsschema hat, und überprüfen Sie den Inhalt. Der Ordner muss die folgenden Dateien enthalten:

    • I18N.js
    • js.txt
  6. Überprüfen Sie den Inhalt von js.txt und stellen Sie sicher, dass die folgenden Einträge vorhanden sind.

    ../Namespace.js
    I18N.js
    ../LogMessages.js
    

Problem: Bild wird nicht angezeigt

  1. Stellen Sie sicher, dass die Bild-URL korrekt ist.

  2. Überprüfen Sie, ob der Bildtyp von Ihrem Browser unterstützt wird.

  3. Suchen Sie in den Ausnahmedetails nach dem Begriff „caused by“.

    Die wahrscheinliche Ursache ist, dass mindestens ein Parameter in der URL falsch ist.

    Überprüfen Sie die folgenden Parameter:

Schritttext

Parameter Beschreibung
template Dateiname der Vorlage
contentRoot Der Pfad, in dem sich Vorlage und zugehörige Ressourcen befinden
dataRef Absoluter Pfad der Datendatei, die mit der Vorlage zusammengeführt werden soll.
Hinweis: Der Pfad definiert den absoluten Pfad der Datendatei.
data UTF-8-kodierte Datenbytes, die mit der Vorlage zusammengeführt werden sollen.
  1. Navigieren Sie im Desktop-Browser zu "Entwicklertools"-> "Ressourcen".

    Überprüfen Sie auf der linken Seite in Frames , ob dieses Bild angezeigt wird.

Auf dieser Seite