Documentation –

Developer-Guide: Aspose.Cells Cloud Web API – Somma e Conteggio per Colore in Excel

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

Panoramica

L’API consente di eseguire calcoli sui dati in base al colore delle celle. Può effettuare somme, conteggi, medie e individuare i valori massimi e minimi in un foglio elettronico Excel in base al colore di riempimento o al colore del carattere delle celle.

Operazione di Calcolo	Descrizione
Count (Conteggio)	Determina il numero di celle aventi lo stesso colore.
Sum (Somma)	Calcola il valore totale delle celle aventi lo stesso colore.
Max Value (Valore Massimo)	Identifica il valore più alto tra le celle dello stesso colore.
Min Value (Valore Minimo)	Individua il valore più basso tra le celle dello stesso colore.
Average Value (Valore Medio)	Calcola il valore medio delle celle dello stesso colore.

Web API

PUT https://api.aspose.cloud/v4.0/cells/calculate/aggregate/color

Sicurezza e Autenticazione

Le API Aspose.Cells Cloud sono sicure e richiedono l’autenticazione tramite token JWT.

Parametri della Richiesta

Nome Parametro	Tipo	Posizione	Descrizione
Spreadsheet	File	FormData	Il workbook Excel da elaborare.
Worksheet	String	Query	Nome del foglio di lavoro contenente l’intervallo.
Range	String	Query	Intervallo in stile A‑1 (es. `A1:B10`).
Operation	String	Query	Metodo di calcolo – `Sum`, `Count`, `Average`, `Min` o `Max`.
ColorPosition	String	Query	Determina quale colore valutare – `Background`, `Font`.
Region	String	Query	Impostazione della regione del foglio elettronico (es. `us-east-1`).
Password	String	Query	Password per aprire un workbook protetto (opzionale).

Enumerazioni

ColorPosition

Valore Significato

Background Utilizza il colore di riempimento della cella.

Font Utilizza il colore del carattere della cella.

Valore	Significato
Background	Utilizza il colore di riempimento della cella.
Font	Utilizza il colore del carattere della cella.

Esempio di richiesta multipart/form‑data

curl -X PUT "https://api.aspose.cloud/v4.0/cells/calculate/aggregate/color?Worksheet=Sheet1&Range=A1:B10&Operation=Sum&ColorPosition=Background" \
  -H "Authorization: Bearer <access_token>" \
  -F "Spreadsheet=@/path/to/workbook.xlsx"

Risposta

Lo schema seguente descrive l’oggetto di risposta. Segue un esempio concreto.

{
  "Name": "AggregateResultByColorResponse",
  "Type": "Class",
  "ParentName": "CellsCloudResponse",
  "IsAbstract": false,
  "Properties": [
    {
      "Name": "AggregateResults",
      "DataType": {
        "Identifier": "Array",
        "Reference": "AggregateResultByColor",
        "ElementDataType": {
          "Reference": "AggregateResultByColor"
        }
      }
    },
    {
      "Name": "Code",
      "DataType": { "Identifier": "Integer" }
    },
    {
      "Name": "Status",
      "DataType": { "Identifier": "String" }
    }
  ]
}

Esempio di risposta (valori reali)

{
  "Code": 200,
  "Status": "OK",
  "AggregateResults": [
    {
      "Color": "#FF0000",
      "Count": 12,
      "Sum": 345.67,
      "Average": 28.8,
      "Min": 5.0,
      "Max": 80.0
    },
    {
      "Color": "#00FF00",
      "Count": 7,
      "Sum": 210.0,
      "Average": 30.0,
      "Min": 10.0,
      "Max": 50.0
    }
  ]
}

Codici di Stato HTTP

Codice	Significato	Descrizione
200	OK	Filtro applicato correttamente; la risposta contiene i dettagli dell’operazione.
400	Bad Request	Parametri mancanti o non validi (es. tipo di file non supportato).
401	Unauthorized	Token JWT non valido o mancante.
413	Payload Too Large	Il file caricato supera il limite di dimensione.
500	Internal Server Error	Errore imprevisto nel server.

Dove utilizzare l’API Aggregate by Color?

In un foglio elettronico, i dati appartenenti a diverse categorie sono spesso codificati a colori. Questa API consente di effettuare somme, conteggi, medie o individuare i valori minimi e massimi per ogni gruppo di colore, semplificando l’analisi dei dati basata sul colore.

