Table — mettre à jour une ligne

Modifie la ligne qui porte cette clé. L’étape échoue si aucune ligne ne correspond.

Modifie la ligne d’une Table qui porte une clé donnée. Seules les colonnes que vous nommez changent ; les autres gardent leur valeur. Si aucune ligne ne porte la clé, l’étape échoue — quand une ligne absente doit être créée, utilisez Table — ajouter ou mettre à jour.

En bref

• Type : table.update · 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 à modifier, 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

values

Colonnes à modifier — Seules les colonnes nommées ici bougent. Les autres gardent ce qu’elles portent.

• 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 ligne modifiée.
• {{ data.<step>.row.<column> }} — object. La ligne entière après modification, par clé machine de colonne — les colonnes modifiées comme les autres. Les cellules vides sont absentes.
• {{ data.<step>.created }} — boolean. Toujours false : ce nœud ne crée jamais de 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 mise à jour., Aurait mis à jour la ligne. ou Déjà écrit lors d’une tentative précédente : rien n’a été réécrit.

Exemple

Quand un client confirme un rendez-vous, le dossier correspondant passe à « Confirmé ». La table dossiers a la colonne clé numero_dossier. Le nœud s’appelle « Marquer confirmé ».

table   dossiers
key     numero_dossier = {{ data.lire_la_reponse.numero_dossier }}
values  statut         = Confirmé
        confirme_le    = {{ data.lire_la_reponse.date }}

Le nœud suivant peut lire toute la ligne modifiée, par exemple {{ data.marquer_confirme.row.email_client }}.

Conseils

• La clé désigne la ligne ; les valeurs la modifient. La Clé de la ligne liste les valeurs des colonnes cochées Entre dans la clé de rapprochement dans la table ; le rapprochement ignore la casse, les accents et la ponctuation. Colonnes à modifier liste les colonnes à écrire.
• Changer la clé. Vous pouvez lister une colonne clé dans Colonnes à modifier : la ligne est alors rangée sous sa nouvelle clé.
• Erreurs. Aucune ligne ne porte la clé : table.row_not_found. Colonne inconnue : table.unknown_column. Valeur qui ne correspond pas au type de sa colonne : table.invalid_value. Table sans colonne clé : table.no_key. Ces échecs sont définitifs.
• Les colonnes se désignent par leur clé machine, pas par leur en-tête. La recherche par clé s’appuie sur l’option de table Refuser deux lignes de même clé ; laissez-la cochée sur une table que vous modifiez par clé.
• Les nouvelles tentatives sont sûres. Une nouvelle tentative après incident rend la ligne écrite par la première tentative (reused: true) sans réécrire.
• Essais. Rien n’est écrit, mais la ligne est réellement cherchée : si elle n’existe pas, le test échoue comme une vraie exécution. Sinon, l’étape rend la ligne telle qu’elle serait après modification, avec simulated: true. Voir Essais.