Documentation – Ajouter des champs de ligne et de colonne à un tableau croisé dynamique dans Aspose.Cells pour .NET

Nodejscpp: Filtrage des tableaux croisés dynamiques par étiquette ou par valeur

Mon, 01 Jan 0001 00:00:00 +0000

Aspose.Cells propose cinq stratégies pratiques pour filtrer les données affichées dans un tableau croisé dynamique. Vous pouvez appliquer des filtres d’étiquettes aux champs de ligne ou de colonne textuels, utiliser des filtres de dates lorsque le champ contient uniquement des cellules de type date-heure ou des cellules vides, appliquer des filtres de valeurs par rapport aux nombres agrégés, utiliser des filtres top 10 pour classer par champ de valeur, ou encore masquer et afficher manuellement des éléments individuels de tableau croisé dynamique via la propriété IsHidden. Chaque stratégie est exposée par des API dédiées sur les classes PivotField et PivotItem.

Introduction

Les tableaux croisés dynamiques sont des outils analytiques puissants, mais les résumés bruts contiennent souvent bien plus d’informations que ce dont vous avez besoin pour une présentation. Le filtrage est le principal mécanisme permettant de restreindre un tableau croisé dynamique aux lignes, colonnes ou valeurs qui importent pour un rapport spécifique. Aspose.Cells for Node.js via C++ reproduit les capacités de filtrage disponibles dans Microsoft Excel, en les exposant par programmation afin que la génération de rapports puisse être entièrement automatisée. Les stratégies de filtrage suivantes sont couvertes dans cet article :

Filtre d’étiquette — filtre les éléments d’un champ de ligne ou de colonne en fonction de leurs étiquettes textuelles.
Filtre de date — filtre les champs de ligne ou de colonne qui contiennent uniquement des valeurs de type date-heure (ou des cellules vides).
Filtre de valeur — filtre les éléments en fonction des valeurs agrégées d’un champ de données.
Filtre top 10 — affiche uniquement les N éléments supérieurs ou inférieurs classés par champ de valeur.
Masquer / Afficher les éléments du tableau croisé dynamique — contrôle manuellement la visibilité de chaque élément individuel d’un champ. Chaque approche utilise une méthode différente sur la classe PivotField ou une propriété sur la classe PivotItem. Après l’application de tout filtre, vous devez appeler refreshData() et calculateData() sur le tableau croisé dynamique afin que les données mises en cache et les valeurs calculées reflètent le nouvel état du filtre.

Filtre d’étiquette

Un filtre d’étiquette vous permet de filtrer les éléments d’un champ de ligne ou de colonne en comparant leurs légendes textuelles à un motif. Cela est utile lorsque vous souhaitez afficher uniquement les produits dont les noms commencent par une lettre spécifique, contiennent un mot particulier, ou répondent à un autre critère basé sur la légende. Aspose.Cells expose le filtrage par étiquette via la méthode PivotField.filterByLabel(PivotFilterType, string). L’énumération PivotFilterType inclut des valeurs telles que CaptionBeginsWith, CaptionContains, CaptionEndsWith, CaptionDoesNotContain, CaptionIsNotBlank, CaptionIsBlank, etc. Le second argument fournit la chaîne d’étiquette utilisée pour la comparaison. L’exemple suivant charge un classeur contenant un tableau croisé dynamique existant, applique un filtre d’étiquette afin que seuls les éléments dont les légendes commencent par un préfixe spécifié restent visibles, actualise le tableau croisé dynamique, et enregistre le résultat.

let fileName = "sample.xlsx";
let prefix = "B";

// Charger le classeur existant contenant un tableau croisé dynamique
let workbook = new AsposeCells.Workbook(fileName);

// Accéder à la feuille de calcul par index (première feuille de calcul)
let worksheet = workbook.getWorksheets().get(0);

// Accéder au tableau croisé dynamique par index
let pivotTable = worksheet.getPivotTables().get(0);

// Récupérer le premier champ de ligne PivotField
let rowField = pivotTable.getRowFields().get(0);

