الحصول على جميع الأشكال الموجودة في ورقة عمل Excel

تتيح هذه واجهة برمجة التطبيقات (REST API) استرجاع جميع الأشكال الموجودة في ورقة عمل Excel.

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

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

واجهة برمجة التطبيقات (REST API)

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

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

اسم المعامل	النوع	الموقع	الوصف
name	نص (string)	مسار (path)	اسم ملف Excel.
sheetName	نص (string)	مسار (path)	اسم ورقة العمل.
folder	نص (string)	استعلام (query)	المجلد الذي يحتوي على المستند.
storageName	نص (string)	استعلام (query)	اسم خدمة التخزين المراد استخدامها.
include	نص (string)	استعلام (query)	ضع القيمة `details` لاسترجاع خصائص الشكل الكاملة؛ وإلا سيتم استرجاع كائنات `link` فقط.

اختياري: يمكن تجاهل folder وstorageName وinclude عندما يكون الملف موجودًا في المجلد الجذر للتخزين.

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

الطلب

curl -v "https://api.aspose.cloud/v3.0/cells/Book1.xlsx/worksheets/Sheet1/shapes?folder=Samples&storageName=MyStorage" \
-X GET \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-H "Authorization: Bearer <jwt token>"

الاستجابة

{
  "Shapes": {
    "ShapeList": [
      {
        "link": {
          "Href": "/0",
          "Rel": "self",
          "Type": null,
          "Title": null
        }
      },
      {
        "link": {
          "Href": "/1",
          "Rel": "self",
          "Type": null,
          "Title": null
        }
      },
      {
        "link": {
          "Href": "/2",
          "Rel": "self",
          "Type": null,
          "Title": null
        }
      },
      {
        "link": {
          "Href": "/3",
          "Rel": "self",
          "Type": null,
          "Title": null
        }
      }
    ],
    "link": {
      "Href": "https://api.aspose.cloud/v3.0/cells/Book1.xlsx/worksheets/Sheet1/shapes",
      "Rel": "self",
      "Type": null,
      "Title": null
    }
  },
  "Code": 200,
  "Status": "OK"
}

حقول الاستجابة

يحتوي كائن Shapes على قائمة من عناصر Shape. يشمل كل شكل الخصائص التالية (عند استخدام علامة include=details؛ وإلا سيتم استرجاع كائن link فقط).

الخاصية	النوع	الوصف
Name	نص (string)	الاسم المُسنَد إلى الشكل (مثل “Chart 1”).
Type	نص (string)	نوع الشكل (مثل `Chart` أو `Picture` أو `TextBox`).
Top	رقم (number)	المسافة (بالنقاط) من الحافة العلوية لورقة العمل إلى الشكل.
Left	رقم (number)	المسافة (بالنقاط) من الحافة اليسرى لورقة العمل إلى الشكل.
Width	رقم (number)	عرض الشكل بالنقاط.
Height	رقم (number)	ارتفاع الشكل بالنقاط.
Link	كائن (object)	معلومات الارتباط التشعبي (`Href` و`Rel` و`Type` و`Title`).

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

حالة HTTP	الوصف	جسم الخطأ النموذجي
400	طلب غير صالح – معاملات غير صحيحة.	`{ "Code": 400, "Message": "Invalid parameter value." }`
401	غير مُصادَق – رمز مميز مفقود أو غير صالح.	`{ "Code": 401, "Message": "Access token is missing or invalid." }`
404	غير موجود – المصنف أو ورقة العمل غير موجودين.	`{ "Code": 404, "Message": "File or worksheet not found." }`
500	خطأ داخلي في الخادم – حالة غير متوقعة.	`{ "Code": 500, "Message": "An unexpected error occurred." }`

يعيد الطلب الناجح HTTP 200 مع كائن Shapes يحتوي على قائمة الأشكال، كما هو موضح في مثال الاستجابة أعلاه.

تفرض واجهة برمجة التطبيقات حدًا قدره 150 طلبًا في الدقيقة لكل رمز مميز JWT. وعند تجاوز هذا الحد، تُعاد استجابة HTTP 429 مع رأس Retry-After يُحدِّد متى يجب إعادة المحاولة.

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

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

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

الحصول على شكل باستخدام الفهرس في ورقة عمل إكسل