Perché utilizzare l’API Aggregate by Color?

L’API fornisce un modo rapido e affidabile per eseguire calcoli basati sul colore, senza dover scrivere logica di parsing personalizzata. Si integra perfettamente con gli SDK Aspose.Cells Cloud, consentendo agli sviluppatori di implementare l’aggregazione per colore in pochissime righe di codice.

Come utilizzare l’API Aggregate by Color con gli SDK

Specifica dell’API Aggregate by Color

La Specifica dell’API Aggregate by Color definisce un’interfaccia di programmazione accessibile pubblicamente e consente di eseguire interazioni REST direttamente da un browser web.

Utilizzare gli SDK Aspose.Cells Cloud

L’utilizzo dell’SDK rappresenta il metodo più veloce per lo sviluppo, poiché astrae i dettagli di basso livello, consentendo di aggregare i calcoli per colore della cella con pochissime righe di codice.
Consultare il repository GitHub per un elenco completo degli SDK Aspose.Cells Cloud.

I seguenti esempi di codice mostrano come effettuare chiamate ai servizi web Aspose.Cells Cloud utilizzando vari SDK:

Note:

Quando si lavora con workbook protetti, includere il parametro di query opzionale Password; altrimenti la richiesta fallirà con un errore 401.
La dimensione massima della richiesta per il file Spreadsheet è di 100 MB. Se è necessario elaborare file più grandi, considerare di caricare prima il workbook nello storage Aspose Cloud e farvi riferimento tramite il parametro Path (non mostrato qui).

Developer-Guide: Calcola Formula

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

La funzione Calcola Formula dei Web Service Aspose.Cells Cloud

Calcola una formula specificata in un foglio di calcolo fornito e restituisce il foglio di calcolo risultante come flusso di file. Questa operazione supporta l’elaborazione in base alle impostazioni locali tramite il parametro region e può aprire file protetti da password.

Endpoint dell’API Web

PUT https://api.aspose.cloud/v4.0/cells/calculate/formula

Sicurezza e autenticazione

Le API di Aspose.Cells Cloud sono sicure e richiedono l’autenticazione basata su token JWT.

Parametri della richiesta

Nome Parametro	Tipo	Percorso/Stringa di query/Corpo HTTP	Descrizione
Spreadsheet	File	FormData	Carica il file del foglio di calcolo.
worksheet	String	Query	Nome del foglio di calcolo contenente la formula.
formula	String	Query	La formula da calcolare (es. `=SUM(A1:B2)`).
region	String	Query	Impostazione di area/geolocalizzazione del foglio di calcolo (es. `it-IT`, `fr-FR`). Influenza la formattazione dei numeri, l’analisi delle date e il comportamento specifico per le impostazioni locali.
password	String	Query	La password per aprire il file del foglio di calcolo.

Parametro del corpo della richiesta

Nome Parametro	Tipo	Descrizione
[DA DEFINIRE]	[DA DEFINIRE]	[DA DEFINIRE]

Risposta

{
  "File": "<flusso binario del foglio di calcolo risultante>"
}

Codici di stato della risposta

Codice	Significato	Descrizione
200	OK	Calcolo completato con successo; il file del foglio di calcolo risultante viene restituito.
400	Richiesta non valida	Uno o più parametri della richiesta sono mancanti o non validi.
401	Non autorizzato	Autenticazione fallita o token JWT mancante/non valido.
413	Payload troppo grande	Il file caricato supera il limite di dimensione consentito.
500	Errore interno del server	Si è verificato un errore imprevisto sul server.

Come utilizzare la funzione Calcola Formula con gli SDK

Specifica della funzione Calcola Formula

La Specifica dell’API Calcola Formula definisce un’interfaccia di programmazione pubblicamente accessibile e consente di effettuare interazioni REST direttamente da un browser web.

Puoi utilizzare lo strumento a riga di comando cURL per accedere facilmente ai servizi web di Aspose Cells Cloud. L’esempio seguente mostra come effettuare chiamate all’API Cloud con cURL.

{< tabs tabTotal=“2” tabID=“1” tabName1=“Richiesta” tabName2=“Risposta” >}

{< tab tabNum=“1” >}