// Appliquer le filtre d'étiquette — afficher uniquement les éléments de ligne dont les étiquettes commencent par le préfixe fourni
rowField.filterByLabel(AsposeCells.PivotFilterType.CaptionBeginsWith, prefix, "");

// Actualiser et recalculer les données du tableau croisé dynamique pour que le filtre prenne effet
pivotTable.getPivotCache().refresh();

// Enregistrer le classeur sur le disque
workbook.save(fileName);

Filtre de date

Les filtres de date vous permettent de restreindre un tableau croisé dynamique selon des critères basés sur les dates, tels qu’aujourd’hui, la semaine dernière, ce mois-ci, le trimestre prochain, ou une plage de dates spécifique. Ce sont des filtres spécialisés qui fonctionnent uniquement sur les champs stockant des informations de type date-heure.

Le filtre de date ne fonctionne que lorsque la zone de ligne ou de colonne contient uniquement des cellules de type date-heure ou des valeurs vides. Si le champ sous-jacent contient d’autres types de données, tels que des nombres ou du texte, le filtre de date ne produira pas le résultat attendu. Assurez-vous que le champ est formaté en tant que date et que toutes les valeurs sont des instances DateTime valides ou des cellules vides avant d’appliquer ce filtre.

Aspose.Cells expose le filtrage par date via la méthode PivotField.filterByDate(PivotFilterType, params DateTime[] values). L’énumération PivotFilterType contient des valeurs de date dédiées telles que Today, Yesterday, LastWeek, ThisWeek, NextWeek, LastMonth, ThisMonth, NextMonth, LastQuarter, ThisQuarter, NextQuarter, LastYear, ThisYear, NextYear, et Between. Selon le type de filtre choisi, vous passez une ou deux valeurs DateTime (pour Between, vous passez les dates de début et de fin). L’exemple suivant charge un classeur contenant un tableau croisé dynamique dont la zone de ligne contient un champ de date, applique un filtre de date qui restreint les éléments visibles à une plage de dates particulière, actualise le tableau croisé dynamique, et enregistre le classeur.

const AsposeCells = require("aspose.cells");
const fs = require("fs");

const inputPath = "sample.xlsx";
const outputPath = "output_filtered.xlsx";

if (!fs.existsSync(inputPath))
{
    throw new Error("Source workbook not found: " + inputPath);
}

// Charger le classeur existant qui contient le tableau croisé dynamique
const workbook = new AsposeCells.Workbook(inputPath);

// Accéder à la feuille de calcul qui contient le tableau croisé dynamique (par index)
const worksheet = workbook.getWorksheets().get(0);

// Accéder au tableau croisé dynamique par index
const pivotTable = worksheet.getPivotTables().get(0);

// Récupérer le PivotField de date depuis la zone des lignes
// (Le filtre de date fonctionne uniquement lorsque la zone des lignes/colonnes contient uniquement des cellules de type date-heure ou des cellules vides)
const dateField = pivotTable.getRowFields().get(0);

// Définir le critère de date pour le filtre Entre
const startDate = new Date(2020, 0, 1);
const endDate = new Date(2020, 11, 31);

// Appliquer le filtre de date sur le champ pivot
dateField.filterByDate(AsposeCells.PivotFilterType.DateBetween, startDate, endDate);

// Actualiser et recalculer le tableau croisé dynamique pour que le filtre prenne effet
pivotTable.getPivotCache().refresh();

// Enregistrer le classeur
workbook.save(outputPath);

Filtre de valeur

Les filtres de valeur opèrent sur les valeurs agrégées qu’un tableau croisé dynamique calcule dans sa zone de données. Au lieu de faire correspondre des étiquettes textuelles, ils comparent des totaux numériques à un seuil. Les cas d’utilisation typiques incluent l’affichage uniquement des produits dont la somme des ventes dépasse un montant cible, ou uniquement des régions dont le nombre de transactions se situe dans une plage. Aspose.Cells expose le filtrage par valeur via la méthode PivotField.filterByValue(PivotField valueField, PivotFilterType filterType, params object[] values). Le paramètre filterType utilise des valeurs telles que ValueGreaterThan, ValueLessThan, ValueBetween, ValueEqual, ValueNotEqual, ValueGreaterThanOrEqual, et ValueLessThanOrEqual. Le paramètre valueField spécifie quel champ de données doit être évalué, et le ou les derniers arguments fournissent la ou les valeurs seuils. L’exemple suivant charge un classeur contenant un tableau croisé dynamique, applique un filtre de valeur qui ne conserve que les éléments dont les ventes agrégées dépassent un seuil numérique, actualise le tableau croisé dynamique, et enregistre le classeur.

let dataFieldIndex = -1;
for (let i = 0; i < pivotTable.getDataFields().getCount(); i++) {
    if (pivotTable.getDataFields().get(i) === dataField) {
        dataFieldIndex = i;
        break;
    }
}

if (dataFieldIndex >= 0) {
    rowField.filterByValue(dataFieldIndex, AsposeCells.PivotFilterType.ValueGreaterThan, 5000, Number.MAX_VALUE);
}

pivotTable.getPivotCache().refresh();

workbook.save("output.xlsx");

Filtre top 10

Le filtre top 10 est une forme spécialisée de filtre de valeur qui ne conserve que les N éléments les plus élevés ou les plus bas en fonction d’un champ de valeur choisi. Il est couramment utilisé pour les rapports de classement, tels que « les 10 meilleurs produits par chiffre d’affaires » ou « les 5 régions les plus faibles par nombre de ventes ».

Le filtre top 10 n’est efficace que lorsque le tableau croisé dynamique possède un ou plusieurs champs de valeur dans la zone de données. Sans au moins un champ de valeur, il n’y a aucune mesure agrégée permettant de classer les éléments, et le filtre ne peut pas être appliqué.

Aspose.Cells expose le filtrage top 10 via la méthode PivotField.filterTop10(int itemCount, bool isTop, PivotField valueField, PivotFilterType filterType). Le paramètre itemCount définit combien d’éléments conserver, isTop indique s’il faut conserver les éléments supérieurs (true) ou inférieurs (false), valueField fait référence au champ de données utilisé pour le classement, et filterType contrôle la façon dont la valeur est calculée (généralement Sum, mais aussi Count et Percent). L’exemple suivant charge un classeur contenant un tableau croisé dynamique qui possède un champ de valeur, applique un filtre top 10 pour ne conserver que les 10 éléments les plus élevés selon la somme des ventes, actualise le tableau croisé dynamique, et enregistre le classeur.

const AsposeCells = require("aspose.cells");

// Charger le classeur existant qui contient le tableau croisé dynamique
const inputPath = "input.xlsx";
const outputPath = "output.xlsx";
const workbook = new AsposeCells.Workbook(inputPath);

// Accéder à la feuille de calcul qui contient le tableau croisé dynamique (index 0)
const worksheet = workbook.getWorksheets().get(0);

// Accéder au tableau croisé dynamique par index
const pivotTable = worksheet.getPivotTables().get(0);

// Vérifier qu'il y a au moins un PivotField de valeur dans la zone de données
if (pivotTable.getDataFields().getCount() === 0) {
    throw new Error("Pivot table has no value (data) PivotField.");
}
const valueField = pivotTable.getDataFields().get(0);

// Récupérer le PivotField de ligne cible (le champ sur lequel nous voulons appliquer Top 10)
const rowField = pivotTable.getRowFields().get(0);

// Le premier (et seul) champ de données est à l'index 0 ; Top 10 classe selon celui-ci.
const valueFieldIndex = 0;

// Appliquer le filtre Top 10 sur le champ de ligne :
//   - itemCount   = 10
//   - filterType  = PivotFilterType.Sum
//   - isTop       = true (top N ; false signifierait bottom N)
//   - valueFieldIndex = l'index du champ de données utilisé pour classer les éléments
rowField.filterTop10(10, AsposeCells.PivotFilterType.Sum, true, valueFieldIndex);

// Actualiser les données du tableau croisé dynamique et le recalculer pour que le filtre prenne effet
pivotTable.getPivotTableCache().refresh();

// Enregistrer le classeur
workbook.save(outputPath);

Filtrer en masquant ou en affichant des éléments du tableau croisé dynamique

