Debug dei moduli di 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 gli errori/avvisi. Per ulteriori dettagli sulla registrazione dei moduli di HTML5, consulta Generazione di registri per i moduli HTML5.

Problema: durante il rendering del modulo, viene visualizzata la pagina dell’eccezione org.apache.sling.api.SlingException

Nei dettagli dell'eccezione, cercare word causato da.

Il motivo probabile è che uno o più parametri nell’URL non sono corretti.

Verifica i seguenti parametri:

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

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

2. Accedi a Gestione pacchetti CRX (all’indirizzo https://)<server>:<port>/crx/packmgr/index.jsp) e verificare che i seguenti pacchetti siano installati correttamente:

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

3. Accedi alla console web CQ (console Felix) all’indirizzo https://<server>:<port>/system/console/bundle.

   Assicurati che lo stato dei seguenti bundle sia "active":

   • scala-lang.bundle [osgi]

   (com.adobe.livecyclescala-lang.bundle)

   • Adobe XFA Forms Renderer

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

   • Connettore LC Forms XFA Adobe

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

Problema: rendering del modulo senza stili

1. Nel browser, aprire Strumenti per sviluppatori. Assicurati che profile.css sia disponibile.

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

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

   • profilo
   • runtime
   • scrollnav
   • barra strumenti
   • xfalib

4. Verifica che i file menzionati all’interno del file css.txt siano presenti in CRX DE lite in /libs/fd/xfaforms/clientlibs/xfalib/css.

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

5. Se i file menzionati non sono disponibili, installa adobe-lc-forms-runtime-pkg<version>.zip.

Problema: si è verificato un errore imprevisto

1. Nell’URL del modulo, aggiungi un parametro di query debugClientLibs e impostane il valore su true (ad esempio: https://<server>:<port>/content/xfaforms/profiles/test.html?contentRoot=<some path="">&template=<name of="" xdp="" file="">&log=1-a9-b9-c9&debugClientLibs=true)

2. Nel browser desktop come chrome, passa a Strumenti di sviluppo -> Console.

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

4. Passa a Strumenti per sviluppatori > Console. Utilizza la traccia dello stack per individuare il codice che causa l’errore. Debug dell’errore per risolvere il problema.

   NOTA

   Se si tratta di un errore di script, verificare se lo stesso problema si verifica durante il rendering PDF del modulo. In caso affermativo, si verifica un problema nella logica di scripting del modulo.

Problema: impossibile inviare il modulo

1. Verificare di disporre dei diritti di accesso al server AEM e di essere connessi al server.
2. Verifica che il parametro submitUrl sia corretto.
3. Abilita i registri lato client come indicato in Registri per i moduli HTML5 utilizzo dell’opzione debug come 1-a5-b5-c5. Quindi esegui il rendering del modulo e fai clic su invia. Apri la console di debug del browser e verifica la presenza di un errore.
4. Individua i registri del server come indicato in Registri per i moduli HTML5. Controlla se si è verificato un errore nei registri del server durante l’invio.

Problema: i messaggi di errore localizzati non vengono visualizzati

1. Esegui il rendering del modulo con un parametro di query aggiuntivo debugClientLibs=true nel browser desktop, quindi vai a Strumenti di sviluppo -> Risorse e controlla il file I18N.css.

2. Se il file non è disponibile, accedi a CRX DE da https://<server>:<port>/crx/de

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

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

4. Se uno dei file o delle cartelle sopra indicati non esiste, installare adobe-lc-forms-runtime-pkg-<version>.zip nuovo pacchetto.

5. Passare alla cartella con lo stesso nome della lingua e verificarne il contenuto. La cartella deve contenere i seguenti file:

   • I18N.js
   • js.txt

6. Controlla il contenuto di js.txt e accertati che contenga le seguenti voci.

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

Problema: immagine non visualizzata

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

2. Verifica se il browser in uso supporta questo tipo di immagine.

3. Nei dettagli dell'eccezione, cercare word causato da.

   Il motivo probabile è che uno o più parametri nell’URL non sono corretti.

   Verifica i seguenti parametri: Testo del passaggio

1. Nel browser desktop, vai a Strumenti di sviluppo -> Risorse.

   Se l'immagine è visualizzata, selezionare la casella di controllo a sinistra in Frame.