Mankomail

Créer un dossier OneDrive ​

Crée un dossier s’il n’existe pas déjà — une nouvelle tentative ne crée pas de doublon.

Ce nœud garantit qu’un dossier existe dans le OneDrive du membre qui exécute le workflow et rend son identifiant : il le crée, sauf si un dossier du même nom existe déjà dans le parent. Utilisez-le pour préparer une destination par client, par projet ou par mois avant Déposer dans OneDrive.

Il exige l’accès OneDrive d’un compte Microsoft, affiché comme la capacité Fichiers dans Connexions. Voir Microsoft. Pour un dossier dans une bibliothèque SharePoint, utilisez le nœud SharePoint (ressource « Dossier »).

En bref ​

  • Type : onedrive.create_folder · 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)

parent ​

Dossier parent — Où créer le dossier. Laissé vide : la racine de votre 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

name ​

Nom du dossier — Accepte des expressions {{ }} : Clients/{{ email.from.email }} n’est pas une arborescence, c’est un seul nom.

  • Type : Texte (string)
  • Requis : Oui
  • Défaut : "" (vide)
  • 255 caractères au plus
  • Exemple : Devis {{ email.from.name }}
  • Expressions : {{ }} accepté

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>.folder }} — object { id, name, mime, size, webUrl, folderId }. Le dossier créé, ou celui qui existait déjà sous ce nom. mime vaut inode/directory, size vaut 0, webUrl est le lien qui l’ouvre dans OneDrive, folderId l’identifiant de son parent (vide pour la racine).
  • {{ data.<step>.folder.id }} — string. L’identifiant du dossier, à brancher dans le champ dossier d’une étape OneDrive suivante (mode identifiant).
  • {{ data.<step>.created }} — boolean. true quand cette étape a créé le dossier, false quand un dossier de ce nom existait déjà dans le parent et a été réutilisé.
  • {{ data.<step>.summary }} — string. Une phrase lisible qui dit si le dossier a été créé ou s’il existait déjà.
  • {{ 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 ​

Chaque nouveau client reçoit un dossier sous Clients. Le nœud s’appelle Dossier client :

parent: (mode liste) Clients
name: {{ email.from.name }}

Le premier mail de Jeanne Martin crée le dossier :

json
{
  "folder": {
    "id": "01XYZ…",
    "name": "Jeanne Martin",
    "mime": "inode/directory",
    "size": 0,
    "webUrl": "https://contoso-my.sharepoint.com/personal/…/Clients/Jeanne%20Martin",
    "folderId": "01PARENT…"
  },
  "created": true
}

Les mails suivants retrouvent le même dossier avec created: false, et l’étape de dépôt utilise {{ data.dossier_client.folder.id }}.

Conseils ​

  • Nouvelle tentative sûre. La correspondance porte sur le nom exact du dossier dans le parent : une nouvelle tentative de l’étape, ou une autre exécution qui demande le même nom, réutilise le dossier au lieu d’en créer une copie numérotée.
  • Un nom, pas un chemin. « Nom du dossier » est un nom unique : Clients/{{ email.from.email }} ne crée pas deux niveaux. Enchaînez deux étapes pour construire une arborescence.
  • Dossier parent. Laissé vide, la racine du OneDrive. Choisissez-le dans la liste, saisissez un identifiant d’élément ou collez une URL de dossier OneDrive ; les liens de partage ne peuvent pas être résolus et échouent avec microsoft.rejected.
  • Essais. En essai, rien n’est créé : l’étape rend un dossier dont l’identifiant commence par simulated:, avec un webUrl vide et created: true.
  • Erreurs. credential.capability_missing : OneDrive n’est pas connecté pour le membre qui exécute le workflow. microsoft.access_denied : reconnectez le compte. microsoft.not_found : le dossier parent n’existe pas. microsoft.rejected : OneDrive a refusé le nom. microsoft.unavailable est retenté automatiquement. Voir Gestion des erreurs.