Mankomail

Drive — chercher des fichiers ​

Cherche des fichiers dans Google Drive et verse la liste dans les données de travail. C’est une lecture : elle a lieu pour de vrai, même pendant un essai.

Ce nœud cherche dans Google Drive et verse la liste des fichiers correspondants dans les données de travail, par exemple pour vérifier qu’un document est déjà classé, pour y faire un lien dans une réponse, ou pour parcourir un dossier avec une Boucle.

Il exige l’accès Google Drive d’un compte Google, affiché comme la capacité Fichiers dans Connexions. Voir Google. La recherche s’exécute avec le compte du membre qui fait tourner le workflow.

L’accès demandé est drive.file : l’application ne voit que les fichiers et dossiers qu’elle a créés elle-même, par exemple avec Drive — déposer un fichier ou Drive — créer un dossier. Les fichiers posés à la main dans Drive n’apparaissent pas dans les résultats.

En bref ​

  • Type : google_drive.search · 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 : Google (capacité drive)
  • Entrées : main
  • Sorties : main

Connexion ​

Ce nœud exige une connexion Google avec la capacité drive accordée.

Paramètres ​

credential ​

Compte Google — Le compte qui porte l’accès Google Drive. Il se connecte une fois dans Connexions ; le workflow s’exécute toujours avec le compte du membre qui le fait tourner.

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

query ​

Le nom contient — Accepte des expressions {{ }}. Laissé vide, tous les fichiers du dossier remontent.

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

folder ​

Dans le dossier — Laissé vide, la recherche porte sur tout ce que l’application peut voir.

  • Type : Ressource distante (resourceLocator)
  • Requis : Non
  • Façons de choisir : dans une liste, saisir un identifiant, coller une URL (drive.folder)
  • Listé avec la connexion de : credential

mimeType ​

Type de fichier — Type MIME exact (application/pdf). Laissé vide, aucun filtre de type.

  • Type : Texte (string)
  • Requis : Non
  • Défaut : "" (vide)
  • 200 caractères au plus
  • Exemple : application/pdf
  • Expressions : {{ }} accepté

limit ​

Nombre de résultats

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

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?, webViewLink?, folderId? }. Les fichiers trouvés, le plus récemment modifié en premier. id est l’identifiant du fichier Drive, mime son type MIME (application/vnd.google-apps.folder pour un dossier), webViewLink le lien qui l’ouvre dans Google Drive, folderId l’identifiant de son dossier parent, size sa taille en octets quand Google la donne.
  • {{ data.<step>.files.0.id }} — string. L’identifiant du fichier trouvé le plus récemment modifié.
  • {{ data.<step>.count }} — number. Le nombre de fichiers trouvés. 0 quand rien ne correspond.
  • {{ data.<step>.summary }} — string. Une phrase lisible qui donne le nombre de fichiers trouvés.

Exemple ​

Avant de classer une facture, un workflow vérifie si un fichier portant la même référence est déjà dans le dossier du fournisseur. Le nœud s’appelle Chercher la facture :

query: {{ data.extraire.reference }}
folder: (mode identifiant) {{ data.dossier_fournisseur.folder.id }}
mimeType: application/pdf
limit: 5

Les données de l’étape sont :

json
{
  "files": [
    {
      "id": "1Hc9…",
      "name": "facture-0412.pdf",
      "mime": "application/pdf",
      "size": 48213,
      "webViewLink": "https://drive.google.com/file/d/1Hc9…/view",
      "folderId": "1TxK9…"
    }
  ],
  "count": 1
}

Une Condition (Si) sur {{ data.chercher_la_facture.count }} décide ensuite du dépôt.

Conseils ​

  • Correspondance. « Le nom contient » cherche une partie du nom de fichier (le name contains de Drive). Laissé vide, tous les fichiers que les autres filtres laissent passer remontent. « Type de fichier » est un type MIME exact (application/pdf) ; laissé vide, aucun filtre de type. Les fichiers à la corbeille ne remontent jamais.
  • Dossier. « Dans le dossier » ne regarde que les enfants directs du dossier, pas ses sous-dossiers. Laissé vide, la recherche porte sur tout ce que l’application peut voir. Le dossier se choisit dans la liste, se saisit par identifiant ou se colle sous forme d’URL de dossier Drive.
  • Nombre de résultats. Entre 1 et 50, 20 par défaut.
  • Essais. Une recherche est une lecture : en essai, elle interroge réellement Google Drive et rend les vrais fichiers.
  • Erreurs. credential.capability_missing : Google Drive n’est pas connecté pour le membre qui exécute le workflow. google.not_found : le dossier n’existe pas ou l’application ne peut pas le voir. google.bad_locator : la valeur de dossier collée n’est ni un identifiant ni une URL Drive reconnue. google.unavailable est retenté automatiquement. Voir Gestion des erreurs.