Mankomail

Table — supprimer une ligne ​

Retire la ligne qui porte cette clé. Aucune ligne à retirer n’est un succès, pas une erreur.

Retire la ligne d’une Table qui porte une clé donnée. Servez-vous-en pour faire le ménage : un dossier clos, une relance devenue inutile, une entrée temporaire. Ne rien trouver à retirer est un succès, pas une erreur : un workflow de nettoyage peut donc tourner deux fois sans risque.

En bref ​

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

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>.deleted }} — number. Le nombre de lignes retirées : 1, ou 0 quand aucune ligne ne portait la clé. En essai, le nombre qui aurait été retiré.
  • {{ data.<step>.reused }} — boolean. true quand l’étape a été retentée après un incident : la suppression avait déjà eu lieu et rien n’a été retiré à nouveau (deleted vaut alors 0).
  • {{ data.<step>.simulated }} — boolean. true en essai : rien n’a été retiré.
  • {{ data.<step>.summary }} — string. Le résumé d’une ligne : 1 ligne supprimée., Aucune ligne à supprimer. ou Aurait supprimé la ligne.

Exemple ​

Quand un dossier est clos, sa relance en attente est retirée de la table relances_en_attente (colonne clé numero_dossier). Le nœud s’appelle « Retirer la relance ».

text
table  relances_en_attente
key    numero_dossier = {{ data.lire_la_cloture.numero_dossier }}

{{ data.retirer_la_relance.deleted }} vaut 1 si une relance était en attente, 0 sinon. Les deux cas continuent par la même sortie.

Conseils ​

  • Rien à retirer n’est pas une erreur. Branchez un nœud Condition (Si) sur {{ data.<step>.deleted }} si vous avez besoin de le savoir.
  • La clé liste les valeurs des colonnes cochées Entre dans la clé de rapprochement dans la table, par clé machine ; le rapprochement ignore la casse, les accents et la ponctuation. Une partie de clé manquante fait échouer l’étape avec table.invalid_value ; une table sans colonne clé échoue avec table.no_key.
  • Une ligne à la fois. Le nœud retire la ligne qui porte la clé ; la recherche par clé s’appuie sur l’option de table Refuser deux lignes de même clé.
  • Une nouvelle tentative ne supprime jamais deux fois. Une nouvelle tentative après incident trouve la suppression déjà enregistrée et ne retire rien, même si quelqu’un a recréé la ligne entre-temps.
  • Essais. Rien n’est retiré. La ligne est réellement cherchée, et deleted dit si l’exécution en aurait retiré une. Voir Essais.