Trier les données d’un ListObject dans une feuille de calcul Excel – API Aspose.Cells Cloud

Conditions préalables
Pour appeler cette API, vous devez disposer d’un jeton d’accès JWT valide pour Aspose Cloud, et le classeur doit avoir été chargé dans le stockage Aspose Cloud. Incluez l’en-tête Authorization: Bearer <jeton JWT> dans chaque requête.

Cette API REST permet de trier les données d’un tableau dans une feuille de calcul Excel.
Pour utiliser cette opération, fournissez le nom du classeur, le nom de la feuille de calcul et l’index du ListObject cible, ainsi qu’un corps JSON dataSorter définissant les critères de tri.

API PostWorksheetListObjectSortTable

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

Sécurité et authentification

Les API REST Aspose.Cells Cloud sont sécurisées et nécessitent une authentification par jeton JWT.

Paramètres de la requête

Nom du paramètre	Type	Emplacement (chemin / chaîne de requête / corps HTTP)	Description
name	string	path	Nom du fichier Excel stocké dans le stockage Aspose Cloud.
sheetName	string	path	Nom de la feuille de calcul contenant le ListObject.
listObjectIndex	integer	path	Index de base zéro du ListObject (tableau) dans la feuille de calcul.
dataSorter	object	body	Objet JSON spécifiant les options de tri (par exemple, `CaseSensitive`, `HasHeaders`, `KeyList`, `SortLeftToRight`).
folder	string	query	Chemin du dossier dans le stockage où se trouve le fichier Excel.
storageName	string	query	Nom du stockage Aspose Cloud.

Remarques
Le corps de la requête doit être un objet JSON valide conforme au schéma dataSorter. Assurez-vous que le classeur, la feuille de calcul et le ListObject existent avant d’appeler l’opération de tri.

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 effectuer des appels à l’API Cloud avec cURL.

Requête

curl -v "https://api.aspose.cloud/v3.0/cells/Book1.xlsx/worksheets/sheet7/listobjects/1/sort" \
  -X POST \
  -d '{
        "CaseSensitive": true,
        "HasHeaders": true,
        "KeyList": [
          {
            "Key": 1,
            "SortOrder": "Ascending",
            "CustomList": "string"
          }
        ],
        "SortLeftToRight": true
      }' \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <jeton JWT>"

Réponse

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

Codes de statut HTTP

Code de statut	Description
200	OK – tri terminé avec succès.
400	Requête incorrecte – paramètres invalides.
401	Non autorisé – échec de l’authentification.
404	Introuvable – classeur, feuille de calcul ou ListObject non trouvé(s).
500	Erreur interne du serveur – problème côté serveur.

Paramètres de la réponse

Paramètre	Type	Description
Code	integer	Code de statut HTTP renvoyé par l’API.
Status	string	Description textuelle du résultat (par ex., “OK”).

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 et vous permet de vous concentrer sur les tâches de votre projet. Consultez le dépôt GitHub pour obtenir la liste complète des SDK Aspose.Cells Cloud.

Les exemples de code ci-dessous illustrent comment appeler les services web Aspose.Cells à l’aide de divers SDK :

Retour à la vue d’ensemble des ListObjects

Convertir un objet liste en plage – Aspose.Cells Cloud API