Exemple d'utilisation de l'action Trouver un fichier/dossier du package Google Drive

Créez un robot qui recherche un fichier dans Google Drive et le crée s'il n'existe pas dans le chemin spécifié.

Prérequis

Supposons que vous souhaitiez créer une feuille Google qui n'existe pas dans Google Drive. Vous pouvez utiliser l'action Google Drive > Trouver un fichier/dossier du package Google Drive pour vérifier s'il existe déjà un fichier dans Google Drive. S'il n'existe pas, vous pouvez créer le fichier à l'aide de l'action Créer un classeur du package Google Sheets.

Ce robot recherche une feuille Google dans Google Drive. Si elle n'existe pas dans le chemin spécifié, le robot crée une feuille Google et y copie les données d'un fichier CSV.

Procédure

  1. Créez un nouveau robot.
    1. Dans le panneau de gauche, cliquez sur Automatisation.
    2. Cliquez sur Créer un nouveau > Robot de tâches.
    3. Dans la fenêtre Créer un robot de tâches, donnez un nom au robot.
    4. Acceptez l'emplacement du dossier par défaut : \Bots\
    5. Pour modifier l'emplacement de stockage par défaut du robot, cliquez sur Choisir et suivez les invites.
    6. Cliquez sur Créer et modifier.
  2. Ouvrez le fichier CSV contenant les données que vous souhaitez copier dans une feuille Google.
    1. Dans le panneau Actions, recherchez l'action CSV/TXT > Ouvrir et ajoutez-la à l'Éditeur de robots.
    2. Dans le champ Nom de session, saisissez csvsession.
    3. Dans Chemin de fichier, indiquez le chemin d'accès au fichier CSV à partir duquel les données doivent être copiées.
    4. Si le tableau CSV comporte un en-tête, sélectionnez Contient un en-tête.
    5. Sélectionnez un délimiteur en fonction de celui utilisé dans le fichier CSV.
    6. Enregistrez les modifications.
  3. Lisez les données du fichier CSV et stockez-les dans une variable de tableau de données.
    1. Dans le panneau Actions, recherchez l'action CSV/TXT > Lire et ajoutez-la à l'Éditeur de robots.
    2. Dans le champ Nom de session, saisissez csvsession.
    3. Dans Attribuer une valeur à la variable, cliquez sur (x) et créez une variable nommée TableFromCSV.
    4. Enregistrez les modifications.
  4. Fermez le fichier CSV.
    1. Dans le panneau Actions, recherchez l'action CSV/TXT > Fermer et ajoutez-la à l'Éditeur de robots.
    2. Dans le champ Nom de session, saisissez csvsession.
    3. Enregistrez les modifications.
  5. Connectez-vous à Google Drive.
    1. Dans le panneau Actions, recherchez l'action Google Drive > Se connecter et ajoutez-la à l'Éditeur de robots.
    2. Dans Nom d'utilisateur, sélectionnez Chaîne non sécurisée, puis saisissez l'identifiant de messagerie associé à la connexion OAuth que vous avez configurée.
    3. Dans Mode d'authentification OAuth2, sélectionnez Géré par la Control Room.
    4. Cliquez sur Choisir et sélectionnez la connexion que vous avez configurée dans la Control Room.
    5. Enregistrez les modifications.
  6. Connectez-vous à Google Sheets.
    1. Dans le panneau Actions, recherchez l'action Google Sheets > Se connecter et ajoutez-la à l'Éditeur de robots.
    2. Dans Nom d'utilisateur, sélectionnez Chaîne non sécurisée, puis saisissez l'identifiant de messagerie associé à la connexion OAuth que vous avez configurée.
    3. Dans le champ Nom de session, saisissez gsheetsession.
    4. Dans Mode d'authentification OAuth2, sélectionnez Géré par la Control Room.
    5. Cliquez sur Choisir et sélectionnez la connexion que vous avez configurée dans la Control Room.
    6. Enregistrez les modifications.
  7. Avant de créer une nouvelle feuille dans Google Drive, vérifiez si le fichier que vous tentez de créer existe déjà. Créez le fichier uniquement s'il n'existe pas au chemin spécifié. Pour ce faire, utilisez les actions Essayer/Capturer.
    1. Dans le panneau Actions, recherchez l'action Gestionnaire d'erreur > Essayer et ajoutez-la à l'Éditeur de robots.
    2. Enregistrez les modifications.
  8. Pour vérifier si le fichier existe, utilisez l'action Trouver un fichier/dossier de Google Drive.
    1. Dans le panneau Actions, recherchez l'action Google Drive > Trouver un fichier/dossier et ajoutez-la au bloc Essayer.
    2. Dans Nom d'utilisateur, sélectionnez Chaîne non sécurisée, puis saisissez l'identifiant de messagerie associé à la connexion OAuth.
    3. Dans Rechercher, cliquez sur Fichier.
    4. Dans Chemin du dossier source, saisissez le dossier source. Dans cet exemple, le robot recherche le fichier dans le chemin aa-docs/spreadsheets.
    5. Dans Type de correspondance, sélectionnez Correspond exactement.
    6. Dans Nom du dossier/du fichier, saisissez contacts.
    7. Dans Renvoie la liste des fichiers ou des dossiers, sélectionnez Dictionnaire.
    8. Cliquez sur (x), puis créez une variable de dictionnaire nommée FileFolderDictionary dont le sous-type est N'importe lequel.
    9. Enregistrez les modifications.
  9. Si le fichier n'existe pas, créez-le.
    1. Dans le panneau Actions, recherchez l'action Google Sheets > Créer un classeur et ajoutez-la au bloc Capturer.
    2. Dans Nom d'utilisateur, sélectionnez Chaîne non sécurisée, puis saisissez l'identifiant de messagerie associé à la connexion OAuth.
    3. Dans le champ Nom de session, saisissez gsheetsession.
    4. Dans Nom du classeur, saisissez contacts.
    5. Dans Chemin de fichier, cliquez sur Depuis mon emplacement partagé et saisissez le chemin du dossier parent. Par exemple, dans ce scénario, le robot recherche le fichier dans le chemin aa-docs/spreadsheets.
    6. Enregistrez les modifications.
  10. Pour ouvrir un tableur à partir de Google Drive, vous devez disposer de son identifiant de fichier ou du chemin de fichier. Étant donné que ce robot crée le fichier de manière dynamique, vous ne disposez pas du chemin de fichier avant l'exécution du robot. Vous pouvez néanmoins obtenir l'identifiant de fichier en utilisant à nouveau l'action Trouver un fichier/dossier de Google Drive.
    1. Dans le panneau Actions, recherchez l'action Google Drive > Trouver un fichier/dossier et ajoutez-la après les blocs Essayer/Capturer.
    2. Dans Nom d'utilisateur, sélectionnez Chaîne non sécurisée, puis saisissez l'identifiant de messagerie associé à la connexion OAuth.
    3. Dans Rechercher, cliquez sur Fichier.
    4. Dans Chemin du dossier source, saisissez le dossier source. Dans cet exemple, ce robot recherche le fichier dans le chemin aa-docs/spreadsheets.
    5. Dans Type de correspondance, sélectionnez Correspond exactement.
    6. Dans Nom du dossier/du fichier, saisissez contacts.
    7. Dans Renvoie la liste des fichiers ou des dossiers, cliquez sur Dictionnaire et sélectionnez la variable FileFolderDictionary.
      L'API Trouver un fichier/dossier renvoie un dictionnaire contenant des informations sur les fichiers correspondants. Le dictionnaire contient une clé appelée NumberOfFiles. Celle-ci indique le nombre de fichiers correspondants. Le dictionnaire contient également des clés nommées File1, File2, et ainsi de suite, en fonction du nombre de fichiers correspondants. Ces clés contiennent des informations, telles que les noms et les identifiants des fichiers, au format JSON. Voici un exemple de dictionnaire renvoyé par l'appel de l'API Trouver un fichier/dossier :
      {NumberOfFiles,1},{File1,{"fileName":"contacts","fileId":"171yBUzqH80ZW_KLEp23DwebzkCdDZgnGFWBzB6K9kco"}}
      Vous pouvez récupérer l'identifiant de fichier en analysant la chaîne JSON, qui est la valeur associée à la clé File1.
    8. Enregistrez les modifications.
  11. Analysez la chaîne JSON associée à la clé File1.
    1. Dans le panneau Actions, recherchez et ajoutez l'action Json > Démarrer une session.
    2. Dans Source de données, sélectionnez Texte et saisissez $FileFolderDictionary{File1}$.
    3. Dans Session d'objet JSON, cliquez sur Session locale et saisissez jsonsession.
    4. Enregistrez les modifications.
  12. Récupérez l'identifiant de fichier à partir de l'objet JSON.
    1. Dans le panneau Actions, recherchez et ajoutez l'action Json > Obtenir la valeur du nœud.
    2. Dans Clé ou chemin du nœud JSON, saisissez fileId.
    3. Dans le champ Nom de session, saisissez jsonsession.
    4. Dans Enregistrer le résultat dans une variable, cliquez sur (x) et créez une variable nommée FileId.
    5. Enregistrez les modifications.
  13. Mettez fin à la session JSON.
    1. Dans le panneau Actions, recherchez et ajoutez l'action Json > Terminer une session.
    2. Dans le champ Nom de session, saisissez jsonsession.
    3. Enregistrez les modifications.
  14. Une fois l'identifiant de fichier récupéré, ouvrez le tableur créé dans Google Drive.
    1. Dans le panneau Actions, recherchez et ajoutez l'action Google Sheets > Ouvrir le tableur.
    2. Dans Nom d'utilisateur, sélectionnez Chaîne non sécurisée, puis saisissez l'identifiant de messagerie associé à la connexion OAuth.
    3. Dans Nom de session, saisissez gsheetsession.
    4. Dans Ouvrir la feuille, cliquez sur À partir de l'identifiant du tableur et saisissez $FileId$.
    5. Enregistrez les modifications.
  15. Inscrivez la variable de tableau de données dans la feuille Google.
    1. Dans le panneau Actions, recherchez et ajoutez l'action Google Sheets > Écrire à partir du tableau de données.
    2. Dans Nom de session, saisissez gsheetsession.
    3. Dans Options de feuille, cliquez sur Feuille spécifique et saisissez Sheet1 ou le nom de la feuille de votre tableur cible dans Nom de la feuille.
    4. Dans Entrer une variable de tableau de données, sélectionnez TableFromCSV.
    5. Dans Valeur de la cellule de départ, saisissez A1.
    6. Enregistrez les modifications.
  16. Déconnectez Google Drive et Google Sheets.
    1. Dans le panneau Actions, recherchez et ajoutez l'action Google Drive > Déconnecter.
    2. Dans Nom d'utilisateur, sélectionnez Chaîne non sécurisée, puis saisissez l'identifiant de messagerie associé à la connexion OAuth.
    3. Enregistrez les modifications.
    4. Dans le panneau Actions, recherchez et ajoutez l'action Google Sheets > Déconnecter.
    5. Dans Nom d'utilisateur, sélectionnez Chaîne non sécurisée, puis saisissez l'identifiant de messagerie associé à la connexion OAuth.
    6. Dans Nom de session, saisissez gsheetsession.
    7. Enregistrez les modifications.
  17. Exécutez le robot.