تحديث كائن OLE في ورقة عمل Excel – دليل واجهة برمجة تطبيقات Aspose.Cells Cloud

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

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

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

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

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

معلمات الطلب هي:

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

حقول جسم الطلب

الحقل	النوع	مطلوب	الوصف
ImageSourceFullName	string	اختياري	المسار إلى ملف الصورة المستخدم في كائن OLE.
IsAutoSize	boolean	اختياري	ما إذا كان يجب تلقائيًا ضبط حجم كائن OLE.
SourceFullName	string	مطلوب	ملف المصدر (مثل صورة أو مخطط) لكائن OLE.
UpperLeftRow	integer	مطلوب	فهرس الصف (مبني على الصفر) للزاوية العلوية اليسرى.
UpperLeftColumn	integer	مطلوب	فهرس العمود (مبني على الصفر) للزاوية العلوية اليسرى.
Left	integer	اختياري	الإزاحة الأفقية، بوحدات النقاط، من الزاوية العلوية اليسرى.
Top	integer	اختياري	الإزاحة الرأسية، بوحدات النقاط، من الزاوية العلوية اليسرى.
Width	integer	مطلوب	عرض كائن OLE، بوحدات النقاط.
Height	integer	مطلوب	ارتفاع كائن OLE، بوحدات النقاط.

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

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

Request

curl -v "https://api.aspose.cloud/v3.0/cells/" \
  -X POST \
  -d '{"ImageSourceFullName":"aspose-logo.png","IsAutoSize":true,"SourceFullName":"Sample_Book2.xls","UpperLeftRow":15,"Top":10,"UpperLeftColumn":5,"Left":10,"Width":400,"Height":400}' \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <jwt token>"

Response

{
  "Code": 200,
  "Status": "OK",
  "OLEObject": {
    "Index": 0,
    "ImageSourceFullName": "aspose-logo.png",
    "IsAutoSize": true,
    "SourceFullName": "Sample_Book2.xls",
    "UpperLeftRow": 15,
    "UpperLeftColumn": 5,
    "Left": 10,
    "Top": 10,
    "Width": 400,
    "Height": 400
  }
}

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

حالة HTTP	الكود	الرسالة
400	4000	طلب خاطئ – معلمات مفقودة أو غير صالحة.
401	4010	غير مصرح به – رمز JWT غير صالح أو مفقود.
404	4040	غير موجود – المصنف أو ورقة العمل أو كائن OLE غير موجود.
500	5000	خطأ داخلي في الخادم – فشل غير متوقع من جانب الخادم.

تعيد الواجهة البرمجية أيضًا حقلًا مخصصًا Code في جسم الاستجابة يطابق حالة HTTP (مثلًا: 200 → 2000، 400 → 4000، إلخ).

متى تستخدم هذه الواجهة البرمجية؟

استخدم هذه النقطة النهائية عندما تحتاج إلى تعديل كائن OLE موجود—مثل صورة مضمنة أو مخطط أو مستند—بدون إعادة رفع ورقة العمل بالكامل. تتضمن السيناريوهات الشائعة تحديث مصدر الصورة، أو تغيير حجم الكائن، أو تعديل موقعه بعد إنشاء المصنف. للاطلاع على العمليات ذات الصلة، راجع إضافة كائن OLE و حذف كائن OLE.

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

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

يعرض المثال التالي بلغة C# كيفية تحديث كائن OLE باستخدام SDK لـ Aspose.Cells Cloud:

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

var config = new Configuration
{
    AppSid = "<your-app-sid>",
    AppKey = "<your-app-key>"
};
var oleApi = new OleObjectsApi(config);
var request = new OleObjectUpdateRequest
{
    ImageSourceFullName = "aspose-logo.png",
    IsAutoSize = true,
    SourceFullName = "Sample_Book2.xls",
    UpperLeftRow = 15,
    UpperLeftColumn = 5,
    Left = 10,
    Top = 10,
    Width = 400,
    Height = 400
};

var response = oleApi.UpdateWorksheetOleObject("SampleBook.xlsx", "Sheet1", 0, request, folder: "myFolder");
Console.WriteLine($"Status: {response.Status}");

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

إضافة كائن OLE في ورقة عمل Excel تحويل كائن OLE إلى صورة – واجهة Aspose.Cells Cloud REST API