Debug di moduli HTML5

Questo documento include diversi scenari di risoluzione dei problemi. Per ogni scenario, vengono forniti alcuni passaggi per risolvere il problema. Segui questi passaggi e, se il problema persiste, configura il logger per ottenere e rivedere i registri per individuare eventuali errori o avvisi. Per ulteriori dettagli sulla registrazione dei moduli HTML5, vedere Generazione di registri per i moduli HTML5.

Problema: Quando si esegue il rendering del modulo, viene visualizzata la pagina di eccezione org.apache.sling.api.SlingException

Nei dettagli dell'eccezione, cercare la parola causata da.

È probabile che uno o più parametri nell’URL non siano corretti.

Controllate i seguenti parametri:

Problema: Impossibile eseguire il rendering di un modulo (viene visualizzato un messaggio di errore)

1. Verificate che i parametri specificati siano corretti. Per informazioni dettagliate sui parametri, vedere Parametri di rendering.

2. Accedete a CRX Package Manager (all'indirizzo https://<server>:<porta>/crx/packmgr/index.jsp) e verificate che i pacchetti seguenti siano installati correttamente:

   • adobe-lc-forms-content-pkg-<versione>.zip
   • adobe-lc-forms-runtime-pkg-<versione>.zip

3. Accedete alla console Web di CQ (console Felix) all'indirizzo https://<server>:<porta>/sistema/console/bundle.

   Verificate che lo stato dei seguenti bundle sia "attivo":

   • scala-lang.bundle [osgi]

   (com.adobe.livecyclescala-lang.bundle)

   • Modulo di rendering Forms XFA Adobe

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

   • Adobe XFA Forms LC Connector

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

Problema: Rendering del modulo senza stili

1. Nel browser, aprire Developer Tools. Verifica che profile.css sia disponibile.

2. Se il file profile.css non è disponibile, accedete a CRX DE all'indirizzo https://<server>:<porta>/crx/de.

3. Nella gerarchia delle cartelle a sinistra, andate a /etc/clientlibs/fd/xfaforms/. Aprite i file css.txt elencati nelle cartelle.

   • profilo
   • runtime
   • scrollnav
   • toolbar
   • xfalib

4. Verificate che i file citati in css.txt siano presenti in CRX DE lite all'indirizzo /libs/fd/xfaforms/clientlibs/xfalib/css.

   #base=css
   application.css
   dialog.css
   datepicker.css
   scribble.css
   listboxwidget.css
   

5. Se i file indicati non sono disponibili, installate di nuovo il pacchetto adobe-lc-forms-runtime-pkg-<versione>.zip.

Problema: Errore imprevisto rilevato

1. Nell'URL del modulo, aggiungere un parametro di query debugClientLibs e impostarne il valore su true (ad esempio: https://<server>:<porta>/content/xfaforms/profiles/test.html?contentRoot=<percorso>&template=<nome del file xdp>&log=1-a9-b9-c9&debugClientLibs=true)

2. Nel browser desktop come Chrome, andate a Strumenti per sviluppatori -> Console.

3. Aprire i registri per identificare il tipo di errore. Per informazioni dettagliate sui registri, vedere registri per i moduli HTML5.

4. Vai a Strumenti per sviluppatori > Console. Utilizzare la traccia dello stack per individuare il codice che causa l'errore. Eseguire il debug dell'errore per risolvere il problema.

   NOTA

   Se si verifica un errore di script, verificare se lo stesso problema si verifica anche durante la rappresentazione PDF del modulo. In caso affermativo, la logica di script del modulo presenta un problema.

Problema: Impossibile inviare il modulo

1. Verificate di disporre dei diritti di accesso al server AEM e di essere connessi al server.
2. Verificate che il parametro submitUrl sia corretto.
3. Abilitare i registri lato client come indicato in Registri per i moduli HTML5 utilizzando l'opzione di debug come 1-a5-b5-c5. Quindi, eseguite il rendering del modulo e fate clic su Invia. Aprite la console di debug del browser e verificate se si è verificato un errore.
4. Individuare i registri del server come indicato in Registri per i moduli HTML5. Verificare se si è verificato un errore nei registri del server durante l'invio.

Problema: I messaggi di errore localizzati non vengono visualizzati

1. Eseguire il rendering del modulo con il parametro di query aggiuntivo debugClientLibs=true nel browser desktop, quindi passare a Strumenti per sviluppatori -> Risorse e verificare il file I18N.css.

2. Se il file non è disponibile, accedete a CRX DE all'indirizzo https://<server>:<porta>/crx/de.

3. Nella gerarchia delle cartelle a sinistra, andate a /libs/fd/xfaforms/clientlibs/I18N e verificate che siano presenti i file e le cartelle seguenti:

   • Namespace.js
   • LogMessages.js
   • Cartelle per le lingue

4. Se uno dei file o delle cartelle di cui sopra non esiste, installate di nuovo il pacchetto adobe-lc-forms-runtime-pkg-<versione>.zip.

5. Individuate la cartella che ha lo stesso nome delle impostazioni internazionali e verificarne il contenuto. La cartella deve contenere i file seguenti:

   • I18N.js
   • js.txt

6. Controllate il contenuto di js.txt e accertatevi che contenga le voci seguenti.

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

Problema: Immagine che non viene visualizzata

1. Accertatevi che l’URL dell’immagine sia corretto.

2. Verificate se il browser supporta questo tipo di immagine.

3. Nei dettagli dell'eccezione, cercare la parola causata da.

   È probabile che uno o più parametri nell’URL non siano corretti.

   Controllate i seguenti parametri:
   Testo del passaggio

1. Nel browser desktop, accedete a Strumenti per sviluppatori -> Risorse.

   Se l'immagine viene visualizzata, selezionate Cornici a sinistra.