Ce guide vous aide à diagnostiquer et à résoudre les problèmes liés aux flux de messages. Il aborde deux types de problèmes distincts : les messages qui ne sont pas envoyés du tout, et ceux qui sont envoyés mais qui affichent incorrectement les variables dynamiques.
Problème : un message n'est pas envoyé
Vérifiez toujours d'abord le journal des messages dans eADM. Ce journal indique si eADM a tenté d'envoyer le message et, le cas échéant, si cette tentative a abouti ou a échoué.
-
Ouvrez le flux de messages concerné.
-
Accédez à l'onglet « Journal des messages ».
-
Vérifiez si une tentative d'envoi figure dans la liste pour l'utilisateur et l'événement concernés.
Si aucune tentative n'apparaît dans la liste, cela signifie que l'ensemble de règles ne s'est pas déclenché. Vérifiez que les critères de l'ensemble de règles correspondent bien aux données de l'utilisateur avant de poursuivre l'analyse. Si une tentative apparaît dans la liste accompagnée d'une erreur, utilisez les causes ci-dessous pour la diagnostiquer.
Cause n° 1 : l'utilisateur n'a pas de responsable
Le responsable est déterminé à partir du poste principal de l'utilisateur. Si le poste principal n'est pas défini dans le système source, eADM ne peut pas identifier de responsable, et tout flux de messages destiné à ce responsable échoue.
-
Vérifiez le poste principal de l'utilisateur dans le système source (HRM).
-
Vérifiez qu’un seul poste est bien désigné comme principal pour l’utilisateur.
-
Corrigez la position principale dans le système source ; eADM mettra à jour le responsable lors de la prochaine synchronisation.
Cause n° 2 : le numéro de portable ou l'adresse e-mail n'est pas renseigné(e)
Les flux de messages destinés à un numéro de téléphone mobile privé ou à une adresse e-mail privée échouent lorsque cette information est manquante dans le système source.
-
Un exemple courant est l'envoi des identifiants de connexion à un nouveau collaborateur : cette opération échoue si l'adresse e-mail personnelle ou le numéro de portable n'est pas renseigné dans les données source issues du système de gestion des ressources humaines (SGRH).
-
Vérifiez le champ « destinataire concerné » dans le système source et assurez-vous que la valeur y est bien renseignée.
-
Corrigez la valeur manquante à la source ; eADM ne génère pas de coordonnées de son propre chef.
Problème : les variables dynamiques ne s'affichent pas correctement
Il est toujours recommandé de prévisualiser les flux de messages avant d'enregistrer les modifications ou de les activer.
Lorsque vous prévisualisez un message, vous remarquerez peut-être que les variables dynamiques, telles que [UserName], ne sont pas remplacées par les données utilisateur correctes. La cause dépend du fait qu'une seule variable présente un dysfonctionnement ou que plusieurs variables présentent un dysfonctionnement.
Cause n° 1 : défaillance d'une seule variable
Si une seule variable dynamique ne fonctionne pas, le problème provient très probablement d'une erreur de syntaxe dans l'expression elle-même.
-
Les variables dynamiques sont des expressions placées entre crochets, par exemple
[UserName]ou[REFERENCE;DisplayName;UserId;1;[Manager]]. -
Vérifiez attentivement l'orthographe, la syntaxe et la structure de la variable qui pose problème afin de vous assurer qu'elle est correcte.
Cause n° 2 : échec de toutes les variables ou de la plupart d'entre elles
Si aucune ou la plupart des variables dynamiques de votre modèle ne s'affichent pas, cela est probablement dû à un code non valide dans le code source HTML du modèle de message. Cela se produit souvent lorsque du texte est copié-collé depuis une application externe telle que Microsoft Word, qui peut insérer des balises de mise en forme non prises en charge.
Pour résoudre ce problème, vous devez vérifier le code source HTML et supprimer les balises non valides.
Comment nettoyer le code HTML
-
Ouvrez le modèle de flux de messages et passez à la vue « Code source ».
-
Recherchez les balises non valides suivantes :
-
<span class="code" spellcheck="false">: Cette balise doit être entièrement supprimée. -
<p data-pm-slice="1 1 []">: Cette balise doit être remplacée par une balise standard<p>balise.
-
-
Après avoir supprimé et remplacé les balises incorrectes, enregistrez les modifications.
-
Prévisualisez à nouveau le flux de messages pour vérifier que les variables dynamiques affichent désormais les valeurs correctes.
Remarque : une astuce utile consiste à copier l'intégralité du code source HTML dans un éditeur de texte tel que Notepad++ et à utiliser sa fonction « Rechercher et remplacer » pour nettoyer rapidement le code.