Mankomail

Table — chercher une ligne ​

Cherche une ligne par sa clé. Deux sorties : trouvée, et non trouvée.

Cherche une ligne d’une Table par sa clé et oriente le workflow : found (trouvée) ou not_found (non trouvée). Servez-vous-en pour les tables de correspondance (« ce département → ce consultant ») et pour la mémoire entre exécutions (« ce dossier a-t-il déjà été relancé ? »). Pour lire plusieurs lignes d’un coup, utilisez Table — lister des lignes.

Le nœud ne dit jamais sur quelles colonnes rapprocher : c’est la table qui le dit. Les colonnes cochées Entre dans la clé de rapprochement forment la clé, et le nœud n’en donne que les valeurs.

En bref ​

  • Type : table.find · version 1
  • Catégorie : Données
  • Nature : Étape — s’exécute pendant une exécution
  • Effet : Sans effet externe (none) — rien n’est écrit hors de Mankomail ; rejouable sans risque
  • Exige un mail porteur : Non
  • Connexion : Aucune
  • Entrées : main
  • Sorties : found, not_found

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 — Les valeurs des colonnes marquées « clé » dans la table. C’est la table qui décide sur quoi on rapproche — pas ce nœud.

  • 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 ​

  • found — Empruntée quand une ligne porte la clé.
  • not_found — Empruntée quand aucune ligne ne porte la clé.

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>.found }} — boolean. true quand une ligne a été trouvée — le même fait que le port emprunté, pour les conditions plus loin dans le graphe.
  • {{ data.<step>.row.<column> }} — object. Trouvée seulement : les cellules de la ligne, par clé machine de colonne ({{ data.<step>.row.consultant }}). Une cellule vide est absente et se lit comme vide.
  • {{ data.<step>.rowId }} — string. Trouvée seulement : l’identifiant de la ligne.
  • {{ data.<step>.updatedAt }} — string. Trouvée seulement : la date de dernière modification de la ligne (ISO 8601).
  • {{ data.<step>.summary }} — string. Le résumé d’une ligne : Ligne trouvée. ou Aucune ligne ne porte cette clé.

Exemple ​

Une table « Départements → consultants » (identifiant departements-consultants) a une colonne clé departement et une colonne consultant. Une étape Extraire nommée « Lire la demande » a tiré le département du mail. Le nœud s’appelle « Trouver le consultant ».

text
table   departements-consultants
key     departement = {{ data.lire_la_demande.departement }}

Sur le port found, un nœud Envoyer ou Rédiger peut prendre {{ data.trouver_le_consultant.row.consultant }} comme destinataire. Sur le port not_found, un nœud Notifier peut prévenir l’équipe que le département manque dans la table.

Conseils ​

  • Les colonnes se désignent par leur clé machine, pas par leur en-tête : l’identifiant affiché comme Clé machine dans les réglages de la colonne (un en-tête « Département (1-95) » donne departement_1_95). La même clé sert dans {{ data.<step>.row.<colonne> }}.
  • Le rapprochement ignore la casse, les accents et la ponctuation : « Saint-Étienne » et « SAINT ETIENNE » sont la même clé. Avec plusieurs colonnes clé, donnez une valeur pour chacune ; une partie manquante fait échouer l’étape avec table.invalid_value.
  • Tables qui refusent les clés en double. 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 interrogez par clé.
  • Erreurs. Aucune table choisie ou clé vide : node_invalid_param. Table inconnue : table.not_found. Table sans colonne clé : table.no_key — cochez Entre dans la clé de rapprochement sur une colonne. Ces échecs sont définitifs et ne sont pas retentés.
  • Essais. La lecture est réelle, même pendant un essai : le nœud interroge la vraie table. Voir Essais.