Mankomail

Émettre un signal ​

Termine ailleurs les attentes qui guettent cette clé — pour ne pas relancer un client dont on a déjà la réponse.

Le nœud Émettre un signal termine, ailleurs, les attentes qui guettent une clé de corrélation. Il répond à une situation courante : la pièce qu’une relance attend arrive par un autre fil, le mandat est signé à l’agence, l’offre se règle au téléphone. Un nœud Attendre réglé pour se réveiller sur un signal s’installe avec une clé, par exemple dossier:PSD-2026-0142:pieces-recues ; le workflow qui apprend le fait émet un signal de même clé, et toutes les attentes qui la guettent se terminent.

Deux actions sont proposées :

  • Réveiller les attentes (resume) : les attentes sortent par leur port event ; la relance prévue n’est donc pas envoyée et l’exécution continue par la branche « événement reçu ».
  • Annuler les exécutions en attente (cancel) : les exécutions sont annulées ; rien de ce qui suivait l’attente n’est exécuté. À choisir quand le dossier est clos.

La clé est une chaîne libre ; la seule exigence est qu’elle soit exactement la même des deux côtés. Sa portée est toute l’organisation. Un programme peut émettre le même signal par l’API, avec une clé d’API dotée de la portée signals:write.

En bref ​

  • Type : flow.signal · version 1
  • Catégorie : Logique
  • Nature : Étape — s’exécute pendant une exécution
  • Effet : Écrit à l’extérieur (external_write) — écrit hors de Mankomail ; décrit au lieu d’être fait pendant un essai
  • Exige un mail porteur : Non
  • Connexion : Aucune
  • Entrées : main
  • Sorties : main

Paramètres ​

key ​

Clé de corrélation — Exactement la même chaîne que celle du nœud Attendre qui guette ce fait. Portée organisation.

  • Type : Texte (string)
  • Requis : Oui
  • Défaut : "" (vide)
  • 200 caractères au plus
  • Exemple : dossier:{{ data.extract_1.reference }}:pieces-recues
  • Expressions : {{ }} accepté

action ​

Ce que le signal fait

  • Type : Un choix (options)
  • Requis : Oui
  • Défaut : resume
  • Options :
    • resume — Réveiller les attentes : Elles sortent par leur branche « événement reçu » — donc sans envoyer la relance prévue.
    • cancel — Annuler les exécutions en attente : Rien de ce qui suivait l’attente ne sera exécuté. À choisir quand le dossier est clos.

payload ​

Ce que le signal apporte — Des valeurs courtes, lisibles par l’attente réveillée sous data.<nœud>.signal. Jamais un corps de mail : la ligne est bornée et vit en base.

  • Type : Paires clé / valeur (keyValue)
  • Requis : Non
  • Défaut : []
  • Affiché quand : action vaut resume
  • Expressions : {{ }} accepté

Sorties ​

  • main — Emprunté une fois le signal émis, qu’une attente y ait correspondu ou non.

Données produites ​

Ce que ce nœud ajoute aux données de l’exécution, et comment le lire dans une expression. <step> désigne la clé de l’étape : le nom du nœud ramené à un identifiant (voir Données et expressions).

  • {{ data.<step>.key }} — string. La clé de corrélation, rendue et sans espaces de bord.
  • {{ data.<step>.action }} — string. resume (réveiller les attentes) ou cancel (annuler les exécutions en attente).
  • {{ data.<step>.matched }} — number. Le nombre d’attentes réveillées ou annulées par cette émission. 0 signifie qu’aucune attente ne guettait la clé à ce moment-là. Toujours 0 en essai.
  • {{ data.<step>.signalId }} — string. L’identifiant du signal enregistré. Absent en essai.
  • {{ data.<step>.duplicate }} — boolean. true quand cette étape avait déjà émis le signal (étape retentée) : rien n’a été réémis. Absent sinon.
  • {{ data.<step>.simulated }} — boolean. Essai uniquement : true, avec effect qui décrit le signal qui aurait été émis.
  • {{ data.<step>.summary }} — string. Un résumé d’une ligne dans la langue du membre, par exemple « Signal émis — 1 attente touchée. » (avec summaryKey et summaryParams).

Example ​

Le workflow A envoie une demande de pièces puis attend dix jours ouvrés, avec réveil sur le signal dossier:{{ data.extraire.reference }}:pieces-recues. Le workflow B est déclenché par les mails entrants avec pièces jointes et en extrait la référence du dossier. À sa fin, ajoutez Émettre un signal :

key:    dossier:{{ data.lire.reference }}:pieces-recues
action: resume

Quand B s’exécute pour le dossier PSD-2026-0142, l’attente de A pour ce dossier sort par event, et {{ data.<step>.matched }} vaut 1 dans B.

Tips ​

  • Un signal peut arriver avant l’attente. Un signal émis par ce nœud reste valable 24 heures (un signal émis par l’API suit SIGNAL_RETENTION_HOURS, 24 par défaut, voir les variables d’environnement). Une attente installée avec cette clé pendant cette fenêtre se termine aussitôt. À l’inverse, réutiliser la même clé pour une attente sans rapport dans cette fenêtre la termine immédiatement : incluez une référence de dossier dans la clé.
  • Exactement une fois. Une étape retentée n’émet pas le signal une seconde fois ; elle le signale par duplicate.
  • matched vaut 0. Rien n’attendait à ce moment-là : vérifiez que les clés sont identiques des deux côtés, casse et séparateurs compris.
  • Essais. Le nœud se contente de décrire le signal qu’il aurait émis : l’émettre pour de vrai réveillerait ou annulerait des exécutions réelles.
  • Une clé vide (après rendu) fait échouer l’étape avec node_invalid_param.