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

Problema: Quando esegui il rendering del modulo, visualizzo la pagina di eccezione org.apache.sling.api.SlingException

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

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

Verifica i seguenti parametri:

Parametro Descrizione
template Il nome del file del modello
contentRoot Percorso in cui risiedono il modello e le risorse associate
dataRef Percorso assoluto del file di dati unito al modello.
Nota: Il percorso definisce il percorso assoluto del file di dati.
data Byte di dati codificati UTF-8 uniti al modello.

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

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

  2. Accedi a CRX Package Manager (all'indirizzo https://<server>:<port>/crx/packmgr/index.jsp) e controlla se i seguenti pacchetti sono correttamente installati:

    • 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/bundles.

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

    • scala-lang.bundle [osgi]

    (com.adobe.livecyclescala-lang.bundle)

    • Adobe XFA Forms Renderer

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

    • Connettore Adobe XFA Forms LC

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

Problema: Rendering di moduli senza stili

  1. Nel browser, apri Strumenti di sviluppo. 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, vai a /etc/clientlibs/fd/xfaforms/. Apri i file css.txt elencati nelle cartelle.

    • profilo
    • runtime
    • scorrimento
    • toolbar
    • xfalib
  4. Verifica che i file menzionati all'interno di 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 di nuovo il pacchetto adobe-lc-forms-runtime-pkg-<version>.zip.

Problema: Errore imprevisto

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

  2. Nel browser desktop come chrome, vai a Strumenti per sviluppatori -> Console.

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

  4. Vai a Strumenti per sviluppatori -> Console. Utilizza la traccia dello stack per individuare il codice che sta causando l’errore. Esegui il debug dell'errore per risolvere il problema.

    NOTA

    Se si tratta di un errore di script, verificare se lo stesso problema si verifica anche durante il rendering PDF del modulo. Se sì, si verifica un problema nella logica di script del modulo.

Problema: Impossibile inviare il modulo

  1. Assicurati di disporre dei diritti per accedere al server AEM e di essere connesso al server.
  2. Verifica che il parametro submitUrl sia corretto.
  3. Abilita i registri lato client come indicato in Registri per i moduli HTML5 utilizzando l’opzione di 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 controlla se si verifica un errore.
  4. Individua i registri del server come indicato in Registri per i moduli HTML5. Controlla se si è verificato un errore nei log del server durante l'invio.

Problema: I messaggi di errore localizzati non vengono visualizzati

  1. Esegui il rendering del modulo con il 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 all'indirizzo https://<server>:<port>/crx/de.

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

    • Namespace.js
    • LogMessages.js
    • Cartelle per le lingue
  4. Se uno dei file o delle cartelle di cui sopra non esiste, installa di nuovo il pacchetto adobe-lc-forms-runtime-pkg-<version>.zip.

  5. Passa alla cartella che ha lo stesso nome delle impostazioni internazionali e ne controlla il contenuto. La cartella deve contenere i file seguenti:

    • I18N.js
    • js.txt
  6. Controlla il contenuto di js.txt e assicurati che contenga le seguenti voci.

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

Problema: Immagine che non viene visualizzata

  1. Assicurati che l'URL dell'immagine sia corretto.

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

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

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

    Verifica i seguenti parametri:
    Testo del passaggio

Parametro Descrizione
template Il nome del file del modello
contentRoot Percorso in cui risiedono il modello e le risorse associate
dataRef Percorso assoluto del file di dati unito al modello.
Nota: Il percorso definisce il percorso assoluto del file di dati.
dati Byte di dati codificati UTF-8 uniti al modello.
  1. Nel browser desktop, accedi a Strumenti per sviluppatori -> Risorse.

    Se l'immagine viene visualizzata, seleziona il lato sinistro in Frame.

In questa pagina