Sparkline dans une image Excel

Les graphiques sont l’un des meilleurs mécanismes de représentation visuelle des données et lorsqu’il s’agit de données informatiques dans des fichiers Excel, les graphiques et diagrammes jouent un rôle essentiel dans la représentation des données. Cependant, nous nous retrouvons parfois dans une situation où nous ne pouvons pas intégrer un ou des graphiques dans une feuille de calcul Excel. Par conséquent, nous avons besoin d’une manière plus intelligente de représenter la tendance des données, et c’est là que les graphiques sparkline entrent en action.

Avantages de l’utilisation des Sparklines dans Excel

Les graphiques sparkline dans Excel vous permettent de voir les tendances et les modèles au sein de vos données en un coup d’œil en utilisant un espace minimal sur votre tableau de bord. La plupart du temps, vous créerez probablement un groupe de graphiques sparkline, un pour chaque ligne ou colonne de données. Une feuille de calcul peut contenir n’importe quel nombre de groupes de graphiques sparkline. Excel mémorise chaque groupe et vous pouvez travailler avec le groupe comme une seule unité.

Les groupes de sparklines offrent un mécanisme très pratique pour gérer un ensemble de sparklines dans certains groupes. Par exemple, vous pouvez sélectionner une sparkline dans un groupe, puis modifier la mise en forme de toutes les sparklines du groupe. Afin de faciliter la gestion programmatique des feuilles de calcul Excel par nos utilisateurs, le travail avec les groupes de sparklines a été encore optimisé dans la dernière version de Aspose.Cells Cloud API.

Comment obtenir une description du groupe Sparkline

Le moyen le plus rapide et le plus simple de gérer des documents est d’utiliser Stockage cloud. Une fois que vous avez téléchargé la feuille de calcul Excel contenant le groupe Sparkline, vous pouvez facilement obtenir des détails relatifs au groupe.

Obtention du jeton d’authentification Web JSON

Nos API Cloud et Cloud Storage sont sécurisés et ne sont accessibles qu’aux utilisateurs autorisés. Une fois autorisé, vous pouvez facilement effectuer des opérations de lecture, de téléchargement, de mise à jour ou de suppression sur des documents disponibles sur le stockage cloud ou disponibles sur un système local. Pour obtenir le jeton JWT,

  • Première inscription pour un compte via tableau de bord Cloud
  • Connectez-vous ensuite au tableau de bord Cloud et cliquez sur le menu Applications à gauche
  • Par défaut, la première application apparaît sur la page. Cliquez pour ouvrir les détails
  • Sur la page des détails de la première application, vous trouverez votre identifiant client personnalisé et votre secret client
  • Entrez la commande suivante dans l’invite de commande pour récupérer votre jeton JWT.
curl -v "https://api.aspose.cloud/connect/token" \
-X POST \
-d "grant_type=client_credentials&client_id=xxxx-xxx-xxx-xxx-xxxx&client_secret=xxxxxxx" \
-H "Accept: application/json"

Pour plus de détails, veuillez visiter Authentification par jeton Web JSON

Commande cURL

curl -X GET "https://api.aspose.cloud/v3.0/cells/Sparkline.xlsx/worksheets/Sheet1/sparklineGroups" \
-H "accept: application/json" \
-H "authorization: Bearer <JWT Token>"

Essayez d’utiliser la référence API

  • Ouvrez la page de référence API pour Aspose.Cells Cloud.
  • Authentifiez-vous à l’aide d’un ID client et de clés client-serveur.
  • Accédez à l’API GetWorksheetSparklineGroups et cliquez sur le bouton Essayer.
  • Indiquez le nom du classeur Excel par rapport au champ de nom (qui est Sparkline.xlsx dans notre cas).
  • Saisissez le nom de la feuille de calcul contenant le groupe Sparkline dans le champ sheetName (Sheet1 dans notre cas).
  • Cliquez sur le bouton Exécuter. Les détails sont récupérés et affichés dans la section des réponses.

URL de la demande

https://api.aspose.cloud/v3.0/cells/Sparkline.xlsx/worksheets/Sheet1/sparklineGroups

La réponse affichera tous les détails liés à la couleur, au préréglage, au style, au type, à LowPointColor, à MarkersColor, etc. Veuillez jeter un œil aux images suivantes montrant un aperçu d’une feuille de calcul Excel contenant des groupes de sparklines ainsi que des informations rendues en réponse.

