Excel 画像のスパークライン

チャートはデータを視覚的に表現する優れたメカニズムの 1 つであり、Excel ファイル 内の計算データを扱う場合、グラフとチャートはデータ表現において重要な役割を果たします。ただし、Excel スプレッドシート内にチャート/グラフを配置できない状況に遭遇することもあります。その結果、データの傾向を表現するよりスマートな方法が必要になり、ここでスパークラインが役立ちます。

Excel でスパークラインを使用する利点

Excel のスパークラインを使用すると、ダッシュボード上の最小限のスペースを使用して、データ内の傾向とパターンを一目で確認できます。ほとんどの場合、データの行または列ごとに 1 つずつ、スパークラインのグループを作成します。ワークシートには、任意の数のスパークライン グループを含めることができます。Excel は各グループを記憶し、グループを 1 つのユニットとして操作できます。

スパークライン グループは、特定のグループ内のスパークラインのセットを処理するための非常に便利なメカニズムを提供します。たとえば、グループ内の 1 つのスパークラインを選択し、グループ内のすべてのスパークラインの書式設定を変更できます。ユーザーが Excel ワークシートをプログラムで処理できるようにするために、Aspose.Cells Cloud API の最新リリース バージョンでは、スパークライン グループの操作がさらに最適化されています。

スパークライングループの説明を取得する方法

ドキュメントを処理する最も速くて簡単な方法は、クラウド ストレージ を使用することです。スパークライン グループを含む Excel ワークシートをアップロードすると、グループに関連する詳細を簡単に取得できます。

JSON Web認証トークンの取得

当社のクラウドAPIとクラウドストレージはセキュリティ保護されており、許可されたユーザーのみがアクセスできます。許可されると、クラウドストレージまたはローカルシステムで利用可能なドキュメントの読み取り、アップロード、更新、削除操作を簡単に実行できます。JWTトークンを取得するには、

  • まず、クラウドダッシュボード でアカウントにサインアップします。
  • 次にクラウドダッシュボードにログインし、左側のアプリケーションメニューをクリックします。
  • デフォルトでは、最初のアプリがページに表示されます。クリックして詳細を開きます。
  • 最初のアプリの詳細ページで、パーソナライズされたクライアントIDとクライアントシークレットが表示されます。
  • 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"

詳細については、JSON Web トークン認証 をご覧ください。

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>"

APIリファレンスを使ってみる

  • Aspose.Cells CloudのAPIリファレンスページを開きます。
  • クライアント ID とクライアント サーバー キーを使用して認証します。
  • GetWorksheetSparklineGroups APIにアクセスし、「試してみる」ボタンをクリックします。
  • 名前フィールドに対して Excel ワークブック名を指定します (この場合は Sparkline.xlsx)。
  • sheetName フィールドに対して、Sparkline グループを含むワークシートの名前を入力します (この場合は Sheet1)。
  • 「実行」ボタンをクリックします。詳細が取得され、応答セクションに表示されます。

リクエストURL

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

応答には、色、プリセット、スタイル、タイプ、LowPointColor、MarkersColor などに関連するすべての詳細が表示されます。スパークライン グループを含む Excel ワークシートのプレビューと、応答でレンダリングされた情報を示す次の画像をご覧ください。

スパークラインのプロパティのプレビュー

図 1: スパークライン グループに関連付けられたプロパティのプレビュー。

垂直スパークライングループのデータ範囲

図 2: 垂直スパークライン グループのデータ範囲のプレビュー。

水平スパークラインデータ範囲

図 3: 水平スパークライン グループのデータ範囲のプレビュー。

スパークライングループタイプ

図 4: スパークライン グループ タイプのプレビュー。

スパークライングループの説明を追加する

Aspose.Cells Cloud は、Excel ワークシートにスパークライン グループの説明を追加する機能も提供します。PostWorksheetSparklineGroup では、この要件を満たすために name、sheetName、sparklineGroupIndex、sparklineGroup パラメーターが必要です。

Excel でスパークライン グループの説明を更新する

Excelでスパークラインを更新するには、PutWorksheetSparklineGroup APIを使用してください。APIは要件を満たすために次のパラメータを必要とします。

  • name :- クラウドストレージに保存されているワークブックの名前
  • sheetName :- スパークラインを追加するワークシート
  • タイプ: スパークラインタイプ (折れ線、列、勝ち負け)
  • dataRange :- スパークラインのソースとして使用するデータ範囲
  • isVertical :- スパークラインが垂直かどうか
  • locationRange :- スパークラインを描画する場所

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>"

上記のシナリオでは、スパークラインの種類は列 (線から列に更新) として指定され、dataRange は B3:F9 として指定され、isVertical は False として指定され、locationRange は G3:G9 として指定されています。

リクエストURL

https://api.aspose.cloud/v3.0/cells/Sparkline.xlsx/worksheets/Sheet1/sparklineGroups?type=Column&dataRange=B3%3AF9&isVertical=false&locationRange=G3%3AG9
スパークラインタイプの更新プレビュー

図 5: スパークライン タイプのプレビューが更新されました。

スパークライングループの説明を削除する手順

Aspose.Cells Cloud は、Excel の既存のスパークラインを簡単に削除するメカニズムも提供します。すべてのスパークライン グループを削除するには、DeleteWorksheetSparklineGroups API を使用してください。一方、特定のインデックス ID に基づいてスパークライン グループを削除する必要がある場合は、DeleteWorksheetSparklineGroup を使用する必要があります。

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

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

実行が成功すると、応答本文に 200 応答コードが表示されます。次の画像は、Excel ワークシートから削除された垂直スパークライン グループを示しています。一方、インデックス 1 グループのみが削除されたため、他の水平スパークライン グループはワークシートに残ります。

垂直スパークライン グループを削除しました

図 6: 削除後の垂直スパークライン グループのプレビュー。

この記事では、REST API を使用して Excel でスパークラインを取得、作成、更新、削除する手順について説明しました。また、クラウド API を使用してグラフ、ピボット テーブル、スパークラインを操作する に関する関連ブログもご覧ください。関連する質問がある場合は、無料サポート フォーラム からお気軽にお問い合わせください。

APIのソースコードはGitHub Free code repositoryでも見つかります。

関連記事

詳細については、次のリンクにアクセスすることを強くお勧めします。