إضافة عمود فارغ إلى ورقة عمل إكسل باستخدام واجهة برمجة تطبيقات Aspose.Cells Cloud
تقوم هذه الواجهة البرمجية REST بإدراج عمود واحد أو أكثر داخل ورقة عمل.
المتطلبات الأساسية
قبل استدعاء هذه النقطة النهائية، تأكد من إتمام الخطوات التالية:
- احصل على رمز وصول OAuth 2.0 صالح وشَمْلَه في الرأس
Authorization. - اخزن ملف العمل المستهدف في التخزين المحدّد (الافتراضي = “Default”) أو حدّد معامَلات
folderوstorageNameالمناسبة. - تحقق من أن اسم ورقة العمل المُعطى في
sheetNameموجود في ملف العمل.
واجهة PutInsertWorksheetColumns
PUT https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/cells/columns/{columnIndex}?totalColumns=1
الأمان والمصادقة
تُعدّ واجهات برمجة تطبيقات Aspose.Cells Cloud آمنة وتحتاج إلى مصادقة باستخدام رمز JWT.
معامَلات الطلب
| اسم المعامل | النوع | الموقع | الوصف |
|---|---|---|---|
| name | نصّ | المسار | اسم ملف ملف العمل. |
| sheetName | نصّ | المسار | اسم ورقة العمل. |
| columnIndex | عدد صحيح | المسار | المؤشّر بصفر (0) للعمود الذي يبدأ منه الإدراج. |
| totalColumns | عدد صحيح | الاستعلام | عدد الأعمدة المراد إدراجها. |
| updateReference | منطقي | الاستعلام | عند القيمة true، تُحدّث المرجعيات الخلوية لتعكس الإدراج. |
| folder | نصّ | الاستعلام | مسار المجلّد الذي يحتوي على ملف العمل. |
| storageName | نصّ | الاستعلام | اسم خدمة التخزين. |
ملاحظات
- يجب أن يكون
columnIndexبين 0 وعدد الأعمدة الحالي في ورقة العمل. وعند الإدراج خارج النطاق الحالي، يتوسّع الملف تلقائيًا. - يؤدي إدراج أعمدة متعددة (
totalColumns> 1) إلى تحريك الأعمدة الموجودة نحو اليمين. - يفترض الإعداد الافتراضي لعلامَة
updateReferenceالقيمةfalse؛ لذا، اضبطها علىtrueلتحديث الصيغ والمجالات المسماة.
يُعرّف مواصفات OpenAPI واجهة برمجة تطبيقات متاحة عمومًا وتتيح لك إجراء تفاعلات REST مباشرة من متصفّح الويب.
يمكنك استخدام أداة سطر الأوامر cURL لاستدعاء خدمات Aspose.Cells. يُظهر المثال التالي طلبًا كاملاً يتضمّن المصادقة ومعاملات المسار الصحيحة.
كود الاستجابة
| الكود | الوصف |
|---|---|
| 200 | تمّ إدراج العمود/الأعمدة بنجاح. |
| 400 | طلب خاطئ – معامَلات مفقودة أو غير صالحة. |
| 401 | غير مصرّح به – رمز وصول غير صالح أو مفقود. |
| 404 | ملف العمل أو ورقة العمل غير موجود. |
| 500 | خطأ داخلي في الخادم. |
أمثلة على استجابات الأخطاء
// 400 Bad Request – معامَلات مفقودة أو غير صالحة
{
"Code": 400,
"Message": "معامل غير صالح: يجب أن يكون totalColumns عددًا صحيحًا موجبًا."
}
// 401 Unauthorized – رمز وصول غير صالح أو مفقود
{
"Code": 401,
"Message": "فشلت المصادقة. رمز الوصول مفقود أو غير صالح."
}
// 404 Not Found – ملف العمل أو ورقة العمل غير موجود
{
"Code": 404,
"Message": "لم يتم العثور على ملف العمل 'test.xlsx'."
}
// 500 Internal Server Error
{
"Code": 500,
"Message": "حدث خطأ غير متوقع في الخادم."
}
عائلة SDK للسحابة
استخدام SDK هو أسرع طريقة لتطوير البرمجيات. فتتولّى SDK تفاصيل المستوى المنخفض، ما يتيح لك التركيز على منطق مشروعك. راجع مستودع GitHub للاطّلاع على قائمة كاملة بـ SDKs الخاصة بـ Aspose.Cells Cloud.
تُظهر أمثلة الشيفرة التالية كيفية استدعاء خدمات Aspose.Cells باستخدام SDKs مختلفة: