Mankomail

Classer ​

Pose ou retire des dossiers/labels sur le mail déclencheur, via le miroir (visible aussitôt dans la boîte).

Classer pose ou retire des dossiers et des labels sur le mail déclencheur. La modification passe par le miroir de la boîte et apparaît dans la vraie boîte du membre. Utilisez-le pour ranger le courrier trié, archiver ce qui est traité ou étiqueter des mails pour un collègue.

Classer agit sur le mail qui a déclenché l’exécution : il lui en faut un. Il s’emploie sous un déclencheur mail, pas sous une planification ou un webhook. Pour changer l’état lu ou suivi, utilisez plutôt Marquer.

En bref ​

  • Type : mail.move · 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 : Oui — il agit sur le mail qui a lancé l’exécution
  • Connexion : Aucune
  • Entrées : main
  • Sorties : main

Paramètres ​

addLabels ​

Labels à poser — Les dossiers ou labels ajoutés au mail. Le nom exact dépend du fournisseur de la boîte.

  • Type : Liste d’éléments (collection)
  • Requis : Non
  • Au plus 20 éléments
  • Chaque élément a :
    • folder — Dossier ou libellé. Choisi dans la liste de la boîte, ou saisi par identifiant — une expression comme {{ data.categorize_1.category }} y est acceptée.
      • Type : Ressource distante (resourceLocator)
      • Requis : Oui
      • Façons de choisir : dans une liste, saisir un identifiant (mail.folder)

removeLabels ​

Labels à retirer — Les dossiers ou labels retirés du mail (par exemple « INBOX » pour archiver).

  • Type : Liste d’éléments (collection)
  • Requis : Non
  • Au plus 20 éléments
  • Chaque élément a :
    • folder — Dossier ou libellé. Choisi dans la liste de la boîte, ou saisi par identifiant — une expression comme {{ data.categorize_1.category }} y est acceptée.
      • Type : Ressource distante (resourceLocator)
      • Requis : Oui
      • Façons de choisir : dans une liste, saisir un identifiant (mail.folder)

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>.opId }} — string. L’identifiant de l’opération sortante enregistrée. Stable quand l’étape est retentée. En essai, il vaut simulated:mail.move.
  • {{ data.<step>.simulated }} — boolean. true en essai : le mail n’a pas été touché, le détail d’exécution décrit ce qui se serait passé.
  • {{ data.<step>.addLabels }} — array of string. Les identifiants des dossiers ou labels posés, tels que résolus pour cette exécution.
  • {{ data.<step>.removeLabels }} — array of string. Les identifiants des dossiers ou labels retirés, tels que résolus pour cette exécution.

Exemple ​

Derrière la branche cat:Factures d’un Catégoriser, ranger les factures fournisseurs et les sortir de la boîte de réception. Ajoutez un nœud Classer :

addLabels:
  - folder: "Factures"   (choisi dans la liste de la boîte)
removeLabels:
  - folder: "INBOX"

Les données de l’étape sont :

json
{
  "opId": "9a40…",
  "simulated": false,
  "addLabels": ["Label_3"],
  "removeLabels": ["INBOX"]
}

Label_3 est l’identifiant fournisseur derrière le label « Factures » choisi dans la liste.

Dossiers et labels ​

Chaque entrée se choisit dans la liste des dossiers de la boîte, ou se saisit par identifiant. Ce qui est enregistré est l’identifiant du fournisseur, pas le nom affiché : l’identifiant de label chez Gmail, l’identifiant de dossier chez Microsoft, le chemin du dossier en IMAP. Chez Gmail et Microsoft, renommer un dossier ne casse donc pas le workflow ; en IMAP, le chemin change avec le nom.

Le champ d’identifiant accepte une expression, par exemple une valeur calculée par une étape précédente. La valeur doit être un identifiant que le fournisseur reconnaît, pas un nom affiché.

Le résultat dépend du fournisseur, car un mail ne se trouve que dans un seul dossier chez Microsoft et en IMAP, alors qu’il peut porter plusieurs labels chez Gmail :

  • Gmail : les labels sont posés et retirés tels que listés. Retirer INBOX archive le mail.
  • Microsoft : la première valeur posée qui désigne un dossier connu devient la destination, et le mail y est déplacé. Retirer INBOX sans destination déplace le mail dans le dossier d’archive. Toute autre valeur posée devient une catégorie.
  • IMAP : la première valeur posée qui désigne un chemin de dossier connu devient la destination. Retirer INBOX sans destination déplace le mail dans le dossier d’archive. Toute autre valeur posée devient un mot-clé sur le message.

Dans tous les cas, retirer INBOX archive : cela ne supprime jamais.

Conseils ​

  • Rien à faire est une erreur. Avec les deux listes vides, l’étape échoue avec node_nothing_to_do au lieu de ne rien faire en silence. Chaque liste compte au plus 20 entrées.
  • Pas de mail déclencheur. Les workflows dont le déclencheur n’apporte pas de mail sont refusés à la validation ; à l’exécution, l’étape échoue avec node_missing_email.
  • Les nouvelles tentatives sont sûres. L’opération est indexée sur l’étape : retenter l’étape ne l’applique pas deux fois. Un échec d’enregistrement de l’opération est retenté (node_service_failed).
  • Essais. En essai, le mail n’est pas touché ; le détail d’exécution indique quels labels auraient été posés ou retirés. Voir Boîtes mail pour la façon dont le miroir applique les modifications.