Applicare le formule del foglio di lavoro del grafico nelle presentazioni con Java

Panoramica

Un foglio di lavoro del grafico è la fonte di dati dietro un grafico in una presentazione. Memorizza i nomi delle categorie e delle serie insieme ai valori numerici visualizzati dal grafico. In Aspose.Slides, questo foglio di lavoro è disponibile tramite la cartella di lavoro dei dati del grafico, che consente di lavorare con i dati del grafico programmaticamente.

Questo articolo spiega come utilizzare le formule del foglio di lavoro nei dati del grafico affinché i valori delle celle possano essere calcolati e aggiornati automaticamente invece di essere inseriti manualmente. Mostra come assegnare formule, utilizzare riferimenti sia in stile A1 sia in stile R1C1, ricalcolare le formule della cartella di lavoro e lavorare con le costanti, gli operatori, i riferimenti alle celle e le funzioni predefinite supportate per i fogli di lavoro dei grafici nelle presentazioni.

Informazioni sulle formule del foglio di calcolo del grafico nelle presentazioni

Chart spreadsheet (o foglio di lavoro del grafico) in una presentazione è la fonte di dati del grafico. Il foglio di calcolo del grafico contiene i dati, che sono rappresentati sul grafico in forma grafica. Quando si crea un grafico in PowerPoint, il foglio di lavoro associato a quel grafico viene creato automaticamente. Il foglio di lavoro del grafico viene creato per tutti i tipi di grafici: grafico a linee, istogramma, grafico a bolle, grafico a torta, ecc. Per vedere il foglio di calcolo del grafico in PowerPoint è necessario fare doppio clic sul grafico:

todo:image_alt_text

Il foglio di calcolo del grafico contiene i nomi degli elementi del grafico (Nome categoria: Category1, Nome serie) e una tabella con dati numerici appropriati a queste categorie e serie. Per impostazione predefinita, quando si crea un nuovo grafico, i dati del foglio di calcolo del grafico vengono impostati con i dati predefiniti. È quindi possibile modificare manualmente i dati del foglio di calcolo nel foglio di lavoro.

Di solito, il grafico rappresenta dati complessi (ad esempio per analisti finanziari o scientifici), con celle calcolate a partire dai valori di altre celle o da altri dati dinamici. Calcolare manualmente il valore di una cella e inserirlo in modo statico rende difficile modificarlo in futuro. Se si modifica il valore di una certa cella, tutte le celle dipendenti da essa dovranno essere aggiornate. Inoltre, i dati della tabella possono dipendere da dati di altre tabelle, creando uno schema di dati di presentazione complesso che deve poter essere aggiornato in modo semplice e flessibile.

Chart spreadsheet formula in una presentazione è un’espressione per calcolare e aggiornare automaticamente i dati del foglio di calcolo del grafico. La formula del foglio di calcolo definisce la logica di calcolo dei dati per una determinata cella o per un insieme di celle. È una formula matematica o logica che utilizza: riferimenti a celle, funzioni matematiche, operatori logici, operatori aritmetici, funzioni di conversione, costanti di stringa, ecc. La definizione della formula è scritta in una cella, e quella cella non contiene un valore semplice. La formula del foglio di calcolo calcola il valore e lo restituisce, quindi questo valore viene assegnato alla cella. Le formule del foglio di calcolo del grafico nelle presentazioni sono in realtà le stesse delle formule di Excel, e sono supportate le stesse funzioni, operatori e costanti predefinite per la loro implementazione.

In Aspose.Slides il foglio di calcolo del grafico è rappresentato con il metodo Chart.getChartData.getChartDataWorkbook del tipo IChartDataWorkbook. Una formula del foglio di calcolo può essere assegnata e modificata con il metodo IChartDataCell.setFormula. Sono supportate le seguenti funzionalità per le formule in Aspose.Slides:

  • Costanti logiche
  • Costanti numeriche
  • Costanti di stringa
  • Costanti di errore
  • Operatori aritmetici
  • Operatori di confronto
  • Riferimenti a celle in stile A1
  • Riferimenti a celle in stile R1C1
  • Funzioni predefinite

