Ajouter un filtre Top 10 à une feuille de calcul Excel – Aspose.Cells Cloud
Cet API REST permet de filtrer les Top 10 éléments d’une liste.
Prérequis
• Obtenir un jeton JWT valide à l’aide de l’authentification Aspose.Cells Cloud.
• Téléverser le classeur Excel vers votre stockage Aspose Cloud (ou spécifier le stockage/dossier dans lequel il se trouve).
• Connaître le nom de la feuille de calcul et la plage de cellules à filtrer.
API PutWorksheetFilterTop10
PUT https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/autoFilter/filterTop10
Sécurité et authentification
Les API Aspose.Cells Cloud sont sécurisées et exigent une authentification basée sur un jeton JWT.
Paramètres de la requête
| Nom du paramètre | Type | Emplacement | Obligatoire | Valeur par défaut | Description |
|---|---|---|---|---|---|
| name | string | chemin | Oui | — | Le nom du fichier Excel. |
| sheetName | string | chemin | Oui | — | Le nom de la feuille de calcul contenant les données. |
| range | string | requête | Oui | — | La plage de cellules à laquelle le filtre est appliqué (par ex., A1:B10). |
| fieldIndex | integer | requête | Oui | — | Index de colonne à zéro de départ sur lequel le filtre est appliqué. |
| isTop | boolean | requête | Oui | true |
true pour filtrer les éléments les plus élevés ; false pour les plus faibles. |
| isPercent | boolean | requête | Non | false |
true pour traiter itemCount comme un pourcentage ; false pour un nombre absolu. |
| itemCount | integer | requête | Non | 10 |
Nombre d’éléments à inclure dans le filtre. |
| matchBlanks | boolean | requête | Non | false |
true pour inclure les cellules vides dans les résultats du filtre. |
| refresh | boolean | requête | Non | false |
true pour actualiser le filtre après l’avoir appliqué. |
| folder | string | requête | Non | — | Le dossier, dans le stockage, où se trouve le fichier Excel. |
| storageName | string | requête | Non | — | Le nom du stockage Aspose Cloud. |
Réponse
{
"Status":"OK",
"Code":200
}
Réponses d’erreur typiques
{
"Code":400,
"Message":"Bad Request – paramètres manquants ou non valides."
}
{
"Code":401,
"Message":"Unauthorized – jeton JWT non valide ou manquant."
}
{
"Code":413,
"Message":"Payload Too Large – le fichier téléversé dépasse la taille autorisée."
}
{
"Code":500,
"Message":"Internal Server Error – erreur inattendue du serveur."
}
Codes de statut HTTP
| Code | Signification | Description |
|---|---|---|
| 200 | OK | Filtre appliqué avec succès ; la réponse contient les détails de l’opération. |
| 400 | Bad Request | Paramètres manquants ou non valides (par ex., type de fichier non pris en charge). |
| 401 | Unauthorized | Jeton JWT non valide ou manquant. |
| 413 | Payload Too Large | Le fichier téléversé dépasse la limite de taille. |
| 500 | Internal Server Error | Erreur serveur inattendue. |
Comment utiliser l’API PutWorksheetFilterTop10 avec les SDK
Spécification de l’API PutWorksheetFilterTop10
La spécification OpenAPI définit une interface de programmation accessible publiquement et permet d’effectuer directement des interactions REST depuis un navigateur web.
Vous pouvez utiliser l’outil en ligne de commande cURL pour accéder facilement aux services web Aspose.Cells. L’exemple suivant montre comment appeler l’API avec cURL.
Utiliser les SDK Aspose.Cells Cloud
L’utilisation d’un SDK est la méthode la plus rapide pour développer. Un SDK gère les détails de bas niveau afin que vous puissiez vous concentrer sur votre projet. Veuillez consulter le dépôt GitHub pour obtenir la liste complète des SDK Aspose.Cells Cloud.
Les exemples de code suivants montrent comment appeler les services web Aspose.Cells à l’aide de divers SDK :