Os gráficos nos oferecem um mecanismo rápido e conciso para apresentar os dados estatísticos. Eles permitem que as partes interessadas relevantes tomem decisões chave rapidamente. Os gráficos são compostos por dados e suas respectivas categorias. Assim, operações como adicionar, atualizar e excluir dados de gráficos no PowerPoint. Suas categorias relacionadas também podem ser realizadas usando Aspose.Slides Cloud API.
Além disso, para usar o SDK, você precisa instalá-lo e a maneira mais fácil é através da biblioteca NuGet. Portanto, tente usar o seguinte comando no console do Gerenciador de Pacotes
Install-Package Aspose.Slides-Cloud -Version 21.2.0
A API Cloud também pode ser acessada usando comandos cURL no terminal. Portanto, para acessá-los, você precisa fornecer um token JWT que é gerado com base no seu Client ID e Client Secret. Portanto, recomendamos que você visite os seguintes links para uma melhor compreensão sobre
- Como instalar os SDKs do Aspose.Cloud
- Como obter o token JWT usando um ID de cliente e uma chave secreta do cliente
Trabalhando com Categorias de Gráfico
O novo recurso é um sub-recurso de forma. Ele funciona apenas para formas de Gráfico que suportam categorias (coluna, linha, etc.).Ele nos permite adicionar, modificar e excluir categorias de gráfico juntamente com os pontos de dados relevantes. Este artigo se concentra principalmente nos seguintes tópicos
Adicionar uma categoria ao Gráfico
Request 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);
Atualizar categoria do gráfico
Request 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);
Excluir Categoria do Gráfico
A API Aspose.Slides Cloud também oferece as capacidades de excluir qualquer categoria existente em objetos de gráfico. Você só precisa fornecer o índice do Slide, o índice da forma respectiva e o ID da categoria relacionada para atender aos requisitos.
Request 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);
Trabalhando com dados de Gráficos
A API é totalmente capaz de fornecer recursos para manipular pontos de dados relacionados a objetos de gráfico dentro dos slides do PowerPoint. De acordo com as atualizações recentes na API, o novo recurso é um subrecurso de séries. Ele funciona apenas para formas de gráfico e nos permite adicionar, modificar e excluir pontos de dados individuais.
Adicione um ponto de dados a uma série de gráficos
Isso funciona com a série de dispersão e bolhas. Você não pode criar um ponto de dados para uma série de um valor sem criar uma categoria relevante.
Request 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);
Atualizar ponto de dados do gráfico
Você também pode usar a API para atualizar os pontos de dados do gráfico existente.
Request 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
Excluir ponto de dados do gráfico
Para todos os pontos de dados existentes dentro do objeto Chart, a API também permite que você exclua qualquer ponto fornecendo um valor para PointIndex.
Request 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);