Tipicamente, i fogli di calcolo memorizzano i valori delle formule calcolati per l’ultima volta. Se, dopo il caricamento della presentazione, i dati del grafico non sono stati modificati, il metodo IChartDataCell.getValue restituisce quei valori durante la lettura. Tuttavia, se i dati del foglio di calcolo sono stati modificati, durante la lettura la proprietà ChartDataCell.Value genera l’eccezione CellUnsupportedDataException per le formule non supportate. Questo accade perché, quando le formule vengono analizzate correttamente, le dipendenze delle celle sono determinate e la correttezza degli ultimi valori è verificata. Se la formula non può essere analizzata, non è possibile garantire la correttezza del valore della cella.

Aggiungere una formula del foglio di calcolo del grafico a una presentazione

Per prima cosa, aggiungi un grafico alla prima diapositiva di una nuova presentazione con IShapeCollection.getShapes.addChart. Il foglio di lavoro del grafico viene creato automaticamente e può essere raggiunto con Chart.getChartData.getChartDataWorkbook method:

Presentation pres = new Presentation();
try {
    IChart chart = pres.getSlides().get_Item(0).getShapes().addChart(ChartType.ClusteredColumn, 150, 150, 500, 300);

    IChartDataWorkbook workbook = chart.getChartData().getChartDataWorkbook();

    // ...
} finally {
    if (pres != null) pres.dispose();
}

Scriviamo alcuni valori nelle celle con IChartDataCell.setValue property del tipo Object, il che significa che è possibile impostare qualsiasi valore alla proprietà:

workbook.getCell(0, "F2").setValue(-2.5);

workbook.getCell(0, "G3").setValue(6.3);

workbook.getCell(0, "H4").setValue(3);

Ora, per scrivere una formula nella cella, è possibile utilizzare il IChartDataCell.setFormula method:

Nota: IChartDataCell.setFormula method è usato per impostare riferimenti a celle in stile A1.

Per impostare il riferimento alla cella R1C1Formula è possibile utilizzare il metodo IChartDataCell.setR1C1Formula:

Se poi si tenta di leggere i valori dalle celle B2 e C2, questi verranno calcolati:

Object value1 = cell1.getValue(); // 7.8

Object value2 = cell2.getValue(); // 2.1

Costanti logiche

È possibile utilizzare costanti logiche come FALSE e TRUE nelle formule delle celle:

workbook.getCell(0, "A2").setValue(false);
IChartDataCell cell = workbook.getCell(0, "B2");
cell.setFormula("A2 = TRUE");
Object value = cell.getValue(); // il valore contiene booleano "false"

Costanti numeriche

I numeri possono essere usati in notazione comune o scientifica per creare una formula del foglio di calcolo del grafico:

workbook.getCell(0, "A2").setFormula("1 + 0.5");
workbook.getCell(0, "B2").setFormula(".3 * 1E-2");

Costanti stringa

Una costante stringa (o letterale) è un valore specifico che viene utilizzato così com’è e non cambia. Le costanti stringa possono essere: date, testi, numeri, ecc.:

workbook.getCell(0, "A2").setFormula("\"abc\"");
workbook.getCell(0, "B2").setFormula("\"2/3/2020 12:00\"");

Costanti di errore

A volte non è possibile calcolare il risultato mediante la formula. In tal caso, nel luogo del valore viene mostrato il codice di errore. Ogni tipo di errore ha un codice specifico:

  • #DIV/0! – la formula tenta di dividere per zero.
  • #GETTING_DATA – può comparire in una cella mentre il suo valore è ancora in fase di calcolo.
  • #N/A – le informazioni sono mancanti o non disponibili. Alcune cause possono essere: le celle usate nella formula sono vuote, un carattere spazio extra, errori di battitura, ecc.
  • #NAME? – una certa cella o altri oggetti della formula non possono essere trovati per nome.
  • #NULL! – può apparire quando c’è un errore nella formula, ad esempio: (,) o un carattere spazio usato al posto dei due punti (:).
  • #NUM! – il valore numerico nella formula è invalido, troppo lungo o troppo corto, ecc.
  • #REF! – riferimento a cella non valido.
  • #VALUE! – tipo di valore inatteso. Per esempio, valore stringa impostato in una cella numerica.
IChartDataCell cell = workbook.getCell(0, "A2");
cell.setFormula("2 / 0");
Object value = cell.getValue(); // il valore contiene la stringa "#DIV/0!"

