Afficher les valeurs comme dans le tableau croisé dynamique

Scénarios d’utilisation possibles

Un tableau croisé dynamique agrège normalement chaque champ de données avec une fonction d’agrégation telle que SUM ou COUNT. La fonctionnalité Afficher les valeurs comme d’Excel remplace chaque résultat affiché par un calcul secondaire dérivé de cet agrégat — par exemple, un pourcentage du total général, un total cumulé, une différence par rapport à un élément de base choisi, ou un classement — vous permettant d’effectuer des analyses comparatives sans formules d’assistance ou colonnes calculées.
Les utilisations typiques comprennent l’analyse de la part du total, y compris les pourcentages d’une ligne, d’une colonne ou du total général ; la production de rapports cumulatifs à l’aide d’un total cumulé dans un champ de période ; l’analyse des écarts par rapport à un élément de référence en utilisant la différence ou la différence en pourcentage à partir d’un élément de base ; et le classement des valeurs du plus petit au plus grand ou du plus grand au plus petit.
Dans Aspose.Cells for Node.js via C++, PivotFieldDataDisplayFormat sélectionne le calcul secondaire. L’accesseur en lecture seule PivotField.getShowValuesSetting() renvoie un objet PivotShowValuesSetting, dont les méthodes modifiables setCalculationType(), setBaseFieldIndex(), setBaseItemPositionType() et setBaseItemIndex() configurent le comportement ; la méthode pratique PivotField.showValuesAs(...) applique les mêmes quatre paramètres en un seul appel. Appliquez ces paramètres à un champ de données ou de valeur obtenu via PivotTable.getDataFields().

Membres de l’énumération PivotFieldDataDisplayFormat

Le champ de données conserve sa fonction d’agrégation, telle que SUM ou COUNT, tandis que Afficher les valeurs comme transforme uniquement la façon dont la valeur agrégée est affichée.
En plus d’écrire directement les propriétés PivotShowValuesSetting (voir la section suivante), une méthode pratique en un appel applique la même configuration :

const AsposeCells = require("aspose.cells.node");
function showValuesAs(pivotField, displayFormat, baseField, baseItemPositionType, baseItem) {
    pivotField.showValuesAs(displayFormat, baseField, baseItemPositionType, baseItem);
}
function pickEnum(enumType, candidates, fallback) {
    const type = enumType || {};
    for (const name of candidates) {
        if (type[name] !== undefined && type[name] !== null) {
            return type[name];
        }
    }
    return fallback;
}
const workbook = new AsposeCells.Workbook();
const sheet = workbook.getWorksheets().add("PivotData");
const cells = sheet.getCells();
// --- Source data -----------------------------------------------------------
const headers = ["Region", "Product", "Sales"];
for (const [c, header] of headers.entries()) {
    cells.get(0, c).putValue(header);
}
const rows = [
    ["East", "Apple", 100],
    ["East", "Banana", 120],
    ["West", "Apple", 90],
    ["West", "Banana", 60],
    ["North", "Apple", 75],
    ["North", "Banana", 45]
];
for (const [r, row] of rows.entries()) {
    for (const [c, value] of row.entries()) {
        cells.get(r + 1, c).putValue(value);
    }
}
// --- Pivot table ------------------------------------------------------------
const pivotTables = sheet.getPivotTables();
const pivotTable = pivotTables.add("A1:C7", 0, 4);
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Row, "Region");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Data, "Sales");
const salesField = pivotTable.getDataFields().get(0);
// --- ShowValuesAs -----------------------------------------------------------
const displayFormat = pickEnum(
    AsposeCells.PivotFieldDataDisplayFormat,
    ["PERCENT_OF_TOTAL", "PercentOfTotal", "PERCENTAGE_OF_TOTAL", "PercentageOfTotal"],
    7
);
const baseItemPositionType = pickEnum(
    AsposeCells.PivotItemPositionType,
    ["DEFAULT", "Default"],
    0
);
showValuesAs(salesField, displayFormat, -1, baseItemPositionType, -1);
// --- Save -------------------------------------------------------------------
workbook.save("ShowValuesAs.xlsx");
console.log("ShowValuesAs applied and workbook saved.");
Paramètre Signification Quand c’est requis
displayFormat Le calcul secondaire PivotFieldDataDisplayFormat à appliquer. Toujours.
baseField Index basé sur zéro du champ de base parmi les champs de base du tableau croisé dynamique (par exemple, l’index du champ de ligne auquel appartient l’élément de base). Uniquement pour les six formats relatifs à une base ci-dessous (DIFFERENCE_FROM, PERCENTAGE_OF, PERCENTAGE_DIFFERENCE_FROM, RUNNING_TOTAL_IN, PERCENTAGE_OF_RUNNING_TOTAL_IN, PERCENTAGE_OF_PARENT_TOTAL) ; ignoré par tout autre format.
baseItemPositionType Mode de sélection de l’élément de base par rapport à l’élément actuel : PivotItemPositionType.PREVIOUS, .NEXT ou .CUSTOM. Uniquement pour les trois formats à élément de base (DIFFERENCE_FROM, PERCENTAGE_OF, PERCENTAGE_DIFFERENCE_FROM) ; ignoré par tout autre format.
baseItem Index basé sur zéro de l’élément de base. Uniquement lorsque baseItemPositionType est CUSTOM (l’index de l’élément désigne précisément l’élément de base) ; ignoré pour PREVIOUS / NEXT et par tout format qui ne repose pas sur un élément de base — passez 0.
Type de calcul Comportement Paramètres de l’élément de base
NORMAL Aucun calcul secondaire ; la valeur agrégée est affichée telle quelle (par défaut). —
DIFFERENCE_FROM Affiche la valeur comme une différence par rapport à la valeur d’un élément de base dans un champ de base. baseField + PREVIOUS/NEXT/CUSTOM (baseItem uniquement avec CUSTOM)
PERCENTAGE_OF Affiche la valeur comme un pourcentage de la valeur d’un élément de base dans un champ de base. baseField + PREVIOUS/NEXT/CUSTOM (baseItem uniquement avec CUSTOM)
PERCENTAGE_DIFFERENCE_FROM Affiche la valeur comme le pourcentage de différence par rapport à la valeur d’un élément de base dans un champ de base. baseField + PREVIOUS/NEXT/CUSTOM (baseItem uniquement avec CUSTOM)
RUNNING_TOTAL_IN Affiche la valeur comme un total cumulé pour les éléments successifs d’un champ de base. baseField (le champ dont l’ordre des éléments entraîne l’accumulation)
PERCENTAGE_OF_ROW Affiche la valeur comme un pourcentage du total de la ligne. —
PERCENTAGE_OF_COLUMN Affiche la valeur comme un pourcentage du total de la colonne. —
PERCENTAGE_OF_TOTAL Affiche la valeur comme un pourcentage du total général. —
INDEX Affiche la valeur à l’aide de la formule d’index Excel ((valeur * total général) / (total ligne * total colonne)). —
PERCENTAGE_OF_PARENT_ROW_TOTAL Affiche la valeur comme un pourcentage du total de la ligne parente (pour les champs de ligne imbriqués). —
PERCENTAGE_OF_PARENT_COLUMN_TOTAL Affiche la valeur comme un pourcentage du total de la colonne parente (pour les champs de colonne imbriqués). —
PERCENTAGE_OF_PARENT_TOTAL Affiche la valeur comme un pourcentage du total parent. baseField (le champ parent servant de référence)
PERCENTAGE_OF_RUNNING_TOTAL_IN Affiche la valeur comme un pourcentage d’un total cumulé dans un champ de base. baseField (le champ d’accumulation)
RANK_SMALLEST_TO_LARGEST Classe la valeur du plus petit (1) au plus grand. —
RANK_LARGEST_TO_SMALLEST Classe la valeur du plus grand (1) au plus petit. —

Afficher les valeurs comme pourcentage du total

Appelez la méthode PivotField.showValuesAs() avec PivotFieldDataDisplayFormat.PERCENTAGE_OF_TOTAL pour convertir chaque cellule du champ de données, y compris le total général, en sa part du total général. Les nombres affichés sont ainsi présentés comme des proportions de l’ensemble du jeu de résultats. Ce format ne mesure chaque valeur que par rapport au total général ; il ne nécessite donc aucun champ ou élément de base : les arguments de fin (0, PivotItemPositionType.PREVIOUS, 0) sont des espaces réservés que le format ignore, comme le précise le tableau des paramètres ci‑dessus.