En plus des API de filtrage structurées, Aspose.Cells vous permet de contrôler directement la visibilité de chaque élément individuel du tableau croisé dynamique. En parcourant la collection PivotItems d’un PivotField et en basculant la propriété IsHidden, vous pouvez supprimer sélectivement des éléments spécifiques sans appliquer un filtre basé sur une formule. Définir IsHidden = true masque l’élément du tableau croisé dynamique ; définir IsHidden = false l’affiche à nouveau et le rend visible. Cette approche est utile lorsque la règle de filtrage est irrégulière ou spécifique à un élément, comme masquer un petit nombre de catégories nommées qui ne doivent pas apparaître dans un rapport particulier. L’exemple ci-dessous charge un tableau croisé dynamique, masque un élément spécifique par son nom, montre comment l’afficher à nouveau, actualise le tableau croisé dynamique, et enregistre le classeur.

const AsposeCells = require("aspose.cells");

// Charger un classeur existant contenant un tableau croisé dynamique
const workbook = new AsposeCells.Workbook("pivot_table_sample.xlsx");

// Accéder à la première feuille de calcul qui contient le tableau croisé dynamique
const sheet = workbook.getWorksheets().get(0);

// Accéder au tableau croisé dynamique par index (le premier tableau croisé dynamique sur la feuille)
const pivotTable = sheet.getPivotTables().get(0);

// Récupérer le PivotField cible (le premier champ d'étiquette de ligne dans lequel nous allons masquer/afficher des éléments)
const pivotField = pivotTable.getRowFields().get(0);

// Parcourir la collection PivotItems du PivotField sélectionné
const itemCount = pivotField.getPivotItems().getCount();
for (let i = 0; i < itemCount; i++)
{
    const item = pivotField.getPivotItems().get(i);

    // Masquer les éléments du tableau croisé dynamique qui correspondent à un nom/critère spécifique
    if (item.getName() == "Item1" || item.getName() == "Item2")
    {
        item.setIsHidden(true);
    }

    // Démontrer l'affichage : réafficher un élément précédemment masqué du tableau croisé dynamique
    if (item.getName() == "Item3")
    {
        item.setIsHidden(false);
    }
}

// Actualiser et recalculer le tableau croisé dynamique pour que les modifications prennent effet
pivotTable.getPivotCache().refreshData();

// Enregistrer le classeur — les éléments masqués restent dans les données sous-jacentes
// mais sont exclus de l'affichage du tableau croisé dynamique
workbook.save("output_pivot_filtered.xlsx");

Résumé

Aspose.Cells for Node.js via C++ fournit un ensemble complet de capacités de filtrage de tableaux croisés dynamiques qui correspondent à celles disponibles dans Microsoft Excel. Les filtres d’étiquette, de date et de valeur couvrent les scénarios analytiques les plus courants, tandis que le filtre top 10 gère les rapports de classement. Lorsque la règle de filtrage est irrégulière, la propriété PivotItem.IsHidden offre un recours flexible au niveau de l’élément. La combinaison de ces stratégies — par exemple, appliquer un filtre d’étiquette puis masquer des éléments spécifiques — vous permet de construire des rapports de tableau croisé dynamique ciblés avec précision, entièrement à partir du code.

Nodejscpp: Spécification de la position absolue de l élément du tableau croisé dynamique

Mon, 01 Jan 0001 00:00:00 +0000

Parfois, l’utilisateur doit spécifier la position absolue des éléments de pivot, l’API Aspose.Cells for Node.js via C++ a exposé quelques nouvelles propriétés et une méthode pour répondre à cette exigence.

Ajouté la propriété PivotItem.setPosition qui peut être utilisée pour spécifier l’index de position dans tous les PivotItems indépendamment du nœud parent. Ajouté la propriété PivotItem.setPositionInSameParentNode qui peut être utilisée pour spécifier l’index de position dans les PivotItems sous le même nœud parent.
Ajout de la méthode PivotItem.move pour déplacer l’élément vers le haut ou vers le bas en fonction de la valeur du compteur, où le compteur est le nombre de positions pour déplacer l’élément du tableau croisé dynamique vers le haut ou vers le bas. Si la valeur du compteur est inférieure à zéro, l’élément sera déplacé vers le haut, alors que si la valeur du compteur est supérieure à zéro, l’élément du tableau croisé dynamique se déplacera vers le bas. Le paramètre de type booléen isSameParent spécifie si l’opération de déplacement doit être effectuée dans le même nœud parent ou non.
La méthode PivotItem.move(int count) étant obsolète, il est recommandé d’utiliser la nouvelle méthode PivotItem.move(number, boolean).

