Ajouter un objet liste (tableau) à une feuille de calcul Excel – Documentation Aspose.Cells Cloud
Cette API REST ajoute un objet liste (tableau) à une feuille de calcul Excel.
Avant d’utiliser cet endpoint, assurez-vous d’avoir un jeton JWT valide, que le classeur soit stocké dans un stockage cloud pris en charge et que la feuille de calcul existe.
API REST
PUT https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/listobjects
Paramètres de la requête
| Nom du paramètre | Type | Emplacement | Description |
|---|---|---|---|
| name | string | path | Nom du fichier du classeur. |
| sheetName | string | path | Nom de la feuille de calcul. |
| startRow | integer | query | Index de base zéro de la première ligne de la plage de table. |
| startColumn | integer | query | Index de base zéro de la première colonne de la plage de table. |
| endRow | integer | query | Index de base zéro de la dernière ligne de la plage de table. |
| endColumn | integer | query | Index de base zéro de la dernière colonne de la plage de table. |
| hasHeaders | boolean | query | true si la première ligne contient des en-têtes de colonne ; sinon false. |
| listObject | object | body | Définition de l’objet liste (voir Schéma du corps de la requête). |
| folder | string | query | Dossier contenant le classeur. |
| storageName | string | query | Nom du stockage. |
Schéma du corps de la requête
L’objet listObject décrit le tableau qui sera créé. Seules les propriétés les plus courantes sont affichées ; reportez-vous à la spécification OpenAPI pour la liste complète.
{
"displayName": "MonTableau",
"showTotals": false,
"style": "TableStyleMedium2"
}
Exemple de requête (cURL)
curl -v "https://api.aspose.cloud/v3.0/cells/Book1.xlsx/worksheets/Sheet1/listobjects?startRow=1&startColumn=1&endRow=10&endColumn=12&hasHeaders=true" \
-X PUT \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-H "Authorization: Bearer <jeton jwt>" \
-d '{
"displayName": "MonTableau",
"showTotals": false,
"style": "TableStyleMedium2"
}'
Exemple de réponse
{
"Code": 200,
"Status": "OK"
}
Codes d’erreur
| Statut HTTP | Raison | Description |
|---|---|---|
| 400 | Demande incorrecte | Paramètres de plage invalides ou corps JSON mal formé. |
| 401 | Non autorisé | Jeton JWT manquant ou expiré. |
| 404 | Non trouvé | Le classeur ou la feuille de calcul spécifié(s) n’existent pas. |
| 500 | Erreur interne du serveur | Échec inattendu côté serveur. |
Exemple de réponse 400
{
"Code": 400,
"Status": "Bad Request",
"Message": "Paramètres de plage invalides."
}
Exemple de réponse 401
{
"Code": 401,
"Status": "Unauthorized",
"Message": "Le jeton d'authentification est manquant ou expiré."
}
La spécification OpenAPI fournit le contrat complet pour cette opération.
Famille de SDK Cloud
L’utilisation d’un SDK est le moyen optimal d’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 suivants montrent comment effectuer des appels aux services web Aspose.Cells à l’aide de divers SDK :