Mankomail

Chercher dans OneDrive ​

Cherche des fichiers dans votre OneDrive et verse la liste dans les données de travail.

Ce nœud cherche dans le OneDrive du membre qui exécute le workflow et verse la liste des résultats dans les données de travail : pour vérifier qu’un document est déjà classé, pour y faire un lien dans une réponse, ou pour parcourir le contenu d’un dossier.

Il exige l’accès OneDrive d’un compte Microsoft, affiché comme la capacité Fichiers dans Connexions. Voir Microsoft. Contrairement à Google Drive, cet accès couvre tout le OneDrive du membre, pas seulement les fichiers créés par l’application.

Pour déposer des fichiers, utilisez Déposer dans OneDrive. Pour une bibliothèque SharePoint, utilisez le nœud SharePoint (ressource « Fichier », action « Chercher »).

En bref ​

  • Type : onedrive.search · version 1
  • Catégorie : Actions
  • 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 : 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)

query ​

Recherche — Le texte cherché dans le nom et le contenu. Laissé vide avec un dossier choisi, la liste rend le contenu du dossier.

  • Type : Texte (string)
  • Requis : Non
  • Défaut : "" (vide)
  • 500 caractères au plus
  • Exemple : devis 2026
  • Expressions : {{ }} accepté

folder ​

Dossier — Restreint la recherche à ce dossier et à ses sous-dossiers. Laissé vide : tout le 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

limit ​

Nombre maximum de résultats

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

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 }. Les fichiers et dossiers trouvés. id est l’identifiant de l’élément OneDrive, mime son type MIME (inode/directory pour un dossier), size sa taille en octets (0 pour un dossier), webUrl le lien qui l’ouvre dans OneDrive, folderId l’identifiant de son dossier parent.
  • {{ data.<step>.files.0.webUrl }} — string. Le lien OneDrive du premier résultat.
  • {{ data.<step>.count }} — number. Le nombre de résultats. 0 quand rien ne correspond.
  • {{ data.<step>.summary }} — string. Une phrase lisible qui donne le nombre de résultats et les premiers noms.

Exemple ​

Un client demande « le dernier devis ». Le nœud s’appelle Chercher le devis :

query: devis {{ email.from.name }}
folder: (mode liste) Clients
limit: 5

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
}

Une étape Rédiger peut ensuite citer {{ data.chercher_le_devis.files.0.webUrl }}.

Conseils ​

  • Ce qui est cherché. La recherche porte sur le nom et le contenu des fichiers. Avec un « Dossier », elle se limite à ce dossier et à ses sous-dossiers ; laissé vide, elle couvre tout le OneDrive.
  • Lister un dossier. Avec « Recherche » vide et un « Dossier » choisi, le nœud rend le contenu direct du dossier (fichiers et sous-dossiers). Laisser les deux vides échoue avec node_invalid_param.
  • Dossier. Choisissez-le dans la liste, saisissez un identifiant d’élément ou collez une URL de dossier OneDrive (un lien onedrive.live.com avec ?id=, ou une URL de dossier OneDrive professionnel). Les liens de partage ne peuvent pas être résolus et échouent avec microsoft.rejected.
  • Nombre maximum de résultats. Entre 1 et 100, 20 par défaut.
  • Essais. Une recherche est une lecture : en essai, elle interroge réellement OneDrive et rend les vrais fichiers.
  • 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 n’existe pas. microsoft.unavailable est retenté automatiquement. Voir Gestion des erreurs.