Mankomail

Table — lister des lignes ​

Rend un tableau de lignes filtrées et triées — à relier à une boucle.

Lit les lignes d’une Table qui passent vos filtres, triées et bornées, et les rend sous forme de tableau. Ce tableau se branche directement sur une Boucle : une itération par ligne. Pour obtenir une seule ligne par sa clé, utilisez Table — chercher une ligne.

En bref ​

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

filters ​

Filtres — Aucun filtre : toutes les lignes, dans la limite demandée.

  • Type : Liste d’éléments (collection)
  • Requis : Non
  • Défaut : []
  • Au plus 10 éléments
  • Chaque élément a :
    • column — Colonne
      • Type : Texte (string)
      • Requis : Oui
      • Défaut : "" (vide)
      • 60 caractères au plus
      • Expressions : {{ }} refusé
    • op — Opérateur
      • Type : Un choix (options)
      • Requis : Oui
      • Défaut : eq
      • Options :
        • eq — est égal à
        • ne — est différent de
        • contains — contient
        • not_contains — ne contient pas
        • starts_with — commence par
        • ends_with — finit par
        • gt — est supérieur à
        • gte — est supérieur ou égal à
        • lt — est inférieur à
        • lte — est inférieur ou égal à
        • empty — est vide
        • not_empty — n’est pas vide
    • value — Valeur
      • Type : Texte (string)
      • Requis : Non
      • Défaut : "" (vide)
      • 10000 caractères au plus

match ​

Combinaison des filtres

  • Type : Un choix (options)
  • Requis : Oui
  • Défaut : all
  • Options :
    • all — Tous doivent passer
    • any — Au moins un doit passer

sortColumn ​

Trier par — Laissé vide : l’ordre de la table (celui d’ajout des lignes).

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

sortDirection ​

Sens du tri

  • Type : Un choix (options)
  • Requis : Non
  • Défaut : asc
  • Options :
    • asc — Croissant
    • desc — Décroissant
  • Affiché quand : sortColumn est renseigné

limit ​

Nombre de lignes au maximum — Une lecture sans borne est une étape dont la taille dépend de ce que quelqu’un a collé dans un tableur.

  • Type : Nombre (number)
  • Requis : Oui
  • Défaut : 100
  • Nombre entier, de 1 à 1000

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>.rows }} — array of { <column>: value }. Les lignes retenues, chacune un objet de cellules par clé machine de colonne : {{ data.<step>.rows.0.consultant }}. Les cellules vides sont absentes.
  • {{ data.<step>.rowIds }} — array. Les identifiants des lignes, dans le même ordre que rows : {{ data.<step>.rowIds.0 }} correspond à rows.0.
  • {{ data.<step>.count }} — number. Le nombre de lignes rendues.
  • {{ data.<step>.truncated }} — boolean. true quand plus de lignes correspondaient que la limite n’en permettait.
  • {{ data.<step>.summary }} — string. Le résumé d’une ligne, par exemple 12 lignes lues.

Exemple ​

Chaque lundi, un workflow planifié relance les dossiers encore ouverts. La table dossiers a les colonnes statut, email_client et ouvert_le (une date). Une étape Calculer une date nommée « Limite » fournit la date butoir. Le nœud s’appelle « Dossiers ouverts ».

text
table          dossiers
filters        statut  est égal à  Ouvert
               ouvert_le  est inférieur à  {{ data.limite.date }}
match          all
sortColumn     ouvert_le
sortDirection  asc
limit          200

Une Boucle prend ensuite {{ data.dossiers_ouverts.rows }} comme éléments. Dans le corps de la boucle, chaque ligne est {{ data.item }} : une relance peut donc partir vers {{ data.item.email_client }}.

Conseils ​

  • Les colonnes se désignent par leur clé machine, pas par leur en-tête, dans les filtres comme dans Trier par. Un filtre ou une colonne de tri qui n’existe pas dans la table est ignoré sans erreur : un filtre mal saisi rend toutes les lignes. Vérifiez la clé dans les réglages de la colonne.
  • Les comparaisons de texte (est égal à, contient, commence par…) ignorent la casse et les accents. est vide et n’est pas vide ne prennent pas de valeur. est supérieur / inférieur à comparent numériquement sur une colonne Nombre (écrivez la valeur avec un point comme séparateur décimal) et comme du texte sinon, ce qui ordonne correctement les dates ISO.
  • Combinaison des filtres. Tous doivent passer garde les lignes qui passent chaque filtre ; Au moins un doit passer garde celles qui en passent un. Sans filtre, toutes les lignes sont rendues, dans la limite. 10 filtres au plus.
  • Limite. Entre 1 et 1 000 lignes, 100 par défaut. Quand plus de lignes correspondent, les premières (dans l’ordre du tri) sont rendues et truncated vaut true. Sans Trier par, les lignes arrivent dans leur ordre d’ajout.
  • Erreurs. Table inconnue : table.not_found, définitif.
  • Essais. La lecture est réelle, même pendant un essai. Voir Essais.