Mettre à jour un objet liste dans une feuille de calcul Excel – Documentation de l’API Aspose.Cells Cloud
Cet API REST permet de mettre à jour les propriétés d’un objet liste (tableau) dans une feuille de calcul Excel.
Sécurité et authentification
Les API Aspose.Cells Cloud sont sécurisées et nécessitent une authentification basée sur un jeton JWT.
Schéma du corps de la demande
L’objet DTO listObject contient les champs suivants. Seuls les champs que vous souhaitez modifier doivent être présents dans le corps de la demande.
| Champ | Type | Obligatoire | Description |
|---|---|---|---|
| DisplayName | string | facultatif | Nom affiché du tableau. |
| StartRow / StartColumn | integer | facultatif | Indice de la première ligne/colonne du tableau (indexation à partir de 0). |
| EndRow / EndColumn | integer | facultatif | Indice de la dernière ligne/colonne du tableau (indexation à partir de 0). |
| Range | string | facultatif | Adresse au format A1 définissant la plage du tableau (par ex., A1:D10). |
| ShowHeaderRow | boolean | facultatif | true pour afficher la ligne d’en‑tête. |
| ShowTotals | boolean | facultatif | true pour afficher la ligne des totaux. |
| TableStyleName | string | facultatif | Nom du style de tableau intégré à appliquer. |
| TableStyleType | string | facultatif | Type de style (TableStyleLight, TableStyleMedium, etc.). |
| ListColumns | tableau d’objets | facultatif | Collection de définitions de colonnes (Name, TotalsCalculation). |
| Sorter, AutoFilter, ShowTableStyle… | objet | facultatif | Options avancées de style et de filtrage (voir le DTO complet dans la spécification OpenAPI). |
Exemple minimal de charge utile
{
"DisplayName": "SalesData",
"Range": "A1:E20",
"ShowHeaderRow": true,
"ShowTotals": false
}
API REST
POST https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/listobjects/{listObjectIndex}
Paramètres de la demande
| Nom du paramètre | Type | Emplacement | Description |
|---|---|---|---|
| name | string | chemin | Nom du document. |
| sheetName | string | chemin | Nom de la feuille de calcul. |
| listObjectIndex | integer | chemin | Index de l’objet liste à mettre à jour. |
| listObject | objet | corps | Objet DTO ListObject dans le corps de la demande. |
| folder | string | requête | Dossier contenant le document. |
| storageName | string | requête | Nom du stockage. |
La spécification OpenAPI définit une interface de programmation accessible publiquement et vous permet d’effectuer des interactions REST directement depuis un navigateur web.
Demande
Réponses d’erreur
| Code HTTP | Description | Exemple de charge utile |
|---|---|---|
| 400 | Demande incorrecte – champs obligatoires manquants ou JSON mal formé. | { "Code": 400, "Message": "Invalid request body." } |
| 401 | Non autorisé – jeton JWT manquant ou invalide. | { "Code": 401, "Message": "Authentication failed." } |
| 404 | Introuvable – le classeur, la feuille de calcul ou l’objet liste spécifié n’existe pas. | { "Code": 404, "Message": "Resource not found." } |
| 500 | Erreur interne du serveur – condition inattendue côté serveur. | { "Code": 500, "Message": "Server error." } |
FAQ
Comment mettre à jour un objet liste à l’aide de l’API Aspose.Cells Cloud ?
Utilisez le point de terminaison POST /cells/{name}/worksheets/{sheetName}/listobjects/{listObjectIndex}. Incluez un corps JSON contenant les propriétés que vous souhaitez modifier (par ex., DisplayName, ShowHeaderRow). Authentifiez-vous à l’aide d’un jeton JWT dans l’en‑tête Authorization.
Quelle réponse reçois‑je après une mise à jour réussie ?
Un objet JSON contenant Code : 200 et Status : "OK" est renvoyé. En cas d’erreur, la réponse contient le code HTTP approprié ainsi qu’un objet Error décrivant le problème.
Puis‑je mettre à jour uniquement un sous‑ensemble des propriétés de l’objet liste ?
Oui. Incluez uniquement les champs que vous souhaitez modifier dans le corps de la demande ; tous les champs omis restent inchangés.
Documentation connexe
Famille de SDK cloud
L’utilisation d’un SDK constitue la meilleure méthode pour accélérer le développement. Un SDK gère les détails de bas niveau, vous permettant ainsi de 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 montrent comment appeler les services web Aspose.Cells à l’aide de divers SDK :