Appliquer les formules de la feuille de calcul du graphique dans les présentations en Java
Vue d’ensemble
Les graphiques PowerPoint stockent généralement leurs données source dans une feuille de calcul intégrée. Dans Aspose.Slides for Java, vous pouvez accéder à cette feuille via le classeur de données du graphique, écrire des valeurs d’entrée, affecter des formules aux cellules, calculer les formules prises en charge et utiliser les cellules calculées comme données du graphique.
Cet article explique le flux de travail complet des formules : créer un graphique, remplir sa feuille de calcul, attribuer des formules au format A1 ou R1C1, les recalculer, lire les valeurs calculées, connecter ces cellules à une série du graphique et enregistrer la présentation. Il décrit également la syntaxe des formules prises en charge, le sous‑ensemble de fonctions intégré, les valeurs mises en cache, les formules non prises en charge et les erreurs spécifiques aux feuilles de calcul.
Feuilles de calcul du graphique et formules
Une feuille de calcul du graphique contient les catégories, les noms de séries et les valeurs utilisées par un graphique. Dans PowerPoint, vous pouvez inspecter la feuille en ouvrant l’éditeur de données du graphique :
Dans Aspose.Slides, la feuille est exposée via l’interface IChartDataWorkbook. Utilisez IChartDataCell.setFormula pour les formules au format A1 et IChartDataCell.setR1C1Formula pour les formules au format R1C1. Après avoir modifié des cellules d’entrée ou des formules, appelez IChartDataWorkbook.calculateFormulas pour recalculer les formules prises en charge et mettre à jour les valeurs correspondantes des cellules.
Une cellule calculée expose toujours son résultat via IChartDataCell.getValue. C’est important lorsque vous devez inspecter le résultat d’une formule dans le code ou utiliser la cellule comme point de données du graphique.
Créer un graphique et calculer les formules de la feuille
L’exemple suivant montre un flux de travail complet. Il crée un graphique à colonnes groupées, supprime les données d’exemple, écrit les valeurs trimestrielles de revenus et de dépenses, calcule le profit avec des formules, lit les résultats, utilise les cellules calculées comme valeurs du graphique et enregistre la présentation.
import com.aspose.slides.*;
Presentation presentation = new Presentation();
try {
ISlide slide = presentation.getSlides().get_Item(0);
IChart chart = slide.getShapes().addChart(ChartType.ClusteredColumn, 50, 50, 600, 350);
IChartDataWorkbook workbook = chart.getChartData().getChartDataWorkbook();
int worksheetIndex = 0;
chart.getChartData().getSeries().clear();
chart.getChartData().getCategories().clear();
workbook.clear(worksheetIndex);
IChartDataCell category1 = workbook.getCell(worksheetIndex, "A2", "Q1");
IChartDataCell category2 = workbook.getCell(worksheetIndex, "A3", "Q2");
IChartDataCell category3 = workbook.getCell(worksheetIndex, "A4", "Q3");
workbook.getCell(worksheetIndex, "B1", "Revenue");
workbook.getCell(worksheetIndex, "C1", "Expenses");
workbook.getCell(worksheetIndex, "D1", "Profit");
workbook.getCell(worksheetIndex, "B2").setValue(120.0);
workbook.getCell(worksheetIndex, "C2").setValue(80.0);
workbook.getCell(worksheetIndex, "B3").setValue(150.0);
workbook.getCell(worksheetIndex, "C3").setValue(95.0);
workbook.getCell(worksheetIndex, "B4").setValue(135.0);
workbook.getCell(worksheetIndex, "C4").setValue(110.0);
IChartDataCell profit1 = workbook.getCell(worksheetIndex, "D2");
IChartDataCell profit2 = workbook.getCell(worksheetIndex, "D3");
IChartDataCell profit3 = workbook.getCell(worksheetIndex, "D4");
profit1.setFormula("B2-C2");
profit2.setFormula("B3-C3");
profit3.setFormula("B4-C4");
workbook.calculateFormulas();
double q1Profit = ((Number) profit1.getValue()).doubleValue(); // 40
double q2Profit = ((Number) profit2.getValue()).doubleValue(); // 55
double q3Profit = ((Number) profit3.getValue()).doubleValue(); // 25
System.out.println("Q1 profit: " + q1Profit);
System.out.println("Q2 profit: " + q2Profit);
System.out.println("Q3 profit: " + q3Profit);
chart.getChartData().getCategories().add(category1);
chart.getChartData().getCategories().add(category2);
chart.getChartData().getCategories().add(category3);
IChartSeries profitSeries = chart.getChartData().getSeries().add(workbook.getCell(worksheetIndex, "D1"), chart.getType());
profitSeries.getDataPoints().addDataPointForBarSeries(profit1);
profitSeries.getDataPoints().addDataPointForBarSeries(profit2);
profitSeries.getDataPoints().addDataPointForBarSeries(profit3);
profitSeries.getLabels().getDefaultDataLabelFormat().setShowValue(true);
presentation.save("chart-formulas.pptx", SaveFormat.Pptx);
} finally {
presentation.dispose();
}
Les points de données du graphique font référence à D2:D4, de sorte que le graphique utilise les valeurs de profit calculées. Aucun appel distinct de rafraîchissement du graphique n’est nécessaire : recalculez d’abord le classeur, puis utilisez ou enregistrez les données du graphique qui pointent vers les cellules calculées.
Utiliser des formules au format A1
La notation A1 identifie les colonnes par des lettres et les lignes par des chiffres. Assignez des expressions au format A1 via IChartDataCell.setFormula.
import com.aspose.slides.*;
Presentation presentation = new Presentation();
try {
ISlide slide = presentation.getSlides().get_Item(0);
IChart chart = slide.getShapes().addChart(ChartType.ClusteredColumn, 50, 50, 500, 300);
IChartDataWorkbook workbook = chart.getChartData().getChartDataWorkbook();
workbook.getCell(0, "C3").setValue(10);
workbook.getCell(0, "F2").setValue(2);
workbook.getCell(0, "G2").setValue(3);
workbook.getCell(0, "H2").setValue(4);
IChartDataCell cell = workbook.getCell(0, "A2");
cell.setFormula("C3+SUM(F2:H2)");
workbook.calculateFormulas();
Object value = cell.getValue(); // 19
} finally {
presentation.dispose();
}
Les formes de référence A1 courantes sont :
| Référence | Relative | Absolue | Mixte |
|---|---|---|---|
| Cellule | A2 |
$A$2 |
A$2, $A2 |
| Ligne | 2:2 |
$2:$2 |
— |
| Colonne | A:A |
$A:$A |
— |
| Plage | A2:C4 |
$A$2:$C$4 |
A$2:$C4, $A2:C$4 |
Les références relatives peuvent changer lorsqu’une formule est déplacée ou copiée par une application de feuille de calcul. Les références absolues conservent les deux coordonnées fixes, tandis que les références mixtes ne fixent qu’une ligne ou une colonne.
Utiliser des formules au format R1C1
La notation R1C1 identifie à la fois les lignes et les colonnes numériquement. Les références relatives utilisent des décalages entre crochets. Assignez cette syntaxe via IChartDataCell.setR1C1Formula.
import com.aspose.slides.*;
Presentation presentation = new Presentation();
try {
ISlide slide = presentation.getSlides().get_Item(0);
IChart chart = slide.getShapes().addChart(ChartType.ClusteredColumn, 50, 50, 500, 300);
IChartDataWorkbook workbook = chart.getChartData().getChartDataWorkbook();
workbook.getCell(0, "B2").setValue(12);
workbook.getCell(0, "C2").setValue(5);
IChartDataCell cell = workbook.getCell(0, "D2");
cell.setR1C1Formula("RC[-2]-RC[-1]");
workbook.calculateFormulas();
Object value = cell.getValue(); // 7
} finally {
presentation.dispose();
}
Les formes de référence R1C1 courantes sont :
| Référence | Relative | Absolue | Mixte |
|---|---|---|---|
| Cellule | R[2]C[3] |
R2C3 |
R2C[3], R[2]C3 |
| Ligne | R[2] |
R2 |
— |
| Colonne | C[3] |
C3 |
— |
| Plage | R[2]C[3]:R[5]C[7] |
R2C3:R5C7 |
R2C3:R[5]C[7], R[2]C3:R5C[7] |
Par exemple, dans la cellule D2, RC[-2] désigne la cellule de la même ligne deux colonnes à gauche (B2).
Constantes et opérateurs de formule
L’évaluateur de formules intégré prend en charge les valeurs logiques, les littéraux numériques, les chaînes, les valeurs d’erreur de feuille de calcul, les opérateurs arithmétiques et les opérateurs de comparaison.
Constantes et littéraux
| Type | Exemples | Remarques |
|---|---|---|
| Logique | TRUE, FALSE |
Peut être utilisé directement dans des expressions logiques telles que A2=TRUE. |
| Numérique | 1, 0.5, .3, 1E-2 |
Les notations décimale et scientifique sont prises en charge. |
| Chaîne | "abc", "2/3/2020 12:00" |
Les littéraux texte sont entourés de guillemets doubles dans la formule. |
| Résultat d’erreur | #DIV/0!, #N/A, #REF! |
Une formule valide peut s’évaluer en une valeur d’erreur de feuille de calcul au lieu d’un résultat normal. |
Cet exemple utilise plusieurs types de constantes :
import com.aspose.slides.*;
Presentation presentation = new Presentation();
try {
ISlide slide = presentation.getSlides().get_Item(0);
IChart chart = slide.getShapes().addChart(ChartType.ClusteredColumn, 50, 50, 500, 300);
IChartDataWorkbook workbook = chart.getChartData().getChartDataWorkbook();
workbook.getCell(0, "A2").setValue(false);
workbook.getCell(0, "B2").setFormula("A2=TRUE");
workbook.getCell(0, "C2").setFormula("1+0.5");
workbook.getCell(0, "D2").setFormula(".3*1E-2");
workbook.getCell(0, "E2").setFormula("\"abc\"");
workbook.getCell(0, "F2").setFormula("2/0");
workbook.calculateFormulas();
Object logicalValue = workbook.getCell(0, "B2").getValue(); // false
Object numericValue = workbook.getCell(0, "C2").getValue(); // 1.5
Object scientificValue = workbook.getCell(0, "D2").getValue(); // 0.003
Object stringValue = workbook.getCell(0, "E2").getValue(); // abc
Object errorValue = workbook.getCell(0, "F2").getValue(); // #DIV/0!
} finally {
presentation.dispose();
}
Opérateurs arithmétiques
| Opérateur | Signification | Exemple |
|---|---|---|
+ |
Addition ou signe plus unaire | 2+3 |
- |
Soustraction ou négation | 2-3, -3 |
* |
Multiplication | 2*3 |
/ |
Division | 2/3 |
% |
Pourcentage | 30% |
^ |
Exponentiation | 2^3 |
Utilisez des parenthèses pour rendre explicite l’ordre d’évaluation, par exemple (A2+B2)*C2.
Opérateurs de comparaison
Les expressions de comparaison renvoient des valeurs logiques.
| Opérateur | Signification | Exemple |
|---|---|---|
= |
Égal à | A2=3 |
<> |
Différent de | A2<>3 |
> |
Supérieur à | A2>3 |
>= |
Supérieur ou égal à | A2>=3 |
< |
Inférieur à | A2<3 |
<= |
Inférieur ou égal à | A2<=3 |
Fonctions prédéfinies prises en charge
Aspose.Slides inclut un évaluateur de formules intégré pour les feuilles de calcul des graphiques, mais ce n’est pas un moteur de calcul complet d’Excel. L’ensemble de fonctions documenté se limite à celles ci‑dessous. Ne supposez pas qu’une fonction Excel quelconque puisse être recalculée par IChartDataWorkbook.calculateFormulas.
| Fonction | Objectif ou forme prise en charge | Exemple |
|---|---|---|
ABS |
Valeur absolue | ABS(A2) |
AVERAGE |
Moyenne arithmétique | AVERAGE(B2:B5) |
CEILING |
Arrondir à la hausse à un multiple | CEILING(A2,5) |
CHOOSE |
Sélectionner une valeur par indice | CHOOSE(A2,"Low","High") |
CONCAT |
Concaténer des valeurs texte | CONCAT(A2,B2) |
CONCATENATE |
Concaténer des valeurs texte | CONCATENATE(A2," ",B2) |
DATE |
Créer une valeur date avec le système de dates 1900 | DATE(2026,8,19) |
DAYS |
Retourner le nombre de jours entre deux dates | DAYS(B2,A2) |
FIND |
Rechercher une chaîne dans une autre | FIND("-",A2) |
FINDB |
Recherche texte orientée octet | FINDB("a",A2) |
IF |
Résultat conditionnel | IF(A2>0,A2,0) |
INDEX |
Forme de référence | INDEX(A2:C4,2,3) |
LOOKUP |
Forme vectorielle | LOOKUP(A2,B2:B5,C2:C5) |
MATCH |
Forme vectorielle | MATCH(A2,B2:B5,0) |
MAX |
Valeur maximale | MAX(B2:B5) |
SUM |
Somme des valeurs | SUM(B2:B5) |
VLOOKUP |
Recherche verticale | VLOOKUP(A2,B2:D10,3,FALSE) |
Les restrictions indiquées dans le tableau sont importantes : INDEX est documenté sous forme de référence, tandis que LOOKUP et MATCH le sont sous forme vectorielle. DATE utilise le système de dates 1900. Les fonctionnalités et fonctions non répertoriées ici doivent être considérées comme non prises en charge par l’évaluateur de formules Aspose.Slides, sauf indication contraire dans une documentation séparée.
Calculer les formules avec une culture préférée
Certaines fonctions du classeur du graphique interprètent le texte selon des règles culturelles spécifiques. Cela est particulièrement important pour les fonctions destinées aux langues utilisant des jeux de caractères à double octet (DBCS). Pour calculer correctement ces formules, créez un LoadOptions, définissez la culture préférée avec SpreadsheetOptions.setPreferredCulture, assignez les options de feuille via LoadOptions.setSpreadsheetOptions, puis chargez la présentation.
L’exemple suivant sélectionne la culture japonaise, ouvre une présentation avec les options de chargement configurées, et appelle IChartDataWorkbook.calculateFormulas pour chaque classeur du graphique :
import com.aspose.slides.*;
import java.util.Locale;
Locale japaneseCulture = Locale.forLanguageTag("ja-JP");
ISpreadsheetOptions spreadsheetOptions = new SpreadsheetOptions();
spreadsheetOptions.setPreferredCulture(japaneseCulture);
LoadOptions loadOptions = new LoadOptions();
loadOptions.setSpreadsheetOptions(spreadsheetOptions);
Presentation presentation = new Presentation("presentation.pptx", loadOptions);
try {
for (ISlide slide : presentation.getSlides()) {
for (IShape shape : slide.getShapes()) {
if (shape instanceof IChart) {
IChart chart = (IChart) shape;
chart.getChartData().getChartDataWorkbook().calculateFormulas();
}
}
}
} finally {
presentation.dispose();
}
La culture préférée fait partie de la configuration de chargement de la présentation, il faut donc la spécifier avant de créer l’instance Presentation. Utilisez la culture attendue par les formules du classeur ; par exemple, ja-JP pour des formules qui doivent suivre les règles de calcul DBCS japonaises.
Recalcul et valeurs mises en cache
Les fichiers de feuille de calcul stockent généralement à la fois une formule et sa dernière valeur calculée. Aspose.Slides peut donc lire une valeur mise en cache via IChartDataCell.getValue lorsqu’une présentation est chargée et que les données du graphique concernées n’ont pas été modifiées.
Après avoir modifié des cellules d’entrée ou des formules, ne comptez pas sur un résultat mis en cache ancien. Appelez IChartDataWorkbook.calculateFormulas avant de lire les valeurs calculées ou d’enregistrer les données du graphique qui en dépendent.
Pour les formules hors du sous‑ensemble pris en charge, Aspose.Slides peut être incapable d’analyser la formule ou d’établir ses dépendances. Si le classeur a été modifié, la valeur mise en cache précédente ne peut plus être considérée comme fiable. Dans ce cas, la lecture de la valeur d’une cellule contenant des données non prises en charge peut lever l’exception CellUnsupportedDataException.
Si votre graphique dépend de fonctions Excel que Aspose.Slides n’évalue pas, calculez ces formules avec un moteur de feuille de calcul qui les supporte et écrivez les valeurs résultantes dans le classeur du graphique. Ne remplacez pas les formules non prises en charge par des valeurs devinées.
Gérer les erreurs de formule
Il existe deux types de problèmes distincts à distinguer.
Une formule peut être valide mais produire un résultat d’erreur de feuille de calcul tel que #DIV/0!, #N/A, #NAME?, #NULL!, #NUM!, #REF! ou #VALUE!. Dans ce cas, le jeton d’erreur est un résultat de cellule et peut être renvoyé via IChartDataCell.getValue.
Une formule peut également échouer au niveau de l’analyse, de la référence, de la dépendance ou des données prises en charge. Aspose.Slides fournit des exceptions spécifiques aux feuilles de calcul pour ces cas : CellInvalidFormulaException, CellInvalidReferenceException, CellCircularReferenceException et CellUnsupportedDataException.
Lorsque les formules proviennent de modèles ou d’entrées utilisateur, gérez ces exceptions autour du recalcul et de l’accès aux valeurs :
import com.aspose.slides.*;
Presentation presentation = new Presentation();
try {
ISlide slide = presentation.getSlides().get_Item(0);
IChart chart = slide.getShapes().addChart(ChartType.ClusteredColumn, 50, 50, 500, 300);
IChartDataWorkbook workbook = chart.getChartData().getChartDataWorkbook();
IChartDataCell cell = workbook.getCell(0, "A2");
cell.setFormula("SUM(B2:B5)");
try {
workbook.calculateFormulas();
System.out.println(cell.getValue());
} catch (CellInvalidFormulaException ex) {
System.err.println("Invalid formula: " + ex.getMessage());
} catch (CellInvalidReferenceException ex) {
System.err.println("Invalid cell reference: " + ex.getMessage());
} catch (CellCircularReferenceException ex) {
System.err.println("Circular reference: " + ex.getMessage());
} catch (CellUnsupportedDataException ex) {
System.err.println("Unsupported spreadsheet data: " + ex.getMessage());
}
} finally {
presentation.dispose();
}
Limitations pratiques
La prise en charge des formules dans les feuilles de calcul des graphiques est destinée à un sous‑ensemble défini de calculs de feuilles, pas à une compatibilité totale avec Excel. Gardez ces contraintes à l’esprit lors de la conception d’un flux de travail de génération de rapports :
- Utilisez uniquement les constantes, opérateurs, références et fonctions documentés lorsque vous avez besoin qu’Aspose.Slides recalcule les formules.
- Recalculez après avoir modifié les cellules dont les résultats de formule dépendent.
- Considérez les valeurs mises en cache des présentations chargées comme des instantanés, et non comme un remplacement du recalcul après des modifications.
- Testez les formules provenant de modèles existants avant de vous fier à leurs valeurs calculées, surtout si elles utilisent des fonctions hors de la liste documentée.
- Pour les formules nécessitant un moteur complet de calcul de feuille de calcul, calculez‑les à l’extérieur puis mettez à jour le classeur du graphique avec les valeurs résultantes.
FAQ
Quelle est la différence entre IChartDataCell.setFormula et IChartDataCell.setR1C1Formula?
IChartDataCell.setFormula stocke une expression au format A1 comme B2-C2. IChartDataCell.setR1C1Formula stocke une expression au format R1C1 comme RC[-2]-RC[-1]. Utilisez la notation qui correspond le mieux à votre manière de générer ou de copier les formules.
Dois‑je lire la cellule elle‑même ou sa valeur après le calcul ?
IChartDataWorkbook.getCell renvoie un IChartDataCell. Pour obtenir le résultat calculé, appelez la méthode IChartDataCell.getValue de cette cellule après le recalcul.
Quand dois‑je appeler IChartDataWorkbook.calculateFormulas?
Appelez IChartDataWorkbook.calculateFormulas après avoir modifié des valeurs d’entrée ou des formules et avant de dépendre des résultats calculés. Cela met à jour les valeurs des formules prises en charge par l’évaluateur intégré.
Aspose.Slides prend‑il en charge toutes les fonctions Excel ?
Non. L’évaluateur intégré ne prend en charge qu’un sous‑ensemble documenté de fonctions. Les fonctions en dehors de ce sous‑ensemble ne doivent pas être supposées se recalculer correctement. Si une compatibilité complète des formules Excel est requise, effectuez le calcul avec un moteur de feuille de calcul approprié et écrivez les valeurs finales dans le classeur du graphique.
Que se passe‑t‑il si une présentation chargée contient une formule non prise en charge ?
Si les données du graphique n’ont pas changé, le classeur peut encore contenir une valeur mise en cache calculée précédemment. Après modification des données associées, cette valeur mise en cache peut ne plus être valide. L’accès à une cellule dont la formule ne peut pas être gérée peut lever CellUnsupportedDataException.
Les valeurs d’erreur de formule sont‑elles identiques aux exceptions Java ?
Non. Un résultat tel que #DIV/0! est une valeur de feuille de calcul produite par un calcul valide. Les exceptions comme CellInvalidFormulaException ou CellCircularReferenceException indiquent que la formule ne peut pas être traitée normalement.
Un graphique se met‑il à jour automatiquement lorsqu’une cellule de formule change ?
Une série de graphique peut référencer des cellules du classeur. Recalculez d’abord le classeur, puis enregistrez ou rendez la présentation. Si les points de données du graphique référencent les cellules calculées, le graphique utilise ces valeurs mises à jour ; aucune méthode distincte de rafraîchissement du graphique n’est requise pour ce flux de travail.
Les graphiques peuvent‑ils utiliser un classeur Excel externe ?
Oui, les données du graphique peuvent être configurées pour utiliser un classeur externe via l’API de données du graphique. Cependant, le flux de calcul de formules décrit dans cet article concerne le classeur de données du graphique et le sous‑ensemble de formules évaluées par Aspose.Slides. Ne supposez pas que IChartDataWorkbook.calculateFormulas effectue un recalcul complet de formules arbitraires dans un fichier XLSX externe.
Puis‑je utiliser des formules qui référencent une autre feuille ou un autre classeur ?
Les références de style Excel peuvent exister dans les classeurs de graphiques, mais l’évaluation des formules est limitée par l’analyseur et le jeu de fonctions pris en charge. Si une référence inter‑feuille ou externe est indispensable, validez cette formule exacte avec la version d’Aspose.Slides que vous utilisez. Pour des flux nécessitant une large compatibilité des références Excel, calculez le classeur à l’extérieur et écrivez les valeurs résolues dans les données du graphique.
Les chaînes de formule doivent‑elles commencer par = ?
Les exemples d’API Aspose.Slides assignent des expressions telles que B2-C2 ou SUM(B2:B5) sans = initial. Utiliser cette forme maintient la cohérence avec les exemples d’API documentés.