إضافة كائن OLE إلى ورقة عمل Excel باستخدام واجهة Aspose.Cells Cloud API
تتيح واجهة Aspose.Cells Cloud API التعديل البرمجي لملفات كتب عمل Excel، بما في ذلك إمكانية تضمين كائنات OLE (مثل مستندات Word، ملفات PDF، أو غيرها من الملفات الثنائية) مباشرة داخل ورقة عمل.
تُضيف هذه الواجهة عبر REST API كائن OLE إلى ورقة عمل Excel.
المتطلبات المسبقة – يجب أن تمتلك رمز مصادقة JWT ساري المفعول، وأن تُرفع أي ملفات مصادر يُشار إليها عبر oleFile أو imageFile إلى موقع التخزين المحدد مسبقًا قبل استدعاء نقطة النهاية.
PutWorksheetOleObject API
PUT https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/oleobjects
الأمان والمصادقة
واجهات Aspose.Cells Cloud API آمنة وتتطلب مصادقة تعتمد على رمز JWT.
معاملات الطلب
| اسم المعامل | النوع | الموقع | الوصف |
|---|---|---|---|
| name | string | path | اسم ملف كتاب العمل. |
| sheetName | string | path | اسم ورقة العمل. |
| oleObject | object | body | تعريف كائن OLE. |
| upperLeftRow | integer | query | فهرس الصف للزاوية العلوية اليسرى (الافتراضي 0). |
| upperLeftColumn | integer | query | فهرس العمود للزاوية العلوية اليسرى (الافتراضي 0). |
| height | integer | query | ارتفاع كائن OLE (الافتراضي 0). |
| width | integer | query | عرض كائن OLE (الافتراضي 0). |
| oleFile | string | query | اسم ملف مصدر OLE. |
| imageFile | string | query | اسم ملف صورة المعاينة. |
| folder | string | query | المجلد الذي يحتوي على كتاب العمل. |
| storageName | string | query | اسم وحدة التخزين المراد استخدامها. |
ملاحظات – يستخدم upperLeftRow و upperLeftColumn الترقيم البادئ بصفر (zero-based indexing). يجب أن يكون oleFile (وباختياري imageFile) موجودًا مسبقًا في وحدة التخزين الهدف؛ وإلا سيُعاد خطأ في الطلب.
يعرّف مواصفات OpenAPI واجهة برمجة تطبيقية متاحة للعامة وتتيح إجراء تفاعلات REST مباشرة من متصفح ويب.
يمكنك استخدام أداة سطر الأوامر cURL لاستدعاء خدمات Aspose.Cells عبر الويب. يوضح المثال التالي كيفية إضافة كائن OLE باستخدام cURL. يجب استخدام HTTPS في جميع المكالمات المُستخدمة في الإنتاج.
رموز حالة HTTP المحتملة
| الرمز | الوصف |
|---|---|
| 200 | تمت إضافة كائن OLE بنجاح. |
| 400 | طلب غير صالح – معاملات مفقودة أو غير صحيحة. |
| 401 | غير مخوّل – رمز JWT غير صالح أو مفقود. |
| 404 | غير موجود – ملف كتاب العمل أو ورقة العمل أو ملف المصدر غير موجود. |
| 500 | خطأ داخلي في الخادم – فشل غير متوقع. |
يُعاد استجابة نموذجية ناجحة مع حُمولة JSON التالية:
{
"Code": 200,
"Status": "OK",
"Data": {
"OleObjectId": "12345",
"UpperLeftRow": 15,
"UpperLeftColumn": 5,
"Width": 400,
"Height": 400,
"SourceFullName": "Sample_Book2.xls",
"ImageSourceFullName": "aspose-logo.png"
}
}
عائلة SDK للسحابة
استخدام SDK يُسرّع عملية التطوير، فهو يُجرّدك من التفاصيل التقنية منخفضة المستوى، ويسمح لك بالتركيز على منطق أعمالك. راجع مستودع GitHub للحصول على قائمة كاملة بـ SDKs الخاصة بـ Aspose.Cells Cloud.
تُظهر أمثلة الكود التالية كيفية استدعاء خدمات Aspose.Cells عبر واجهة الويب باستخدام SDKs مختلفة: