Documentation –

Developer-Guide: الحصول على جدول محوري في ورقة عمل إكسل

Mon, 01 Jan 0001 00:00:00 +0000

تُعيد هذه الواجهة البرمجية معلومات الجدول المحوري في ورقة العمل بناءً على مؤشره.

الأمان والمصادقة

تُعدّ واجهات برمجة تطبيقات Aspose.Cells Cloud آمنة وتتطلب مصادقة تعتمد على رمز JWT.

واجهة برمجة تطبيقات REST

GET https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/pivottables/{pivottableIndex}

معلمات الطلب

اسم المعلمة	النوع	الموقع	الوصف
name	نص (string)	مسار	اسم ملف إكسل.
sheetName	نص (string)	مسار	اسم ورقة العمل التي تحتوي على الجدول المحوري.
pivottableIndex	عدد صحيح (integer)	مسار	المؤشر الصفري (zero-based) للجدول المحوري في ورقة العمل.
folder	نص (string)	استعلام	المجلد الذي يُخزَّن فيه المستند.
storageName	نص (string)	استعلام	اسم تخزين Aspose Cloud.

يمكنك استخدام أداة سطر الأوامر cURL للوصول بسهولة إلى خدمات Aspose.Cells عبر الويب. يُظهر المثال التالي كيفية استدعاء الواجهة البرمجية باستخدام cURL.

الطلب

curl -v "https://api.aspose.cloud/v3.0/cells/Sample_Pivot_Table_Example.xls/worksheets/Sheet2/pivottables/0" \
  -X GET \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <jwt token>"

الاستجابة

{
  "Status": "string",
  "PivotFilters": [
    {
      "AutoFilter": {
        "link": {
          "Href": "string",
          "Rel": "string",
          "Title": "string",
          "Type": "string"
        },
        "FilterColumns": [
          {
            "FieldIndex": 0,
            "FilterType": "string",
            "MultipleFilters": {
              "MatchBlank": true,
              "MultipleFilterList": [{}]
            },
            "ColorFilter": {
              "FilterByFillColor": "string",
              "Pattern": "string",
              "Color": {
                "Color": {
                  "A": 0,
                  "R": 0,
                  "G": 0,
                  "B": 0
                },
                "ColorIndex": 0,
                "IsShapeColor": true,
                "ThemeColor": {
                  "ColorType": "string",
                  "Tint": 0
                },
                "Type": "string"
              },
              "ForegroundColorColor": {
                "Color": {
                  "A": 0,
                  "R": 0,
                  "G": 0,
                  "B": 0
                },
                "ColorIndex": 0,
                "IsShapeColor": true,
                "ThemeColor": {
                  "ColorType": "string",
                  "Tint": 0
                },
                "Type": "string"
              },
              "BackgroundColor": {
                "Color": {
                  "A": 0,
                  "R": 0,
                  "G": 0,
                  "B": 0
                },
                "ColorIndex": 0,
                "IsShapeColor": true,
                "ThemeColor": {
                  "ColorType": "string",
                  "Tint": 0
                },
                "Type": "string"
              }
            },
            "CustomFilters": [
              {
                "FilterOperatorType": "string"
              }
            ],
            "DynamicFilter": {
              "DynamicFilterType": "string"
            },
            "IconFilter": {
              "IconId": 0,
              "IconSetType": "string"
            },
            "Top10Filter": {
              "Criteria": "string",
              "IsPercent": true,
              "IsTop": true,
              "Items": 0
            },
            "VisibleDropdown": "string"
          }
        ],
        "Range": "string",
        "Sorter": {
          "CaseSensitive": true,
          "HasHeaders": true,
          "KeyList": [
            {
              "Key": 0,
              "SortOrder": "string",
              "CustomList": "string"
            }
          ],
          "SortLeftToRight": true
        }
      },
      "EvaluationOrder": 0,
      "FieldIndex": 0,
      "FilterType": "string",
      "MeasureFldIndex": 0,
      "MemberPropertyFieldIndex": 0,
      "Name": "string",
      "Value1": "string",
      "Value2": "string"
    }
  ]
}

مخطط الاستجابة

الحقل	النوع	الوصف
Status	نص (string)	حالة العملية كنص (مثال: “OK”).
PivotFilters	مصفوفة (array)	مجموعة تعريفات مرشّحات الجدول المحوري.
└─ AutoFilter	كائن (object)	تفاصيل التصفية التلقائية المطبّقة على الجدول المحوري.
└─ link	كائن (object)	معلومات الارتباط التشعبي (hyperlink) الخاص بالمرشّح.
└─ FilterColumns	مصفوفة (array)	إعدادات المرشّح لكل عمود على حدة.
└─ Range	نص (string)	مدى الخلايا الذي يطبّق عليه المرشّح.
└─ Sorter	كائن (object)	إعدادات الترتيب للبيانات المُرشّحة.
(تتّبع الحقول المتداخلة الإضافية نفس البنية الموضّحة في مثال JSON أعلاه)

معالجة الأخطاء

تتّبع الواجهة البرمجية رموز حالة HTTP القياسية. تشمل الاستجابات الشائعة ما يلي:

رمز الحالة	المعنى	مثال JSON (خطأ)
200	نجاح – تم إرجاع الجدول المحوري	—
401	غير مصادَق – رمز غير صالح أو مفقود	`{"code":401,"message":"Invalid access token."}`
404	غير موجود – الملف أو ورقة العمل أو مؤشر الجدول المحوري غير موجود	`{"code":404,"message":"Pivot table not found."}`
500	خطأ في الخادم – حالة غير متوقّعة	`{"code":500,"message":"Internal server error."}`

ملاحظات: تدعم الواجهة البرمجية ملفات إكسل حتى 150 ميغابايت، وتعمل مع صيغ إكسل من 2007 إلى 2021. تأكّد من أن اسم ورقة العمل حسّاس لحالة الأحرف.

عائلة حزم تطوير البرمجيات (SDK) السحابية

استخدام حزمة تطوير برمجيات (SDK) هو أفضل طريقة لتسريع عملية التطوير. فحزمة SDK تُدار بالتفاصيل منخفضة المستوى، مما يمكّنك من التركيز على مهام مشروعك. يُرجى الاطّلاع على مستودع GitHub للحصول على قائمة كاملة بحزم تطوير البرمجيات لـ Aspose.Cells Cloud.

تُظهر أمثلة الكود التالية كيفية استدعاء خدمات Aspose.Cells عبر الويب باستخدام حزم تطوير برمجيات مختلفة:

C#

Java

PHP
Ruby
Python

Node.js

Objective C
Android

Perl

Go

Developer-Guide: الحصول على جميع جداول البيانات المحورية في ورقة عمل Excel

Mon, 01 Jan 0001 00:00:00 +0000

يُعد جدول البيانات المحوري (PivotTable) أداة لتلخيص البيانات في Excel، تتيح لك إعادة تنظيم وتحليل مجموعات بيانات كبيرة. وتسترجع واجهة برمجة التطبيقات هذه معلومات حول جميع جداول البيانات المحورية الموجودة في ورقة عمل محددة.

الأمان والمصادقة

تُعد واجهات برمجة تطبيقات Aspose.Cells Cloud آمنة وتشترط المصادقة باستخدام رمز JWT .

واجهة برمجة تطبيقات REST

GET https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/pivottables

معاملات الطلب

اسم المعامل	النوع	الموقع	الوصف
name	string	path	اسم مستند Excel.
sheetName	string	path	اسم ورقة العمل.
folder	string	query	المجلد الذي يُخزَّن فيه المستند.
storageName	string	query	اسم خدمة التخزين.

يُعرّف مواصفات OpenAPI واجهة برمجة تطبيقات متاحة عمومًا، ويسمح لك بإجراء تفاعلات REST مباشرة من متصفح ويب.

الطلب

Request

curl -v "https://api.aspose.cloud/v3.0/cells/Sample_Pivot_Table_Example.xls/worksheets/Sheet2/pivottables" \
  -X GET \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <jwt token>"

Response

{
  "PivotTables": {
    "PivotTableList": [
      {
        "link": {
          "Href": "/0",
          "Rel": "self"
        }
      }
    ],
    "link": {
      "Href": "https://api.aspose.cloud/v3.0/cells/Sample_Pivot_Table_Example.xls/worksheets/Sheet2",
      "Rel": "self"
    }
  },
  "Code": "200",
  "Status": "OK"
}

استجابات الخطأ

رمز HTTP	الوصف	حمولة JSON المثال
400	طلب غير صالح – معامل مطلوب مفقود.	`{ "Code": "400", "Message": "Missing required parameter." }`
401	غير مصرّح به – رمز غير صالح أو مفقود.	`{ "Code": "401", "Message": "Authentication failed." }`
404	غير موجود – المصنف أو ورقة العمل أو جدول البيانات المحوري غير موجود.	`{ "Code": "404", "Message": "Resource not found." }`
500	خطأ داخلي في الخادم – حالة غير متوقعة في الخادم.	`{ "Code": "500", "Message": "Server error." }`

مجموعة أدوات SDK للسحابة

يُعد استخدام SDK الطريقة الأسرع لتطوير التطبيقات، إذ يتعامل SDK مع التفاصيل منخفضة المستوى، مما يتيح لك التركيز على مشروعك. يُرجى الاطّلاع على مستودع GitHub للحصول على قائمة كاملة بـ SDKs الخاصة بـ Aspose.Cells Cloud.

تُظهر أمثلة الكود التالية كيفية استدعاء خدمات ويب Aspose.Cells باستخدام مكتبات SDK مختلفة:

C#

Java

PHP
Ruby
Python

Node.js

Android

Swift
Perl

Go

Developer-Guide: إضافة جدول محوري في ورقة عمل Excel

Mon, 01 Jan 0001 00:00:00 +0000

تضيف هذه الواجهة البرمجية (REST API) جدولًا محوريًا في ورقة عمل.

المتطلبات المسبقة:

حساب Aspose.Cells Cloud مع رمز وصول JWT صالح.
يجب تخزين ملف العمل المستهدف في موقع تخزين مدعوم (التخزين الافتراضي أو تخزين مُحدّد من قِبل المستخدم).
يجب أن توجد الورقة المحددة عبر sheetName في ملف العمل.

PutWorksheetPivotTable API

PUT https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/pivottables

الأمان والمصادقة

تُطبّق واجهات برمجة التطبيقات (APIs) الخاصة بـ Aspose.Cells Cloud سياسة أمان صارمة وتتطلب مصادقة قائمة على رمز JWT.

معاملات الطلب

اسم المعامل	النوع	الموقع	الوصف
name	string	path	اسم ملف Excel.
sheetName	string	path	اسم ورقة العمل التي سيتم إنشاء الجدول المحوري فيها.
request	object	body	كائن `CreatePivotTableRequest` DTO الذي يحتوي على تعريف الجدول المحوري.
folder	string	query	المجلد الذي يحتوي على المستند.
storageName	string	query	اسم مكان التخزين الذي يوجد فيه المستند.
sourceData	string	query	النطاق الذي يزوّد البيانات المصدرية لذاكرة التخزين المؤقتة الجديدة للجدول المحوري (مثل `A5:E10`).
destCellName	string	query	عنوان الخلية العلوية اليسرى للنطاق الوجهة لتقرير الجدول المحوري.
tableName	string	query	الاسم المُسنَد إلى الجدول المحوري الجديد.
useSameSource	boolean	query	عندما تكون القيمة `true`، فإن الجدول المحوري الجديد يُعيد استخدام مصدر بيانات موجود، مما يوفّر الذاكرة إذا كان هناك جدول محوري آخر قد استخدم هذا المصدر مسبقًا.

يمكنك الاطّلاع على مواصفات OpenAPI التي تُعرّف واجهة برمجة تطبيقات عامة قابلة للاستعمال، وتتيح لك إجراء تفاعلات REST مباشرة من متصفح ويب.

يمكنك استخدام أداة سطر الأوامر cURL للوصول إلى خدمات ويب Aspose.Cells بسهولة. يُظهر المثال التالي كيفية استدعاء واجهة برمجة التطبيقات السحابية باستخدام cURL.

ملاحظة أمنية: تأكد دائمًا من استخدام https:// عند استدعاء الواجهة البرمجية، واحتفظ بسرية رمز JWT الخاص بك؛ إذ أن إرساله عبر بروتوكول HTTP غير المشفر يعرّضه للاختطاف.

الطلب

curl -v "https://api.aspose.cloud/v3.0/cells/Sample_Test_Book.xls/worksheets/Sheet1/pivottables" \
-X PUT \
-d '{"Name":"MyPivot","SourceData":"A5:E10","DestCellName":"H20","UseSameSource":true,"PivotFieldRows":[1],"PivotFieldColumns":[1],"PivotFieldData":[1]}' \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-H "Authorization: Bearer <jwt token>"

الاستجابة

{
  "Code": 200,
  "Status": "OK"
}

رموز حالة HTTP

الرمز	المعنى	الوصف
200	ناجح (OK)	تم تطبيق التصفية بنجاح؛ تحتوي الاستجابة على تفاصيل العملية.
400	طلب غير صالح (Bad Request)	معاملات مفقودة أو غير صحيحة (مثل نوع ملف غير مدعوم).
401	غير مُصرّح (Unauthorized)	رمز JWT غير صالح أو مفقود.
413	حجم الحمولة كبير جدًا (Payload Too Large)	حجم الملف المرفوع يتجاوز الحد المسموح.
500	خطأ داخلي في الخادم (Internal Server Error)	خطأ غير متوقع في الخادم.

عائلة SDK السحابية

استخدام SDK هو أفضل طريقة لتسريع عملية التطوير. فتتولى SDK التعامل مع التفاصيل من المستوى المنخفض، مما يمكّنك من التركيز على مهام مشروعك. يُرجى زيارة مستودع GitHub للاطّلاع على القائمة الكاملة لـ SDKs الخاصة بـ Aspose.Cells Cloud.

تُظهر أمثلة الكود التالية كيفية استدعاء خدمات ويب Aspose.Cells باستخدام SDKs المختلفة:

لمزيد من العمليات، راجع صفحات الواجهة البرمجية ذات الصلة: الحصول على جدول محوري، حذف جدول محوري، و تحديث جدول محوري.

Developer-Guide: إضافة حقل محوري إلى جدول محوري

Mon, 01 Jan 0001 00:00:00 +0000

تقوم هذه الواجهة إضافة حقل محوري إلى جدول محوري موجود.

الشرط المسبق: لاستدعاء هذه النقطة النهائية، يجب تضمين رمز مصادقة JWT صالح في رأس Authorization، وضمان تخزين الملف في المجلد المحدد أو وحدة التخزين الافتراضية.

واجهة REST API

PUT https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/pivottables/{pivotTableIndex}/PivotField

معلمات الطلب

اسم المعلمة	النوع	الموقع	الوصف
name	string	path	اسم المستند.
sheetName	string	path	اسم ورقة العمل.
pivotTableIndex	integer	path	فهرس الجدول المحوري.
pivotFieldType	string	query	نوع منطقة الحقول (مثل: Row، Column).
request	object	body	كائن يحتوي على فهارس الحقول المراد إضافتها.
needReCalculate	boolean	query	اضبطها على true لإعادة حساب الجدول المحوري بعد تنفيذ العملية.
folder	string	query	المجلد الذي يُخزّن فيه المستند.
storageName	string	query	اسم وحدة التخزين.

يعرّف مواصفات OpenAPI واجهة برمجة تطبيقات متاحة عمومًا، ويتيح لك إجراء تفاعلات REST مباشرة من متصفح ويب.

يمكنك استخدام أداة سطر الأوامر cURL لاستدعاء خدمات Aspose.Cells عبر الويب. يوضح المثال التالي كيفية إضافة حقل محوري باستخدام cURL.

Request

curl -v "https://api.aspose.cloud/v3.0/cells/Sample_Pivot_Table_Example.xls/worksheets/Sheet2/pivottables/0/PivotField?pivotFieldType=Row" \
  -X PUT \
  -d '{"Data":[1,2]}' \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <jwt token>"

Response

{
  "Code": 200,
  "Status": "OK"
}

يُعيد الطلب الناجح كائن JSON يحتوي على الحقلين Code و Status. مخطط المثال:

{
  "Code": 0,        // عدد صحيح يُشير إلى رمز حالة HTTP
  "Status": "OK"    // رسالة نصية
}

تشمل استجابات الخطأ المحتملة 400 Bad Request عند غياب المعلمات، و401 Unauthorized إذا كان الرمز غير صالح، و500 Internal Server Error في حال حدوث مشكلات من جانب الخادم.

عائلة SDK للسحابة

استخدام SDK هو أسرع طريقة لدمج هذه الوظيفة. فتتولى SDKs إدارة التفاصيل من المستوى المنخفض، مما يتيح لك التركيز على منطق أعمالك. راجع مستودع GitHub للاطلاع على القائمة الكاملة لـ SDKs الخاصة بـ Aspose.Cells Cloud.

توضح أمثلة الكود التالية كيفية استدعاء خدمات Aspose.Cells عبر SDKs مختلفة:

انظر أيضًا:

Developer-Guide: العمل مع مرشحات الجداول المحورية

Mon, 01 Jan 0001 00:00:00 +0000

تُضيف هذه الواجهة البرمجية REST مرشحًا جذريًا (Pivot Filter) إلى الجدول المحوري الموجود عند الفهرس المحدد.

المتطلبات المسبقة
قبل استدعاء هذه النقطة النهائية (endpoint)، يجب أن:

تولّد رمز وصول OAuth/JWT صالحًا وتضمينه في رأس Authorization.
تتأكد من أن ملف المصنف المستهدف محفوظ في مجلد سحابي يمكنك الوصول إليه (حدد folder واختياريًا storageName).
تستخدم إصدار 3.0 أو أحدث من واجهة برمجة تطبيقات Aspose.Cells Cloud.

واجهة PutWorksheetPivotTableFilter البرمجية

PUT https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/pivottables/{pivotTableIndex}/PivotFilters

الأمان والمصادقة

تُقدّم واجهات برمجة تطبيقات Aspose.Cells Cloud بشكل آمن وتتطلب مصادقة مبنية على رمز JWT.

معلمات الطلب

اسم المعلمة	النوع	الموقع	الوصف
name	نص (string)	المسار (path)	اسم ملف Excel.
sheetName	نص (string)	المسار (path)	الورقة التي تحتوي على الجدول المحوري.
pivotTableIndex	عدد صحيح (integer)	المسار (path)	فهرس الجدول المحوري (يبدأ من الصفر) الذي سيتم تطبيق المرشح عليه.
filter	كائن (object)	الجسم (body)	كائن JSON يُعرّف إعدادات المرشح. انظر جدول مخطط المرشح أدناه.
needReCalculate	منطقي (boolean)	الاستعلام (query)	عند القيمة true، يُجبر المصنف على إعادة الحساب بعد إضافة المرشح. القيمة الافتراضية: false.
folder	نص (string)	الاستعلام (query)	المجلد في التخزين السحابي حيث يوجد الملف.
storageName	نص (string)	الاستعلام (query)	اسم خدمة التخزين السحابي.

مخطط المرشح (filter schema)

الخاصية	النوع	الوصف
AutoFilter	كائن (object)	إعدادات المرشح التلقائي (AutoFilter)؛ يمكن تجاهلها إن لم تُستخدم.
EvaluationOrder	عدد صحيح (integer)	ترتيب تقييم المرشح.
FieldIndex	عدد صحيح (integer)	فهرس الحقل (يبدأ من الصفر) الذي يطبّق عليه المرشح.
FilterType	نص (string)	نوع المرشح (مثل: `Value`، `Count`، `Label`).
MeasureFldIndex	عدد صحيح (integer)	فهرس حقل القياس، إن وُجد.
MemberPropertyFieldIndex	عدد صحيح (integer)	فهرس حقل خاصية العضو، إن وُجد.
Name	نص (string)	اسم اختياري للمرشح.
Value1	نص (string)	القيمة الأولى المستخدمة في المرشح (مثل: الحد الأدنى للنطاق).
Value2	نص (string)	القيمة الثانية المستخدمة في المرشح (مثل: الحد الأقصى للنطاق).
CustomFilters	مصفوفة (array)	مجموعة كائنات المرشح المخصصة (كل منها يحتوي على `FilterOperatorType`، `Value1`، `Value2`).
DynamicFilter	كائن (object)	إعدادات المرشح الديناميكي (مثل: Top10، Bottom10).
IconFilter	كائن (object)	إعدادات المرشح القائم على الأيقونات.
Top10Filter	كائن (object)	إعدادات مرشح Top10/Bottom10.
ColorFilter	كائن (object)	إعدادات المرشح القائم على اللون.
Visibledropdown	منطقي (boolean)	يُشير إلى ظهور القائمة المنسدلة للمرشح.

ملاحظة: جميع المعلمات المذكورة أعلاه إجبارية ما لم يُشار صراحةً إلى كونها اختيارية في وثائق الواجهة البرمجية.

أكواد الاستجابة

الكود	المعنى
200	تمت إضافة المرشح بنجاح.
400	طلب غير صالح – معلمات غير صحيحة.
401	غير مصرّح – رمز مفقود أو غير صالح.
404	غير موجود – المصنف أو الجدول المحوري مفقود.
500	خطأ داخلي في الخادم.

أفضل الممارسات

حافظ على صغر حجم كائنات المرشح قدر الإمكان؛ فالتعريفات الكبيرة للمرشحات قد تزيد من زمن الاستجابة.
تكون المكالمات مُتكررة (Idempotent) — إضافة نفس المرشح مرتين لن تُنتِج نسخًا مكررة.
التزم بحدّ معدل طلبات الواجهة البرمجية: 100 طلب في الدقيقة لكل حساب.

ملاحظات إضافية:

الحد الأقصى لحجم تعريف المرشح هو 1 ميغابايت؛ سيتم رفض الحمولات الأكبر بخطأ 400.
عند استخدام needReCalculate=true، قد يؤدي إعادة الحساب إلى زيادة زمن الاستجابة، خاصةً مع المصنفات الكبيرة.

يمكنك استكشاف تعريف OpenAPI الكامل هنا:
مواصفات OpenAPI

مثال على طلب cURL

Request

curl -v "https://api.aspose.cloud/v3.0/cells/Book1.xlsx/worksheets/Sheet1/pivottables/0/PivotFilters?needReCalculate=true" \
  -X PUT \
  -d '{
        "AutoFilter": {
          "link": { "Href": "https://example.com", "Rel": "self", "Title": "AutoFilter Link", "Type": "application/json" },
          "FilterColumns": [
            {
              "FieldIndex": 0,
              "FilterType": "Value",
              "MultipleFilters": {
                "MatchBlank": true,
                "MultipleFilterList": [ { "Value": "example" } ]
              },
              "ColorFilter": {
                "FilterByFillColor": "FF0000",
                "Pattern": "Solid",
                "Color": {
                  "Color": { "A": 255, "R": 255, "G": 0, "B": 0 },
                  "ColorIndex": 3,
                  "IsShapeColor": false,
                  "ThemeColor": { "ColorType": "Accent1", "Tint": 0 },
                  "Type": "Rgb"
                },
                "ForegroundColorColor": null,
                "BackgroundColor": null
              },
              "CustomFilters": [ { "FilterOperatorType": "Equals", "Value1": "Example" } ],
              "DynamicFilter": { "DynamicFilterType": "Top10" },
              "IconFilter": { "IconId": 1, "IconSetType": "3Arrows" },
              "Top10Filter": { "Criteria": "Top", "IsPercent": true, "IsTop": true, "Items": 10 },
              "Visibledropdown": "true"
            }
          ],
          "Range": "A1:D100",
          "Sorter": {
            "CaseSensitive": false,
            "HasHeaders": true,
            "KeyList": [ { "Key": 0, "SortOrder": "Ascending", "CustomList": null } ],
            "SortLeftToRight": false
          }
        },
        "EvaluationOrder": 0,
        "FieldIndex": 0,
        "FilterType": "Value",
        "MeasureFldIndex": 0,
        "MemberPropertyFieldIndex": 0,
        "Name": "MyFilter",
        "Value1": "10",
        "Value2": "20"
      }' \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <jwt token>"

Response

{
  "Code": 200,
  "Status": "OK"
}

عائلة SDK السحابية

استخدام SDK هو أسرع طريقة لتطوير تطبيقاتك ضد Aspose.Cells Cloud. فالمكتبات البرمجية تتعامل مع التفاصيل منخفضة المستوى، مما يتيح لك التركيز على منطق تطبيقك. راجع مستودع GitHub للحصول على قائمة كاملة بـ SDKs الخاصة بـ Aspose.Cells Cloud.

توضح الأمثلة التالية كيفية إجراء مكالمات لخدمات الويب Aspose.Cells باستخدام مكتبات SDK مختلفة.

using System;
using System.Threading.Tasks;
using Aspose.Cells.Cloud.Sdk.Api;
using Aspose.Cells.Cloud.Sdk.Model;

public class PivotFilterExample
{
    public static async Task AddPivotFilterAsync()
    {
        // تهيئة عميل الواجهة البرمجية (استبدل بالمُعطيات الخاصة بك)
        var config = new Configuration
        {
            ClientId = "YOUR_CLIENT_ID",
            ClientSecret = "YOUR_CLIENT_SECRET"
        };
        var apiInstance = new CellsApi(config);

        // بناء كائن المرشح
        var filter = new PivotFilter
        {
            AutoFilter = null,
            EvaluationOrder = 0,
            FieldIndex = 1,
            FilterType = "Count"
        };

        // إعداد الطلب
        var request = new PutWorksheetPivotTableFilterRequest(
            name: "Book1.xlsx",
            sheetName: "PivotSheet",
            pivotTableIndex: 0,
            filter: filter,
            needReCalculate: true,
            folder: "Temp",
            storageName: null);

        // تنفيذ الطلب
        var response = await apiInstance.PutWorksheetPivotTableFilterAsync(request);
        Console.WriteLine($"Status: {response.Status}");
    }
}

للمزيد من العمليات المتعلقة بالجداول المحورية، راجع وثائق الإضافة والحذف والمسح للمرشحات.

Developer-Guide: تحويل جدول إلى جدول محوري

Mon, 01 Jan 0001 00:00:00 +0000

تُنشئ هذه الواجهة البرمجية (REST API) جدولاً محورياً من كائن قائمة.

يُلخّص الجدول المحوري البيانات الواردة من كائن قائمة، مما يتيح لك تحليل البيانات وإعداد تقارير عنها في مجموعات بيانات كبيرة مباشرةً داخل المصنف.

المتطلبات المسبقة:

رمز مُعتمد (bearer token) صالح من نوع JWT للتحقق من الهوية.
يجب أن يكون المصنف موجوداً في موقع التخزين المحدّد.
يجب أن تحتوي الورقة المستهدفة على كائن القائمة الذي ترغب في تلخيصه.

واجهة PostWorksheetListObjectSummarizeWithPivotTable

POST https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/listobjects/{listObjectIndex}/SummarizeWithPivotTable

الأمان والمصادقة

تتطلب واجهات Aspose.Cells Cloud API المصادقة باستخدام رمز JWT token، وهي آمنة.

مُعاملات الطلب

اسم المُعامل	النوع	الموقع	الوصف
name	string	path	اسم ملف المصنف.
sheetName	string	path	اسم الورقة التي تحتوي على كائن القائمة.
listObjectIndex	integer	path	فهرس كائن القائمة داخل الورقة.
destsheetName	string	query	اسم الورقة الوجهة.
request	object	body	حمولة JSON التي تُعرّف الجدول المحوري.
folder	string	query	مسار المجلد الذي يوجد فيه المصنف.
storageName	string	query	اسم مساحة التخزين.

يجب أن يتّبع محتوى جسم الطلب المخطط (schema) المُعرّف في JSON أدناه:

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {
    "Name": { "type": "string", "description": "اسم الجدول المحوري الجديد." },
    "DestCellName": { "type": "string", "description": "الخلية العلوية اليسرى للجدول المحوري (مثال: \"C1\")." },
    "PivotFieldRows": {
      "type": "array",
      "items": { "type": "integer" },
      "description": "فهارس الحقول (تبدأ من الصفر) التي سيتم وضعها في الصفوف."
    },
    "PivotFieldColumns": {
      "type": "array",
      "items": { "type": "integer" },
      "description": "فهارس الحقول (تبدأ من الصفر) التي سيتم وضعها في الأعمدة."
    },
    "PivotFieldData": {
      "type": "array",
      "items": { "type": "integer" },
      "description": "فهارس الحقول (تبدأ من الصفر) التي ستُستخدم كحقول بيانات."
    }
  },
  "required": ["Name", "DestCellName", "PivotFieldRows", "PivotFieldColumns", "PivotFieldData"]
}

يُعرّف مواصفات OpenAPI واجهة برمجة تطبيقات قابلة للوصول العام، ويتيح لك إجراء تفاعلات REST مباشرة من متصفّح ويب.

يمكنك استخدام أداة cURL للاستفادة من خدمات Aspose.Cells عبر واجهة سطر الأوامر بسهولة. يوضّح المثال التالي كيفية إجراء المكالمات إلى واجهة Cloud API باستخدام cURL.

Request

curl -v "https://api.aspose.cloud/v3.0/cells/TestCase.xlsx/worksheets/Sheet2/listobjects/0/SummarizeWithPivotTable?folder=CellsTests&destsheetName=Sheet4" \
-X POST \
-d '{"Name":"TestPivot","DestCellName":"C1","PivotFieldRows":[0,1],"PivotFieldColumns":[2],"PivotFieldData":[3,4]}' \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-H "Authorization: Bearer <jwt token>"

ملاحظة: استخدم نقطة النهاية الإنتاجية (api.aspose.cloud) في البيئات الحية. وتُستخدم نقطة النهاية التجريبية (api-qa.aspose.cloud) للتجربة والاختبار فقط. ويجب استخدام بروتوكول HTTPS لجميع المكالمات في البيئات الإنتاجية.

Response

{
  "Code": 200,
  "Status": "OK"
}

رموز حالة HTTP

الرمز	المعنى	الوصف
200	OK (تم بنجاح)	تمت تطبيق الفلتر بنجاح؛ تحتوي الاستجابة على تفاصيل العملية.
400	Bad Request (طلب غير صالح)	معطيات مفقودة أو غير صحيحة (مثل نوع ملف غير مدعوم).
401	Unauthorized (غير مصرّح)	رمز JWT غير صالح أو مفقود.
413	Payload Too Large (حمولة كبيرة جداً)	تجاوز حجم الملف المرفوع الحد المسموح به.
500	Internal Server Error (خطأ داخلي في الخادم)	حدث خطأ غير متوقع في الخادم.

عائلة SDK للسحابة

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

توضّح أمثلة الكود أدناه كيفية إجراء مكالمات إلى خدمات Aspose.Cells عبر واجهات مختلفة لحزم التطوير (SDK):

Developer-Guide: حذف جدول محوري في ورقة عمل Excel

Mon, 01 Jan 0001 00:00:00 +0000

يقوم هذا الـ REST API بحذف جدول محوري من ورقة عمل باستخدام فهرسه.

المتطلبات المسبقة – يجب أن يكون لديك رمز وصول JWT صالح لـ Aspose.Cells Cloud، وأن يكون ملف Excel المستهدف مخزنًا في موقع مدعوم للتخزين. تأكد من تحديد اسم الملف، واسم الورقة، وتفاصيل التخزين بشكل صحيح قبل استدعاء الـ API.

تعتبر الجداول المحورية وسيلة قوية لتلخيص البيانات في ورقة عمل Excel. باستخدام Aspose.Cells Cloud، يمكنك حذف جدول محوري غير مرغوب فيه برمجيًا باستخدام طلب HTTP DELETE واحد. وتُعد هذه العملية مثالية عند الحاجة إلى تنظيف ورقات العمل، أو أتمتة توليد التقارير، أو دمج تعديل ملفات Excel في تطبيقاتك.

API DeleteWorksheetPivotTable

DELETE https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/pivottables/{pivotTableIndex}

الأمان والمصادقة

تُعد واجهات برمجة تطبيقات Aspose.Cells Cloud آمنة وتتطلب مصادقة تعتمد على رمز JWT.

مُعلمات الطلب

اسم المُعلمة	النوع	الموقع	الوصف
name	string	path	اسم مستند Excel.
sheetName	string	path	اسم ورقة العمل التي تحتوي على الجدول المحوري.
pivotTableIndex	integer	path	الفهرس الصفري (zero-based) للجدول المحوري المراد حذفه.
folder	string	query	المسار إلى المجلد الذي يحتوي على المستند.
storageName	string	query	اسم خدمة التخزين.

يُعرّف مواصفات OpenAPI واجهة برمجة تطبيقات متاحة عمومًا، مما يسمح لك بإجراء تفاعلات REST مباشرة من متصفح ويب.

يمكنك استخدام أداة سطر الأوامر cURL للوصول إلى خدمات ويب Aspose.Cells بسهولة. يوضح المثال التالي كيفية إجراء مكالمات إلى الـ API السحابي باستخدام cURL.

Request

curl -v "https://api.aspose.cloud/v3.0/cells/Sample_Pivot_Table_Example.xls/worksheets/Sheet2/pivottables/0" \
  -X DELETE \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <jwt token>"

Response

مثال على الاستجابة

{
  "Code": 200,
  "Status": "OK"
}

تتبع الاستجابة مخطط JSON بسيط:

{
  "Code": integer,   // رمز الحالة المشابه لـ HTTP لعملية الحذف
  "Status": string   // وصف نصي، مثل "OK"
}

معالجة الأخطاء

تُدرج أدناه رموز حالة الاستجابة الشائعة:

حالة HTTP	الوصف
400	طلب غير صالح – مُعلمات مفقودة أو غير صالحة.
401	غير مصرح به – رمز JWT غير صالح أو مفقود.
404	غير موجود – الملف أو الورقة أو الجدول المحوري غير موجود.
500	خطأ داخلي في الخادم – حدثت حالة غير متوقعة على الخادم.

عائلة SDK السحابية

يُعد استخدام SDK أفضل طريقة لتسريع عملية التطوير. فتتولى SDK معالجة التفاصيل منخفضة المستوى، مما يتيح لك التركيز على مهام مشروعك. يُرجى زيارة مستودع GitHub للاطلاع على قائمة كاملة بـ SDKs الخاصة بـ Aspose.Cells Cloud.

توضح أمثلة الكود التالية كيفية إجراء مكالمات إلى خدمات ويب Aspose.Cells باستخدام SDKs مختلفة:

C#

Java

PHP
Ruby
Python

Node.js

Android

Swift
Perl

Go

Developer-Guide: تحديث نمط الخلية لجدول محوري

Mon, 01 Jan 0001 00:00:00 +0000

تقوم هذه الواجهة البرمجية لـ REST بتحديث نمط خلية في جدول محوري.

المتطلبات المسبقة / المصادقة
لاستدعاء نقطة النهاية هذه، يجب أن يكون لديك رمز وصول JWT صالح من Aspose Cloud. احصل على الرمز المميز عبر تدفق OAuth 2.0 الموصوف في دليل المصادقة. ضع الرمز المميز في رأس الطلب:

Authorization: Bearer <رمز jwt>

يُطلب رمز JWT لجميع استدعاءات واجهة برمجة تطبيقات Aspose.Cells Cloud.

واجهة برمجة تطبيقات PostPivotTableCellStyle

POST https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/pivottables/{pivotTableIndex}/Format

الأمان والمصادقة

واجهات برمجة تطبيقات Aspose.Cells Cloud آمنة وتشترط المصادقة باستخدام رمز JWT.

معاملات الطلب

اسم المعامل	النوع	الموقع	الوصف
name	string	path	اسم المستند (مطلوب).
sheetName	string	path	اسم ورقة العمل (مطلوبة).
pivotTableIndex	integer	path	فهرس الجدول المحوري (مطلوب).
column	integer	query	فهرس العمود (مبتدأ من الصفر) للخلية المراد تنسيقها (مطلوب).
row	integer	query	فهرس الصف (مبتدأ من الصفر) للخلية المراد تنسيقها (مطلوب).
style	object	body	كائن نقل البيانات (DTO) يُعرّف نمط الخلية الجديد.
needReCalculate	boolean	query	يُشير إلى ما إذا كان يجب إعادة حساب الجدول المحوري بعد التنسيق. القيمة الافتراضية هي false.
folder	string	query	المجلد المخزن فيه المستند (اختياري).
storageName	string	query	اسم وحدة التخزين (اختياري).
Method	string	N/A	طريقة HTTP المستخدمة في الطلب (POST).

يُعرّف مواصفات OpenAPI واجهة برمجة تطبيقات قابلة للوصول العام، وتمكّنك من إجراء تفاعلات REST مباشرة من متصفح الويب.

يمكنك استخدام أداة سطر الأوامر cURL للوصول إلى خدمات Aspose.Cells بسهولة. يوضح المثال التالي كيفية إجراء استدعاء إلى واجهة برمجة التطبيقات السحابية باستخدام cURL.

Request

curl -v "https://api.aspose.cloud/v3.0/cells/Sample_Pivot_Table_Example.xls/worksheets/Sheet2/pivottables/0/Format?column=1&row=1" \
  -X POST \
  -d '{"Font":{"Name":"Arial","Size":10}}' \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <رمز jwt>"

Response

{
  "Code": 200,
  "Status": "OK"
}

الاستجابة
في حالة النجاح، تُعيد الخدمة الرمز HTTP 200 مع جسم فارغ يشير إلى تطبيق النمط بنجاح. وفي حالة حدوث خطأ، تُعاد حمولة JSON تحتوي على رمز الخطأ والرسالة.

حالة HTTP	الوصف
200	تم تطبيق النمط بنجاح.
400	طلب غير صالح – مثلاً: فهرس عمود/صف غير صحيح.
401	غير مصرّح به – رمز JWT مفقود أو غير صالح.
404	غير موجود – المستند أو ورقة العمل أو الجدول المحوري المحدد غير موجود.
500	خطأ داخلي في الخادم – حالة غير متوقعة.

يكون جسم الاستجابة فارغًا في حالة النجاح.

لمزيد من المعلومات، راجع وثائق واجهة برمجة التطبيقات Get Pivot Table.

عائلة SDK السحابية

يُعد استخدام SDK الطريقة الأسرع للتطوير. فتقوم SDK بإخفاء التفاصيل من المستوى المنخفض، مما يسمح لك بالتركيز على منطق عملك. يُرجى الاطلاع على مستودع GitHub للحصول على قائمة كاملة بـ SDKs لـ Aspose.Cells Cloud.

يُظهر مثال الكود التالي كيفية استدعاء خدمات Aspose.Cells باستخدام Go SDK:

Developer-Guide: تحديث نمط جدول محوري

Mon, 01 Jan 0001 00:00:00 +0000

تُحدِّث هذه الواجهة البرمجية REST نمط جدول محوري.

واجهة PostPivotTableStyle

POST https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/pivottables/{pivotTableIndex}/FormatAll

المتطلبات المسبقة / المصادقة
يجب تقديم رمز وصول JWT صالح في رأس Authorization (مثل Bearer <رمز jwt>). تأكّد من أن الرمز يملك الصلاحيات الكافية للوصول إلى ملف المصنف والورقة المحددين.

الأمان والمصادقة

تُعدّ واجهات Aspose.Cells Cloud آمنة وتتطلب مصادقة تعتمد على رمز JWT.

مُعَيّنات الطلب

اسم المعَيّن	النوع	الموقع	الوصف
name	نص	المسار	اسم ملف المصنف.
sheetName	نص	المسار	الورقة التي يحتوي عليها الجدول المحوري.
pivotTableIndex	عدد صحيح	المسار	الفهرس (الصفر-based) للجدول المحوري المراد تنسيقه.
style	كائن	الجسم	كائن DTO لتحديد التنسيق المراد تطبيقه.
needReCalculate	منطقي	الاستعلام	عدّله إلى true لإعادة حساب الجدول المحوري بعد التنسيق؛ القيمة الافتراضية هي false.
folder	نص	الاستعلام	المجلد الذي يُخزّن فيه المصنف.
storageName	نص	الاستعلام	اسم خدمة التخزين.

يُعرّف مواصفات OpenAPI واجهة برمجة تفاعلية مُتاحة للعامة وتتيح لك إجراء تفاعلات REST مباشرة من متصفح ويب.

يمكنك استخدام أداة سطر الأوامر cURL للوصول إلى خدمات Aspose.Cells بسهولة. يُظهر المثال التالي كيفية إجراء استدعاء إلى واجهة Cloud API باستخدام cURL.

الطلب

curl -v "https://api.aspose.cloud/v3.0/cells/Sample_Pivot_Table_Example.xls/worksheets/Sheet2/pivottables/0/FormatAll" \
  -X POST \
  -d '{"Font":{"Name":"Arial","Size":10}}' \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <رمز jwt>"

الاستجابة

{
  "Code": 200,
  "Status": "OK"
}

رموز حالة HTTP

الرمز	المعنى	الوصف
200	OK	تطبيق التنسيق بنجاح؛ تحتوي الاستجابة على تفاصيل العملية.
400	Bad Request	مُعَيّنات مفقودة أو غير صالحة (مثل نوع ملف غير مدعوم).
401	Unauthorized	رمز JWT غير صالح أو مفقود.
413	Payload Too Large	حجم الملف المرفوع يتجاوز الحد المسموح.
500	Internal Server Error	خطأ داخلي في الخادم غير متوقع.

عائلة SDK للسحابة

استخدام SDK هو أسرع طريقة لتطوير التطبيقات باستخدام الواجهة البرمجية. تُجسّد SDK التفاصيل من المستوى المنخفض، مما يتيح لك التركيز على منطق أعمالك. راجع مستودع GitHub للحصول على قائمة كاملة بـ SDKs الخاصة بـ Aspose.Cells Cloud.

يُظهر مثال الكود التالي كيفية استدعاء الواجهة البرمجية باستخدام SDK للغة Go:

Go

Developer-Guide: إخفاء عنصر حقل محوري في جدول محوري

Mon, 01 Jan 0001 00:00:00 +0000

قبل استدعاء الواجهة، تأكّد من توافر ما يلي:

رمز وصول JWT صالح (يمكن الحصول عليه عبر عملية مصادقة Aspose Cloud).
ملف المصنف المستهدف مُحمّل بالفعل في مساحة التخزين الخاصة بك في Aspose Cloud.
وجود ورقة العمل والجدول المحوري مُنشئَين مسبقًا.

تُساعدك هذه الشروط المسبقة في تجنّب أخطاء المصادقة واستجابات “المورد غير موجود”. وتوضّح الخطوات التالية الإعدادات المطلوبة قبل استدعاء الواجهة.

تُستخدم هذه الواجهة البرمجية لإخفاء عنصر حقل محوري في جدول محوري.

PostPivotTableFieldHideItem API

POST https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/pivottables/{pivotTableIndex}/PivotField/Hide

الأمان والمصادقة

تتطلّب واجهات برمجة تطبيقات Aspose.Cells Cloud مصادقة قائمَة على رمز JWT token، وهي آمنة.

مُعاملات الطلب

اسم المُعامل	النوع	الموقع	الوصف
name	string	path	اسم ملف Excel.
sheetName	string	path	ورقة العمل التي تحتوي على الجدول المحوري.
pivotTableIndex	integer	path	مؤشر الجدول المحوري داخل ورقة العمل.
pivotFieldType	string	query	نوع الحقل المحوري (Row، Column، Page، Data، إلخ).
fieldIndex	integer	query	المؤشر المُعدّ من الصفر للحقل المحوري المُراد تعديله.
itemIndex	integer	query	مؤشر العنصر المُحدّد داخل الحقل المُراد إخفاؤه.
isHide	boolean	query	ضعها على true لإخفاء العنصر، وfalse لإظهاره.
needReCalculate	boolean	query	يُشير إلى ما إذا كان يجب إعادة حساب الجدول المحوري بعد التعديل. القيمة الافتراضية هي false.
folder	string	query	مسار المجلد حيث يُخزّن ملف المصنف.
storageName	string	query	اسم خدمة التخزين.

مرجع سريع للمُعاملات المطلوبة في الاستعلام

pivotFieldType – نوع الحقل (مثل Row).
fieldIndex – المؤشر المُعدّ من الصفر للحقل المُراد تعديله.
itemIndex – المؤشر المُعدّ من الصفر للعنصر المُراد إخفاؤه/إظهاره.
isHide – true لإخفاء، false لإظهار.
needReCalculate – اختياري، وقيمته الافتراضية false.

يُعرّف مواصفات OpenAPI واجهة برمجة تطبيقات قابلة للوصول من قِبل المطورين، ويتيح لك إجراء تفاعلات REST مباشرة من متصفّح الويب.

يمكنك استخدام أداة سطر الأوامر cURL للوصول بسهولة إلى خدمات Aspose.Cells Web. ويوضّح المثال التالي كيفية استدعاء الواجهة باستخدام cURL.

Request

curl -v "https://api.aspose.cloud/v3.0/cells/Book1.xlsx/worksheets/Sheet1/pivottables/0/PivotField/Hide?pivotFieldType=Row&fieldIndex=0&itemIndex=1&isHide=true&needReCalculate=true" \
  -X POST \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <jwt token>"

Response

{
  "Code": 200,
  "Status": "OK"
}

تفاصيل الاستجابة

كود الحالة	الوصف
200	تمت عملية الإخفاء بنجاح.
400	طلب غير صالح – مُعطَلات ناقصة أو غير صالحة.
401	غير مُصادَق – رمز JWT غير صالح أو ناقص.
500	خطأ في الخادم – تعذّر إكمال العملية.

ملاحظة: إذا كان المؤشر fieldIndex أو itemIndex خارج النطاق المسموح، تُعيد الواجهة استجابة 400 Bad Request.

مجموعة أدوات Cloud SDK

استخدام حزمة تطوير البرمجيات (SDK) هو أسرع طريقة لتطوير التطبيقات ضد هذه الواجهة. وتتولّى SDKs معالجة التفاصيل منخفضة المستوى، مما يتيح لك التركيز على منطق عملك. يمكنك الاطّلاع على مستودع GitHub للحصول على قائمة كاملة بحزم تطوير البرمجيات لـ Aspose.Cells Cloud.

يُظهر الأمثلة التالية كيفية إخفاء عنصر حقل محوري باستخدام SDKs مختلفة.

public void Run_PivotTable_NeedReCalculate()
{
    // إعداد المصنف وورقة العمل
    url = @"https://api.aspose.cloud/v3.0/storage/file/Temp/V17.02.00_01.xlsx";
    using (HttpWebResponse response = _helper.CallDelete(url, string.Empty, contentType))
    {
        Assert.AreEqual(response.StatusCode, HttpStatusCode.OK);
    }

    // رفع المصنف
    url = @"https://api.aspose.cloud/v3.0/cells/V17.02.00_01.xlsx?folder=Temp";
    using (HttpWebResponse response = _helper.CallPut(url, string.Empty, contentType))
    {
        Assert.AreEqual(response.StatusCode, HttpStatusCode.OK);
    }

    // إنشاء ورقة العمل التي ستحتوي على الجدول المحوري
    url = @"https://api.aspose.cloud/v3.0/cells/V17.02.00_01.xlsx/worksheets/PivotSheet?folder=Temp";
    using (HttpWebResponse response = _helper.CallPut(url, string.Empty, contentType))
    {
        Assert.AreEqual(response.StatusCode, HttpStatusCode.OK);
    }

    // إنشاء ورقة عمل ثانية تحتوي على بيانات تجريبية
    url = @"https://api.aspose.cloud/v3.0/cells/V17.02.00_01.xlsx/worksheets/Sheet2?folder=Temp";
    using (HttpWebResponse response = _helper.CallPut(url, string.Empty, contentType))
    {
        Assert.AreEqual(response.StatusCode, HttpStatusCode.OK);
    }

    // استيراد بيانات تجريبية في Sheet2
    url = @"https://api.aspose.cloud/v3.0/cells/V17.02.00_01.xlsx/importdata?folder=Temp";
    data = "{ \"BatchData\":[{...}] }"; // مقتطعة للاختصار
    using (HttpWebResponse response = _helper.CallPost(url, data, contentType))
    {
        Assert.AreEqual(response.StatusCode, HttpStatusCode.OK);
    }

    // إضافة جدول محوري إلى PivotSheet
    url = @"https://api.aspose.cloud/v3.0/cells/V17.02.00_01.xlsx/worksheets/PivotSheet/pivottables?folder=Temp";
    data = "{\"Name\":\"TestPivot\",\"SourceData\":\"=Sheet2!A1:E8\",\"DestCellName\":\"C1\",\"UseSameSource\":true,\"PivotFieldRows\":[0,1],\"PivotFieldColumns\":[2],\"PivotFieldData\":[3,4]}";
    using (HttpWebResponse response = _helper.CallPut(url, data, contentType))
    {
        Assert.AreEqual(response.StatusCode, HttpStatusCode.OK);
    }

    // إخفاء عنصر حقل صف معيّن
    url = @"https://api.aspose.cloud/v3.0/cells/V17.02.00_01.xlsx/worksheets/PivotSheet/pivottables/0/PivotField/Hide?pivotFieldType=Row&fieldIndex=0&itemIndex=1&isHide=true&needReCalculate=true&folder=Temp";
    using (HttpWebResponse response = _helper.CallPost(url, string.Empty, contentType))
    {
        Assert.AreEqual(response.StatusCode, HttpStatusCode.OK);
    }
}

