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 in caso di errori/avvisi. Per ulteriori dettagli sulla registrazione dei moduli in HTML5, consulta 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 causato 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, vedi 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 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/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 del modulo senza stili

  1. Nel browser, apri Strumenti per gli 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, 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 adobe-lc-forms-runtime-pkg-<version>pacchetto zip di nuovo.

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=<name of="" xdp="" file="">&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 di HTML5 forms.

  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 del modulo in PDF. 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 utilizzo dell'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. Eseguire 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 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 il adobe-lc-forms-runtime-pkg-<version>.zip di nuovo.

  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 non 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 causato 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.
data 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