PowerPoint プレゼンテーションのチャート

チャートは、統計データを迅速かつ簡潔に提示するメカニズムを提供します。これにより、関連する利害関係者は迅速に重要な意思決定を行うことができます。チャートはデータとそれに関連するカテゴリで構成されています。したがって、PowerPointにおけるチャートデータの追加、更新、および削除の操作が可能です。それに関連するカテゴリも、Aspose.Slides Cloud APIを使用して実行できます。

さらに、SDKを使用するためには、SDKをインストールする必要がありますが、最も簡単な方法はNuGetライブラリを通じてです。したがって、パッケージマネージャーコンソールで以下のコマンドを試してみてください。

 Install-Package Aspose.Slides-Cloud -Version 21.2.0

Cloud APIは、ターミナルでcURLコマンドを使用してアクセスすることもできます。そのため、アクセスするには、クライアントIDとクライアントシークレットに基づいて生成されたJWTトークンを提供する必要があります。したがって、理解を深めるために以下のリンクを訪れることをお勧めします。

チャートカテゴリの操作

新しいリソースは形状のサブリソースです。カテゴリをサポートするチャート形状(列、線など)にのみ機能します。これにより、関連するデータポイントとともにチャートのカテゴリを追加、変更、および削除できます。この記事は主に以下のトピックに焦点を当てています。

チャートにカテゴリを追加する

リクエストURL

<code>POST https://api.aspose.cloud/v3.0/slides/myPresentaion.pptx/slides/1/shapes/1/categories?folder=myFolder</code>

C#.NET

string MyAppKey = "xxxxxxxx";    // Get AppKey and AppSID from https://dashboard.aspose.cloud/
string MyAppSid = "xxxxxxxx";    // Get AppKey and AppSID from https://dashboard.aspose.cloud/

SlidesApi api = new SlidesApi(MyAppSid, MyAppKey);
ChartCategory dto = new ChartCategory
{
    Value = "NewCategory",
    DataPoints = new List<OneValueChartDataPoint>
    {
        new OneValueChartDataPoint { Value = 5.5 },
        new OneValueChartDataPoint { Value = 76 },
        new OneValueChartDataPoint { Value = 27 }
    }
};
PostChartCategoryRequest request = new PostChartCategoryRequest
{
    Name = "myPresentaion.pptx",
    Folder = "myFolder",
    SlideIndex = 1,
    ShapeIndex = 1,
    Category = dto
};
Chart chart = api.PostChartCategory(request);
Console.WriteLine(chart.Categories.Count);

チャートカテゴリを更新する

リクエストURL

<code>PUT https://api.aspose.cloud/v3.0/slides/myPresentaion.pptx/slides/1/shapes/1/categories/2?folder=myFolder</code>

C#.NET

string MyAppKey = "xxxxxxxx";    // Get AppKey and AppSID from https://dashboard.aspose.cloud/
string MyAppSid = "xxxxxxxx";    // Get AppKey and AppSID from https://dashboard.aspose.cloud/

SlidesApi api = new SlidesApi(MyAppSid, MyAppKey);
ChartCategory dto = new ChartCategory
{
    Value = "UpdatedCategory",
    DataPoints = new List<OneValueChartDataPoint>
    {
        new OneValueChartDataPoint { Value = 5.5 },
        new OneValueChartDataPoint { Value = 76 },
        new OneValueChartDataPoint { Value = 27 }
    }
};
PutChartCategoryRequest request = new PutChartCategoryRequest
{
    Name = "myPresentaion.pptx",
    Folder = "myFolder",
    SlideIndex = 1,
    ShapeIndex = 1,
    CategoryIndex = 2,
    Category = dto
};
Chart chart = api.PutChartCategory(request);
Console.WriteLine(chart.Categories.Count);

チャートのカテゴリを削除

Aspose.Slides Cloud API は、チャートオブジェクト内の既存のカテゴリを削除する機能も提供しています。スライドのインデックス、該当するシェイプインデックス、および関連するカテゴリIDを提供するだけで、要件を満たすことができます。

リクエストURL

<code>DELETE https://api.aspose.cloud/v3.0/slides/myPresentaion.pptx/slides/1/shapes/1/categories/2?folder=myFolder</code>

C#.NET

string MyAppKey = "xxxxxxxx";    // Get AppKey and AppSID from https://dashboard.aspose.cloud/
string MyAppSid = "xxxxxxxx";    // Get AppKey and AppSID from https://dashboard.aspose.cloud/

