استيراد صورة إلى ورقة عمل Excel – دليل واجهة برمجة تطبيقات Aspose.Cells Cloud
يمكنك تحسين محتوى جداول البيانات البصرية من خلال استيراد الصور إليها، مثل الشعارات أو المخططات أو الرسوم البيانية. يوضح هذا الدليل كيفية استخدام عملية ImportPicture في Aspose.Cells Cloud، والتنسيق المطلوب للطلب، وكيفية التعامل مع الاستجابات.
المتطلبات الأساسية: يجب أن تمتلك رمز مصادقة JWT ساري المفعول وملف مصنف موجود مخزنًا في تخزين Aspose Cloud قبل تنفيذ عملية الاستيراد.
واجهة PostImportData API
POST https://api.aspose.cloud/v3.0/cells/import
الأمان والمصادقة
تُعد واجهات برمجة تطبيقات Aspose.Cells Cloud آمنة وتتطلب مصادقة تعتمد على رمز JWT.
متغيرات الطلب
يكون الطلب عبارة عن POST عبر HTTP مع محتوى من نوع multipart/related (انظر RFC 2046 أو RFC 1341).
- يحتوي الجزء الأول على كائن JSON يُسمى ImportPictureOption يصف مكان وضع الصورة وكيفية ذلك.
- يحتوي الجزء الثاني على ملف الصورة (أو بيانات Base64 المُشفّرة الخاصة بها).
ImportPictureOption – التعريف
{
"UpperLeftRow": 0,
"UpperLeftColumn": 0,
"LowerRightRow": 10,
"LowerRightColumn": 5,
"Filename": "logo.png",
"Data": "iVBORw0KGgoAAAANSUhEUgAA...",
"DestinationWorksheet": "Sheet1",
"IsInsert": true,
"ImportDataType": "Picture",
"Source": { "FileSource": "Storage" }
}
IsInsert قيمة منطقية (boolean) – القيمة true تُدرج صورة جديدة، وfalse تستبدل صورة موجودة.
المتغيرات المهمة
ImportPictureOption
| اسم المتغير | النوع | الوصف |
|---|---|---|
| UpperLeftRow | عدد صحيح (int) | فهرس الصف للزاوية العلوية اليسرى حيث سيتم وضع الصورة. |
| UpperLeftColumn | عدد صحيح (int) | فهرس العمود للزاوية العلوية اليسرى حيث سيتم وضع الصورة. |
| LowerRightRow | عدد صحيح (int) | فهرس الصف للزاوية السفلية اليمنى التي تحدّد حدود الصورة. |
| LowerRightColumn | عدد صحيح (int) | فهرس العمود للزاوية السفلية اليمنى التي تحدّد حدود الصورة. |
| Filename | سلسلة نصية (string) | اسم ملف الصورة. |
| Data | سلسلة نصية (string) | بيانات الصورة الثنائية المُشفّرة بصيغة Base64 (اختيارية إذا تم إرسال الملف كجزء ثانٍ). |
| DestinationWorksheet | سلسلة نصية (string) | اسم ورقة العمل التي سيتم إدراج الصورة فيها. |
| IsInsert | قيمة منطقية (boolean) | true لإدراج صورة جديدة؛ false لاستبدال صورة موجودة. |
| ImportDataType | سلسلة نصية (string) | نوع البيانات التي يتم استيرادها (مثل Picture أو IntArray أو DoubleArray أو StringArray أو TwoDimensionIntArray أو TwoDimensionDoubleArray أو TwoDimensionStringArray أو BatchData أو csvData). |
| Source | FileSource | يُحدد موقع ملف البيانات عندما تكون قيمة المعامل BatchData فارغة. |
الاستجابة
يُعيد الطلب الناجح رمز الحالة HTTP 200 مع حمولة JSON تشبه ما يلي:
{
"Code": 200,
"Status": "OK"
}
رموز الحالة الممكنة:
| الرمز | المعنى |
|---|---|
| 200 | نجح الاستيراد |
| 400 | طلب غير صالح – بيانات مفقودة أو غير صحيحة |
| 401 | غير مصرح به – رمز غير صالح أو مفقود |
| 500 | خطأ داخلي في الخادم |
كيفية استخدام واجهة PostImportData API مع مكتبات SDK
مواصفات واجهة PostImportData API
تُعرّف مواصفات OpenAPI واجهة برمجة تطبيقات قابلة للوصول العام وتتيح لك إجراء تفاعلات REST مباشرة من متصفح الويب.
استخدام مكتبات Aspose.Cells Cloud SDK
يُعد استخدام مكتبات SDK أفضل طريقة لتسريع عملية التطوير. فتتولى مكتبات SDK معالجة التفاصيل منخفضة المستوى، مما يتيح لك التركيز على مهام مشروعك. يُرجى مراجعة مستودع GitHub للحصول على قائمة كاملة بمكتبات Aspose.Cells Cloud SDK.
توضح الأمثلة التالية كيفية استدعاء خدمات ويب Aspose.Cells باستخدام مكتبات SDK المختلفة: