Mankomail

Table — ajouter un commentaire ​

Ajoute un texte horodaté au bas d’une cellule, sans jamais écraser ce qu’elle contient. Une action = un commentaire.

Ajoute une ligne de texte au bas d’une cellule d’une Table, sans jamais écraser ce que la cellule contient déjà. Il tient un historique par dossier : une action, un commentaire. Pour poser une valeur qui remplace la précédente (un statut, une date), utilisez plutôt Table — mettre à jour une ligne ou Table — ajouter ou mettre à jour.

En bref ​

  • Type : table.append_text · version 1
  • Catégorie : Actions
  • 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 ​

table ​

Table — Choisie dans la liste, ou par son identifiant court (son « slug »), qui peut venir d’un template.

  • Type : Ressource distante (resourceLocator)
  • Requis : Oui
  • Façons de choisir : dans une liste, saisir un identifiant (table)

key ​

Clé de la ligne — La ligne à commenter, désignée par les valeurs de ses colonnes « clé ».

  • Type : Liste d’éléments (collection)
  • Requis : Oui
  • Défaut : []
  • Au plus 8 éléments
  • Chaque élément a :
    • column — Colonne clé
      • Type : Texte (string)
      • Requis : Oui
      • Défaut : "" (vide)
      • 60 caractères au plus
      • Expressions : {{ }} refusé
    • value — Valeur cherchée
      • Type : Texte (string)
      • Requis : Non
      • Défaut : "" (vide)
      • 10000 caractères au plus

column ​

Colonne à compléter — Une colonne de type texte. Ce qu’elle contient n’est jamais remplacé.

  • Type : Texte (string)
  • Requis : Oui
  • Défaut : "" (vide)
  • 60 caractères au plus
  • Expressions : {{ }} refusé

text ​

Texte à ajouter — Une ligne par action. Écrivez ce qui s’est passé, pas l’état résultant — l’état a sa propre colonne.

  • Type : Texte long (text)
  • Requis : Oui
  • Défaut : "" (vide)
  • 4000 caractères au plus
  • Expressions : {{ }} accepté

withTimestamp ​

Préfixer par la date et l’heure — La date est écrite en format court universel (2026-04-03 14:30), pas dans la langue du membre : une cellule est relue par des gens différents et exportée telle quelle.

  • Type : Oui / non (boolean)
  • Requis : Non
  • Défaut : true

createIfMissing ​

Créer la ligne si elle n’existe pas — Pratique pour un journal par dossier : le premier commentaire crée la ligne.

  • Type : Oui / non (boolean)
  • Requis : Non
  • Défaut : true

Sorties ​

  • main

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>.rowId }} — string. L’identifiant de la ligne commentée. En essai, quand la ligne serait créée : simulated:<identifiant de la table>.
  • {{ data.<step>.row.<column> }} — object. La ligne entière après écriture, par clé machine de colonne ; la colonne complétée porte tout le journal, nouvelle entrée en dernier.
  • {{ data.<step>.created }} — boolean. true quand la ligne n’existait pas et a été créée par ce commentaire.
  • {{ data.<step>.reused }} — boolean. true quand l’étape a été retentée après un incident : le commentaire avait déjà été ajouté et ne l’a pas été une seconde fois.
  • {{ data.<step>.simulated }} — boolean. true en essai : rien n’a été écrit.
  • {{ data.<step>.summary }} — string. Le résumé d’une ligne : Commentaire ajouté., Aurait ajouté le commentaire. ou Commentaire déjà ajouté lors d’une tentative précédente.

Exemple ​

À chaque relance d’un client, un workflow consigne l’action dans la colonne historique de la table dossiers (colonne clé numero_dossier). Le nœud s’appelle « Consigner la relance ».

text
table            dossiers
key              numero_dossier = {{ data.lire_le_dossier.numero_dossier }}
column           historique
text             Relance envoyée à {{ data.lire_le_dossier.email_client }}
withTimestamp    activé
createIfMissing  activé

Après deux exécutions, la cellule contient :

text
2026-04-03 14:30 — Relance envoyée à ada@exemple.fr
2026-04-10 09:05 — Relance envoyée à ada@exemple.fr

Conseils ​

  • Rien n’est jamais remplacé. La nouvelle entrée s’ajoute sur une nouvelle ligne, sous le contenu existant. Écrivez ce qui s’est passé, pas l’état résultant — l’état a sa propre colonne.
  • Horodatage. Avec Préfixer par la date et l’heure activé, chaque entrée commence par AAAA-MM-JJ HH:MM — . L’heure est en UTC et le format ne dépend pas de la langue du membre : la cellule se trie et s’exporte proprement.
  • Création de la ligne. Avec Créer la ligne si elle n’existe pas activé (le défaut), le premier commentaire crée la ligne avec ses valeurs de clé. Désactivé, une ligne absente fait échouer l’étape avec table.row_not_found.
  • La colonne se désigne par sa clé machine et doit être une colonne Texte. Une colonne inconnue échoue avec table.unknown_column.
  • Taille de la cellule. Tout le journal compte dans la limite de la cellule (4 000 caractères par défaut, réglée par l’administrateur de l’instance). Une fois cette limite atteinte, les commentaires suivants échouent avec table.invalid_value.
  • Texte vide. Si le texte est vide une fois les expressions résolues, l’étape échoue plutôt que d’ajouter une ligne portant seulement une date.
  • Une nouvelle tentative n’ajoute jamais deux fois. Le commentaire est enregistré avec la clé d’idempotence de l’étape : une nouvelle tentative après incident rend la ligne déjà écrite (reused: true) au lieu d’ajouter le même commentaire une seconde fois.
  • La recherche par clé ignore la casse, les accents et la ponctuation, et s’appuie sur l’option de table Refuser deux lignes de même clé.
  • Essais. Rien n’est écrit. La ligne est réellement cherchée, et l’étape la rend telle qu’elle serait avec le commentaire ajouté, avec simulated: true. Voir Essais.