Aperçu des propriétés Sparkline

Fig 1 : Aperçu des propriétés associées au groupe Sparkline.

Plage de données pour le groupe de graphiques sparkline verticaux

Fig 2 : Aperçu de la plage de données pour le groupe de graphiques sparkline verticaux.

Plage de données de sparkline horizontale

Fig 3 : Aperçu de la plage de données pour le groupe Sparkline horizontal.

Type de groupe Sparkline

Fig 4 : Aperçu du type de groupe sparkline.

Ajouter une description du groupe Sparkline

Aspose.Cells Cloud offre également la possibilité d’ajouter une description de groupe Sparkline dans la feuille de calcul Excel. PostWorksheetSparklineGroup requiert les paramètres name, sheetName, sparklineGroupIndex et sparklineGroup pour répondre à cette exigence.

Mettre à jour la description du groupe Sparkline dans Excel

Pour mettre à jour un graphique sparkline dans Excel, essayez d’utiliser l’API PutWorksheetSparklineGroup. L’API requiert les paramètres suivants pour répondre à l’exigence

  • nom : nom du classeur stocké sur le stockage cloud
  • sheetName : feuille de calcul dans laquelle vous devez ajouter le graphique sparkline
  • type : type Sparkline (ligne, colonne, gain/perte)
  • dataRange : la plage de données que nous devons utiliser comme source pour le graphique sparkline
  • isVertical : le sparkline est-il vertical ou non
  • locationRange : l’emplacement où nous devons dessiner le graphique sparkline

Commande cURL

curl -X PUT "https://api.aspose.cloud/v3.0/cells/Sparkline.xlsx/worksheets/Sheet1/sparklineGroups?type=Column&dataRange=B3%3AF9&isVertical=false&locationRange=G3%3AG9" \
-H  "accept: application/json" \
-H  "authorization: Bearer <JWT Token>"

Dans le scénario ci-dessus, le type de sparkline est spécifié comme Colonne (mis à jour de Ligne vers Colonne), dataRange est spécifié comme B3:F9, isVertical est spécifié comme False et locationRange est spécifié comme G3:G9.

URL de la demande

https://api.aspose.cloud/v3.0/cells/Sparkline.xlsx/worksheets/Sheet1/sparklineGroups?type=Column&dataRange=B3%3AF9&isVertical=false&locationRange=G3%3AG9
Aperçu de la mise à jour du type Sparkline

Fig 5 : Aperçu du type de graphique sparkline mis à jour.

Étapes pour supprimer la description du groupe Sparkline

Aspose.Cells Cloud fournit également un mécanisme rapide pour supprimer les graphiques sparkline existants dans Excel. Pour supprimer tous les groupes de graphiques sparkline, essayez d’utiliser l’API DeleteWorksheetSparklineGroups. En revanche, si nous devons supprimer le groupe de graphiques sparkline en fonction d’un ID d’index spécifique, nous devons utiliser DeleteWorksheetSparklineGroup.

Commande cURL

curl -X DELETE "https://api.aspose.cloud/v3.0/cells/Sparkline.xlsx/worksheets/Sheet1/sparklineGroups/1" \
-H "accept: application/json" \
-H "authorization: Bearer <JWT Token>"

URL de la demande

https://api.aspose.cloud/v3.0/cells/Sparkline.xlsx/worksheets/Sheet1/sparklineGroups/1

Après une exécution réussie, le code de réponse 200 s’affiche dans le corps de la réponse. L’image suivante montre le groupe de graphiques sparkline vertical supprimé de la feuille de calcul Excel. Tandis que l’autre groupe de graphiques sparkline horizontal reste dans la feuille de calcul car seul le groupe d’index 1 est supprimé.

Groupe de sparkline vertical supprimé

Fig 6 : Aperçu du groupe de sparklines verticales après suppression.

L’article explique les étapes à suivre pour obtenir, créer, mettre à jour et supprimer des graphiques sparkline dans Excel à l’aide de l’API REST. Vous pouvez également envisager de lire un blog associé à Manipuler des graphiques, des tableaux croisés dynamiques et des graphiques sparkline à l’aide de l’API Cloud. Si vous avez des questions à ce sujet, n’hésitez pas à nous contacter via Forum d’assistance gratuit.

Le code source de l’API peut également être trouvé sur GitHub Free code repository.

Articles connexes

Nous vous recommandons vivement de visiter les liens suivants pour en savoir plus sur :