Niveau de codage: Débutant
Durée: 5 minutes
Type de projet: Fonction personnalisée
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
Si vous avez des données structurées similaires sur plusieurs feuilles d'une feuille de calcul, telles que des métriques de support client pour les membres de l'équipe, vous pouvez utiliser cette fonction personnalisée pour créer un résumé de chaque feuille. Cette solution est axée sur les demandes d'assistance client, mais vous pouvez la personnaliser en fonction de vos besoins.
Comment ça marche ?
La fonction personnalisée, appelée getSheetsData()
, résume les données de chaque feuille de la feuille de calcul en fonction de la colonne Status (État) de la feuille. Le script ignore les feuilles qui ne doivent pas être incluses dans l'agrégation, telles que les feuilles ReadMe et Summary.
Services Apps Script
Cette solution utilise le service suivant:
- Service Spreadsheet : récupère les feuilles à synthétiser et compte le nombre d'éléments correspondant à une chaîne spécifiée. Le script ajoute ensuite les informations calculées dans une plage en fonction de l'endroit où la fonction personnalisée a été appelée 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 ci-dessous pour créer une copie de la feuille de calcul Résumer la fonction personnalisée des données de la feuille de calcul. Le projet Apps Script correspondant à cette solution est joint à la feuille de calcul.
Créer une copie
Exécuter le script
- Dans la feuille de calcul copiée, accédez à la feuille Récapitulatif.
- Cliquez sur la cellule
A4
. La fonctiongetSheetsData()
se trouve dans cette cellule. - Accédez à l'une des feuilles du propriétaire et mettez à jour ou ajoutez des données à la feuille. Voici quelques actions que vous pouvez effectuer :
- Ajoutez une ligne contenant des exemples d'informations sur les billets.
- Dans la colonne Status (État), modifiez l'état d'une demande existante.
- Modifiez la position de la colonne État. Par exemple, dans la feuille Owner1, déplacez la colonne Status de la colonne C vers la colonne D.
- Accédez à la feuille Summary (Résumé) et consultez le tableau récapitulatif mis à jour que
getSheetsData()
a créé à partir de la celluleA4
. Vous devrez peut-être cocher la case à la ligne 10 pour actualiser les résultats mis en cache de la fonction personnalisée. Google met en cache les fonctions personnalisées pour optimiser les performances.- Si vous avez ajouté ou mis à jour des lignes, le script met à jour le nombre de demandes et d'états.
- Si vous avez déplacé la position de la colonne Status, le script fonctionne toujours comme prévu avec le nouvel index de colonne.
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
Modifications
Vous pouvez modifier la fonction personnalisée autant que vous le souhaitez en fonction de vos besoins. Vous trouverez ci-dessous un ajout facultatif permettant d'actualiser manuellement les résultats des fonctions personnalisées.
Actualiser les résultats mis en cache
Contrairement aux fonctions intégrées, Google met en cache les fonctions personnalisées pour optimiser les performances. Cela signifie que si vous modifiez un élément de votre fonction personnalisée, comme une valeur en cours de calcul, la mise à jour risque de ne pas être immédiatement forcée. Pour actualiser manuellement le résultat de la fonction, procédez comme suit:
- Ajoutez une case à cocher à une cellule vide en cliquant sur Insertion > Case à cocher.
- Ajoutez la cellule contenant la case à cocher en tant que paramètre de la fonction personnalisée (par exemple,
getSheetsData(B11)
). - Cochez ou décochez la case pour actualiser les résultats de la fonction personnalisée.
Contributeurs
Cet échantillon est géré par Google avec l'aide d'Experts Google Developers.