ملاحظة: تفترض أمثلة SDK أنك قد قمت مسبقًا بإعداد المصادقة (رمز JWT) وأن ملف المصنف موجود في مجلد التخزين المحدّد. قم بتعديل المُعاملات folder و storageName وفقًا لاحتياجات بيئة العمل الخاصة بك.

Developer-Guide: نقل جدول محوري في ملف Excel

Mon, 01 Jan 0001 00:00:00 +0000

تقوم هذه الواجهة REST بنقل جدول محوري داخل ملف Excel.

المتطلبات المسبقة: قبل استدعاء هذه العملية، يجب أن يكون لديك رمز وصول JWT صالح، ويجب أن يكون الملف مخزنًا في مساحة تخزين Aspose Cloud. حدد المعاملات folder وstorageName حسب الحاجة.

واجهة REST API

POST https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/pivottables/{pivotTableIndex}/PivotField/Move

معاملات الطلب

اسم المعامل	النوع	الموقع	الوصف
name	string	path	اسم ملف Excel.
sheetName	string	path	اسم ورقة العمل التي تحتوي على الجدول المحوري.
pivotTableIndex	integer	path	الفهرس الصفرِي للجدول المحوري المراد نقله.
fieldIndex	integer	query	فهرس الحقل المحوري المراد نقله.
from	string	query	المنطقة المصدر للحقل (مثل `Row` أو `Column`).
to	string	query	المنطقة الوجهة للحقل (مثل `Row` أو `Column`).
folder	string	query	المجلد داخل مساحة التخزين حيث يقع الملف.
storageName	string	query	اسم خدمة التخزين.

تُعرّف مواصفات OpenAPI واجهة برمجة تطبيقات متاحة علنًا وتتيح لك إجراء تفاعلات REST مباشرة من متصفح الويب.

يمكنك استخدام أداة سطر الأوامر cURL للوصول بسهولة إلى خدمات ويب Aspose.Cells. يُظهر المثال التالي كيفية إجراء المكالمات إلى واجهة Cloud API باستخدام cURL.

Request

curl -v "https://api.aspose.cloud/v3.0/cells/Book1.xlsx/worksheets/Sheet1/pivottables/0/PivotField/Move?fieldIndex=0&from=C1&to=C10" \
  -X POST \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <jwt token>"

Response

{
  "Code": 200,
  "Status": "OK"
}

عائلة SDK للسحابة

استخدام SDK هو أفضل طريقة لتسريع عملية التطوير. فتتولى SDK معالجة التفاصيل من المستوى المنخفض، مما يمكّنك من التركيز على مهام مشروعك. يُرجى الاطّلاع على مستودع GitHub للاطّلاع على قائمة كاملة بـ SDKs الخاصة بـ Aspose.Cells Cloud.

تُظهر أمثلة الكود التالية كيفية إجراء المكالمات إلى خدمات ويب Aspose.Cells باستخدام SDKs متنوعة:

// استخدم نقاط نهاية HTTPS في الإنتاج.
public void Run_PivotTable_Move()
{
    url = @"https://api.aspose.com/v3.0/storage/file/Temp/V17.02.00_01.xlsx";
    using (HttpWebResponse response = _helper.CallDelete(url, string.Empty, contentType))
    {
        Assert.AreEqual(response.StatusCode, HttpStatusCode.OK);
    }

    url = @"https://api.aspose.com/v3.0/cells/V17.02.00_01.xlsx?folder=Temp";
    using (HttpWebResponse response = _helper.CallPut(url, string.Empty, contentType))
    {
        Assert.AreEqual(response.StatusCode, HttpStatusCode.OK);
    }

    url = @"https://api.aspose.com/v3.0/cells/V17.02.00_01.xlsx/worksheets/PivotSheet?folder=Temp";
    using (HttpWebResponse response = _helper.CallPut(url, string.Empty, contentType))
    {
        Assert.AreEqual(response.StatusCode, HttpStatusCode.OK);
    }

    url = @"https://api.aspose.com/v3.0/cells/V17.02.00_01.xlsx/worksheets/Sheet2?folder=Temp";
    using (HttpWebResponse response = _helper.CallPut(url, string.Empty, contentType))
    {
        Assert.AreEqual(response.StatusCode, HttpStatusCode.OK);
    }

    url = @"https://api.aspose.com/v3.0/cells/V17.02.00_01.xlsx/importdata?folder=Temp";
    data = "{ \"BatchData\":[{\"rowIndex\":0,\"columnIndex\":0,\"type\":\"String\",\"value\":\"Sport\",\"style\":null}, ... ],\"DestinationWorksheet\":\"Sheet2\",\"IsInsert\":false}";
    using (HttpWebResponse response = _helper.CallPost(url, data, contentType))
    {
        Assert.AreEqual(response.StatusCode, HttpStatusCode.OK);
    }

    url = "https://api.aspose.com/v3.0/cells/V17.02.00_01.xlsx/worksheets/PivotSheet/pivottables?folder=Temp";
    data = "{\"Name\":\"TestPivot\",\"SourceData\":\"=Sheet2!A1:E8\",\"DestCellName\":\"C1\",\"UseSameSource\":true,\"PivotFieldRows\":[0,1],\"PivotFieldColumns\":[2],\"PivotFieldData\":[3,4]}";
    using (HttpWebResponse response = _helper.CallPut(url, data, contentType))
    {
        Assert.AreEqual(response.StatusCode, HttpStatusCode.OK);
    }

    url = "https://api.aspose.com/v3.0/cells/V17.02.00_01.xlsx/worksheets/PivotSheet/pivottables/0/Move?row=10&column=10&folder=Temp";
    using (HttpWebResponse response = _helper.CallPost(url, string.Empty, contentType))
    {
        Assert.AreEqual(response.StatusCode, HttpStatusCode.OK);
    }

    url = "https://api.aspose.com/v3.0/cells/V17.02.00_01.xlsx/worksheets/PivotSheet/pivottables/0/PivotField/Move?fieldIndex=1&from=Row&to=Column&folder=Temp";
    using (HttpWebResponse response = _helper.CallPost(url, string.Empty, contentType))
    {
        Assert.AreEqual(response.StatusCode, HttpStatusCode.OK);
    }
}

Developer-Guide: حذف جميع جداول البيانات المحورية في ورقة عمل Excel

Thu, 30 Jul 2026 00:00:00 +0000

حذف جميع جداول البيانات المحورية في ورقة عمل Excel

نظرة عامة

يقوم هذا الإجراء بإزالة جميع جداول البيانات المحورية من ورقة عمل محددة في ملف Excel. وهو مفيد عندما تحتاج إلى إعادة تعيين تحليلات ورقة العمل أو تنظيف جداول البيانات المحورية غير المستخدمة في استدعاء واحد.

المتطلبات المسبقة

قبل استدعاء واجهة برمجة التطبيقات (API)، تأكد من إكمال الخطوات التالية:

حساب Aspose Cloud – سجّل حسابًا في Aspose Cloud إذا لم يكن لديك حساب بالفعل.
رمز JWT – أنشئ رمز JWT (JSON Web Token) للمصادقة. راجع دليل المصادقة للحصول على التفاصيل.
إعداد التخزين – قم برفع ملف Excel المستهدف إلى تخزين Aspose Cloud أو إلى تخزين خارجي متصل. لاحظ المجلد واسم التخزين (إن وُجد) حيث يوجد الملف.

المصادقة

تتطلب واجهات برمجة تطبيقات Aspose.Cells Cloud مصادقة تعتمد على رمز JWT. أضف الرمز في رأس الطلب Authorization في كل طلب:

Authorization: Bearer <jwt token>

طلب HTTP

DELETE https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/pivottables

معاملات المسار

الاسم	النوع	مطلوب	الوصف
`name`	نص	نعم	اسم ملف Excel (مثال: `Sample.xlsx`).
`sheetName`	نص	نعم	اسم ورقة العمل التي سيتم إزالة جميع جداول البيانات المحورية منها (مثال: `Sheet1`).

