Conseils de dépannage pour l’espace de travail AEM Forms

Cet article explique comment déboguer l’espace de travail AEM Forms en activant la journalisation et en utilisant le débogueur dans un navigateur. Il décrit également certains problèmes courants que vous pouvez rencontrer lors de l’utilisation de l’espace de travail AEM Forms et leurs solutions.

Impossible d’installer le package de l’espace de travail AEM Forms

Une fois que vous avez installé le correctif, ouvrez l’espace de travail AEM Forms. Si vous rencontrez l’erreur « Aucune ressource trouvée », ouvrez le gestionnaire de packages CRX, puis réinstallez le package adobe-lc-workspace-pkg-<version>.zip.

Lors de l’installation du package, si vous rencontrez une erreur javax.jcr.nodetype.ConstraintViolationException: OakConstraint0025: Authorizable property rep:authorizableId may not be removed, procédez comme suit :

1. Connectez-vous à CRXDE Lite. L’URL par défaut est https://[localhost]:'port'/lc/crx/de/index.jsp

2. Supprimez le nœud suivant :

   /home/groups/P/PERM_WORKSPACE_USER

3. Accédez au gestionnaire de packages. L’URL par défaut est https://[localhost]:'port'/lc/crx/packmgr/index.jsp.

4. Recherchez et installez le package adobe-lc-workspace-pkg-[version].zip.

5. Redémarrez le serveur d’applications.

Journalisation de l’espace de travail AEM Forms

Vous pouvez générer des journaux à différents niveaux pour la résolution optimale des erreurs. Prenez l’exemple d’une application complexe. La journalisation au niveau du composant permet de déboguer et de résoudre les problèmes liés à des composants spécifiques.

Dans l’espace de travail AEM Forms :

• Pour obtenir les informations de journalisation sur un fichier de composant spécifique, ajoutez /log/<ComponentFile>/<LogLevel> dans l’URL, puis appuyez sur Enter. Toutes les informations de journalisation pour le fichier de composant au niveau spécifié de journal sont imprimées sur la console.

• Pour obtenir des informations de journalisation tous les fichiers de composant, ajoutez /log/all/trace dans l’URL, puis appuyez sur Enter.

• Format du journal : <Component file> <Date>:<Time>: <Log Level> : <Log Message>

• Le niveau de journal défini par l’utilisateur est conservé uniquement pour cette session de navigateur. Lorsque l’utilisateur ou l’utilisatrice actualise la page, le niveau de journal est défini sur sa valeur initiale pour tous les composants.

Liste des fichiers de composant dans l’espace de travail AEM Forms

Niveaux de journal disponibles dans l’espace de travail AEM Forms

• FATAL
• ERROR
• WARN
• INFO
• DEBUG
• TRACE
• DÉSACTIVÉ

Informations de débogage pour les navigateurs

Les scripts et les styles peuvent être débogués dans différents navigateurs.

• Débogage dans IE : pour déboguer l’espace de travail AEM Forms dans IE, voir https://learn.microsoft.com/fr-fr/office/dev/add-ins/testing/debug-add-ins-using-f12-tools-ie.

• Débogage dans Chrome : pour ouvrir le débogueur dans Chrome, utilisez le raccourci clavier Ctrl+Maj+I. Pour plus d’informations, consultez le lien https://developer.chrome.com/docs/extensions/mv3/tut_debugging/.

• Débogage dans Firefox : plusieurs modules complémentaires sont disponibles pour déboguer des scripts et des styles dans Firefox. Par exemple, Firebug est un utilitaire de débogage de ce type (https://getfirebug.com).

FAQ

1. Le formulaire PDF n’est pas rendu ou envoyé dans Google Chrome.

   1. Installez le plug-in Adobe® Reader®.
   2. Dans Chrome, ouvrez chrome://plugins pour afficher les plug-ins disponibles.
   3. Désactivez le plug-in PDF Viewer de Chrome et activez le plug-in Adobe Reader.

2. Le formulaire SWF ou le guide n’est pas rendu dans Google Chrome.

   1. Dans Chrome, ouvrez chrome://plugins pour afficher les plug-ins disponibles.
   2. Consultez les détails du plug-in Adobe Flash® Player.
   3. Désactivez PepperFlash sous le plug-in Adobe Flash Player.

3. J’ai personnalisé l’espace de travail AEM Forms, mais je ne parviens pas à voir les modifications.

   Effacez le cache de votre navigateur, puis accédez à l’espace de travail AEM Forms.

4. Que doit faire la personne utilisatrice pour permettre le rendu du formulaire en HTML lors de son ouverture dans le bureau ?

   Sélectionnez le bouton radio HTML du profil par défaut, à l’étape Affecter une tâche, tout en utilisant Workbench.

5. La pièce jointe ne s’affiche pas lorsque vous cliquez dessus.

   Pour afficher les pièces jointes, activez les fenêtres contextuelles dans votre navigateur.

6. Une personne utilisatrice est connectée à une application Forms. Si la personne utilisatrice tente de se connecter à l’espace de travail, il se peut que ce dernier ne se charge pas si la personne utilisatrice ne dispose pas des autorisations d’espace de travail.

   Déconnectez-vous de l’autre application Forms, puis connectez-vous à l’espace de travail.

7. Lors du rendu des formulaires HTML dans l’espace de travail AEM Forms, qui utilisent les propriétés de processus dans leur conception, le bouton Envoyer s’affiche à l’intérieur du formulaire.

   Lorsque vous utilisez les propriétés du processus pendant la conception de formulaires, un bouton Envoyer est ajouté à l’intérieur du formulaire. Lorsqu’il est rendu en tant que fichier PDF dans l’espace de travail AEM Forms, le bouton Envoyer n’est pas visible par la personne utilisatrice finale. Cependant, lors du rendu en tant que formulaire HTML dans l’espace de travail AEM Forms, le bouton Envoyer est visible par la personne utilisatrice finale. Si vous cliquez sur ce bouton Envoyer à l’intérieur du formulaire, rien ne se passe. Cliquez sur le bouton Envoyer au bas de l’espace de travail AEM Forms, en dehors du formulaire, pour terminer la tâche.