Debug dei moduli di HTML5 debugging-html-forms

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 HTML5, vedere Generazione dei registri per i moduli HTML5.

Problema: durante il rendering del modulo, viene visualizzata la pagina dell’eccezione org.apache.sling.api.SlingException problem-when-rendering-the-form-i-see-org-apache-sling-api-slingexception-exception-page

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

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

Verifica i seguenti parametri:

Parametro
Descrizione
Modello
Nome 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 assoluto del file di dati.
dati
Byte di dati con codifica UTF-8 uniti al modello.

Problema: impossibile eseguire il rendering di un modulo (viene visualizzato un messaggio di errore) problem-unable-to-render-form

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

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

    • adobe-lc-forms-content-pkg-<versione>.zip
    • adobe-lc-forms-runtime-pkg-<versione>.zip
  3. Accedi alla console web CQ (console Felix) all’indirizzo https://<server>:<porta>/system/console/bundles.

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

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

  2. Se il file profile.css non è disponibile, accedere 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.

    code language-css
    #base=css
    application.css
    dialog.css
    datepicker.css
    scribble.css
    listboxwidget.css
    
  5. Se i file menzionati non sono disponibili, installa nuovamente il pacchetto adobe-lc-forms-runtime-pkg-<versione>.zip.

Problema: si è verificato un errore imprevisto problem-unexpected-error-encountered

  1. Nell’URL del modulo, aggiungi un parametro di query debugClientLibs e impostane 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, 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. Vai a Strumenti di sviluppo > Console. Utilizza la traccia dello stack per individuare il codice che causa l’errore. Debug dell’errore per risolvere il problema.

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

  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 utilizzando l'opzione di debug 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 problem-localized-error-messages-do-not-display

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

  2. Se il file non è disponibile, accedere a CRX DE all'indirizzo 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 di cui sopra non esiste, installa di nuovo il pacchetto adobe-lc-forms-runtime-pkg-<versione>.zip.

  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.

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

Problema: immagine non visualizzata problem-image-not-showing-up

  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 la parola causata da.

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

    Verifica i seguenti parametri:
    Testo del passaggio

Parametro
Descrizione
Modello
Nome 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 assoluto del file di dati.
dati
Byte di dati con codifica UTF-8 uniti al modello.
  1. Nel browser desktop, vai a Strumenti di sviluppo > Risorse.

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

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2