معاملات الاستعلام

الاسم	النوع	مطلوب	الوصف
`folder`	نص	لا	المجلد الذي يحتوي على الملف.
`storageName`	نص	لا	اسم التخزين المراد استخدامه (إذا لم يكن الملف في التخزين الافتراضي).

مثال على الطلب (cURL)

curl -v "https://api.aspose.cloud/v3.0/cells/Sample_Pivot_Table_Example.xls/worksheets/Sheet2/pivottables?folder=SampleFolder&storageName=MyStorage" \
  -X DELETE \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <jwt token>"

الاستجابة الناجحة

يعيد الخدمة كائنًا قياسيًا CellsCloudResponse يُبيّن حالة العملية.

{
  "Code": 200,
  "Status": "OK"
}

معالجة الأخطاء

حالة HTTP	المعنى	مثال على حمولة الطلب
400	طلب غير صالح – معاملات مفقودة أو غير صحيحة	`{ "Code": 400, "Message": "Missing required parameter 'name'." }`
401	غير مصادق – رمز JWT غير صالح أو منتهٍ	`{ "Code": 401, "Message": "Invalid authentication token." }`
404	غير موجود – الملف أو ورقة العمل غير موجودة	`{ "Code": 404, "Message": "Worksheet not found." }`
500	خطأ داخلي في الخادم – فشل غير متوقع	`{ "Code": 500, "Message": "An unexpected error occurred." }`

أمثلة باستخدام SDKs

تُظهر مقاطع الكود التالية كيفية استدعاء العملية باستخدام العديد من SDKs الخاصة بـ Aspose.Cells Cloud.

C# (.NET)

using Aspose.Cells.Cloud.SDK.Api;
using Aspose.Cells.Cloud.SDK.Model;

// تهيئة عميل الواجهة البرمجية
var apiInstance = new CellsApi("<client-id>", "<client-secret>");

// تكوين معاملات الطلب
string name = "Sample_Pivot_Table_Example.xls";
string sheetName = "Sheet2";
string folder = "SampleFolder";
string storageName = "MyStorage";

try
{
    var response = apiInstance.DeleteWorksheetPivotTables(name, sheetName, folder, storageName);
    Console.WriteLine($"Response code: {response.Code}, status: {response.Status}");
}
catch (Exception e)
{
    Console.WriteLine("Exception when calling CellsApi.DeleteWorksheetPivotTables: " + e.Message);
}

Java

import com.aspose.cells.cloud.api.CellsApi;
import com.aspose.cells.cloud.model.*;

public class DeletePivotTables {
    public static void main(String[] args) {
        CellsApi api = new CellsApi("<client-id>", "<client-secret>");
        String name = "Sample_Pivot_Table_Example.xls";
        String sheetName = "Sheet2";
        String folder = "SampleFolder";
        String storageName = "MyStorage";

        try {
            CellsCloudResponse result = api.deleteWorksheetPivotTables(name, sheetName, folder, storageName);
            System.out.println("Code: " + result.getCode() + ", Status: " + result.getStatus());
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

Python

import asposecellscloud_sdk
from asposecellscloud_sdk import CellsApi, ApiException

# تكوين عميل الواجهة البرمجية
configuration = asposecellscloud_sdk.Configuration()
configuration.api_key['client_id'] = '<client-id>'
configuration.api_key['client_secret'] = '<client-secret>'

api_instance = CellsApi(asposecellscloud_sdk.ApiClient(configuration))

name = 'Sample_Pivot_Table_Example.xls'
sheet_name = 'Sheet2'
folder = 'SampleFolder'
storage_name = 'MyStorage'

try:
    response = api_instance.delete_worksheet_pivot_tables(name, sheet_name, folder, storage_name)
    print(f'Code: {response.code}, Status: {response.status}')
except ApiException as e:
    print("Exception when calling CellsApi->delete_worksheet_pivot_tables: %s\n" % e)

Node.js

const { CellsApi, Configuration } = require('asposecellscloud-sdk');

const config = new Configuration({
    clientId: '<client-id>',
    clientSecret: '<client-secret>'
});
const apiInstance = new CellsApi(config);

const name = 'Sample_Pivot_Table_Example.xls';
const sheetName = 'Sheet2';
const folder = 'SampleFolder';
const storageName = 'MyStorage';

apiInstance.deleteWorksheetPivotTables(name, sheetName, folder, storageName)
    .then(result => {
        console.log(`Code: ${result.code}, Status: ${result.status}`);
    })
    .catch(err => {
        console.error('Error:', err);
    });

SDKs إضافية (Go, PHP, Ruby, Swift, Perl, Android) متوفرة في مستودع Aspose.Cells Cloud SDK.

Documentation –

Developer-Guide: الحصول على جدول محوري في ورقة عمل إكسل

الأمان والمصادقة

واجهة برمجة تطبيقات REST

معلمات الطلب

معالجة الأخطاء

عائلة حزم تطوير البرمجيات (SDK) السحابية

C# Java PHP Ruby Python Node.js Objective C Android Perl Go

Developer-Guide: الحصول على جميع جداول البيانات المحورية في ورقة عمل Excel

الأمان والمصادقة

واجهة برمجة تطبيقات REST

معاملات الطلب

الطلب

استجابات الخطأ

مجموعة أدوات SDK للسحابة

C# Java PHP Ruby Python Node.js Android Swift Perl Go

Developer-Guide: إضافة جدول محوري في ورقة عمل Excel

PutWorksheetPivotTable API

الأمان والمصادقة

معاملات الطلب

عائلة SDK السحابية

Developer-Guide: إضافة حقل محوري إلى جدول محوري

واجهة REST API

معلمات الطلب

عائلة SDK للسحابة

Developer-Guide: العمل مع مرشحات الجداول المحورية

واجهة PutWorksheetPivotTableFilter البرمجية

الأمان والمصادقة

معلمات الطلب

أكواد الاستجابة

مثال على طلب cURL

عائلة SDK السحابية

للمزيد من العمليات المتعلقة بالجداول المحورية، راجع وثائق الإضافة والحذف والمسح للمرشحات.

Developer-Guide: تحويل جدول إلى جدول محوري

واجهة PostWorksheetListObjectSummarizeWithPivotTable

الأمان والمصادقة

مُعاملات الطلب

عائلة SDK للسحابة

توضّح أمثلة الكود أدناه كيفية إجراء مكالمات إلى خدمات Aspose.Cells عبر واجهات مختلفة لحزم التطوير (SDK):

Developer-Guide: حذف جدول محوري في ورقة عمل Excel

API DeleteWorksheetPivotTable

الأمان والمصادقة

مُعلمات الطلب

معالجة الأخطاء

عائلة SDK السحابية

C# Java PHP Ruby Python Node.js Android Swift Perl Go

Developer-Guide: تحديث نمط الخلية لجدول محوري

واجهة برمجة تطبيقات PostPivotTableCellStyle

الأمان والمصادقة

معاملات الطلب

عائلة SDK السحابية

Developer-Guide: تحديث نمط جدول محوري

واجهة PostPivotTableStyle

الأمان والمصادقة

مُعَيّنات الطلب

عائلة SDK للسحابة

Go

Developer-Guide: إخفاء عنصر حقل محوري في جدول محوري

PostPivotTableFieldHideItem API

الأمان والمصادقة

مُعاملات الطلب

مجموعة أدوات Cloud SDK

Developer-Guide: نقل جدول محوري في ملف Excel

واجهة REST API

معاملات الطلب

عائلة SDK للسحابة

Developer-Guide: حذف جميع جداول البيانات المحورية في ورقة عمل Excel

حذف جميع جداول البيانات المحورية في ورقة عمل Excel

نظرة عامة

المتطلبات المسبقة

المصادقة

طلب HTTP

معاملات المسار

معاملات الاستعلام

مثال على الطلب (cURL)

الاستجابة الناجحة

معالجة الأخطاء

أمثلة باستخدام SDKs

C# (.NET)

Java

C#

Java

PHP
Ruby
Python

Node.js

Objective C
Android

Perl

Go

C#

Java

PHP
Ruby
Python

Node.js

Android

Swift
Perl

Go

C#

Java

PHP
Ruby
Python

Node.js

Android

Swift
Perl

Go