Mankomail

Déposer dans OneDrive ​

Dépose les pièces jointes (du mail ou ajoutées par une étape) — ou un texte — dans un dossier de votre OneDrive.

Ce nœud dépose des fichiers dans le OneDrive du membre qui exécute le workflow : les pièces jointes de l’exécution (celles du mail déclencheur et les fichiers ajoutés par des étapes précédentes), ou un texte que vous écrivez (un compte rendu, un résumé, un CSV).

Il exige l’accès OneDrive d’un compte Microsoft, affiché comme la capacité Fichiers dans Connexions (bouton « Connecter OneDrive »). Voir Microsoft. Cet accès couvre uniquement le OneDrive du membre ; un site d’équipe SharePoint demande le nœud SharePoint.

Créez d’abord la destination avec Créer un dossier OneDrive, et retrouvez des fichiers existants avec Chercher dans OneDrive. Pour Google Drive, utilisez Drive — déposer un fichier.

En bref ​

  • Type : onedrive.upload · 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 : Microsoft (capacité files)
  • Entrées : main
  • Sorties : main

Connexion ​

Ce nœud exige une connexion Microsoft avec la capacité files accordée.

Paramètres ​

credential ​

Compte Microsoft — Le compte dont on utilise le OneDrive. Connectez-le depuis Connexions ; le jeton est résolu par le serveur et n’apparaît nulle part.

  • Type : Connexion (credential)
  • Requis : Non
  • Défaut : "" (vide)

source ​

Ce qu’on dépose

  • Type : Un choix (options)
  • Requis : Oui
  • Défaut : attachment
  • Options :
    • attachment — Les pièces jointes : Celles du mail et les fichiers ajoutés par une étape précédente, déposés tels quels — le cas « archive la facture ».
    • text — Un texte : Un contenu que vous écrivez (accepte des expressions {{ }}) : un compte rendu, un résumé, un CSV.

selection ​

Pièces jointes retenues

  • Type : Un choix (options)
  • Requis : Oui
  • Défaut : all
  • Options :
    • all — Toutes les pièces jointes : Celles du mail déclencheur, puis les fichiers ajoutés par les étapes précédentes (un acte rapatrié, un PDF signé), dans cet ordre.
    • first — La première seulement : La première PJ, quand on sait qu’il n’y en a qu’une qui compte.
    • byMime — Par type de fichier : Par type MIME : application/pdf, ou toute une famille avec image/*.
    • byName — Par nom de fichier : Par motif sur le nom : *.pdf, facture-*.
  • Affiché quand : source vaut attachment

mime ​

Type de fichier — Type MIME exact (application/pdf) ou famille entière (image/*). Laissé vide, aucune PJ n’est retenue.

  • Type : Texte (string)
  • Requis : Non
  • Défaut : "" (vide)
  • 200 caractères au plus
  • Exemple : application/pdf
  • Affiché quand : source vaut attachment et selection vaut byMime
  • Expressions : {{ }} accepté

namePattern ​

Nom du fichier — Motif simple : * remplace n’importe quoi, ? un caractère (*.pdf, facture-*). La casse est ignorée.

  • Type : Texte (string)
  • Requis : Non
  • Défaut : "" (vide)
  • 200 caractères au plus
  • Exemple : *.pdf
  • Affiché quand : source vaut attachment et selection vaut byName
  • Expressions : {{ }} accepté

text ​

Contenu — Le texte du fichier. Accepte des expressions {{ }} : {{ data.summarize_1.summary }}, {{ email.subject }}.

  • Type : Texte long (text)
  • Requis : Non
  • Défaut : "" (vide)
  • 200000 caractères au plus
  • Affiché quand : source vaut text
  • Expressions : {{ }} accepté

fileName ​

Nom du fichier — Extension comprise. Laissé vide avec des pièces jointes, chacune garde son nom ; rempli, il ne s’applique que si une seule PJ est retenue.

  • Type : Texte (string)
  • Requis : Non
  • Défaut : "" (vide)
  • 255 caractères au plus
  • Exemple : facture-{{ email.from.email }}.pdf
  • Expressions : {{ }} accepté

folder ​

Dossier de destination — Laissé vide : la racine de votre OneDrive. Vous pouvez choisir dans la liste, coller un identifiant ou une URL OneDrive.

  • Type : Ressource distante (resourceLocator)
  • Requis : Non
  • Défaut : {"mode":"id","value":""}
  • Façons de choisir : dans une liste, saisir un identifiant, coller une URL (onedrive.folder)
  • Listé avec la connexion de : credential

onConflict ​

Si le nom existe déjà

  • Type : Un choix (options)
  • Requis : Oui
  • Défaut : rename
  • Options :
    • rename — Garder les deux : OneDrive numérote le nouveau (facture 1.pdf). Rien n’est perdu.
    • skip — Ne rien faire : Le fichier déjà en place est rendu tel quel, sans être réécrit.
    • replace — Remplacer : Le contenu écrase celui du fichier existant (son historique OneDrive le garde).

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>.files }} — array of { id, name, mime, size, webUrl, folderId }. Une entrée par fichier traité, dans l’ordre : le fichier écrit, ou le fichier déjà en place quand il a été réutilisé ou laissé tel quel. id est l’identifiant de l’élément OneDrive, webUrl le lien qui l’ouvre dans OneDrive, folderId l’identifiant du dossier parent (vide pour la racine), size sa taille en octets.
  • {{ data.<step>.files.0.webUrl }} — string. Le lien OneDrive du premier fichier, prêt à coller dans un mail. Vide en essai.
  • {{ data.<step>.count }} — number. Le nombre d’entrées de files.
  • {{ data.<step>.reused }} — array of string. Les noms des fichiers qu’une nouvelle tentative a retrouvés, déjà déposés par une tentative précédente de l’étape : rien n’a été réécrit.
  • {{ data.<step>.skipped }} — array of string. Avec « Si le nom existe déjà » sur « Ne rien faire » : les noms déjà pris. Le fichier existant n’a pas été touché et c’est lui qui figure dans files.
  • {{ data.<step>.attachments }} — array of { position, filename, mime, size, origin, addedByNodeId?, integration? }. Avec « Ce qu’on dépose » sur « Les pièces jointes » : la provenance de chaque pièce déposée. origin vaut email (le mail déclencheur) ou added (un fichier ajouté par une étape précédente). Vide pour un texte.
  • {{ data.<step>.summary }} — string. Une phrase lisible qui liste les fichiers déposés, avec ceux réutilisés ou laissés en place.
  • {{ data.<step>.simulated }} — boolean. true quand l’étape s’est jouée en essai et que l’écriture n’a été que décrite — le même champ que sur les nœuds Google et Outlook. Toujours false pour une lecture.

Exemple ​

Les devis signés reviennent par mail en PDF et sont classés dans le dossier du client. Une étape Créer un dossier OneDrive nommée Dossier client s’exécute d’abord. Le nœud s’appelle Classer le devis :

source: attachment
selection: byName
namePattern: *.pdf
fileName: Devis signé {{ email.from.name }}.pdf
folder: (mode identifiant) {{ data.dossier_client.folder.id }}
onConflict: rename

Pour un mail qui porte un seul PDF, les données de l’étape sont :

json
{
  "files": [
    {
      "id": "01ABCDEF…",
      "name": "Devis signé Jeanne Martin.pdf",
      "mime": "application/pdf",
      "size": 182044,
      "webUrl": "https://contoso-my.sharepoint.com/personal/…/Devis%20sign%C3%A9%20Jeanne%20Martin.pdf",
      "folderId": "01XYZ…"
    }
  ],
  "count": 1,
  "reused": [],
  "skipped": [],
  "attachments": [
    { "position": 1, "filename": "devis-2026-031.pdf", "mime": "application/pdf", "size": 182044, "origin": "email" }
  ]
}

Conseils ​

  • Conflits de nom et rejeux. « Garder les deux » (rename, le défaut) laisse OneDrive numéroter le nouveau fichier (facture 1.pdf). « Ne rien faire » (skip) rend le fichier déjà en place sans le réécrire et inscrit son nom dans skipped. « Remplacer » (replace) écrase le contenu ; OneDrive garde la version précédente dans son historique. Une nouvelle tentative de l’étape ne duplique jamais un fichier avec « Remplacer » ou « Ne rien faire ». Avec « Garder les deux », le nœud marque chaque fichier déposé pour qu’une nouvelle tentative le retrouve (il figure alors dans reused) ; certains tenants professionnels refusent cette marque, et chez eux une nouvelle tentative en mode « Garder les deux » peut créer une copie numérotée.
  • Nom du fichier. Extension comprise. Laissé vide avec des pièces jointes, chaque fichier garde son nom. Rempli, il ne s’applique que si une seule pièce jointe est retenue ; avec plusieurs, il est ignoré et chacune garde son nom. Avec « Un texte », « Nom du fichier » est obligatoire (node_invalid_param sinon) et le type du fichier suit son extension (.csv, .json, .md, .html, .xml, .txt ; toute autre extension est déposée en texte brut).
  • Bornes. Au plus 20 pièces jointes par étape, et 100 Mo par fichier. Si aucune pièce jointe ne correspond à la sélection, l’étape échoue avec node_nothing_to_do.
  • Dossier de destination. Laissé vide, la racine du OneDrive. Choisissez-le dans la liste, saisissez un identifiant d’élément, ou collez une URL OneDrive : un lien onedrive.live.com portant ?id=, ou une URL de dossier OneDrive professionnel (…-my.sharepoint.com/personal/…/Documents/Clients/Acme ou une page onedrive.aspx?id=…). Un lien de partage (…/:f:/…) ne peut pas être résolu et échoue avec microsoft.rejected : utilisez plutôt la liste.
  • Essais. En essai, rien n’est déposé : chaque entrée de files porte le nom qu’elle aurait eu, un identifiant qui commence par simulated: et un webUrl vide. Le détail d’exécution liste le dépôt parmi ce qui aurait été fait.
  • Erreurs. credential.capability_missing : OneDrive n’est pas connecté pour le membre qui exécute le workflow ; connectez-le dans Connexions. microsoft.access_denied ou microsoft.auth_failed : l’accès a été révoqué ou refusé ; reconnectez le compte. microsoft.not_found : le dossier n’existe plus. microsoft.storage_full : le OneDrive est plein (définitif). microsoft.locked (un fichier en cours d’édition par quelqu’un) et microsoft.unavailable (limitation de débit, panne) sont retentés automatiquement. Voir Gestion des erreurs.