Google Apps Script

Google apps script ou comment automatiser les choses embêtantes dans un tableur

Table des matières

• Table des matières
• Qu'est ce que Google Apps Script ?
• Quelles sont les principales fonctionnalités ?
  • Fonctions de calcul personnalisées
  • Automatiser plusieurs cases
    • Class Range
    • Class Sheet
  • Déclencheur de fonction
    • Manuellement
    • Temporellement
    • Listener
• Exemple - Création d'un Tricount
• Liens Utiles

Qu'est ce que Google Apps Script ?

Google Apps Script est un outils permettant d'automatiser les autres outils de Google en effectuant des taches régulières, ou en réaction à l'interaction d'un utilisateur.

Nous nous concentrerons sur l'apport que peut faire Google Apps Script à Google Sheet, mais il est aussi possible d'automatiser Google Docs et Google Slides (↓ liens vers la documentation ↓)

Google Apps Script est un outils qui execute du JavaScript pour effectuer vos actions. Il est possible aussi d'ajouter des bibliothèques, mais attention, l'utilisation de bibliothèque ralentit l'execution du code.

Comment accéder Google Apps Script sur Google Sheet ?

Quelles sont les principales fonctionnalités ?

Fonctions de calcul personnalisées

Google Sheet a une grande quantité de formules déjà définies pour faire des opérations simples, SOMME, MOYENNE, ...

Mais il existe un nombre limité de fonctions, Google Apps Script permet de créer la fonction qui répond à nos besoins.

Comment faire ?

On créer une fonction :

function MaFonction(mesParametres){
  // Mes calculs
  return resultat
}

et dans la case où on veut appliquer la fonction, on applique le calcul : =MaFonction(A1)

Automatiser plusieurs cases

Les fonctions de Google Apps Script n'offrent pas seulement la possibilité de modifier une unique case (une formule retourne une unique valeur qui est stockée dans une seule cellule). Google Apps Script offre aussi la possibilité de gérer un grand nombre de cases, en accédant de manière indépendante à l'ensemble des cases du tableur.

Pour cela, il faut savoir comment accéder, en lecture et en écriture, aux cellules, à partir de la fonction.

Sinon voici quelques fonctions essentielles pour bien commencer 👇

Class Range

Class Sheet

Déclencheur de fonction

Manuellement

Pour executer de manière manuelle la fonction, il faut d'abord l'importer,

Ensuite, on peut l'executer à tous moment :

Temporellement

Il est possible de déclencher une fonction de manière temporelle.

Voici un exemple, issue de la documentation de Google liens

function createTimeDrivenTriggers() {
  // Trigger every 6 hours.
  ScriptApp.newTrigger('myFunction')
      .timeBased()
      .everyHours(6)
      .create();
  // Trigger every Monday at 09:00.
  ScriptApp.newTrigger('myFunction')
      .timeBased()
      .onWeekDay(ScriptApp.WeekDay.MONDAY)
      .atHour(9)
      .create();
}

J'ai pas cependant eu l'occasion d'aller en profondeur dans cette fonctionnalité, le laisse cette possibilité à quelqu'un d'autre pour un autre MON 😉

Listener

En créant une fonction ayant des noms spécifiques, il est possible de déclencher un script lors qu'un action se produit.

Les 2 principales fonctions sont :

• onEdit : executée à chaque fois qu'un utilisateur modifie une case
• onOpen : executée à chaque fois qu'un utlisateur (ayant des droits de modification) se connecte sur le google sheet.

exemple :

function onEdit(e){
  //supprime le contenu de toute les cases modifiées (⊙ˍ⊙)
  const range = e.range;
  range.clear()
}

Il existe quelques autres fonctions, comme d'habitude le détail dans les liens👇

Exemple - Création d'un Tricount

Le projet est composé de paramtères modifiables, pour permettre de personnaliser le Google Sheet

const tricountSettings = {
  sourceSheet: 'Ajout_achat',
  targetSheet: 'Historique',
  statSheet: 'Statistiques',
  people:["Personne 1","Personne 2", "Personne 3"]
}

Et de 4 fonctions :

• tricountAddToHistory, dont le but est de transférer les données d'ajout d'achat dans la partie historique (fonction inspirée du travail de --Hyde)
• columnToLetter, dont le but est de transformer la ième colonne en la lettre associée (fonction créée par AdamL)
• onEdit, dont le but est de déclencher la fonction trincountAddToHistory si les conditions sont réunies
• generateSheet, dont le but est de créer toute la mise en page du tricount au début

Tout le code source est disponible liens.

Liens Utiles

Documentation de Google sur l'utilisation de Google Apps Script sur ses différents produits :

• Google Sheet
• Google Docs
• Google Slides

Documentation sur les fonctionnalitées :

• Class Sheet : classe de feuille de calcul
• Class Range : classe d'un ou plusieurs cases
• Déclencheurs listener : Fonction listener
• Déclencheur temporel : Fonction exéctuée de manière régulière

Mon travail :

• Le Google Sheet
• Le code source
• Inspiration pour tricountAddToHistory
• Fonction columnToLetter