Comment ajouter un tableau croisé dynamique dans une feuille de calcul Excel à l’aide d’Aspose.Cells Cloud

Cette API REST ajoute un tableau croisé dynamique dans une feuille de calcul.

Prérequis :

Un compte Aspose.Cells Cloud disposant d’un jeton d’accès JWT valide.
Le classeur cible doit être stocké dans un emplacement pris en charge (stockage par défaut ou un stockage spécifié par l’utilisateur).
La feuille de calcul spécifiée par sheetName doit exister dans le classeur.

API PutWorksheetPivotTable

PUT https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/pivottables

Sécurité et authentification

Les API REST Aspose.Cells Cloud sont sécurisées et nécessitent une authentification basée sur un jeton JWT.

Paramètres de la requête

Nom du paramètre	Type	Emplacement	Description
name	string	path	Le nom du document Excel.
sheetName	string	path	Le nom de la feuille de calcul dans laquelle le tableau croisé dynamique sera créé.
request	object	body	DTO `CreatePivotTableRequest` contenant la définition du tableau croisé dynamique.
folder	string	query	Le dossier contenant le document.
storageName	string	query	Le nom du stockage dans lequel le document est situé.
sourceData	string	query	La plage fournissant les données sources pour le nouveau cache de tableau croisé dynamique (par exemple, `A5:E10`).
destCellName	string	query	L’adresse de la cellule en haut à gauche de la plage de destination pour le rapport du tableau croisé dynamique.
tableName	string	query	Le nom attribué au nouveau tableau croisé dynamique.
useSameSource	boolean	query	Si `true`, le nouveau tableau croisé dynamique réutilise une source de données existante, économisant ainsi de la mémoire si un autre tableau croisé dynamique a déjà utilisé cette source.

La spécification OpenAPI définit une interface de programmation accessible publiquement et permet d’effectuer directement des interactions REST à partir d’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 appeler l’API Cloud avec cURL.

Note de sécurité : Utilisez toujours https:// lors de l’appel de l’API et gardez votre jeton JWT confidentiel ; sa transmission en clair via HTTP expose le jeton à une interception.

Requête

curl -v "https://api.aspose.cloud/v3.0/cells/Sample_Test_Book.xls/worksheets/Sheet1/pivottables" \
-X PUT \
-d '{"Name":"MyPivot","SourceData":"A5:E10","DestCellName":"H20","UseSameSource":true,"PivotFieldRows":[1],"PivotFieldColumns":[1],"PivotFieldData":[1]}' \
-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	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 exemple, type de fichier non pris en charge).
401	Non autorisé	Jeton JWT invalide ou manquant.
413	Charge utile trop grande	Le fichier envoyé dépasse la limite de taille.
500	Erreur interne du serveur	Erreur inattendue du serveur.

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 et vous permet 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 illustrent comment appeler les services web Aspose.Cells à l’aide de divers SDK :

Pour plus d’opérations, consultez les pages API associées : Obtenir un tableau croisé dynamique, Supprimer un tableau croisé dynamique et Mettre à jour un tableau croisé dynamique.

Supprimer tous les tableaux croisés dynamiques d'une feuille Excel Ajouter un champ croisé à un tableau croisé dynamique