Diese REST-API filtert die Top 10-Elemente in einer Liste.
Voraussetzungen
• Holen Sie sich ein gültiges JWT-Token über die Aspose.Cells Cloud-Authentifizierung.
• Laden Sie die Excel-Arbeitsmappe in Ihren Aspose Cloud-Speicher hoch (oder geben Sie den Speicher/Ordner an, in dem sich die Datei befindet).
• Kennen Sie den Namen des Arbeitsblatts sowie den Zellbereich, den Sie filtern möchten.
PutWorksheetFilterTop10 API
PUT https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/autoFilter/filterTop10
Sicherheit und Authentifizierung
Die Aspose.Cells Cloud APIs sind sicher und erfordern eine JWT-Token-basierte Authentifizierung.
Anforderungsparameter
| Parametername | Typ | Speicherort | Erforderlich | Standardwert | Beschreibung |
|---|---|---|---|---|---|
| name | string | Pfad | Ja | — | Der Name der Excel-Datei. |
| sheetName | string | Pfad | Ja | — | Der Name des Arbeitsblatts, das die Daten enthält. |
| range | string | Abfrage | Ja | — | Der Zellbereich, auf den der Filter angewendet wird (z. B. A1:B10). |
| fieldIndex | integer | Abfrage | Ja | — | Nullbasierter Index der Spalte, auf die der Filter angewendet wird. |
| isTop | boolean | Abfrage | Ja | true |
true, um die obersten Elemente zu filtern; false für die untersten. |
| isPercent | boolean | Abfrage | Nein | false |
true, um itemCount als Prozentsatz zu interpretieren; false für eine absolute Anzahl. |
| itemCount | integer | Abfrage | Nein | 10 |
Anzahl der Elemente, die in den Filter einbezogen werden sollen. |
| matchBlanks | boolean | Abfrage | Nein | false |
true, um leere Zellen in die Filterergebnisse einzubeziehen. |
| refresh | boolean | Abfrage | Nein | false |
true, um den Filter nach dem Anwenden zu aktualisieren. |
| folder | string | Abfrage | Nein | — | Der Ordner im Speicher, in dem sich die Excel-Datei befindet. |
| storageName | string | Abfrage | Nein | — | Der Name des Aspose Cloud-Speichers. |
Antwort
{
"Status":"OK",
"Code":200
}
Typische Fehlerantworten
{
"Code":400,
"Message":"Bad Request – fehlende oder ungültige Parameter."
}
{
"Code":401,
"Message":"Unauthorized – ungültiges oder fehlendes JWT-Token."
}
{
"Code":413,
"Message":"Payload Too Large – hochgeladene Datei überschreitet die zulässige Größe."
}
{
"Code":500,
"Message":"Internal Server Error – unerwarteter Serverfehler."
}
HTTP-Statuscodes
| Code | Bedeutung | Beschreibung |
|---|---|---|
| 200 | OK | Filter erfolgreich angewendet; 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 | Hochgeladene Datei überschreitet die Größe. |
| 500 | Internal Server Error | Unerwarteter Serverfehler. |
Verwendung der PutWorksheetFilterTop10 API mit SDKs
PutWorksheetFilterTop10 API-Spezifikation
Die OpenAPI-Spezifikation definiert eine öffentlich zugängliche Programmierschnittstelle und ermöglicht es Ihnen, REST-Interaktionen direkt über einen Webbrowser durchzuführen.
Sie können das cURL-Befehlszeilentool nutzen, um problemlos auf die Aspose.Cells-Webdienste zuzugreifen. Im folgenden Beispiel wird gezeigt, wie die API mit cURL aufgerufen wird.
Verwendung der Aspose.Cells Cloud SDKs
Die Verwendung eines SDKs ist der schnellste Weg zur Entwicklung. Ein SDK übernimmt die Details der niedrigen Ebene, sodass Sie sich auf Ihr Projekt konzentrieren können. Besuchen Sie das GitHub-Repository, um eine vollständige Liste der Aspose.Cells Cloud SDKs zu erhalten.
Die folgenden Codebeispiele zeigen, wie Aspose.Cells-Webdienste mithilfe verschiedener SDKs aufgerufen werden: