Diagramm-Arbeitsblatt-Formeln in Präsentationen mit Python anwenden
Übersicht
PowerPoint‑Diagramme speichern ihre Quelldaten in der Regel in einem eingebetteten Arbeitsblatt. In Aspose.Slides für Python via .NET können Sie über die Diagrammdaten‑Arbeitsmappe auf dieses Arbeitsblatt zugreifen, Eingabewerte schreiben, Formeln Zellen zuweisen, unterstützte Formeln berechnen und die berechneten Zellen als Diagrammdaten verwenden.
Dieser Artikel erklärt den vollständigen Formel‑Workflow: ein Diagramm erstellen, sein Arbeitsblatt füllen, A1‑ oder R1C1‑Formeln zuweisen, sie neu berechnen, die berechneten Werte auslesen, diese Zellen mit einer Diagrammreihe verbinden und die Präsentation speichern. Er beschreibt außerdem die unterstützte Formelsyntax, das integrierte Funktions‑Subset, zwischengespeicherte Werte, nicht unterstützte Formeln und tabellenspezifische Fehler.
Diagramm‑Arbeitsblätter und Formeln
Ein Diagramm‑Arbeitsblatt enthält die Kategorien, Seriennamen und Werte, die von einem Diagramm verwendet werden. In PowerPoint können Sie das Arbeitsblatt inspizieren, indem Sie den Diagrammdaten‑Editor öffnen:
In Aspose.Slides wird das Arbeitsblatt über die Diagrammdaten‑Arbeitsmappe bereitgestellt. Verwenden Sie die formula‑Eigenschaft für A1‑Formeln und die r1c1_formula‑Eigenschaft für R1C1‑Formeln. Nach dem Ändern von Eingabezellen oder Formeln rufen Sie calculate_formulas auf, um unterstützte Formeln neu zu berechnen und die entsprechenden Zellenwerte zu aktualisieren.
Eine berechnete Zelle gibt ihr Ergebnis weiterhin über die value‑Eigenschaft zurück. Das ist wichtig, wenn Sie das Ergebnis einer Formel im Code prüfen oder die Zelle als Diagrammdatenpunkt verwenden müssen.
Diagramm erstellen und Arbeitsblatt‑Formeln berechnen
Das folgende Beispiel zeigt einen End‑to‑End‑Workflow. Es erstellt ein gruppiertes Säulendiagramm, löscht die Beispieldaten, schreibt quartalsweise Umsatz‑ und Ausgabenwerte, berechnet den Gewinn mit Formeln, liest die Ergebnisse, verwendet die berechneten Zellen als Diagrammwerte und speichert die Präsentation.
import aspose.slides as slides
import aspose.slides.charts as charts
with slides.Presentation() as presentation:
slide = presentation.slides[0]
chart = slide.shapes.add_chart(charts.ChartType.CLUSTERED_COLUMN, 50, 50, 600, 350)
workbook = chart.chart_data.chart_data_workbook
worksheet_index = 0
chart.chart_data.series.clear()
chart.chart_data.categories.clear()
workbook.clear(worksheet_index)
category1 = workbook.get_cell(worksheet_index, "A2", "Q1")
category2 = workbook.get_cell(worksheet_index, "A3", "Q2")
category3 = workbook.get_cell(worksheet_index, "A4", "Q3")
workbook.get_cell(worksheet_index, "B1", "Revenue")
workbook.get_cell(worksheet_index, "C1", "Expenses")
workbook.get_cell(worksheet_index, "D1", "Profit")
workbook.get_cell(worksheet_index, "B2").value = 120.0
workbook.get_cell(worksheet_index, "C2").value = 80.0
workbook.get_cell(worksheet_index, "B3").value = 150.0
workbook.get_cell(worksheet_index, "C3").value = 95.0
workbook.get_cell(worksheet_index, "B4").value = 135.0
workbook.get_cell(worksheet_index, "C4").value = 110.0
profit1 = workbook.get_cell(worksheet_index, "D2")
profit2 = workbook.get_cell(worksheet_index, "D3")
profit3 = workbook.get_cell(worksheet_index, "D4")
profit1.formula = "B2-C2"
profit2.formula = "B3-C3"
profit3.formula = "B4-C4"
workbook.calculate_formulas()
q1_profit = profit1.value # 40
q2_profit = profit2.value # 55
q3_profit = profit3.value # 25
print(f"Q1 profit: {q1_profit}")
print(f"Q2 profit: {q2_profit}")
print(f"Q3 profit: {q3_profit}")
chart.chart_data.categories.add(category1)
chart.chart_data.categories.add(category2)
chart.chart_data.categories.add(category3)
profit_series = chart.chart_data.series.add(workbook.get_cell(worksheet_index, "D1"), chart.type)
profit_series.data_points.add_data_point_for_bar_series(profit1)
profit_series.data_points.add_data_point_for_bar_series(profit2)
profit_series.data_points.add_data_point_for_bar_series(profit3)
profit_series.labels.default_data_label_format.show_value = True
presentation.save("chart-formulas.pptx", slides.export.SaveFormat.PPTX)
Die Diagrammdatenpunkte verweisen auf D2:D4, sodass das Diagramm die berechneten Gewinnwerte verwendet. In diesem Workflow gibt es keinen separaten Chart‑Refresh‑Aufruf: Die Arbeitsmappe wird zuerst neu berechnet, dann werden die Diagrammdaten, die auf die berechneten Zellen verweisen, verwendet oder gespeichert.
A1‑Formeln verwenden
A1‑Notation identifiziert Spalten mit Buchstaben und Zeilen mit Zahlen. Weisen Sie A1‑Ausdrücke über IChartDataCell.formula zu.
import aspose.slides as slides
import aspose.slides.charts as charts
with slides.Presentation() as presentation:
slide = presentation.slides[0]
chart = slide.shapes.add_chart(charts.ChartType.CLUSTERED_COLUMN, 50, 50, 500, 300)
workbook = chart.chart_data.chart_data_workbook
workbook.get_cell(0, "C3").value = 10
workbook.get_cell(0, "F2").value = 2
workbook.get_cell(0, "G2").value = 3
workbook.get_cell(0, "H2").value = 4
cell = workbook.get_cell(0, "A2")
cell.formula = "C3+SUM(F2:H2)"
workbook.calculate_formulas()
value = cell.value # 19
Gängige A1‑Referenzformen sind:
| Referenz | Relativ | Absolut | Gemischt |
|---|---|---|---|
| Zelle | A2 |
$A$2 |
A$2, $A2 |
| Zeile | 2:2 |
$2:$2 |
— |
| Spalte | A:A |
$A:$A |
— |
| Bereich | A2:C4 |
$A$2:$C$4 |
A$2:$C4, $A2:C$4 |
Relative Referenzen können sich ändern, wenn eine Formel von einer Tabellenkalkulationsanwendung verschoben oder kopiert wird. Absolute Referenzen halten beide Koordinaten fest, während gemischte Referenzen nur eine Zeile oder eine Spalte fixieren.
R1C1‑Formeln verwenden
R1C1‑Notation identifiziert sowohl Zeilen als auch Spalten numerisch. Relative Referenzen verwenden Versätze in eckigen Klammern. Weisen Sie diese Syntax über IChartDataCell.r1c1_formula zu.
import aspose.slides as slides
import aspose.slides.charts as charts
with slides.Presentation() as presentation:
slide = presentation.slides[0]
chart = slide.shapes.add_chart(charts.ChartType.CLUSTERED_COLUMN, 50, 50, 500, 300)
workbook = chart.chart_data.chart_data_workbook
workbook.get_cell(0, "B2").value = 12
workbook.get_cell(0, "C2").value = 5
cell = workbook.get_cell(0, "D2")
cell.r1c1_formula = "RC[-2]-RC[-1]"
workbook.calculate_formulas()
value = cell.value # 7
Gängige R1C1‑Referenzformen sind:
| Referenz | Relativ | Absolut | Gemischt |
|---|---|---|---|
| Zelle | R[2]C[3] |
R2C3 |
R2C[3], R[2]C3 |
| Zeile | R[2] |
R2 |
— |
| Spalte | C[3] |
C3 |
— |
| Bereich | R[2]C[3]:R[5]C[7] |
R2C3:R5C7 |
R2C3:R[5]C[7], R[2]C3:R5C[7] |
Beispielsweise bedeutet in Zelle D2 RC[-2] die Zelle in derselben Zeile zwei Spalten links (B2).
Formelkonstanten und Operatoren
Der integrierte Formelauswerter unterstützt logische Werte, numerische Literale, Zeichenketten, Tabellenfehlerwerte, arithmetische Operatoren und Vergleichsoperatoren.
Konstanten und Literale
| Typ | Beispiele | Hinweise |
|---|---|---|
| Logisch | TRUE, FALSE |
Kann direkt in logischen Ausdrücken wie A2=TRUE verwendet werden. |
| Numerisch | 1, 0.5, .3, 1E-2 |
Dezimal‑ und wissenschaftliche Notation werden unterstützt. |
| Zeichenkette | "abc", "2/3/2020 12:00" |
Text‑Literale werden innerhalb der Formel in doppelte Anführungszeichen eingeschlossen. |
| Fehlerergebnis | #DIV/0!, #N/A, #REF! |
Eine gültige Formel kann zu einem Tabellen‑Fehlerwert anstelle eines normalen Ergebnisses auswerten. |
Dieses Beispiel verwendet mehrere Konstantentypen:
import aspose.slides as slides
import aspose.slides.charts as charts
with slides.Presentation() as presentation:
slide = presentation.slides[0]
chart = slide.shapes.add_chart(charts.ChartType.CLUSTERED_COLUMN, 50, 50, 500, 300)
workbook = chart.chart_data.chart_data_workbook
workbook.get_cell(0, "A2").value = False
workbook.get_cell(0, "B2").formula = "A2=TRUE"
workbook.get_cell(0, "C2").formula = "1+0.5"
workbook.get_cell(0, "D2").formula = ".3*1E-2"
workbook.get_cell(0, "E2").formula = "\"abc\""
workbook.get_cell(0, "F2").formula = "2/0"
workbook.calculate_formulas()
logical_value = workbook.get_cell(0, "B2").value # Falsch
numeric_value = workbook.get_cell(0, "C2").value # 1.5
scientific_value = workbook.get_cell(0, "D2").value # 0.003
string_value = workbook.get_cell(0, "E2").value # abc
error_value = workbook.get_cell(0, "F2").value # #DIV/0!
Arithmetische Operatoren
| Operator | Bedeutung | Beispiel |
|---|---|---|
+ |
Addition oder unäres Plus | 2+3 |
- |
Subtraktion oder Negation | 2-3, -3 |
* |
Multiplikation | 2*3 |
/ |
Division | 2/3 |
% |
Prozent | 30% |
^ |
Exponentiation | 2^3 |
Verwenden Sie Klammern, um die Auswertungsreihenfolge explizit zu machen, zum Beispiel (A2+B2)*C2.
Vergleichsoperatoren
| Operator | Bedeutung | Beispiel |
|---|---|---|
= |
Gleich | A2=3 |
<> |
Ungleich | A2<>3 |
> |
Größer als | A2>3 |
>= |
Größer‑ oder gleich | A2>=3 |
< |
Kleiner als | A2<3 |
<= |
Kleiner‑ oder gleich | A2<=3 |
Unterstützte vordefinierte Funktionen
Aspose.Slides enthält einen integrierten Formelauswerter für Diagramm‑Arbeitsblätter, ist jedoch keine vollständige Excel‑Berechnungs‑Engine. Der dokumentierte Funktionsumfang ist auf die unten aufgeführten Funktionen beschränkt. Gehen Sie nicht davon aus, dass eine beliebige Excel‑Funktion von calculate_formulas neu berechnet werden kann.
| Funktion | Zweck oder unterstützte Form | Beispiel |
|---|---|---|
ABS |
Betrag | ABS(A2) |
AVERAGE |
Arithmetisches Mittel | AVERAGE(B2:B5) |
CEILING |
Auf ein Vielfaches aufrunden | CEILING(A2,5) |
CHOOSE |
Wert nach Index auswählen | CHOOSE(A2,"Low","High") |
CONCAT |
Textwerte verketten | CONCAT(A2,B2) |
CONCATENATE |
Textwerte verketten | CONCATENATE(A2," ",B2) |
DATE |
Datumwert mit 1900‑Datumsystem erstellen | DATE(2026,8,19) |
DAYS |
Anzahl Tage zwischen Daten zurückgeben | DAYS(B2,A2) |
FIND |
Ein Text innerhalb eines anderen finden | FIND("-",A2) |
FINDB |
Byte‑orientierte Textsuche | FINDB("a",A2) |
IF |
Bedingtes Ergebnis | IF(A2>0,A2,0) |
INDEX |
Referenzform | INDEX(A2:C4,2,3) |
LOOKUP |
Vektorform | LOOKUP(A2,B2:B5,C2:C5) |
MATCH |
Vektorform | MATCH(A2,B2:B5,0) |
MAX |
Maximum | MAX(B2:B5) |
SUM |
Summe | SUM(B2:B5) |
VLOOKUP |
Vertikaler Suchen | VLOOKUP(A2,B2:D10,3,FALSE) |
Die in der Tabelle gezeigten Einschränkungen sind bedeutend: INDEX ist in Referenzform dokumentiert, während LOOKUP und MATCH in ihren Vektorformen dokumentiert sind. DATE verwendet das 1900‑Datumsystem. Funktionen und Features, die hier nicht aufgeführt sind, sollten als nicht unterstützt vom Aspose.Slides‑Formelauswerter betrachtet werden, sofern sie nicht gesondert dokumentiert sind.
Formeln mit bevorzugter Kultur berechnen
Einige Funktionen der Diagramm‑Arbeitsmappe interpretieren Text nach kulturspezifischen Regeln. Das ist besonders wichtig für Funktionen, die für Sprachen mit Double‑Byte‑Character‑Sets (DBCS) gedacht sind. Um solche Formeln korrekt zu berechnen, erstellen Sie LoadOptions, setzen Sie SpreadsheetOptions.preferred_culture über LoadOptions.spreadsheet_options, und laden dann die Präsentation.
Das folgende Beispiel wählt die japanische Kultur aus, öffnet eine Präsentation mit den konfigurierten Ladeoptionen und ruft für jede Diagramm‑Arbeitsmappe ChartDataWorkbook.calculate_formulas auf:
import aspose.slides as slides
import aspose.slides.charts as charts
load_options = slides.LoadOptions()
load_options.spreadsheet_options.preferred_culture = "ja-JP"
with slides.Presentation("presentation.pptx", load_options) as presentation:
for slide in presentation.slides:
for shape in slide.shapes:
if isinstance(shape, charts.Chart):
shape.chart_data.chart_data_workbook.calculate_formulas()
Die bevorzugte Kultur ist Teil der Präsentations‑Ladekonfiguration, daher geben Sie sie an, bevor Sie die Presentation‑Instanz erstellen. Verwenden Sie die Kultur, die von den Arbeitsblatt‑Formeln erwartet wird; zum Beispiel ja-JP für Formeln, die den japanischen DBCS‑Berechnungsregeln folgen sollen.
Neuberechnung und zwischengespeicherte Werte
Tabellendateien speichern in der Regel sowohl eine Formel als auch ihren zuletzt berechneten Wert. Aspose.Slides kann daher beim Laden einer Präsentation einen zwischengespeicherten Wert aus IChartDataCell.value auslesen, sofern die zugehörigen Diagrammdaten nicht geändert wurden.
Nach dem Ändern von Eingabezellen oder Formeln sollten Sie sich nicht auf ein altes zwischengespeichertes Ergebnis verlassen. Rufen Sie ChartDataWorkbook.calculate_formulas auf, bevor Sie berechnete Werte lesen oder Diagrammdaten speichern, die davon abhängen.
Für Formeln außerhalb des unterstützten Subsets kann Aspose.Slides die Formel möglicherweise nicht parsen oder ihre Abhängigkeiten ermitteln. Wenn die Arbeitsmappe geändert wurde, kann der vorherige zwischengespeicherte Wert nicht mehr als zuverlässig angesehen werden. In diesem Fall kann das Auslesen des Werts einer Zelle mit nicht unterstützten Daten die Ausnahme CellUnsupportedDataException auslösen.
Wenn Ihr Diagramm von Excel‑Funktionen abhängt, die Aspose.Slides nicht auswertet, berechnen Sie diese Formeln mit einer Tabellen‑Engine, die sie unterstützt, und schreiben Sie die resultierenden Werte zurück in das Diagramm‑Arbeitsbuch. Ersetzen Sie nicht‑unterstützte Formeln nicht durch geschätzte Werte.
Formelfehler behandeln
Es gibt zwei verschiedene Arten von Problemen zu unterscheiden.
Eine Formel kann gültig sein, aber ein Tabellen‑Fehlerergebnis wie #DIV/0!, #N/A, #NAME?, #NULL!, #NUM!, #REF! oder #VALUE! erzeugen. In diesem Fall ist das Fehlertoken ein Zellergebnis und kann über value zurückgegeben werden.
Eine Formel kann zudem beim Parsen, bei Referenzen, Abhängigkeiten oder auf Ebene unterstützter Daten fehlschlagen. Aspose.Slides stellt für diese Fälle tabellenspezifische Ausnahmen bereit: CellInvalidFormulaException, CellInvalidReferenceException, CellCircularReferenceException und CellUnsupportedDataException.
Wenn Formeln aus Vorlagen oder Benutzereingaben stammen, fangen Sie diese Ausnahmen beim Neuberechnen und beim Zugriff auf Werte ab:
import aspose.slides as slides
import aspose.slides.charts as charts
import aspose.slides.spreadsheet as spreadsheet
with slides.Presentation() as presentation:
slide = presentation.slides[0]
chart = slide.shapes.add_chart(charts.ChartType.CLUSTERED_COLUMN, 50, 50, 500, 300)
workbook = chart.chart_data.chart_data_workbook
cell = workbook.get_cell(0, "A2")
cell.formula = "SUM(B2:B5)"
try:
workbook.calculate_formulas()
print(cell.value)
except spreadsheet.CellInvalidFormulaException as ex:
print(f"Invalid formula: {ex}")
except spreadsheet.CellInvalidReferenceException as ex:
print(f"Invalid cell reference: {ex}")
except spreadsheet.CellCircularReferenceException as ex:
print(f"Circular reference: {ex}")
except spreadsheet.CellUnsupportedDataException as ex:
print(f"Unsupported spreadsheet data: {ex}")
Praktische Einschränkungen
Die Formelunterstützung in Diagramm‑Arbeitsblättern ist für ein definiertes Subset von Tabellenkalkulationen gedacht, nicht für vollständige Excel‑Kompatibilität. Berücksichtigen Sie diese Einschränkungen beim Entwerfen eines Reporting‑Workflows:
- Verwenden Sie nur die dokumentierten Konstanten, Operatoren, Referenzen und Funktionen, wenn Aspose.Slides Formeln neu berechnen soll.
- Berechnen Sie neu, nachdem Sie Zellen geändert haben, von denen Formelresultate abhängen.
- Betrachten Sie zwischengespeicherte Werte geladener Präsentationen als Momentaufnahmen, nicht als Ersatz für eine Neuberechnung nach Änderungen.
- Testen Sie Formeln aus bestehenden Vorlagen, bevor Sie sich auf deren berechnete Werte verlassen, insbesondere wenn sie Funktionen außerhalb der dokumentierten Liste verwenden.
- Für Formeln, die eine vollständige Tabellen‑Engine benötigen, berechnen Sie sie extern und aktualisieren anschließend das Diagramm‑Arbeitsbuch mit den resultierenden Werten.
FAQ
Was ist der Unterschied zwischen formula und r1c1_formula?
formula speichert einen A1‑Stil‑Ausdruck wie B2-C2. r1c1_formula speichert einen R1C1‑Stil‑Ausdruck wie RC[-2]-RC[-1]. Verwenden Sie die Notation, die am besten zu Ihrer Erzeugungs‑ oder Kopierweise von Formeln passt.
Muss ich nach der Berechnung die Zelle selbst oder ihren Wert auslesen?
ChartDataWorkbook.get_cell gibt ein IChartDataCell zurück. Um das berechnete Ergebnis zu erhalten, lesen Sie nach der Neuberechnung die value‑Eigenschaft dieser Zelle.
Wann sollte ich calculate_formulas aufrufen?
Rufen Sie calculate_formulas auf, nachdem Sie Eingabewerte oder Formeln geändert haben und bevor Sie von den berechneten Ergebnissen abhängen. Dadurch werden die Werte der von dem integrierten Auswerter unterstützten Formeln aktualisiert.
Unterstützt Aspose.Slides jede Excel‑Funktion?
Nein. Der integrierte Auswerter unterstützt ein dokumentiertes Subset von Funktionen. Funktionen außerhalb dieses Subsets sollten nicht als korrekt neu berechnet angenommen werden. Wenn vollständige Excel‑Formel‑Kompatibilität erforderlich ist, führen Sie die Berechnung mit einer geeigneten Tabellen‑Engine durch und schreiben die Endwerte in das Diagramm‑Arbeitsbuch.
Was passiert, wenn eine geladene Präsentation eine nicht unterstützte Formel enthält?
Wenn die Diagrammdaten nicht geändert wurden, kann die Arbeitsmappe noch einen zuvor berechneten zwischengespeicherten Wert enthalten. Nach einer Änderung der zugehörigen Daten ist dieser zwischengespeicherte Wert möglicherweise nicht mehr gültig. Der Zugriff auf eine Zelle, deren Formel nicht verarbeitet werden kann, kann die Ausnahme CellUnsupportedDataException auslösen.
Sind Formel‑Fehlerwerte das Gleiche wie Python‑Ausnahmen?
Nein. Ein Ergebnis wie #DIV/0! ist ein Tabellenwert, der durch eine gültige Berechnung erzeugt wird. Ausnahmen wie CellInvalidFormulaException oder CellCircularReferenceException zeigen an, dass die Formel nicht normal verarbeitet werden kann.
Wird ein Diagramm automatisch aktualisiert, wenn sich eine Formelzelle ändert?
Eine Diagrammserie kann auf Arbeitsblattzellen verweisen. Berechnen Sie zunächst die Arbeitsmappe neu, dann speichern oder rendern Sie die Präsentation. Verweisen die Diagrammdatenpunkte auf die berechneten Zellen, verwendet das Diagramm diese aktualisierten Zellwerte; ein separater Chart‑Refresh‑Aufruf ist für diesen Workflow nicht erforderlich.
Können Diagramme ein externes Excel‑Arbeitsbuch verwenden?
Ja, Diagrammdaten können so konfiguriert werden, dass sie ein externes Arbeitsbuch verwenden, über die Diagrammdaten‑API. Allerdings bezieht sich der in diesem Artikel beschriebene Formel‑Berechnungs‑Workflow auf das Diagramm‑Arbeitsbuch und das von Aspose.Slides bewertete Formel‑Subset. Gehen Sie nicht davon aus, dass calculate_formulas eine vollständige Neuberechnung beliebiger Formeln in einer externen XLSX‑Datei liefert.
Kann ich Formeln verwenden, die ein anderes Arbeitsblatt oder Arbeitsbuch referenzieren?
Excel‑artige Verweise können in Diagramm‑Arbeitsmappen vorkommen, die Formel‑Auswertung ist jedoch durch den unterstützten Parser und Funktionsumfang begrenzt. Wenn ein bereichsübergreifender oder externer Verweis wesentlich ist, prüfen Sie die genaue Formel mit Ihrer Ziel‑Aspose.Slides‑Version. Für Workflows, die breite Excel‑Referenz‑Kompatibilität erfordern, berechnen Sie das Arbeitsbuch extern und schreiben die aufgelösten Werte zurück in die Diagrammdaten.
Sollten Formelfolgen mit = beginnen?
Die Aspose.Slides‑API‑Beispiele weisen Ausdrücke wie B2-C2 oder SUM(B2:B5) ohne führendes = zu. Die Verwendung dieser Form hält generierte Formeln konsistent mit den dokumentierten API‑Beispiele.