Insérer un filtre dynamique dans un ListObject Excel – Aspose.Cells Cloud API

Cette API REST insère un filtre dynamique pour un objet liste présent sur une feuille de calcul Excel.

API REST

POST https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/listobjects/{listObjectIndex}/InsertSlicer

Paramètres de la requête

Nom du paramètre	Type	Emplacement	Description
name	String	Path	Le nom du fichier Excel.
sheetName	String	Path	Le nom de la feuille de calcul contenant l’objet liste.
listObjectIndex	Integer	Path	L’indice de base zéro de l’objet liste auquel le filtre dynamique sera ajouté.
columnIndex	Integer	Query	L’indice de base zéro de la colonne sur laquelle repose le filtre dynamique.
destCellName	String	Query	La référence de la cellule (par ex., A1) où le filtre dynamique sera placé.
folder	String	Query	Le dossier de stockage contenant le fichier Excel.
storageName	String	Query	Le nom du service de stockage Aspose Cloud.

Vous pouvez utiliser l’outil en ligne de commande cURL pour appeler l’API :

Requête

curl -v "https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/listobjects/{listObjectIndex}/InsertSlicer" \
  -X POST \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <jeton jwt>"

Remarque : La requête nécessite un jeton porteur JWT valide obtenu auprès du service d’authentification Aspose Cloud. Ce point de terminaison ne nécessite pas de corps de requête ; envoyez un objet JSON vide {} si votre bibliothèque client exige la présence d’un payload.

Réponse

{
  "Code": 200,
  "Status": "OK",
  "Slicer": {
    "Name": "Slicer1",
    "ColumnIndex": 2,
    "Position": "A1"
  }
}

En‑tête de réponse : Content-Type: application/json

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	Requête incorrecte	Paramètres manquants ou non valides (par ex., type de fichier non pris en charge).
401	Non autorisé	Jeton JWT invalide ou manquant.
413	Payload trop volumineux	Le fichier téléchargé dépasse la limite de taille.
500	Erreur interne du serveur	Erreur serveur inattendue.

Gestion des erreurs

En cas d’erreur, l’API renvoie un objet JSON contenant un champ ErrorMessage décrivant le problème. Examinez le code de statut HTTP ainsi que le champ ErrorMessage pour déterminer les actions correctives à entreprendre.

Famille de SDK Cloud

L’utilisation d’un SDK constitue la méthode optimale pour accélérer le développement. Un SDK gère les détails de bas niveau afin que vous puissiez vous concentrer sur les tâches de 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 illustrent comment effectuer des appels aux services web Aspose.Cells à l’aide de divers SDK :

Ajouter un objet liste (tableau) à une feuille de calcul Excel Convertir un objet liste en plage – Aspose.Cells Cloud API