Débogage des formulaires HTML5
- S'applique à :
- Experience Manager 6.5
Créé pour :
- Administration
- Utilisateur ou utilisatrice
- Développeur
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 l’enregistreur 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 informations des exceptions, recherchez les mots causé par.
Cela est probablement dû au fait qu’un ou plusieurs paramètres de l’URL sont incorrects.
Vérifiez les paramètres suivants :
| Paramètre | Description |
| template | Nom de fichier du modèle |
| contentRoot | Chemin d’accès à l’emplacement où le modèle et les ressources connexes résident. |
| dataRef | Chemin d’accès absolu au fichier de données fusionné avec le modèle. Remarque : le chemin définit le chemin d’accès absolu au fichier de données. |
| data | Octets de données codés au format UTF-8 fusionnés avec le modèle. |
Problème : impossible d’effectuer le rendu d’un formulaire (un message d’erreur s’affiche).
-
Assurez-vous que les paramètres indiqués sont corrects. Pour plus d’informations sur les paramètres, consultez Paramètres de rendu.
-
Connectez vous au gestionnaire de modules CRX (à l’adresse https://<server>:<port>/crx/packmgr/index.jsp) et vérifiez que les packages suivants sont correctement installés :
- adobe-lc-forms-content-pkg-<version>.zip
- adobe-lc-forms-runtime-pkg-<version>.zip
-
Connectez-vous à CQ Web Console (Console Felix) à l’adresse https://<server>:<port>/system/console/bundles.
Assurez-vous que l’état des bundles suivants est « actif » :
- scala-lang.bundle [osgi]
(com.adobe.livecyclescala-lang.bundle)
- Adobe XFA Forms Renderer
(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
-
Dans votre navigateur, ouvrez les Outils de développement. Assurez-vous que profile.css est disponible.
-
Si le fichier profile.css n’est pas disponible, connectez-vous à CRX DE à l’adresse https://<server>:<port>/crx/de.
-
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 dossiers.
- son profil
- runtime
- scrollnav
- toolbar
- xfalib
-
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 -
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
-
Dans l’URL du formulaire, ajoutez un paramètre de demande debugClientLibs et définissez sa valeur sur true (par exemple : https://<server>:<port>/content/xfaforms/profiles/test.html?contentRoot=<some path>&template=<name of xdp file>&log=1-a9-b9-c9&debugClientLibs=true).
-
Dans le navigateur de bureau tel que Chrome, accédez à Outils de développement > Console.
-
Ouvrez les journaux pour identifier le type d’erreur. Pour plus d’informations sur les journaux, consultez journaux des formulaires HTML5.
-
Accédez à Outils de développement > Console. Utilisez la trace de la pile pour localiser le code qui déclenche l’erreur. Déboguez l’erreur pour résoudre le problème.
NOTEEn cas d’échec de script, vérifiez si le même problème se produit également lors du rendu du PDF du formulaire. Si oui, alors il y a un problème dans la logique de script du formulaire.
Problème : impossible d’envoyer le formulaire
- Assurez-vous de disposer des droits d’accès au serveur AEM et d’être connecté au serveur.
- Vérifiez que le paramètre submitUrl est correct.
- Activez les journaux côté client comme mentionné dans Journaux des 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.
- Recherchez les journaux du serveur comme indiqué dans la section Journaux des formulaires HTML5. Vérifiez si une erreur s’est produite dans les journaux du serveur lors de l’envoi.
Problème : les messages d’erreur localisés ne s’affichent pas
-
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 recherchez le fichier I18N.css.
-
Si le fichier n’est pas disponible, connectez-vous à CRX DE à l’adresse https://<server>:<port>/crx/de.
-
Dans la hiérarchie de 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
-
Si l’un des fichiers ou dossiers ci-dessus n’existe pas, réinstallez le package adobe-lc-forms-runtime-pkg-<version>.zip.
-
Accédez au dossier portant le même nom que le nom du paramètre régional et vérifiez son contenu. Le dossier doit contenir les fichiers suivants :
- I18N.js
- js.txt
-
Vérifiez le contenu de js.txt et assurez-vous qu’il comporte les entrées suivantes.
../Namespace.js I18N.js ../LogMessages.js
Problème : l’image ne s’affiche pas
-
Assurez-vous que l’URL de l’image est correcte.
-
Vérifiez si votre navigateur prend en charge ce type d’image.
-
Dans les informations des exceptions, recherchez les mots causé 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
Remarque : le chemin définit le chemin d’accès absolu au fichier de données.
-
Dans le navigateur de bureau, accédez à Outils de développement > Ressources.
Vérifiez sur le côté gauche de la section Images si cette image s’affiche.