Accès

L'accès à l'outil de développement se fait :

• Via le drive

• Via l' Éditeur de script d'un document

Pour créer un fichier :

• Cliquez sur la catégorie Fichiers (nous utiliserons des fichiers de type Script dans une premier temps)

• Un nom de fichier vous est demandé

• Une fois le nom du fichier renseigné, il est affiché dans l'arborescence des fichiers (par exemple le fichier D&F.gs a été créé et va contenir des fonctions)

• Un fichier non enregistré : lorsque vous effectuez une modification sur un fichier, l'entête de ce dernier possède un point à gauche de son nom

Sélection & exécution d'une fonction

Pour exécuter une fonction directement depuis l'interface de GAS, vous devez la sélectionner puis lancer son exécution via l'icone Exécuter

Afficher les journaux

Utiles pour trouver les bugs, les journaux recensent les erreurs d'exécution du fichier ainsi que les valeurs des variables passées en paramètre de la fonction Logger.log(). Pour les afficher, cliquer sur le menu Afficher/Journaux

Si le code contient une erreur, le journal remonte alors cette erreur avec la ligne posant problème

Comme vu précédemment, les journaux sont des outils pour trouver & corriger les bugs.

Leur accès se fait depuis l'interface de développement via le menu Exécutions

Debug : Browser.msgBox(parametre)

Uniquement si le script est de type Container, cette fonction permet d'afficher, depuis le document, une popup avec la valeur de la variable passée en paramètre de la fonction Browser.msgBox()

Debug : Alerte Compilation

Lors de l'enregistrement de votre fichier, la compilation de ce dernier est effectuée. Si une erreur survient car votre code possède une mauvaise syntaxe, un message apparaît indiquant la ligne sur laquelle l'erreur est reconnue

Autorisations

Lors de l'exécution d'une fonction, GAS peut vous demander une 1ère autorisation d'exécution. En effet, il vous demande si le code que vous allez exécuter est fiable car il n'est pas reconnu par Google.

Google vous indique alors quelles actions sont notamment effectuées par le code

Les librairies ou bibliothèques

Chaque script peut importer une liste de fonctions créées dans un autre script de type Standalone. Cette liste sera appelée librairie ou bibliothèque.

Pour créer et importer une bibliothèque :

• Créez un script de type Standalone (Ce script sera votre bibliothèque)

• Créez un fichier et une fonction dans ce script

• Créez une version de votre script

• Bouton Déployer/Nouveau déploiement

• Sur la roue crantée, sélectionnez Bibliothèque

• Indiquez le nom de la bibliothèque et cliquer sur Déployer

• Vous pourrez ensuite gérer vos versions/déploiements enregistrés via le Bouton Déployer/Gérer les déploiements. Plus d'informations via ce lien : Google Script Version Library

• Récupérer l'identifiant du script : Cet identifiant est récupérable depuis le menu Paramètre du projet (roue crantée sur la gauche). Il va servir de lien entre la librairie et le script qui va utiliser la libraire

On se place ensuite sur le Script qui devra utiliser la libraire et on récupère l'identifiant du script (cela peut se faire via l'ouverture d'un Google Sheets par exemple et d'y créer un script)

Dans ce script :

• Cliquez sur le menu Bibliothèque

• Copiez l'identifiant du Script (i.e. de la bibliothèque)

• Cliquez sur Rechercher

• Les paramètres de la bibliothèque apparaissent. Choisissez ensuite la version à importer et le nom de la librairie. Ce nom sera utilisé dans votre code pour appeler les fonctions (MALIBRAIRIE.maFonction())

Votre librairie est importée ! Plus d'informations sur les librairies via ce lien : Google Script Library

Les déclencheurs

Un déclencheur est un outil permettant d'exécuter une fonction :

• Lors d'un événement particulier depuis une source telle que Google Sheet Google Forms, Google Docs ou Google Calendar

• Avec une fréquence prédéfinie (horaire, quotidienne,...)

Les sources des événements peuvent être basées sur :

• Un document Google Sheets, Google Forms, Google Docs, Google Slides

• Un Google Calendar

• Une fréquence (horaire, quotidienne,...)

Les types d'événements peuvent être les suivants :

• Lors de l’envoi du formulaire (uniquement pour Google Forms)

• Lors d’une modification

• A l’ouverture

• Lors d'un changement

• Fréquence (horaire, quotidienne,...)

• Modification sur l'agenda d'un compte particulier (uniquement pour Google Agenda)

Pour créer un déclencheur :

• Rendez vous sur l'interface de gestion des scripts GAS et dans la barre latérale de gauche cliquez sur Déclencheurs

• • Paramètres de notifications d'échec : envoi par mail un bilan des échecs lors de l'exécution de la fonction du déclencheur. La fréquence des ces mails peut donc être :

    • Hebdomadaire : un mail par semaine si échec

    • Quotidienne : un mail par jour si échec

    • Horaire : un mail par heure si échec

    • Immédiate : un mail après chaque échec

Le déclencheur de modification & Google Sheets

Dans Google Sheets, il est possible de créer un déclencheur ayant pour source " Base sur la feuille de calcul" et pour type "Lors d'une modification". On écrira dans notre script ce déclencheur comme suit Mon_Declencheur(e).

Le paramètre e permet de spécifier l'objet modifié et d'accéder :

• A l'ancienne valeur de l'objet modifié >> e.oldValue

• A la plage de cellule de l'objet modifié >> e.range

• A la nouvelle valeur de l'objet modifié >> e.value

• A la source (i.e. document Google Sheets ) de l'objet modifié >> e.source

Ceci peut être utile pour détecter la cellule modifié et récupérer la valeur modifié en cas d'historique par exemple.