Abrufen bedingter Formatierungsregeln

Diese REST API ruft die bedingten Formatierungsregeln ab, die auf ein Arbeitsblatt angewendet werden.

Sicherheit und Authentifizierung

Die Aspose.Cells Cloud APIs sind sicher und erfordern eine JWT-Token-basierte Authentifizierung.

REST API

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

Anforderungsparameter

Parametername	Typ	Ort	Beschreibung
name	string	path	Der Name der Excel-Datei.
sheetName	string	path	Der Name des Arbeitsblatts.
folder	string	query	Der Pfad des Ordners, in dem die Datei gespeichert ist.
storageName	string	query	Der Name des Speicherdienstes (optional).

Fehlerantworten

HTTP-Code	Grund	Beispielinhalt
400	Bad Request – fehlende oder ungültige Parameter.	`{ "Code":"400", "Message":"Ungültiger Parameterwert." }`
401	Unauthorized – fehlender oder ungültiger JWT-Token.	`{ "Code":"401", "Message":"Zugriffstoken fehlt oder ist ungültig." }`
404	Not Found – Arbeitsmappe oder Arbeitsblatt existiert nicht.	`{ "Code":"404", "Message":"Datei nicht gefunden." }`
500	Internal Server Error – unerwarteter Serverfehler.	`{ "Code":"500", "Message":"Ein unerwarteter Fehler ist aufgetreten." }`

Die OpenAPI-Spezifikation definiert eine öffentlich zugängliche Programmierschnittstelle und ermöglicht REST-Interaktionen direkt aus einem Webbrowser.

Sie können das cURL-Befehlszeilentool nutzen, um Aspose.Cells-Webservices einfach aufzurufen. Das folgende Beispiel zeigt, wie ein Aufruf an die Cloud-API mit cURL erfolgt.

Anforderung

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>"

Antwort

{
  "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
              }
            }
          }
        ]
      }
    ]
  }
}

Das obige Beispiel zeigt nur die relevantesten Felder, um die Nutzlast knapp zu halten.

Antwortparameter

Parameter	Typ	Beschreibung
Status	string	Ergebnisstatus der Anforderung (z. B. OK).
ConditionalFormattings	object	Container für bedingte Formatierungsdaten.
ConditionalFormattings.Count	integer	Anzahl der zurückgegebenen bedingten Formatierungsregeln.
ConditionalFormattings.ConditionalFormattingList	array	Liste der bedingten Formatierungsobjekte.
ConditionalFormattingList[].sqref	string	Zellbereich, auf den die Formatierung angewendet wird (z. B. A1:B10).
ConditionalFormattingList[].FormatConditions	array	Sammlung von Formatbedingungsobjekten für den Bereich.
FormatConditions[].Priority	integer	Evaluationspriorität der Bedingung.
FormatConditions[].Type	string	Typ der Bedingung (z. B. CellValue).
FormatConditions[].Operator	string	Für die Bedingung verwendeter Operator (z. B. GreaterThan).
FormatConditions[].Formula1	string	Erste Formel oder der erste Wert für die Bedingung.
FormatConditions[].Style	object	Formatierung, die angewendet wird, wenn die Bedingung erfüllt ist.
Style.Font.Color	object	RGBA-Farbangabe für die Schriftart.
Style.Font.IsBold	boolean	Gibt an, ob die Schriftart fett ist.

HTTP-Statuscodes

Code	Bedeutung	Beschreibung
200	OK	Filter erfolgreich angewendet; Antwort enthält Vorgangsdetails.
400	Bad Request	Fehlende oder ungültige Parameter (z. B. nicht unterstützter Dateityp).
401	Unauthorized	Ungültiger oder fehlender JWT-Token.
413	Payload Too Large	Hochgeladene Datei überschreitet die Größenbeschränkung.
500	Internal Server Error	Unerwarteter Serverfehler.

Cloud SDK-Familie

Die Verwendung eines SDK ist die beste Möglichkeit, die Entwicklung zu beschleunigen. Ein SDK übernimmt die Low-Level-Details, sodass Sie sich auf Ihre ProjektAufgaben konzentrieren können. Bitte schauen Sie in das GitHub-Repository, um eine vollständige Liste der Aspose.Cells Cloud SDKs zu erhalten.

Die folgenden Codebeispiele zeigen, wie Aspose.Cells-Webservices mithilfe verschiedener SDKs aufgerufen werden:

Bedingte Formatierung abrufen Fügen Sie CellArea zur bedingten Formatierung hinzu