# Utilizzare HTTPS per una connessione sicura
curl -v "https://api.aspose.cloud/v4.0/cells/calculate/formula?worksheet=Sheet1&formula=%3DSUM(A1%3AB2)&region=it-IT&password=MyPassword" \
  -X PUT \
  -H "Content-Type: multipart/form-data" \
  -H "Accept: application/octet-stream" \
  -H "Authorization: Bearer <jwt token>" \
  -F "Spreadsheet=@sample.xlsx"

{< /tab >}

{< tab tabNum=“2” >}

{
  "File": "<flusso binario del foglio di calcolo risultante>"
}

{< /tab >}

{< /tabs >}

Utilizzare gli SDK di Aspose Cells Cloud

L’utilizzo di un SDK è il modo più rapido per accelerare lo sviluppo. Un SDK astrae i dettagli di basso livello, consentendoti di concentrarti sulle attività del tuo progetto. Consulta il repository GitHub per un elenco completo degli SDK di Aspose.Cells Cloud.

I seguenti esempi di codice mostrano come chiamare i servizi web di Aspose Cells Cloud utilizzando vari SDK: `[DA DEFINIRE]`

Developer-Guide:

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

title: “Aspose.Cells Cloud – API di calcolo matematico (Add, Subtract, Multiply, Divide, %)” second_title: “Documento” ArticleTitle: “Add, Subtract, Multiply, Divide e Percentuale nei fogli di calcolo/Excel” linktitle: “Calcolo matematico” type: docs url: /math-calculate/ keywords: “API di calcolo matematico, Aspose.Cells Cloud, calcoli Excel, addizione, sottrazione, moltiplicazione, divisione, percentuale, elaborazione in blocco di file Excel, API REST” description: “Scopri come utilizzare l’API di calcolo matematico di Aspose.Cells Cloud per applicare in blocco operazioni di addizione, sottrazione, moltiplicazione, divisione o percentuale su intervalli di Excel. Include il formato della richiesta, codice di esempio e gestione degli errori.” weight: 100

Introduzione: Calcolo rapido nei fogli di calcolo – Formule per addizione, moltiplicazione, sottrazione, divisione e percentuale in un’unica API in esecuzione

Esegui calcoli in blocco su intere colonne, righe o tabelle senza scrivere alcuna formula.

Operazioni matematiche di base: aggiungi, sottrai, moltiplica o dividi ogni cella di un intervallo per qualsiasi numero
Percentuali: aumenta/riduci di una percentuale, oppure calcola la percentuale di un numero (es. +15%, -8%, 20% di…)
Elaborazione in blocco: applica a migliaia di celle istantaneamente—nessuna trascinamento di riempimento, nessuna formula matriciale, nessun VBA

Operazione di calcolo	Descrizione
Add (Addizione)	+
Subtract (Sottrazione)	-
Multiply (Moltiplicazione)	*
Divide (Divisione)	/
Percentage (Percentuale)	%

API di calcolo matematico

PUT https://api.aspose.cloud/v4.0/cells/calculate/math

Sicurezza e autenticazione

Le API di Aspose.Cells Cloud sono sicure e richiedono l’autenticazione basata su token JWT.

Parametri della richiesta:

Nome parametro	Tipo	Percorso/Stringa di query/Corpo HTTP	Descrizione
Spreadsheet	File	FormData	Carica il file del foglio di calcolo da elaborare.
operation	String	Query	L’operazione matematica da eseguire (Add, Subtract, Multiply, Divide, Percentage).
value	String	Query	Un valore da utilizzare nel calcolo, se applicabile.
worksheet	String	Query	Il nome del foglio di calcolo su cui operare.
range	String	Query	L’intervallo di celle da includere nel calcolo.
region	String	Query	L’impostazione della regione del foglio di calcolo.
password	String	Query	La password per aprire il file del foglio di calcolo, se protetto.

Risposta

[
  {
    "Name": "ResponseFile",
    "DataType": {
      "Identifier": "File",
      "Reference": "Stream",
      "Name": "file"
    }
  }
]

Codici di stato HTTP

