Rapport planifié par e-mail

Le besoin

La direction veut recevoir les chiffres de la veille par e-mail à 8 h les jours ouvrés, sans script à part.

La démarche

Élément	Mécanisme
Calculer les chiffres	Une tâche Nomaflow planifiée, avec une étape sql_query qui les écrit dans une table de rapport.
Les envoyer	Une règle de notification sur l'événement succeeded de la tâche, canal email, vers un rôle ou des adresses.
Présenter le détail	Un tableau de bord ou un écran sur la table de rapport.

La recette

1. Le compte e-mail

Liberty Next → Administrer → App → Notifications : serveur SMTP, port, sécurité, compte et adresse d'expédition. Send a test le vérifie. Voir Notifications → Le compte e-mail.

2. La table de rapport et sa requête

CREATE TABLE daily_pipeline (
  report_date DATE,
  stage       VARCHAR(30),
  deals       INTEGER,
  amount      DECIMAL(14,2)
);

Une requête d'écriture compute_daily_pipeline sur le connecteur du CRM :

INSERT INTO daily_pipeline (report_date, stage, deals, amount)
SELECT CURRENT_DATE - 1, stage, COUNT(*), SUM(amount)
FROM deals
WHERE updated_at >= CURRENT_DATE - 1 AND updated_at < CURRENT_DATE
GROUP BY stage

3. La tâche

Dans Nomaflow, une tâche crm-daily-pipeline avec :

• une planification 0 8 * * 0-4 — 8 h du lundi au vendredi (dans le cron de Liberty Next, le jour 0 est le lundi ; voir Planifications → Cron) ;
• une étape sql_query qui exécute compute_daily_pipeline.

Run now permet de la vérifier aussitôt. Voir Créer une tâche.

4. L'e-mail

Liberty Next → Construire → Notifications, une nouvelle règle :

Champ	Valeur
Déclencheur	Un événement de tâche, tâche crm-daily-pipeline, événement succeeded.
Canaux	email (et portal pour la cloche).
Destinataires	role:management, ou email:direction@example.com.
Objet	Pipeline du jour — {ROWS} lignes calculées
Corps	Le pipeline du jour est prêt. Le détail se trouve dans le tableau de bord du CRM.

Les variables d'un événement de tâche sont JOB, RUN_ID, STATE, ERROR, DURATION_MINUTES et ROWS. Send a test envoie la règle avec des valeurs d'exemple. Voir Notifications → Règles.

5. Le détail

Un widget de tableau de bord ou un écran sur daily_pipeline (par exemple un graphique en barres par étape, filtré sur la dernière report_date), accessible depuis le menu. Voir Tableaux de bord.

6. En cas d'échec

Les alertes propres à la tâche préviennent les exploitants par e-mail en cas d'échec — voir Notifications → Les alertes propres à une tâche.

Quand un fichier doit être joint

Une tâche envoie elle-même un fichier en deux étapes, sans code :

1. une étape report produit en Excel ou en PDF une analyse ou un tableau de bord partagé de l'explorateur de données, sur une période prédéfinie (Mois dernier), et pour un utilisateur donné quand les destinataires ne doivent voir que leur propre périmètre ;
2. une étape notify envoie le message à role:management, avec Joindre à * : tous les fichiers produits par l'exécution partent avec l'e-mail.

La règle de notification sur la réussite de la tâche devient alors inutile. Voir Étapes → Rapport et Étapes → Notification.

Variantes

Besoin	Moyen
Chaque lundi	Cron 0 8 * * 0.
Un message dans Teams ou un autre outil	Une règle de notification avec le canal action, qui appelle un endpoint d'un connecteur API (un webhook).
Un avertissement seulement en cas d'anomalie	Une étape qui échoue quand un contrôle n'est pas satisfait, et une règle sur l'événement failure.

Pour aller plus loin

• Notifications — règles, canaux, destinataires, variables.
• Planifications — cron et préréglages.
• Tableaux de bord — présenter les chiffres.