Niveau de codage: intermédiaire
Durée: 15 minutes
Type de projet: automatisation avec un déclencheur temporel
Objectifs
- Comprendre ce que fait la solution.
- Découvrez le rôle des services Apps Script dans la solution.
- Configurez le script.
- Exécutez le script.
À propos de cette solution
Importez automatiquement les données de fichiers CSV dans une feuille de calcul Google Sheets. Si vous travaillez avec plusieurs fichiers CSV ayant une structure similaire, vous pouvez utiliser cette solution pour centraliser les données dans Sheets.
Comment ça marche ?
Le script s'exécute quotidiennement sur un déclencheur basé sur l'heure. Il parcourt les fichiers CSV dans un dossier désigné et ajoute les données de chaque fichier à une feuille de calcul. Par défaut, le script supprime la ligne d'en-tête de chaque ensemble de données CSV avant d'ajouter les données à la dernière ligne de la feuille. Le script envoie un e-mail récapitulatif répertoriant les fichiers importés et les déplace vers un autre dossier pour éviter les doublons.
Le script inclut également des fonctions qui configurent des exemples de fichiers CSV pour présenter cette solution.
Services Apps Script
Cette solution utilise les services suivants:
- Service de script : crée le déclencheur temporel.
- Service Drive : récupère les dossiers que le script utilise pour stocker les fichiers CSV traités et non traités, et les crée s'ils n'existent pas. Récupère l'URL du projet Apps Script à inclure dans l'e-mail récapitulatif.
- Service Feuille de calcul : obtient la feuille de calcul dans laquelle le script ajoute les données de chaque fichier CSV.
- Service de base : utilise la classe
Session
pour obtenir l'adresse e-mail de l'utilisateur et le fuseau horaire du script.- Le choix de l'utilisateur dépend de la personne qui exécute le script. Étant donné que le script s'exécute sur un déclencheur basé sur le temps, l'utilisateur est défini comme la personne qui a créé le déclencheur.
- Le script utilise ce fuseau horaire pour ajouter la date et l'heure d'exécution du script à l'e-mail récapitulatif.
- Service Utilitaires (Service utilitaires) : analyse chaque fichier CSV dans un tableau. Met en forme la date à laquelle le script ajoute à l'e-mail récapitulatif.
- Service de messagerie : envoie l'e-mail récapitulatif une fois que les données des fichiers CSV ont été importées dans la feuille de calcul.
Prérequis
Pour utiliser cet exemple, vous devez remplir les conditions préalables suivantes:
- Un compte Google (les comptes Google Workspace peuvent nécessiter l'approbation d'un administrateur)
- Un navigateur Web avec accès à Internet.
Configurer le script
- Cliquez sur le bouton suivant pour ouvrir le projet Apps Script Import CSV data (Importer des données CSV).
Ouvrir le projet - Cliquez sur Vue d'ensemble .
- Sur la page "Vue d'ensemble", cliquez sur Créer une copie .
Exécuter le script
- Dans le projet Apps Script copié, accédez au fichier SetupSample.gs.
- Dans le menu déroulant des fonctions, sélectionnez setupSample et cliquez sur Run (Exécuter). Cette fonction crée le déclencheur temporel, les fichiers CSV, la feuille de calcul et le dossier que le script utilise pour s'exécuter correctement.
Lorsque vous y êtes invité, autorisez le script. Si l'écran de consentement OAuth affiche l'avertissement Cette application n'est pas validée, continuez en sélectionnant Paramètres avancés > Accéder à {Project Name} (non sécurisé).
Pour afficher le déclencheur temporel une fois la configuration terminée, cliquez sur Déclencheurs
.Pour afficher les fichiers créés, ouvrez le dossier [Exemple Apps Script] Importer des fichiers CSV dans Google Drive.
Revenez au projet Apps Script et, dans l'éditeur, accédez au fichier Code.gs.
Dans le menu déroulant des fonctions, sélectionnez updateApplicationSheet, puis cliquez sur Exécuter.
Pour afficher l'e-mail récapitulatif contenant un lien vers la feuille de calcul contenant les données importées, consultez votre boîte de réception.
(Facultatif) Réinitialiser la solution
Vous pouvez réinitialiser la solution pour la mettre à jour avec vos propres données ou relancer la démonstration.
- Dans le projet Apps Script, accédez au fichier SetupSample.gs.
- Dans le menu déroulant des fonctions, sélectionnez removeSample et cliquez sur Run (Exécuter). Cette fonction supprime le déclencheur, les fichiers et le dossier créés dans la section précédente.
Examiner le code
Pour examiner le code Apps Script de cette solution, cliquez sur Afficher le code source ci-dessous:
Afficher le code source
Code.gs
SampleData.gs
SetupSample.gs
Utilities.gs
Contributeurs
Cet échantillon est géré par Google avec l'aide d'Experts Google Developers.