Codice	Significato	Descrizione
200	OK	Filtro applicato correttamente; la risposta contiene i dettagli dell’operazione.
400	Richiesta non valida	Parametri mancanti o non validi (es. tipo di file non supportato).
401	Non autorizzato	Token JWT non valido o mancante.
413	Payload troppo grande	Il file caricato supera il limite di dimensione.
500	Errore interno del server	Errore imprevisto del server.

Dove dovresti utilizzare l’API di calcolo matematico?

Finanza: aggiungi l’13% di IVA a un’intera colonna di prezzi di acquisto.
Inventario: moltiplica la colonna dei kg per 2,2046 per convertire in blocco in libbre.
Retribuzioni: aggiungi un bonus fisso di 1.000 alla colonna dei bonus per tutto lo staff.
Conversione valuta estera (FX): dividi la colonna delle vendite per il tasso di cambio corrente per ottenere importi in USD.
Valutazione: sottrai 5 punti da ogni voto degli studenti come penalità per assenteismo.
E-commerce: applica uno sconto promozionale del 15% riducendo in un solo click i prezzi dei prodotti.

Perché dovresti utilizzare l’API di calcolo matematico?

Calcoli Excel veloci – completa i report di fine mese in pochi secondi.
Aumento percentuale in blocco su Excel – aggiorna prezzi, previsioni, commissioni in un solo click.
Aggiungi lo stesso numero a tutta una colonna – inventario, conversione valuta, conversione unità.
Excel senza formule – gli utenti non tecnici apprezzano la semplicità.
Lo sviluppo può essere completato rapidamente sfruttando gli SDK esistenti.

Note
La dimensione massima del file supportata è 200 MB. Il parametro range deve essere un indirizzo Excel valido (es. A1:B10). Fogli di calcolo molto grandi potrebbero richiedere un tempo di elaborazione aggiuntivo.

Come utilizzare l’API di calcolo matematico con gli SDK

Specifica dell’API di calcolo matematico

La Specifiche dell’API di calcolo matematico definisce un’interfaccia di programmazione accessibile pubblicamente, consentendo agli sviluppatori di interagire direttamente con l’API da un browser web.

Utilizzare gli SDK di Aspose.Cells Cloud

Utilizzare gli SDK è il modo più rapido per sviluppare, poiché nasconde i dettagli di basso livello, permettendoti di eseguire calcoli matematici per cella con pochissimo codice.
Consulta gli SDK di Aspose.Cells Cloud su GitHub per un elenco completo degli SDK disponibili.

I seguenti esempi di codice mostrano come effettuare chiamate ai servizi web di Aspose.Cells utilizzando vari SDK:

Documentation –

Developer-Guide: Aspose.Cells Cloud Web API – Somma e Conteggio per Colore in Excel

Panoramica

Web API

Sicurezza e Autenticazione

Parametri della Richiesta

Enumerazioni

Risposta

Dove utilizzare l’API Aggregate by Color?

Perché utilizzare l’API Aggregate by Color?

Come utilizzare l’API Aggregate by Color con gli SDK

Specifica dell’API Aggregate by Color

Utilizzare gli SDK Aspose.Cells Cloud

Developer-Guide: Calcola Formula

La funzione Calcola Formula dei Web Service Aspose.Cells Cloud

Endpoint dell’API Web

Sicurezza e autenticazione

Parametri della richiesta

Parametro del corpo della richiesta

Risposta

Come utilizzare la funzione Calcola Formula con gli SDK

Specifica della funzione Calcola Formula

Utilizzare gli SDK di Aspose Cells Cloud

I seguenti esempi di codice mostrano come chiamare i servizi web di Aspose Cells Cloud utilizzando vari SDK: [DA DEFINIRE]

Developer-Guide:

Introduzione: Calcolo rapido nei fogli di calcolo – Formule per addizione, moltiplicazione, sottrazione, divisione e percentuale in un’unica API in esecuzione

API di calcolo matematico

Sicurezza e autenticazione

Parametri della richiesta:

Risposta

Dove dovresti utilizzare l’API di calcolo matematico?

Perché dovresti utilizzare l’API di calcolo matematico?

Come utilizzare l’API di calcolo matematico con gli SDK

Specifica dell’API di calcolo matematico

Utilizzare gli SDK di Aspose.Cells Cloud

I seguenti esempi di codice mostrano come chiamare i servizi web di Aspose Cells Cloud utilizzando vari SDK: `[DA DEFINIRE]`