Ein benutzerdefiniertes Kriterium in einem Excel-Arbeitsblatt hinzufügen – Aspose.Cells Cloud API

Diese REST-API filtert eine Liste mithilfe eines benutzerdefinierten Kriteriums.

PutWorksheetCustomFilter API

PUT https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/autoFilter/custom

Sicherheit und Authentifizierung

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

Anforderungsparameter:

Parametername	Typ	Standort	Beschreibung
name	string	path	Name der Excel-Datei.
sheetName	string	path	Name des Arbeitsblatts, das die zu filternden Daten enthält.
range	string	query	Zellbereich, auf den der Filter angewendet wird (z. B. `A1:B1`).
fieldIndex	integer	query	Nullbasierter Index der Spalte, auf die der Filter angewendet wird.
operatorType1	string	query	Erster Vergleichsoperator (z. B. `LessOrEqual`, `Equal`).
criteria1	string	query	Erster Filterwert oder Ausdruck.
isAnd	boolean	query	Wenn `true`, werden die beiden Kriterien mit UND verknüpft, andernfalls mit ODER.
operatorType2	string	query	Zweiter Vergleichsoperator (optional).
criteria2	string	query	Zweiter Filterwert oder Ausdruck (optional).
matchBlanks	boolean	query	Wenn `true`, werden leere Zellen in die Filterergebnisse einbezogen.
refresh	boolean	query	Wenn `true`, wird das Arbeitsblatt nach dem Anwenden des Filters aktualisiert.
folder	string	query	Ordnerpfad im Speicher, in dem sich die Datei befindet.
storageName	string	query	Name des Speicherdiensts.

Antwort

{
    "Status":"OK",
    "Code":200
}

HTTP-Statuscodes

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

Verwendung der PutWorksheetCustomFilter API mit SDKs

PutWorksheetCustomFilter API-Spezifikation

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

Sie können das cURL-Befehlszeilentool verwenden, um Aspose.Cells-Webservices einfach aufzurufen. Das folgende Beispiel zeigt, wie ein Aufruf der Cloud-API mit cURL durchgeführt wird.

Anforderung

curl -v "https://api.aspose.cloud/v3.0/cells/Book1.xlsx/worksheets/Sheet1/autoFilter/custom?range=A1:B1&fieldIndex=0&operatorType1=LessOrEqual&criteria1=1" \
  -X PUT \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <jwt token>"

Antwort

{
  "Code": 200,
  "Status": "OK"
}

Verwendung der Aspose.Cells Cloud SDKs

Die Verwendung eines SDKs ist der schnellste Weg zur Entwicklung. Ein SDK übernimmt Details auf niedriger Ebene, sodass Sie sich auf Ihre Projeklogik konzentrieren können. Eine vollständige Liste der Aspose.Cells Cloud SDKs finden Sie im GitHub-Repository.

Die folgenden Codebeispiele zeigen, wie Aspose.Cells-Webservices mit verschiedenen SDKs aufgerufen werden:

Weitere AutoFilter-Vorgänge, wie das Hinzufügen eines Standardfilters oder eines Datumsfilters, finden Sie in den zugehörigen Dokumentationsseiten im Abschnitt AutoFilter.

Dynamischen Filter in einem Excel-Arbeitsblatt mit der Aspose.Cells Cloud API hinzufügen AutoFitterOptions – Eigenschaften & Gebrauchsanleitung | Aspose.Cells Cloud API