Les notifications au niveau de l’utilisateur
Chaque utilisateur peut configurer ses notifications sur chaque Tracker.
Plusieurs modes de notification sont disponibles :
Aucune notification : aucune notification ne sera envoyée.
Notifier à chaque mise à jour des artifacts impliquant l’utilisateur : correspond au mode par défaut.
Notifier lors de la création d’un artifact : une notification est envoyée uniquement lors de la création.
Notifier à chaque changement : une notification est envoyée pour toute modification, même sans implication de l’utilisateur.
Notifier lors d’un changement de statut : une notification est envoyée pour chaque changement d’état, même si l’utilisateur n’est pas directement impliqué.
Info pratique
Vous avez la possibilité de supprimer les notifications par artifact en cliquant sur “Désactiver les notifications” dans le menu Actions à côté du titre de l’artifact.
Les notifications au niveau du tracker
Pour configurer l’ensemble des notifications d’un tracker, il faut accéder à l’administration du tracker, disponible uniquement pour ses administrateurs.
Cette configuration s’applique en priorité et remplace les règles définies individuellement par les utilisateurs.
Trois types de notifications peuvent être configurés :
les notifications par défaut
les notifications globales
les rappels.
Les notifications par défaut
Info Pratique
Par défaut, les notifications sont envoyées aux personnes désignées comme Contributeurs ou Responsables des artifacts. Pour définir ces rôles, la configuration se fait dans la Sémantique de l'administration du tracker.
Il suffit de définir le champ qui servira de référence pour la sémantique de responsabilité. Le champ utilisable est un champ de type liste lié à des utilisateurs.
Notifications Globales
Les notifications globales servent à prévenir par email, des utilisateurs ou groupes d'utilisateurs indépendamment du rôle qu'ils jouent par rapport à l'artifact.
Pour chaque type de notification il est possible d'envoyer des emails soit à chaque changement soit seulement à la création.
Attention !
Lors d'un envoi d'email, vérifier les permissions accordées aux utilisateurs ou aux groupes permet de contrôler que les destinataires de l'email sont bien autorisés à consulter le contenu de l'artifact.
Les rappels automatiques sur les dates
Cela permet d’envoyer des notifications en fonction des informations saisies dans le tracker.
Toute personne assignée à un artifact recevra une notification à la date prévue.
Lorsque un artifact contient des dates, notamment lorsqu’il s’agit d’échéances, il est donc possible de configurer des rappels automatiques envoyés par courriel.
Info pratique
Les notifications par email sont très pratiques mais allez-y avec précaution car les modifications d'artifacts seront très nombreuses et vos boites mail seront rapidement submergées si les notifications sont mal configurées. A tout moment, vous pouvez suspendre l'ensemble des notifications par email.
Les notifications au niveau des champs
Certains champs du tracker peuvent être configurés pour envoyer automatiquement des notifications aux personnes qui y sont sélectionnées. Il s'agit de l'option "Envoyer des notifications aux personnes sélectionnées".
Seuls les champs de type liste (Selectbox, Multi-selectbox, Open List) liés à un bind Utilisateur ou un bind Groupe d'utilisateurs supportent cette fonctionnalité.
Pour l’utiliser :
Accédez à Administration du Tracker → Gérer l'utilisation des champs.
Éditez un champ de type liste lié à des utilisateurs ou groupes d'utilisateurs.
Cochez l'option "Envoyer des notifications aux personnes sélectionnées".
Enregistrez.
Dès lors, toute personne sélectionnée dans ce champ sera ajoutée à la liste des destinataires de la notification. Les règles de filtrage habituelles s'appliquent ensuite (permissions, désabonnement, etc.).
Info pratique
C'est typiquement utilisé pour les champs "Assigned to", "CC" ou tout champ de type Open List lié à des utilisateurs. Les personnes sélectionnées dans ces champs reçoivent une notification à chaque création ou mise à jour de l'artifact.
Les @mentions dans les commentaires
Lorsque vous rédigez un commentaire sur un artifact, vous pouvez mentionner un utilisateur en tapant @ suivi de son identifiant (par exemple : @jean.dupont). L'utilisateur mentionné recevra une notification par email.
Attention !
Les @mentions ont un comportement privilégié : elles contournent la plupart des filtres de notification. Un utilisateur mentionné recevra la notification même s'il s'est désabonné du tracker ou de l'artifact, et même s'il est en mode "Me notifier à chaque changement d'état" ou "Me notifier lors de la création d'un nouvel artifact".
Les seules conditions qui bloquent une notification par @mention sont :
Les notifications du tracker sont désactivées (option "Désactiver toutes les notifications" au niveau de l'administration).
L'utilisateur mentionné est un compte technique.
L'utilisateur mentionné n'a pas la permission de lire l'artifact.
L'utilisateur est l'auteur du changement et a désactivé la préférence "Quand vous êtes l'auteur d'un changement" dans son profil.
Le désabonnement par artifact
En plus du mode "Aucune notification" configurable au niveau du tracker (via "Mes notifications"), il est possible de se désabonner d'un artifact individuel.
Pour cela, ouvrez l'artifact concerné et cliquez sur "Ne plus recevoir les notifications de cet artifact" dans le menu Actions à côté du titre.
Info pratique
Le désabonnement par artifact est indépendant du désabonnement par tracker. Vous pouvez être abonné aux notifications du tracker mais désabonné d'un artifact spécifique, et inversement. Une @mention contournera ce désabonnement.
Les notifications dans le profil utilisateur
Dans votre profil utilisateur, deux préférences globales influencent le comportement des notifications sur l'ensemble des trackers :
"Pour toutes les mises à jour après que vous ayez effectué un changement sur un artifact (commentaire, changement de valeurs...)" : si activée (par défaut), vous recevrez des notifications pour les artifacts que vous avez commentés ou modifiés, même si vous n'êtes pas directement assigné. Si désactivée, vous ne serez notifié que si vous êtes explicitement désigné (via un champ, une notification globale, ou une @mention).
"Quand vous êtes l'auteur d'un changement" : si activée (par défaut), vous recevrez un email même lorsque c'est vous qui modifiez l'artifact. Si désactivée, vous ne serez jamais notifié de vos propres changements.
Attention !
La préférence "Quand vous êtes l'auteur d'un changement" est le filtre le plus puissant côté utilisateur : même une @mention ne contournera pas ce filtre. Si vous vous mentionnez vous-même dans un commentaire et que cette préférence est désactivée, vous ne recevrez pas de notification.
Comprendre les priorités entre les niveaux de notification
Avec autant de points de configuration, il est légitime de se demander : quel paramètre prend le dessus sur les autres ? Voici la logique appliquée par Tuleap, étape par étape.
Étape 1 : Les blocages globaux
Avant toute collecte de destinataires, deux conditions peuvent bloquer l'envoi :
Le tracker a ses notifications désactivées (Administration du Tracker → Notifications → "Désactiver toutes les notifications"). C'est le seul véritable "kill-switch" : aucune notification email ne sera envoyée pour ce tracker, y compris les @mentions.
L'artifact a été créé/modifié via l'API REST avec le paramètre
notify: false. Les notifications aux abonnés classiques (champs, commentateurs, notifications globales) sont désactivées. Cependant, les @mentions dans les commentaires sont toujours traitées et envoyées.
Si les notifications du tracker ne sont pas désactivées, le système passe à l'étape suivante.
Étape 2 : Collecte des destinataires potentiels
Tuleap collecte les destinataires depuis quatre sources :
Les champs avec notifications activées : les personnes sélectionnées dans les champs configurés (ex: Assigned to, CC).
Les commentateurs précédents : les utilisateurs ayant déjà commenté l'artifact, à condition qu'ils aient la préférence "Pour toutes les mises à jour après que vous ayez effectué un changement sur un artifact" activée dans leur profil.
Les notifications globales du tracker : les adresses, utilisateurs et groupes configurés par l'administrateur.
Les @mentions : les utilisateurs mentionnés par
@identifiantdans le commentaire.
Étape 3 : Filtrage (qui est finalement retiré ?)
Une fois la liste collectée, Tuleap applique une série de filtres dans un ordre précis. Si un filtre retire un destinataire, celui-ci ne recevra pas l'email.
Pour les destinataires classiques (sources 1, 2 et 3), les filtres suivants sont appliqués dans l'ordre :
❌ Compte technique → Retiré automatiquement.
❌ Auteur du changement → Retiré si la préférence "Quand vous êtes l'auteur d'un changement" est désactivée dans le profil.
❌ Pas de permission de lecture → Retiré si l'utilisateur ne peut pas voir l'artifact, ou s'il ne peut lire aucun champ modifié et qu'il n'y a pas de commentaire. Ce filtre ne s'applique que quand la vérification des permissions est activée (paramètre
check_permissionsde la notification globale).❌ Désabonné → Retiré si l'utilisateur s'est désabonné du tracker ou de l'artifact.
❌ Mode "Me notifier à chaque changement d'état" → Retiré si le statut de l'artifact n'a pas changé.
❌ Mode "Me notifier lors de la création d'un nouvel artifact" → Retiré si c'est une mise à jour (pas une création).
Pour les @mentions (source 4), seuls 3 filtres s'appliquent :
❌ Compte technique
❌ Auteur du changement (si préférence "Quand vous êtes l'auteur d'un changement" désactivée)
❌ Pas de permission de lecture
Attention !
Les @mentions sont particulièrement résistantes : elles contournent le désabonnement (tracker et artifact), le mode "Me notifier à chaque changement d'état" et le mode "Me notifier lors de la création d'un nouvel artifact". De plus, elles sont toujours envoyées même via l'API REST avec
notify: false. Seule l'option "Désactiver toutes les notifications" au niveau du tracker les bloque totalement.
Info pratique
Les deux listes (destinataires classiques et @mentions) sont ensuite fusionnées. Si un utilisateur a été retiré de la liste classique (par exemple parce qu'il est désabonné) mais qu'il a été @mentionné, il recevra quand même la notification.
Tableau récapitulatif — Qui reçoit quoi et quand ?
Situation | Notification envoyée ? |
|---|---|
Notifications du tracker désactivées par l'admin ("Désactiver toutes les notifications") | ❌ Jamais |
Action via API REST avec | ❌ Abonnés classiques / ✅ @Mentions / ✅ Webhooks |
Utilisateur désabonné du tracker (mode "Aucune notification") | ❌ Sauf si @mentionné |
Utilisateur désabonné d'un artifact | ❌ Sauf si @mentionné |
Utilisateur en mode "Me notifier à chaque changement d'état" et statut inchangé | ❌ Sauf si @mentionné |
Utilisateur en mode "Me notifier lors de la création d'un nouvel artifact" lors d'une mise à jour | ❌ Sauf si @mentionné |
Utilisateur sans permission de lecture sur l'artifact | ❌ Jamais (même avec @mention) |
Auteur du changement avec "Quand vous êtes l'auteur d'un changement" désactivé | ❌ Jamais (même avec @mention) |
Utilisateur @mentionné dans un commentaire | ✅ Oui (contourne désabonnement et modes) |
Utilisateur sélectionné dans un champ avec "Envoyer des notifications aux personnes sélectionnées" | ✅ Oui (soumis au filtrage complet) |
Utilisateur dans la "Notification e-mail globale" du tracker | ✅ Oui (soumis au filtrage complet) |
Commentateur précédent (avec préférence "Pour toutes les mises à jour après un changement" activée) | ✅ Oui (soumis au filtrage complet) |
FAQ
Pourquoi est-ce que je reçois des notifications alors que je me suis désabonné du tracker ?
Vérifiez si vous êtes @mentionné dans les commentaires. Les @mentions contournent le désabonnement au tracker et à l'artifact. C'est le seul cas où un désabonnement est "ignoré".
Vérifiez également si vous êtes sélectionné dans un champ avec l'option "Envoyer des notifications aux personnes sélectionnées" (par exemple, le champ "Assigned to"). Cette source de notification est indépendante de votre mode de notification.
Pourquoi est-ce que je ne reçois plus de notifications ?
Plusieurs causes possibles, à vérifier dans l'ordre :
L'administrateur a désactivé les notifications sur ce tracker (Administration → Notifications → "Désactiver toutes les notifications").
Vous vous êtes désabonné du tracker via "Mes notifications" → mode "Aucune notification".
Vous vous êtes désabonné de cet artifact spécifique (menu Actions de l'artifact).
Vous êtes en mode "Me notifier à chaque changement d'état" et le statut n'a pas changé.
Vous êtes en mode "Me notifier lors de la création d'un nouvel artifact" et l'artifact a été modifié (pas créé).
Vous n'avez pas les permissions de lecture sur l'artifact ou les champs modifiés.
Quelle est la différence entre "Mes notifications" et la "Notification e-mail globale" du tracker ?
"Mes notifications" est un réglage personnel : chaque utilisateur choisit son propre mode de notification (aucune, impliqué seulement, changement d'état, etc.). C'est accessible depuis le fil d'Ariane du tracker.
La "Notification e-mail globale" est un réglage administrateur : l'admin du tracker définit des adresses email, des utilisateurs ou des groupes qui seront notifiés automatiquement à chaque création ou mise à jour d'artifact. Ce réglage s'applique en plus des paramètres personnels.
Est-ce que les @mentions fonctionnent quand les notifications du tracker sont désactivées ?
Non. Lorsque les notifications sont désactivées au niveau du tracker (kill-switch), aucune notification n'est envoyée, y compris les @mentions. C'est le seul cas où les @mentions sont totalement bloquées (en dehors des permissions de lecture, des comptes techniques et de la préférence "Quand vous êtes l'auteur d'un changement").
En revanche, si l'action est effectuée via l'API REST avec notify: false, les @mentions sont quand même envoyées. Seuls les abonnés classiques (champs, commentateurs, notifications globales) sont bloqués par ce paramètre.
Est-ce que le champ "Assigned to" envoie des notifications automatiquement ?
Pas par défaut. Pour que le champ "Assigned to" (ou tout autre champ de type liste liée à des utilisateurs) envoie des notifications, l'administrateur doit activer l'option "Envoyer des notifications aux personnes sélectionnées" dans les propriétés du champ. Sans cette option, le champ n'a aucun effet sur les notifications.
Comment savoir quel mode de notification est actif pour moi sur un tracker ?
Accédez au tracker concerné, puis cliquez sur "Mes notifications" dans le fil d'Ariane. Vous verrez le mode actuellement sélectionné parmi les 5 options disponibles.
Est-ce que les webhooks sont affectés par la désactivation des notifications ?
Non. Les webhooks fonctionnent de manière totalement indépendante du système de notifications email. Même si les notifications sont désactivées ou si l'API REST est appelée avec notify: false, les webhooks seront quand même déclenchés.
Est-ce que les notifications par email contiennent les pièces jointes ?
Si le tracker a une sémantique "Plage de temps" configurée et que l'option d'événements de calendrier est activée, les emails de notification incluront un fichier .ics (événement calendrier) en pièce jointe.