Le code d’exemple suivant crée un tableau croisé dynamique et spécifie ensuite les positions des éléments du tableau croisé dynamique dans le même nœud parent. Vous pouvez télécharger les fichiers Excel source et Excel de sortie pour votre référence. Si vous ouvrez le fichier Excel de sortie, vous verrez l’élément du tableau croisé dynamique “4H12” est à la 0e position dans le parent “K11” et “DIF400” est à la 3e position. De même, CA32 est à la position 1 et AAA3 est à la position 2

Veuillez noter qu’il est nécessaire d’appeler les méthodes PivotTable.RefreshData et PivotTable.CalculateData avant d’utiliser les propriétés PivotItem.setPosition, PivotItem.setPositionInSameParentNode et la méthode PivotItem.move.

Nodejscpp: Obtenez l objet Cell par le nom d affichage du champ de tableau croisé dynamique du tableau croisé dynamique

Mon, 01 Jan 0001 00:00:00 +0000

Aspose.Cells for Node.js via C++ fournit la méthode PivotTable.getCellByDisplayName(string) que vous pouvez utiliser pour accéder à l’objet cellule par le nom d’affichage du champ de pivot. Cette méthode est utile lorsque vous souhaitez mettre en évidence ou formater l’en-tête de votre champ de pivot. Cet article explique comment récupérer l’objet cellule par le nom d’affichage du champ de données puis lui appliquer un format.

Comment obtenir l’objet Cell par le nom d’affichage du champ de tableau croisé dynamique du tableau croisé dynamique

Le code suivant accède au premier tableau croisé dynamique de la feuille de calcul, puis obtient la cellule par le nom d’affichage du deuxième champ de données du tableau croisé dynamique. Il change ensuite la couleur de remplissage et la couleur de la police de la cellule en bleu clair et noir respectivement. Les captures d’écran ci-dessous montrent à quoi ressemble le tableau croisé dynamique avant et après l’exécution du code.

Tableau croisé dynamique - Avant

Tableau croisé dynamique - Après

Nodejscpp: Regrouper les champs de tableau croisé dynamique dans le tableau croisé dynamique

Mon, 01 Jan 0001 00:00:00 +0000

Scénarios d’utilisation possibles

Microsoft Excel permet de grouper les champs de pivot du tableau croisé dynamique. Lorsqu’il y a une grande quantité de données liées à un champ de pivot, il est souvent utile de les regrouper en sections. Aspose.Cells for Node.js via C++ offre également cette fonctionnalité via la méthode PivotTable.groupBy().

Comment regrouper les champs de tableau croisé dynamique dans le tableau croisé dynamique

Le code d’exemple suivant charge le fichier Excel d’exemple et effectue un groupement sur le premier champ de tableau croisé dynamique en utilisant la méthode PivotTable.groupBy(). Ensuite, il actualise et calcule les données du tableau croisé dynamique et enregistre le classeur sous le nom de fichier Excel de sortie. La capture d’écran montre l’effet du code d’exemple sur le fichier Excel d’exemple. Comme vous pouvez le voir sur la capture d’écran, le premier champ de tableau croisé dynamique est maintenant regroupé par mois et par trimestres.

Code d’exemple

Nodejscpp: Masquer et trier les données du tableau croisé dynamique

Mon, 01 Jan 0001 00:00:00 +0000

Masquer et trier les données du tableau croisé dynamique

Aspose.Cells for Node.js via C++ prend en charge la dissimulation et le tri des données dans le tableau croisé dynamique. Le code suivant illustre cette fonctionnalité en triant la colonne Score en ordre décroissant puis en masquant les lignes avec un score inférieur à 60.

