Notifications unifiées

Chaque notification est une entrée du Journal des notifications rattaché à un utilisateur. Elle a un Type de notification. Le type sert à trier les notifications et à choisir celles qui envoient aussi un e-mail.

Lire ses notifications

1. Cliquez sur la cloche, dans le dock ou dans la barre latérale.
2. Le panneau s'ouvre sur l'onglet Tous. L'onglet Événements liste vos événements à venir.
3. Cliquez sur une notification pour ouvrir le document lié. Elle est alors marquée comme lue.

Le panneau a aussi :

• Tout marquer comme lu ;
• Paramètres des notifications, qui ouvre vos préférences ;
• Voir les journaux complets, qui ouvre la liste de vos notifications.

Types de notification fournis

Dodock crée cinq types. Ils ne peuvent pas être supprimés, seulement désactivés.

Les noms des quatre premiers types ne sont pas encore traduits. Une application peut ajouter ses propres types.

Choisir les e-mails reçus

1. Dans le panneau, cliquez sur Paramètres des notifications.
2. Laissez Autoriser les notifications par email coché.
3. Dans Me notifier par e-mail pour ces types de notification, cochez les types qui doivent envoyer un e-mail.
4. Enregistrez.

La liste est une liste d'autorisation. Un type non coché n'envoie pas d'e-mail. Un nouvel utilisateur reçoit tous les types actifs, sauf Alerte. Le type Alerte n'envoie jamais son propre e-mail : la règle de notification gère l'e-mail.

D'autres cases de la même page ne dépendent pas des types : Rappels pour les événements et Envoyer les fils de discussion liés aux documents attribués par email. Activer les notifications système coupe ou rétablit toutes les notifications du panneau.

Créer un type de notification

Cette tâche demande le rôle System Manager.

1. Ouvrez la recherche (Ctrl+K), puis saisissez « Type de notification ».
2. Cliquez sur Ajouter, saisissez le Nom du type, puis enregistrez.

Un nouveau type n'envoie d'e-mail à personne. Chaque utilisateur doit le cocher dans ses paramètres. Pour l'activer pour tous, ouvrez le type, puis cliquez sur Actions > Activer les notifications par e-mail pour tous les utilisateurs. Le traitement se fait en arrière-plan. Chaque utilisateur peut ensuite le décocher.

Créer une notification depuis le code

Cette section s'adresse aux développeurs.

from frappe.desk.doctype.notification_log.notification_log import enqueue_create_notification

enqueue_create_notification(
    ["claire@example.com"],
    {
        "type": "Assignment",
        "document_type": doc.doctype,
        "document_name": doc.name,
        "subject": f"Tâche à valider : {doc.name}",
        "from_user": frappe.session.user,
    },
    dedupe_on=["type", "document_type", "document_name"],
)

• La création se fait en arrière-plan, après le commit de la transaction.
• Seuls les utilisateurs actifs dont les notifications système sont activées reçoivent la notification.
• Un utilisateur ne reçoit pas une notification dont il est l'auteur, sauf pour les types listés dans le hook notification_self_notify_types.
• Avec dedupe_on, aucune notification n'est créée si l'utilisateur en a déjà une avec les mêmes valeurs pour ces champs.
• Les types listés dans le hook notification_skip_email_types n'envoient pas d'e-mail.

Pour savoir si un utilisateur veut un e-mail pour un type, utilisez is_email_notifications_enabled_for_type(user, type) du module frappe.desk.doctype.notification_settings.notification_settings. Pour les rappels d'événements et les fils de discussion, utilisez is_email_enabled_for_feature(user, fieldname).