Trier les données d'une plage dans une feuille Excel

L’API REST permet de trier les données situées dans une plage spécifiée d’une feuille Excel.

API REST

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

Paramètres de la requête

Nom du paramètre	Type	Emplacement	Obligatoire	Description
name	string	path	Oui	Le nom du classeur.
sheetName	string	path	Oui	Le nom de la feuille de calcul.
cellArea	string	query	Oui	La plage de cellules à trier (par ex. `A5:A10`).
dataSorter	object	body	Oui	Objet JSON définissant les paramètres de tri (voir le schéma ci-dessous).
folder	string	query	Non	Le dossier contenant le classeur.
storageName	string	query	Non	Le nom du stockage où se trouve le classeur.

Schéma de l’objet dataSorter – Le corps doit contenir un objet JSON doté des propriétés suivantes :

CaseSensitive (boolean, obligatoire) – Détermine si le tri est sensible à la casse.
HasHeaders (boolean, obligatoire) – Indique si la plage contient une ligne d’en-tête.
KeyList (array, obligatoire) – Collection de clés de tri. Chaque objet clé comprend :
- Key (integer) – Indice de colonne (indexé à partir de 0).
- SortOrder (string) – "ascending" ou "descending".
SortLeftToRight (boolean, obligatoire) – Si true, le tri s’effectue de gauche à droite ; sinon, de haut en bas.
D’autres propriétés facultatives telles que CaseOrder, SortLeftToRight, peuvent également être fournies conformément à la spécification OpenAPI.

La spécification OpenAPI définit une interface de programmation publiquement accessible et permet d’effectuer des interactions REST directement depuis un navigateur web.

Vous pouvez utiliser l’outil en ligne de commande cURL pour accéder facilement aux services web d’Aspose.Cells. L’exemple suivant montre comment effectuer un appel à l’API Cloud via cURL.

Requête

curl -v "https://api.aspose.cloud/v3.0/cells/Sample_Test_Book.xls/worksheets/Sheet1/sort?cellArea=A5:A10" \
  -X POST \
  -d '{"CaseSensitive":false,"HasHeaders":false,"KeyList":[{"Key":0,"SortOrder":"descending"}],"SortLeftToRight":false}' \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <jeton JWT>"

Réponse

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

Gestion des erreurs – L’API peut renvoyer des codes d’erreur HTTP standard. Les réponses typiques incluent :

Statut HTTP	Code	Message
400	400	Mauvaise requête – paramètres manquants ou non valides.
401	401	Non autorisé – jeton JWT invalide ou absent.
404	404	Introuvable – le classeur ou la feuille de calcul n’existe pas.
500	500	Erreur interne du serveur.

Le corps de la réponse suit le format { "Code": <statut>, "Message": "<description>", "Status": "Error" } dans les cas d’erreur.

Famille de SDK Cloud

L’utilisation d’un SDK constitue 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 vos tâches de 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 appeler les services web Aspose.Cells à l’aide de divers SDK :