const AsposeCells = require("aspose.cells.node");
// Load or create a workbook with source data
const workbook = new AsposeCells.Workbook();
const dataSheet = workbook.getWorksheets().get(0);
dataSheet.getCells().get("A1").putValue("Fruit");
dataSheet.getCells().get("B1").putValue("Amount");
const fruits = ["Apple", "Banana", "Apple", "Cherry", "Banana", "Apple"];
const amounts = [10, 20, 30, 40, 50, 60];
for (let i = 0; i < fruits.length; i++) {
    dataSheet.getCells().get(i + 1, 0).putValue(fruits[i]);
    dataSheet.getCells().get(i + 1, 1).putValue(amounts[i]);
}
// Add a pivot table on a new worksheet
const pivotSheetIndex = workbook.getWorksheets().add();
const pivotTable = workbook
    .getWorksheets()
    .get(pivotSheetIndex)
    .getPivotTables()
    .add("=Sheet1!A1:B7", 2, 2);
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Row, "Fruit");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Data, "Amount");
pivotTable.calculateData();
// Show the Amount data field as a percentage of the grand total with the
// one-call method; PercentageOfTotal takes no base item, so the trailing
// base arguments (0, Previous, 0) are placeholders the format ignores
const dataField = pivotTable.getDataFields().get(0);
dataField.showValuesAs(
    AsposeCells.PivotFieldDataDisplayFormat.PercentageOfTotal,
    0,
    AsposeCells.PivotItemPositionType.Previous,
    0
);
pivotTable.calculateData();
// Body now reads: Apple 47.62%, Banana 33.33%, Cherry 19.05%, Grand Total 100.00%
workbook.save("ShowValuesAsPercentageOfTotal.xlsx");

Lire et configurer PivotField.getShowValuesSetting()

Lisez la configuration actuelle via PivotField.getShowValuesSetting() : l’accesseur en lecture seule renvoie l’objet PivotShowValuesSetting du champ, dont les quatre propriétés décrivent le calcul Afficher les valeurs comme actif. Pour modifier la configuration, appelez la méthode PivotField.showValuesAs() — elle écrit les quatre paramètres en un seul appel, vous évitant ainsi d’assigner chaque propriété séparément.
L’objet PivotShowValuesSetting expose les quatre paramètres écrits par showValuesAs() :

  • getCalculationType() et setCalculationType() sélectionnent le calcul secondaire PivotFieldDataDisplayFormat.
  • getBaseFieldIndex() et setBaseFieldIndex() indiquent l’index basé sur zéro du champ de base parmi les champs du tableau croisé dynamique. Il est utilisé par les formats relatifs à une base.
  • getBaseItemPositionType() et setBaseItemPositionType() déterminent comment l’élément de base est positionné par rapport à l’élément actuel et acceptent PivotItemPositionType.NEXT, PivotItemPositionType.PREVIOUS ou PivotItemPositionType.CUSTOM.
  • getBaseItemIndex() et setBaseItemIndex() précisent l’index basé sur zéro de l’élément de base et sont utilisés lorsque getBaseItemPositionType() est CUSTOM.
    Après avoir appelé showValuesAs(), appelez à nouveau PivotTable.calculateData() afin que le corps du tableau croisé dynamique soit recalculé et réaffiché avec la nouvelle configuration.
const AsposeCells = require("aspose.cells.node");
const workbook = new AsposeCells.Workbook("ShowValuesAsPercentageOfTotal.xlsx");
const pivotTable = workbook.getWorksheets().get(1).getPivotTables().get(0);
const dataField = pivotTable.getDataFields().get(0);
// Read the current show-values settings
const settings = dataField.getShowValuesSetting();
console.log(`CalculationType: ${settings.getCalculationType()}`);
console.log(`BaseFieldIndex: ${settings.getBaseFieldIndex()}`);
console.log(`BaseItemPositionType: ${settings.getBaseItemPositionType()}`);
console.log(`BaseItemIndex: ${settings.getBaseItemIndex()}`);
// Switch to a base-item calculation with the one-call method: difference
// from the value of the previous item in the row field
dataField.showValuesAs(
    AsposeCells.PivotFieldDataDisplayFormat.DifferenceFrom,
    pivotTable.getRowFields().get(0).getBaseIndex(),
    AsposeCells.PivotItemPositionType.Previous,
    0
);
pivotTable.calculateData();
// Note: the percentage number format saved by the previous example still
// clings to the data field cells; the underlying values are now differences
// Re-read the applied configuration
console.log(`CalculationType now: ${dataField.getShowValuesSetting().getCalculationType()}`);
workbook.save("ShowValuesAsDifferenceFrom.xlsx");

Articles associés