Operatori aritmetici

È possibile utilizzare tutti gli operatori aritmetici nelle formule del foglio di lavoro del grafico:

Operatore Significato Esempio
+ (segno più) Addizione o segno più unario 2 + 3
- (segno meno) Sottrazione o negazione 2 - 3
-3
* (asterisco) Moltiplicazione 2 * 3
/ (barra obliqua) Divisione 2 / 3
% (segno percentuale) Percentuale 30%
^ (caret) Elevamento a potenza 2 ^ 3

Nota: Per modificare l’ordine di valutazione, racchiudere tra parentesi la parte della formula da calcolare per prima.

Operatori di confronto

È possibile confrontare i valori delle celle con gli operatori di confronto. Quando due valori sono confrontati con questi operatori, il risultato è un valore logico TRUE oppure FALSE:

Operatore Significato Esempio
= (segno di uguale) Uguale a A2 = 3
<> (segno di diverso) Non uguale a A2 <> 3
> (segno maggiore) Maggiore di A2 > 3
>= (maggiore o uguale) Maggiore o uguale a A2 >= 3
< (segno minore) Minore di A2 < 3
<= (minore o uguale) Minore o uguale a A2 <= 3

Riferimenti a celle in stile A1

I riferimenti a celle in stile A1 sono usati per i fogli di lavoro, dove la colonna ha un identificatore alfabetico (ad es. “A") e la riga ha un identificatore numerico (ad es. “1"). I riferimenti a celle in stile A1 possono essere utilizzati nel modo seguente:

Riferimento a cella Esempio Assoluto Relativo Misto
Assoluto Relativo Misto
Cella $A$2 A2

A$2

$A2
Riga $2:$2 2:2 -
Colonna $A:$A A:A -
Intervallo $A$2:$C$4 A2:C4

$A$2:C4

A$2:$C4

Ecco un esempio di utilizzo di un riferimento a cella in stile A1 in una formula:

workbook.getCell(0, "A2").setFormula("C3 + SUM(F2:H5)");

Riferimenti a celle in stile R1C1

I riferimenti a celle in stile R1C1 sono usati per i fogli di lavoro, dove sia la riga sia la colonna hanno un identificatore numerico. I riferimenti a celle in stile R1C1 possono essere utilizzati nel modo seguente:

Riferimento a cella Esempio Assoluto Relativo Misto
Assoluto Relativo Misto
Cella R2C3 R[2]C[3] R2C[3]
R[2]C3
Riga R2 R[2] -
Colonna C3 C[3] -
Intervallo R2C3:R5C7 R[2]C[3]:R[5]C[7] R2C3:R[5]C[7]
R[2]C3:R5C[7]

Ecco un esempio di utilizzo di un riferimento a cella in stile R1C1 in una formula:

workbook.getCell(0, "A2").setR1C1Formula("R2C4 + SUM(R5C6:R7C9)");

Funzioni predefinite

Esistono funzioni predefinite che possono essere utilizzate nelle formule per semplificarne l’implementazione. Queste funzioni racchiudono le operazioni più comunemente usate, come:

  • ABS
  • AVERAGE
  • CEILING
  • CHOOSE
  • CONCAT
  • CONCATENATE
  • DATE (sistema data 1900)
  • DAYS
  • FIND
  • FINDB
  • IF
  • INDEX (forma di riferimento)
  • LOOKUP (forma vettoriale)
  • MATCH (forma vettoriale)
  • MAX
  • SUM
  • VLOOKUP

FAQ

I file Excel esterni sono supportati come fonte di dati per un grafico con formule?

Sì. Aspose.Slides supporta cartelle di lavoro esterne come fonte dati di un grafico, consentendo di utilizzare formule da un file XLSX al di fuori della presentazione.

Le formule del grafico possono fare riferimento a fogli all’interno della stessa cartella di lavoro usando il nome del foglio?

Sì. Le formule seguono il modello di riferimento standard di Excel, quindi è possibile fare riferimento ad altri fogli all’interno della stessa cartella di lavoro o a una cartella di lavoro esterna. Per i riferimenti esterni, includere il percorso e il nome della cartella di lavoro utilizzando la sintassi di Excel.

Formattare i grafici delle presentazioni in Java Animare i grafici PowerPoint in Java