Les fichiers Excel source et de sortie utilisés dans l’extrait de code sont joints à titre de référence.

Fichier source

Fichier de sortie

Nodejscpp: Ajouter un filtre dans un tableau croisé dynamique

Mon, 01 Jan 0001 00:00:00 +0000

Scénarios d’utilisation possibles

Lorsque vous créez un tableau croisé dynamique avec des données connues et souhaitez filtrer le tableau, vous devez apprendre et utiliser le filtrage. Cela peut vous aider à filtrer efficacement les données que vous souhaitez. En utilisant l’API Aspose.Cells for Node.js via C++, vous pouvez ajouter un filtre sur les valeurs de champ dans les tableaux croisés dynamiques.

Ajouter un filtre dans un tableau croisé dynamique en utilisant Aspose.Cells for Node.js via C++

Veuillez consulter le code d’exemple suivant. Il défini les données et crée un tableau croisé dynamique basé sur celles-ci. Ajoute ensuite un filtre sur le champ de ligne du tableau croisé dynamique. Enfin, enregistre le classeur au format XLSX de sortie. Après avoir exécuté le code d’exemple, un tableau croisé dynamique avec filtre top10 est ajouté à la feuille de calcul.

Code d’exemple

Nodejscpp: Effacer le filtre dans le tableau croisé dynamique

Mon, 01 Jan 0001 00:00:00 +0000

Scénarios d’utilisation possibles

Lorsque vous créez un tableau croisé dynamique avec des données connues et souhaitez filtrer le tableau, vous devez apprendre et utiliser le filtrage. Cela peut vous aider à filtrer efficacement les données que vous souhaitez. En utilisant l’API Aspose.Cells for Node.js via C++, vous pouvez opérer un filtre sur les valeurs de champ dans les tableaux croisés dynamiques.

Comment effacer le filtre dans le tableau croisé dynamique dans Excel

Effacer le filtre dans le tableau croisé dynamique dans Excel, suivez ces étapes :

Sélectionnez le tableau croisé dynamique que vous souhaitez effacer.
Cliquez sur la flèche déroulante pour le filtre que vous souhaitez effacer dans le tableau croisé dynamique.
Sélectionnez “Effacer le filtre” dans le menu déroulant.
Si vous souhaitez effacer tous les filtres du tableau croisé dynamique, vous pouvez également cliquer sur le bouton “Effacer les filtres” dans l’onglet Analyser le tableau croisé dynamique dans le ruban d’Excel.

Comment effacer le filtre dans un tableau croisé dynamique en utilisant Aspose.Cells for Node.js via C++

Effacer le filtre dans le tableau croisé dynamique en utilisant Aspose.Cells for Node.js via C++. Voir le code d’exemple ci-dessous.

Définir les données et créer un tableau croisé dynamique basé sur celles-ci.
Ajouter un filtre sur le champ de ligne du tableau croisé dynamique.
Enregistrer le classeur au format XLSX de sortie. Après l’exécution du code d’exemple, un tableau croisé dynamique avec un filtre top10 est ajouté à la feuille de calcul.
Effacer le filtre sur un champ pivotant spécifique. Après l’exécution du code pour effacer le filtre, le filtre sur le champ pivotant spécifique sera effacé. Veuillez vérifier le XLSX de sortie.

Code d’exemple

Nodejscpp: Tri personnalisé dans la table pivotante

Mon, 01 Jan 0001 00:00:00 +0000

Comment définir un tri personnalisé dans un tableau croisé dynamique en utilisant la bibliothèque Aspose.Cells for Node.js via C++

En utilisant l’API Aspose.Cells for Node.js via C++, vous pouvez trier les tableaux croisés dynamiques sur les valeurs de champ. Le code suivant charge un fichier excel exemple et ajoute trois tableaux croisés dynamiques. Le premier tableau croisé dynamique est sans tri personnalisé, le deuxième est trié sur les valeurs de champ “SeaFood” et le troisième sur les valeurs de champ “28/07/2000”.

Le fichier source d’exemple et les fichiers de sortie peuvent être téléchargés ici pour tester le code d’exemple :

Fichier Excel source

Fichier Excel de sortie

Fichier PDF de sortie