Debugging von HTML5-Formularen debugging-html-forms

CAUTION
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“. problem-when-rendering-the-form-i-see-org-apache-sling-api-slingexception-exception-page

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) problem-unable-to-render-a-form-an-error-message-is-displayed

  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 problem-form-renders-without-styles

  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.

    code language-css
    #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 problem-unexpected-error-encountered

  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.

    note note
    NOTE
    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 problem-unable-to-submit-the-form

  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 problem-localized-error-messages-do-not-display

  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.

    code language-none
    ../Namespace.js
    I18N.js
    ../LogMessages.js
    

Problem: Bild wird nicht angezeigt problem-image-not-showing-up

  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.

recommendation-more-help
a6ebf046-2b8b-4543-bd46-42a0d77792da