تحديث شكل في ورقة عمل Excel - Aspose.Cells Cloud API

تقوم هذه الواجهة البرمجية لـ REST بتحديث شكل في ورقة عمل Excel.

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

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

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

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

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

اسم المعامل النوع الموقع الوصف
name سلسلة المسار اسم ملف المصنف.
sheetName سلسلة المسار اسم ورقة العمل التي يحتوي عليها الشكل.
shapeindex عدد صحيح المسار الفهرس الصفر-الأساسي للشكل داخل ورقة العمل.
dto كائن الجسم كائن نقل بيانات الشكل الذي يحتوي على الخصائص المُحدَّثة (انظر مخطط نقل البيانات أدناه).
folder سلسلة الاستعلام المجلد الذي يُخزَّن فيه المصنف.
storageName سلسلة الاستعلام اسم مساحة التخزين الخاصة بـ Aspose Cloud.

مخطط نقل البيانات (DTO)

يحتوي الكائن dto على الخصائص التي يمكن تحديثها. جميع الحقول اختيارية ما لم يُذكر خلاف ذلك.

الحقل النوع الإلزام الوصف
Name سلسلة لا الاسم الجديد للشكل.
UpperLeftRow عدد صحيح لا فهرس الصف لزاوية الشكل العلوية اليسرى.
UpperLeftColumn عدد صحيح لا فهرس العمود لزاوية الشكل العلوية اليسرى.
Width عدد صحيح لا عرض الشكل (بالنقاط).
Height عدد صحيح لا ارتفاع الشكل (بالنقاط).
RotationAngle عدد صحيح لا زاوية الدوران بالدرجات.
IsHidden منطقي لا true لإخفاء الشكل.
IsLocked منطقي لا true لقفل الشكل.
Font كائن لا إعدادات الخط (انظر مواصفة OpenAPI لمعرفة الخصائص الفرعية).
… … لا خصائص إضافية مثل HtmlText وAlternativeText وZOrderPosition وما إلى ذلك.

للحصول على قائمة كاملة، يُرجى الرجوع إلى المواصفات الرسمية لـ OpenAPI: https://apireference.aspose.cloud/cells/#/Shapes/PostWorksheetShape.

رؤوس الطلب

  • Content-Type: application/json
  • Accept: application/json
  • Authorization: Bearer <accessToken> (رمز JWT المستحصل من خطوة المصادقة)

جسم الطلب (مثال)

{
  "Name": "MyShape",
  "UpperLeftRow": 2,
  "UpperLeftColumn": 3,
  "Width": 150,
  "Height": 80,
  "RotationAngle": 0,
  "IsHidden": false,
  "IsLocked": false,
  "Font": {
    "Name": "Calibri",
    "Size": 12,
    "IsBold": true,
    "Color": { "A": 255, "R": 0, "G": 0, "B": 0 }
  }
}

مثال باستخدام cURL (أداة سطر الأوامر)

curl -v "https://api.aspose.cloud/v3.0/cells/Book1.xlsx/worksheets/Sheet1/shapes/0?folder=Temp" \
  -X POST \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <accessToken>" \
  -d '{
        "Name": "UpdatedShape",
        "UpperLeftRow": 1,
        "UpperLeftColumn": 1,
        "Width": 120,
        "Height": 60,
        "IsHidden": false,
        "IsLocked": false
      }'

الاستجابة

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

معالجة الأخطاء – قد تُعيد الواجهة البرمجية رموز الحالة التالية:

الرمز المعنى السبب الشائع
400 طلب غير صالح هيكل JSON غير صالح أو حقول مطلوبة مفقودة.
401 غير مُصادَق عليه رمز JWT مفقود أو غير صالح.
404 غير موجود المصنف أو ورقة العمل أو فهرس الشكل غير موجود.
500 خطأ داخلي في الخادم مشكلة غير متوقعة من جانب الخادم.

أمثلة على استجابات الأخطاء

400 – طلب غير صالح

{
  "Code": 400,
  "Message": "حمولة الطلب غير صالحة. حقل 'Name' يتجاوز الحد الأقصى للطول."
}

401 – غير مُصادَق عليه

{
  "Code": 401,
  "Message": "فشل المصادقة. رمز JWT غير صالح أو منتهٍ."
}

404 – غير موجود

{
  "Code": 404,
  "Message": "لم يتم العثور على المصنف أو ورقة العمل أو فهرس الشكل المحدَّد."
}

500 – خطأ داخلي في الخادم

{
  "Code": 500,
  "Message": "حدث خطأ غير متوقع في الخادم."
}

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

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

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

إضافة شكل إلى ورقة عمل Excel حذف جميع الأشكال في ورقة عمل Excel