تلاعب بيانات المخطط والفئات داخل عرض PowerPoint

تقدم الرسوم البيانية لنا آلية سريعة وموجزة لعرض البيانات الإحصائية. فهي تمكن الأطراف المعنية ذات الصلة من اتخاذ قرارات رئيسية بسرعة. تتكون الرسوم البيانية من البيانات وفئاتها المعنية. لذا يمكن إجراء عمليات مثل الإضافة والتحديث وحذف بيانات الرسم البياني في PowerPoint. يمكن أيضًا إجراء الفئات ذات الصلة باستخدام Aspose.Slides Cloud API.

علاوة على ذلك، لاستخدام SDK، تحتاج إلى تثبيته، وأبسط طريقة هي من خلال مكتبة NuGet. لذلك، يرجى محاولة استخدام الأمر التالي في وحدة تحكم إدارة الحزم

 Install-Package Aspose.Slides-Cloud -Version 21.2.0
copy

يمكن الوصول إلى واجهة برمجة التطبيقات السحابية أيضًا باستخدام أوامر cURL عبر المحطة الطرفية. لذلك، للوصول إليها، تحتاج إلى تقديم رمز JWT والذي يتم إنشاؤه استنادًا إلى معرّف العميل وسر العميل. لذلك، نوصي بزيارة الروابط التالية لفهم المزيد حول

• كيفية تثبيت Aspose.Cloud SDKs
• كيفية الحصول على توكن JWT باستخدام معرف العميل ومفتاح العميل السري

العمل مع فئات الرسم البياني

المورد الجديد هو مورد فرعي من الشكل. إنه يعمل فقط مع أشكال الرسوم البيانية التي تدعم الفئات (العمود، الخط، إلخ).وهو يتيح لنا إضافة وتعديل وحذف فئات الرسم البياني مع نقاط البيانات ذات الصلة. يركز هذا المقال بشكل أساسي على الموضوعات التالية

• العمل مع فئات المخطط
  • أضف فئة إلى الرسم البياني
  • تحديث فئة الرسم البياني
  • احذف فئة الرسم البياني
  • العمل مع بيانات الرسوم البيانية
  • أضف نقطة بيانات إلى سلسلة الرسم البياني
  • تحديث نقطة بيانات الرسم البياني
  • حذف نقطة بيانات الرسم البياني

إضافة فئة إلى الرسم البياني

طلب عنوان URL

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

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);
copy

تحديث فئة الرسم البياني

طلب عنوان URL

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

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);
copy

حذف فئة الرسم البياني

واجهة برمجة تطبيقات Aspose.Slides Cloud توفر أيضًا إمكانية حذف أي فئة موجودة في كائنات الرسم البياني. كل ما عليك فعله هو تقديم فهرس الشريحة، وفهرس الشكل المعني، ومعرف الفئة المرتبط لتلبية المتطلبات.

طلب عنوان URL

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

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);
copy

العمل مع بيانات المخططات

تتمتع واجهة برمجة التطبيقات (API) بالقدرة الكاملة على توفير ميزات للتلاعب بنقاط البيانات المتعلقة بكائنات المخطط داخل شرائح PowerPoint. وفقًا للتحديثات الأخيرة في واجهة برمجة التطبيقات، فإن المورد الجديد هو مورد فرعي للسلاسل. إنه يعمل فقط مع أشكال المخططات ويسمح لنا بإضافة وتعديل وحذف نقاط البيانات الفردية.

إضافة نقطة بيانات إلى سلسلة الرسم البياني

هذا يعمل مع سلسلة التشتت والفقاعات. لا يمكنك إنشاء نقطة بيانات لسلسلة ذات قيمة واحدة دون إنشاء فئة ذات صلة.

طلب عنوان URL

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

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);
copy

تحديث نقطة بيانات الرسم البياني

يمكنك أيضًا استخدام واجهة برمجة التطبيقات (API) لتحديث نقاط بيانات الرسم البياني الحالية.

طلب عنوان URL

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

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
copy

حذف بيانات نقطة الرسم البياني

بالنسبة لجميع نقاط البيانات الموجودة داخل كائن الرسم البياني، يتيح لك واجهة البرمجة أيضًا حذف أي نقطة عن طريق توفير قيمة لـ PointIndex.

طلب عنوان URL

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

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);
copy