Debug dei moduli di HTML5 debugging-html-forms

Last update: Thu Dec 21 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

Argomenti:
HTML5 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 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 problem-when-rendering-the-form-i-see-org-apache-sling-api-slingexception-exception-page

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:

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 definisce 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

Verificare che i parametri specificati siano corretti. Per informazioni dettagliate sui parametri, consulta Parametri di rendering.
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
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 problem-form-renders-without-styles

Nel browser, aprire Strumenti per sviluppatori. Assicurati che profile.css sia disponibile.
Se il file profile.css non è disponibile, accedi a CRX DE all’indirizzo https://<server>:<port>/crx/de
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

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`

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

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

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)
Nel browser desktop come chrome, passa a Strumenti di sviluppo > Console.
Apri i registri per identificare il tipo di errore. Per informazioni dettagliate sui registri, consulta registri per moduli HTML5.

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

Verificare di disporre dei diritti di accesso al server AEM e di essere connessi al server.
Verifica che il parametro submitUrl sia corretto.
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.
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

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.
Se il file non è disponibile, accedi a CRX DE da https://<server>:<port>/crx/de
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
Se uno dei file o delle cartelle sopra indicati non esiste, installare adobe-lc-forms-runtime-pkg-<version>.zip nuovo pacchetto.
Passare alla cartella con lo stesso nome della lingua e verificarne il contenuto. La cartella deve contenere i seguenti file:
- I18N.js
- js.txt

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

Verifica che l’URL dell’immagine sia corretto.
Verifica se il browser in uso supporta questo tipo di immagine.
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