Débogage des formulaires HTML5

Ce document comprend plusieurs scénarios de résolution des problèmes. Pour chaque scénario, certaines étapes sont fournies pour résoudre le problème. Procédez comme suit et, si le problème persiste, configurez le journal pour obtenir et parcourir les journaux et rechercher les erreurs/avertissements. Pour plus d’informations sur la journalisation des formulaires HTML5, voir Génération de journaux pour les formulaires HTML5.

Problème : lorsque vous effectuez le rendu d’un formulaire, la page d’exception org.apache.sling.api.SlingException s'affiche

Dans les détails de l’exception, recherchez le mot provoqué par.

Cela est probablement dû au fait qu’un ou plusieurs paramètres de l’URL sont incorrects.

Vérifiez les paramètres suivants :

Problème : impossible d'effectuer le rendu d'un formulaire (un message d’erreur s’affiche)

1. Assurez-vous que les paramètres indiqués sont corrects. Pour plus d’informations sur les paramètres, voir Paramètres de rendu.

2. Connectez-vous au gestionnaire de modules CRX (à l’adresse https://<server>:<port>/crx/packmgr/index.jsp) et vérifiez que les modules suivants sont correctement installés :

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

3. Connectez-vous à la console web CQ (console Felix) à l’adresse https://<serveur>:<port>/system/console/bundles.

   Assurez-vous que l’état des bundles suivants est « actif » :

   • scala-lang.bundle [osgi]

   (com.adobe.livecyclescala-lang.bundle)

   • Adobe du moteur de rendu XFA Forms

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

   • Adobe XFA Forms LC Connector

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

Problème : le rendu des formulaires ne prend pas les styles en compte

1. Dans votre navigateur, ouvrez Outils de développement. Vérifiez que profile.css est disponible.

2. Si le fichier profile.css n’est pas disponible, connectez-vous à CRX DE à l’adresse https://<server>:<port>/crx/de.

3. Dans la hiérarchie de dossiers sur la gauche, accédez à /etc/clientlibs/fd/xfaforms/. Ouvrez les fichiers css.txt répertoriés dans les fichiers.

   • son profil
   • runtime
   • scrollnav
   • toolbar
   • xfalib

4. Vérifiez que les fichiers mentionnés dans le fichier css.txt sont présents dans CRX DE Lite à l’adresse /libs/fd/xfaforms/clientlibs/xfalib/css.

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

5. Si les fichiers mentionnés ne sont pas disponibles, réinstallez le package adobe-lc-forms-runtime-pkg-<version>.zip.

Problème : erreur inattendue rencontrée

1. Dans l’URL du formulaire, ajoutez un paramètre de requête debugClientLibs et définissez sa valeur sur true (par exemple : https://<serveur>:<port>/content/xfaforms/profiles/test.html?contentRoot=<some path>&template=<name of xdp file>&log=1-a9-b9-c9&debugClientLibs=true)

2. Dans le navigateur de bureau, comme Chrome, accédez à Outils de développement -> Console.

3. Ouvrez les journaux pour identifier le type d’erreur. Pour plus d’informations sur les journaux, voir journaux des formulaires HTML5.

4. Accédez à Outils de développement -> Console. Utilisez la trace de pile pour localiser le code qui déclenche l’erreur. Corrigez l’erreur pour résoudre le problème.

   REMARQUE

   en cas d’échec du script, vérifiez si le même problème se produit également au cours du rendu PDF du formulaire. Si oui, la logique de script du formulaire présente un problème.

Problème : impossible d’envoyer le formulaire

1. Assurez-vous de disposer des droits d’accès au serveur AEM et d’être connecté au serveur.
2. Vérifiez que le paramètre submitUrl est correct.
3. Activez les journaux côté client comme mentionné à la section Journaux pour les formulaires HTML5 à l’aide de l’option de débogage comme 1-a5-b5-c5. Puis lancez le rendu du formulaire et cliquez sur envoyer. Ouvrez la console de dépannage du navigateur et vérifiez s’il se produit une erreur.
4. Recherchez les journaux du serveur comme expliqué dans la section Journaux des formulaires HTML5. Vérifiez si une erreur s’est produite dans les journaux du serveur pendant l’envoi.

Problème : les messages d’erreur localisés ne s’affichent pas

1. Effectuez le rendu du formulaire avec un paramètre de requête supplémentaire debugClientLibs=true dans le navigateur de bureau, puis accédez à Outils de développement -> Ressources et vérifiez le fichier I18N.css.

2. Si le fichier n’est pas disponible, connectez-vous à CRX DE à l’adresse https://<server>:<port>/crx/de.

3. Dans la hiérarchie des dossiers sur la gauche, accédez à /libs/fd/xfaforms/clientlibs/I18N et assurez-vous que les fichiers et dossiers suivants existent :

   • Namespace.js
   • LogMessages.js
   • Dossiers de langues

4. Si l’un des fichiers ou dossiers ci-dessus n’existe pas, réinstallez le package adobe-lc-forms-runtime-pkg-<version>.zip.

5. Naviguez jusqu’au dossier portant le même nom que le nom du jeu de paramètres régionaux et vérifiez son contenu. Le dossier doit contenir les fichiers suivants :

   • I18N.js
   • js.txt

6. Vérifiez le contenu de js.txt et assurez-vous qu’il possède les entrées suivantes.

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

Problème : l’image ne s’affiche pas

1. Assurez-vous que l’URL de l’image est correcte.

2. Vérifiez si votre navigateur prend en charge ce type d’image.

3. Dans les détails de l’exception, recherchez le mot provoqué par.

   Cela est probablement dû au fait qu’un ou plusieurs paramètres de l’URL sont incorrects.

   Vérifiez les paramètres suivants :
   Texte de l’étape

1. Dans le navigateur de bureau, accédez à Outils de développement -> Ressources.

   Vérifiez sur le côté gauche, dans Images, que l’image s’affiche.