Grouper les champs croisés dynamiques dans le tableau croisé dynamique

Scénarios d’utilisation possibles

  • Le regroupement des champs croisés dynamiques est utile lorsqu’un champ de ligne ou de colonne d’un tableau croisé dynamique contient de nombreux éléments distincts, comme un champ de date avec des centaines de dates ou un champ numérique avec de nombreuses valeurs dispersées. Le regroupement condense ces éléments en sections significatives : les dates en mois, trimestres et années, et les nombres en plages telles que 0-1, 2-3, 4-5. Cela rend un grand tableau croisé dynamique compact et plus facile à analyser. Aspose.Cells for Node.js via Java offre cette capacité via la méthode PivotField.group() (regroupement automatique par type de données) et PivotField.group(PivotFieldGroupOptions) (options de regroupement personnalisées).
  • Le regroupement par date condense les dates individuelles en périodes plus larges, telles que jours, mois, trimestres et années, et construit une hiérarchie temporelle (par exemple Années, Trimestres, Mois). Les tendances au fil du temps deviennent visibles d’un coup d’œil, et chaque niveau de période devient son propre champ croisé dynamique dans la zone de ligne ou de colonne du tableau croisé dynamique.
  • Le regroupement n’est disponible que pour les champs placés dans la zone LIGNE ou COLONNE d’un tableau croisé dynamique. Un champ de données (valeur) ne peut pas être regroupé directement. Pour regrouper un tel champ, vous devez d’abord l’ajouter à la zone de ligne ou de colonne du tableau croisé dynamique.

Grouper automatiquement les champs croisés dynamiques

La surcharge PivotField.group() sans paramètre inspecte le type de données du champ et le regroupe automatiquement. Un champ contenant uniquement des dates (et des vides) est regroupé par mois. Un champ contenant uniquement des nombres (et des vides) est regroupé en plages numériques à l’aide d’un intervalle automatique.

const AsposeCells = require("aspose.cells");
let wb = new AsposeCells.Workbook("sampleGroupPivotFieldsInPivotTable.xlsx");
// Accéder à la deuxième feuille de calcul et à son tableau croisé dynamique
let pt = wb.getWorksheets().get(1).getPivotTables().get(0);
// Grouper automatiquement le premier champ de ligne.
// Le champ contient des dates, donc il est groupé par mois.
let field = pt.getRowFields().get(0);
field.group();
// Calculer les données du tableau croisé dynamique et enregistrer le fichier de sortie
pt.calculateData();
wb.save("outputAutoGroupPivotField.xlsx");

Grouper les champs croisés dynamiques avec des options personnalisées

La classe PivotFieldGroupOptions fournit une configuration de regroupement personnalisée. Pour les champs de date, définissez StartDate, EndDate et GroupTypes. Pour les champs numériques, définissez StartNumber, EndNumber et Interval. La propriété NewPivotField contrôle si le regroupement crée de nouveaux champs croisés dynamiques à côté de l’original (voir la section Remarque à la fin de cet article).

Regrouper un champ de date par mois et trimestres

L’exemple suivant regroupe le champ de ligne de date du tableau croisé dynamique d’exemple par mois et trimestres entre une date de début et une date de fin. Le code charge le fichier Excel d’exemple, effectue le regroupement, calcule les données du tableau croisé dynamique et enregistre le résultat regroupé. La capture d’écran montre l’effet : le champ de ligne de date est désormais regroupé par trimestres et mois. Notez que l’ordre des valeurs dans options.GroupTypes est ignoré. Quel que soit l’ordre dans lequel les types de groupes sont listés, les champs regroupés sont toujours affichés de la période la plus grande à la plus petite : années, trimestres, mois, jours, heures, minutes, secondes. Dans cet exemple, les mois sont listés avant les trimestres dans options.GroupTypes, mais les trimestres sont affichés comme niveau extérieur et les mois comme niveau intérieur.

const AsposeCells = require("aspose.cells");
// Charger le classeur d'exemple
const wb = new AsposeCells.Workbook("sampleGroupPivotFieldsInPivotTable.xlsx");
// Accéder à la deuxième feuille de calcul et à son tableau croisé dynamique
const pt = wb.getWorksheets().get(1).getPivotTables().get(0);
// Grouper le premier champ de ligne (un champ de date) par mois et trimestres
const options = new AsposeCells.PivotFieldGroupOptions();
options.setStartDate(new Date(2008, 0, 1));
options.setEndDate(new Date(2008, 8, 5));
options.setGroupTypes([AsposeCells.PivotGroupByType.MONTHS, AsposeCells.PivotGroupByType.QUARTERS]);
pt.getRowFields().get(0).group(options);
// Calculer les données du tableau croisé dynamique et enregistrer le fichier de sortie
pt.calculateData();
wb.save("outputGroupPivotFieldsInPivotTable.xlsx");

Tableau croisé dynamique regroupé par mois et trimestres

Regrouper un champ numérique en plages

FieldTwo du tableau croisé dynamique d’exemple est initialement un champ de données (valeur). Comme seuls les champs de ligne ou de colonne peuvent être regroupés, le code appelle d’abord pivotTable.addFieldToArea(PivotFieldType.Row, "FieldTwo") pour déplacer FieldTwo vers la zone de ligne, actualise le tableau croisé dynamique, puis regroupe le champ numérique dans les plages 0-1, 2-3 et 4-5 à l’aide de StartNumber = 0, EndNumber = 5 et Interval = 2.

const AsposeCells = require("aspose.cells");
// Charger le classeur d'exemple
const wb = new AsposeCells.Workbook("sampleGroupPivotFieldsInPivotTable.xlsx");
// Accéder à la deuxième feuille de calcul et à son tableau croisé dynamique
const pt = wb.getWorksheets().get(1).getPivotTables().get(0);
// FieldTwo est un champ de données : déplacez-le d'abord dans la zone des lignes,
// car seuls les champs de ligne/colonne peuvent être groupés
pt.addFieldToArea(AsposeCells.PivotFieldType.ROW, "FieldTwo");
pt.calculateData();
// Grouper le champ numérique dans les plages 0-1, 2-3, 4-5
const options = new AsposeCells.PivotFieldGroupOptions();
options.setStartNumber(0);
options.setEndNumber(5);
options.setInterval(2);
pt.getRowFields().get(1).group(options);
// Calculer les données du tableau croisé dynamique et enregistrer le fichier de sortie
pt.calculateData();
wb.save("outputNumberGroupPivotField.xlsx");

Remarque

Articles connexes