SlidesApi api = new SlidesApi(MyAppSid, MyAppKey);
DeleteChartCategoryRequest request = new DeleteChartCategoryRequest
{
    Name = "myPresentaion.pptx",
    Folder = "myFolder",
    SlideIndex = 1,
    ShapeIndex = 1,
    CategoryIndex = 2
};
Chart chart = api.DeleteChartCategory(request);
Console.WriteLine(chart.Categories.Count);

チャートデータを扱う

API は、PowerPoint スライド内のチャートオブジェクトに関連するデータポイントを操作する機能を提供する完全な能力を持っています。最近の API の更新により、新しいリソースは series のサブリソースです。これはチャート形状のみに機能し、個々のデータポイントを追加、変更、および削除することを可能にします。

チャート系列にデータポイントを追加する

この機能は散布図およびバブル系列で機能します。関連するカテゴリを作成することなく、単一値系列のデータポイントを作成することはできません。

リクエストURL

<code>POST https://api.aspose.cloud/v3.0/slides/myPresentaion.pptx/slides/1/shapes/1/series/2/dataPoints?folder=myFolder</code>

C#.NET

string MyAppKey = "xxxxxxxx";    // Get AppKey and AppSID from https://dashboard.aspose.cloud/
string MyAppSid = "xxxxxxxx";    // Get AppKey and AppSID from https://dashboard.aspose.cloud/

SlidesApi api = new SlidesApi(MyAppSid, MyAppKey);
ScatterChartDataPoint dto = new ScatterChartDataPoint
{
 XValue = 5.5,
 YValue = 8
};
PostChartDataPointRequest request = new PostChartDataPointRequest
{
 Name = "myPresentaion.pptx",
 Folder = "myFolder",
 SlideIndex = 1,
 ShapeIndex = 1,
 SeriesIndex = 2,
 DataPoint = dto
};
Chart chart = api.PostChartDataPoint(request);
Console.WriteLine(((ScatterSeries)chart.Series[1]).DataPoints.Count);

チャートデータポイントを更新する

既存のチャートデータポイントを更新するためにAPIを使用することもできます。

リクエストURL

<code>PUT https://api.aspose.cloud/v3.0/slides/myPresentaion.pptx/slides/1/shapes/1/series/2/dataPoints/2?folder=myFolder</code>

C#.NET

string MyAppKey = "xxxxxxxx";    // Get AppKey and AppSID from https://dashboard.aspose.cloud/
string MyAppSid = "xxxxxxxx";    // Get AppKey and AppSID from https://dashboard.aspose.cloud/

SlidesApi api = new SlidesApi(MyAppSid, MyAppKey);

ScatterChartDataPoint dto = new ScatterChartDataPoint
{
 XValue = 5.5,
 YValue = 8
};
PutChartDataPointRequest request = new PutChartDataPointRequest
{
 Name = "myPresentaion.pptx",
 Folder = "myFolder",
 SlideIndex = 1,
 ShapeIndex = 1,
 SeriesIndex = 2,
 PointIndex = 2,
 DataPoint = dto
};
Chart chart = api.PutChartDataPoint(request);
Console.WriteLine(((ScatterSeries)chart.Series[1]).DataPoints[1].XValue); //5.5

チャートデータポイントを削除する

Chart オブジェクト内のすべての既存データポイントに対して、API は PointIndex の値を指定することによって任意のポイントを削除することも可能です。

リクエストURL

<code>DELETE https://api.aspose.cloud/v3.0/slides/myPresentaion.pptx/slides/1/shapes/1/series/2/dataPoints/2?folder=myFolder</code>

C#.NET

string MyAppKey = "xxxxxxxx";    // Get AppKey and AppSID from https://dashboard.aspose.cloud/
string MyAppSid = "xxxxxxxx";    // Get AppKey and AppSID from https://dashboard.aspose.cloud/

SlidesApi api = new SlidesApi(MyAppSid, MyAppKey);
DeleteChartDataPointRequest request = new DeleteChartDataPointRequest
{
 Name = "myPresentaion.pptx",
 Folder = "myFolder",
 SlideIndex = 1,
 ShapeIndex = 1,
 SeriesIndex = 2,
 PointIndex = 2
};
Chart chart = api.DeleteChartDataPoint(request);
Console.WriteLine(((ScatterSeries)chart.Series[1]).DataPoints.Count);