Ce guide explique comment et pourquoi utiliser l'API Google Sheets pour créer des tableaux croisés dynamiques dans vos feuilles de calcul.
Qu'est-ce qu'un tableau croisé dynamique ?
Les tableaux croisés dynamiques permettent de résumer les données de votre feuille de calcul, en agrégeant, triant, comptant ou faisant une moyenne automatiquement des données tout en affichant les résultats résumés dans un nouveau tableau. Un tableau croisé dynamique agit comme une sorte de requête sur un ensemble de données source. Ces données sources existent à un autre emplacement de la feuille de calcul, et le tableau croisé dynamique présente une vue traitée des données.
Prenons l'exemple de l'ensemble de données de vente suivant:
A | B | C | D | E | F | G | |
1 | Catégorie de l'élément | Numéro de modèle | Coût | Quantité | Région | Commercial | Date d'expédition |
2 | Roue | W-24 | 20,50 $ | 4 | Ouest | Beth | 01/03/2016 |
3 | Porte | D-01X | 15 $ | 2 | Sud | Amir | 15/03/2016 |
4 | Moteur | ENG-0134 | 100,00 € | 1 | Nord | Carmen | 20/03/2016 |
5 | Cadre | FR-0B1 | 34,00 $ | 8 | Est | Anna | 12/03/2016 |
6 | Panneau | P-034 | 6 $ | 4 | Nord | Devyn | 02/04/2016 |
7 | Panneau | P-052 | 11,50 $ | 7 | Est | Erik | 16/05/2016 |
8 | Roue | W-24 | 20,50 $ | 11 | Sud | Sheldon | 30/04/2016 |
9 | Moteur | ENG-0161 | 330,00 $ | 2 | Nord | Jessica | 02/07/2016 |
10 | Porte | J-01Y | 29,00 $ | 6 | Ouest | Armando | 13/03/2016 |
11 | Cadre | FR-0B1 | 34,00 $ | 9 | Sud | Yuliana | 27/02/2016 |
12 | Panneau | P-102 | 3 $ | 15 | Ouest | Carmen | 18/04/2016 |
13 | Panneau | P-105 | 8,25 $ | 13 | Ouest | Jessica | 20/06/2016 |
14 | Moteur | ENG-0211 | 283,00 $ | 1 | Nord | Amir | 21/06/2016 |
15 | Porte | D-01X | 15 $ | 2 | Ouest | Armando | 03/07/2016 |
16 | Cadre | FR-0B1 | 34,00 $ | 6 | Sud | Carmen | 7/15/2016 |
17 | Roue | W-25 | 20 $ | 8 | Sud | Anna | 02/05/2016 |
18 | Roue | W-11 | 29,00 $ | 13 | Est | Erik | 19/05/2016 |
19 | Porte | D-05 | 17,70 $ | 7 | Ouest | Beth | 28/06/2016 |
20 | Cadre | FR-0B1 | 34,00 $ | 8 | Nord | Sheldon | 30/03/2016 |
Vous pouvez utiliser un tableau croisé dynamique pour créer un rapport indiquant le nombre de modèles vendus dans chaque région:
Pour connaître le code source utilisé pour générer ce tableau croisé dynamique, consultez la section Exemple ci-dessous.
Une fois qu'un tableau croisé dynamique est placé dans une feuille de calcul, les utilisateurs peuvent modifier de manière interactive la structure et les détails du résumé à l'aide de l'interface utilisateur de Sheets.
Travailler avec des tableaux croisés dynamiques
Une définition de tableau croisé dynamique est associée à une seule cellule d'une feuille. Bien que son apparence affichée comporte plusieurs cellules en hauteur et en largeur, elle est programmatiquement située à une seule coordonnée de cellule. Cette cellule devient le coin supérieur gauche du tableau croisé dynamique affiché, dont l'étendue horizontale et verticale est déterminée par sa définition.
Ajouter un tableau croisé dynamique
Pour ajouter un tableau croisé dynamique, utilisez la méthode batchUpdate en envoyant une requête updateCells. Cette requête permet de fournir une définition de PivotTable en tant que contenu d'une cellule, comme indiqué ci-dessous:
"updateCells": {
"rows": {
"values": [{
"pivotTable": MyPivotTable
},
"start": {
"sheetId": sheetId,
"rowIndex": 0,
"columnIndex": 0
},
"fields": "pivotTable"
}
Le tableau croisé dynamique décrit par MyPivotTable
est placé sur la feuille spécifiée, avec l'angle supérieur gauche dans la cellule A1
. (La hauteur et la largeur du tableau croisé dynamique sont dynamiques ; vous spécifiez uniquement l'origine.)
Le type PivotTable vous permet de spécifier les éléments suivants:
- Plage de données source
- un ou plusieurs champs dont les données constitueront les lignes du tableau croisé dynamique ;
- un ou plusieurs champs dont les données constitueront les colonnes du tableau croisé dynamique ;
- Critères de filtrage et d'agrégation
- Mise en page du tableau croisé dynamique
Modification et suppression de tableaux croisés dynamiques
Il n'existe aucune demande explicite de modification ou de suppression d'un tableau croisé dynamique. Utilisez plutôt une requête updateCells avec un contenu de cellule différent:
- Pour modifier un tableau croisé dynamique, créez une définition de PivotTable modifiée et mettez à jour la cellule en l'utilisant, de la même manière que pour l'ajout d'un nouveau tableau croisé dynamique.
- Pour supprimer un tableau croisé dynamique, mettez à jour la cellule avec des valeurs vides. Pour obtenir un exemple, consultez l'exemple Supprimer un tableau croisé dynamique.
Cas d'utilisation
Les tableaux croisés dynamiques peuvent être utilisés de nombreuses façons, dans de nombreux domaines tels que l'analyse statistique, les applications ERP, la création de rapports financiers, etc. Voici des exemples de cas d'utilisation classiques des tableaux croisés dynamiques:
- Ventes totales par région et par trimestre
- Salaire moyen par titre et lieu
- Nombre d'incidents par produit et par heure de la journée
Le nombre d'applications potentielles des tableaux croisés dynamiques est vaste, et la possibilité de les générer par programmation est puissante. Vous pouvez générer des tableaux croisés dynamiques compatibles avec l'exploration interactive, mais adaptés à des circonstances spécifiques, par exemple:
- Explorer les données d'incident pour les dernières 24 heures
- Afficher/analyser les données globales correspondant au compte actuellement sélectionné
- Examiner les données de vente pour les territoires appartenant à l'utilisateur actuel
Exemple
Cet exemple crée un tableau croisé dynamique à partir d'un ensemble de données pour générer le rapport "numéro de modèle par région" présenté en introduction de cette page. Pour obtenir des exemples supplémentaires, consultez la page Exemple de tableau croisé dynamique.