Mankomail

Table — ajouter une ligne ​

Ajoute une ligne. Si la table a une clé unique et qu’elle est déjà prise, l’étape échoue — utilisez « ajouter ou mettre à jour ».

Ajoute une ligne à une Table. Servez-vous-en pour les journaux et les registres où chaque exécution ajoute une entrée. Quand la ligne peut déjà exister et doit être mise à jour plutôt que refusée, utilisez Table — ajouter ou mettre à jour.

En bref ​

  • Type : table.insert · 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)

values ​

Valeurs de la ligne — Une entrée par colonne à remplir. Les colonnes non renseignées restent vides.

  • Type : Liste d’éléments (collection)
  • Requis : Non
  • Défaut : []
  • Au plus 60 éléments
  • Chaque élément a :
    • column — Colonne
      • Type : Texte (string)
      • Requis : Oui
      • Défaut : "" (vide)
      • 60 caractères au plus
      • Expressions : {{ }} refusé
    • value — Valeur. Convertie dans le type de la colonne : « 1 234,50 » devient un nombre, « oui » un booléen, « 03/04/2026 » une date. Ce qu’il ne sait pas lire est refusé, jamais vidé.
      • Type : Texte (string)
      • Requis : Non
      • Défaut : "" (vide)
      • 10000 caractères au plus

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 nouvelle ligne. En essai : simulated:<identifiant de la table>.
  • {{ data.<step>.row.<column> }} — object. La ligne telle qu’écrite, cellules converties dans le type de leur colonne, par clé machine de colonne. Les cellules vides sont absentes.
  • {{ data.<step>.created }} — boolean. true : le nœud a créé une ligne.
  • {{ data.<step>.reused }} — boolean. true quand l’étape a été retentée après un incident et que la ligne écrite par la première tentative a été rendue, sans réécriture.
  • {{ data.<step>.simulated }} — boolean. true en essai : rien n’a été écrit.
  • {{ data.<step>.summary }} — string. Le résumé d’une ligne : Ligne ajoutée., Aurait ajouté une ligne. ou Déjà écrit lors d’une tentative précédente : rien n’a été réécrit.

Exemple ​

Chaque devis signé est consigné dans une table devis_signes. Le nœud s’appelle « Consigner le devis ».

text
table   devis_signes
values  client     = {{ email.from.email }}
        montant    = {{ data.lire_le_devis.montant }}
        signe_le   = {{ data.lire_le_devis.date }}

montant est une colonne Nombre : « 1 234,50 » et « 1,234.50 » sont tous deux enregistrés comme le nombre 1234,5. signe_le est une colonne Date : « 03/04/2026 » et « 2026-04-03 » sont tous deux enregistrés comme 2026-04-03. Le nœud suivant lit {{ data.consigner_le_devis.rowId }}.

Conseils ​

  • Les colonnes se désignent par leur clé machine, pas par leur en-tête. Une colonne qui n’existe pas fait échouer l’étape avec table.unknown_column. Les colonnes non renseignées restent vides ; une valeur vide donne aussi une cellule vide.
  • Les valeurs sont converties dans le type de la colonne — Nombre, Vrai ou faux (oui/non, yes/no, x, 1/0…), Date (ISO ou jour/mois/année), Date et heure, Adresse e-mail, Liste de choix (rapprochée d’une valeur autorisée sans tenir compte de la casse ni des accents). Une valeur inconvertible est refusée, jamais vidée : l’étape échoue avec table.invalid_value et nomme la colonne. Une cellule obligatoire laissée vide échoue de la même façon.
  • Clés en double. Si la table refuse deux lignes de même clé et que la clé est déjà prise, l’étape échoue. Utilisez plutôt Table — ajouter ou mettre à jour.
  • Limites. Une cellule contient au plus 4 000 caractères par défaut, et une table au plus 50 000 lignes (table.limit_reached) ; les deux bornes sont réglées par l’administrateur de l’instance.
  • Les nouvelles tentatives sont sûres. L’écriture est enregistrée avec la clé d’idempotence de l’étape dans la même transaction : une nouvelle tentative après incident rend la ligne déjà écrite (reused: true) au lieu d’en ajouter une seconde.
  • Auteur. Une ligne écrite par un workflow est attribuée au workflow, pas au membre qui a déclenché l’exécution.
  • Essais. Rien n’est écrit. L’étape rend la ligne qu’elle aurait écrite, valeurs converties, avec simulated: true. Voir Essais.