Ottenere le regole di formattazione condizionale

Questa API REST recupera le regole di formattazione condizionale applicate a un foglio di lavoro.

Sicurezza e autenticazione

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

API REST

GET https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/conditionalFormattings

Parametri della richiesta

Nome parametro	Tipo	Posizione	Descrizione
name	string	path	Il nome del file Excel.
sheetName	string	path	Il nome del foglio di lavoro.
folder	string	query	Il percorso della cartella in cui è memorizzato il file.
storageName	string	query	Il nome del servizio di archiviazione (opzionale).

Risposte di errore

Codice HTTP	Motivo	Corpo di esempio
400	Richiesta non valida – parametri mancanti o non validi.	`{ "Code":"400", "Message":"Valore di parametro non valido." }`
401	Non autorizzato – token JWT mancante o non valido.	`{ "Code":"401", "Message":"Il token di accesso è mancante o non valido." }`
404	Non trovato – cartella di lavoro o foglio di lavoro inesistente.	`{ "Code":"404", "Message":"File non trovato." }`
500	Errore interno del server – errore imprevisto nel server.	`{ "Code":"500", "Message":"Si è verificato un errore imprevisto." }`

La Specifiche OpenAPI definiscono un’interfaccia di programmazione pubblicamente accessibile e consentono 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. L’esempio seguente mostra come effettuare una chiamata all’API Cloud con cURL.

Richiesta

curl -v "https://api.aspose.cloud/v3.0/cells/Book1.xlsx/worksheets/sheet1/conditionalFormattings" \
  -X GET \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <access_token>"

Risposta

{
  "Status": "OK",
  "ConditionalFormattings": {
    "Count": 1,
    "ConditionalFormattingList": [
      {
        "sqref": "A1:B10",
        "FormatConditions": [
          {
            "Priority": 1,
            "Type": "CellValue",
            "Operator": "GreaterThan",
            "Formula1": "100",
            "Style": {
              "Font": {
                "Color": { "A": 255, "R": 255, "G": 0, "B": 0 },
                "IsBold": true
              }
            }
          }
        ]
      }
    ]
  }
}

L’esempio precedente mostra solo i campi più rilevanti per mantenere il payload conciso.

Parametri di risposta

Parametro	Tipo	Descrizione
Status	string	Stato del risultato della richiesta (ad esempio, OK).
ConditionalFormattings	object	Contenitore per i dati di formattazione condizionale.
ConditionalFormattings.Count	integer	Numero di regole di formattazione condizionale restituite.
ConditionalFormattings.ConditionalFormattingList	array	Elenco di oggetti di formattazione condizionale.
ConditionalFormattingList[].sqref	string	Intervallo di celle a cui si applica la formattazione (ad esempio, A1:B10).
ConditionalFormattingList[].FormatConditions	array	Raccolta di oggetti di condizione di formattazione per l’intervallo.
FormatConditions[].Priority	integer	Priorità di valutazione della condizione.
FormatConditions[].Type	string	Tipo di condizione (ad esempio, CellValue).
FormatConditions[].Operator	string	Operatore utilizzato per la condizione (ad esempio, GreaterThan).
FormatConditions[].Formula1	string	Prima formula o valore per la condizione.
FormatConditions[].Style	object	Stile applicato quando la condizione è soddisfatta.
Style.Font.Color	object	Definizione colore RGBA per il carattere.
Style.Font.IsBold	boolean	Indica se il carattere è in grassetto.

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 (ad esempio, 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 nel server.

Famiglia di SDK Cloud

Utilizzare un SDK è il modo migliore per velocizzare lo sviluppo. Un SDK gestisce 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 utilizzando vari SDK:

C#

Java

PHP
Ruby

Node.js

Python
Android
Swift
Perl

Go

Aggiungi Condizione di Formato