إضافة صف فارغ إلى ورقة عمل Excel باستخدام واجهة برمجة تطبيقات Aspose.Cells Cloud

تقوم هذه الواجهة البرمجية REST بإضافة صف جديد إلى ورقة عمل Excel. وهي تُدرج صفًا فارغًا عند الفهرس المحدد الذي يبدأ من الصفر.

المتطلبات المسبقة:

يجب تضمين رمز وصول Aspose Cloud صالح (Bearer JWT) في رأس Authorization.
يجب رفع ملف المصنف المستهدف إلى مساحة التخزين الخاصة بك في Aspose Cloud، ويجب أن تشير المعاملات folder وstorageName إلى موقعه.

ملاحظات:

يكون الفهرس rowIndex ابتدائيًا من الصفر؛ وإدراج صف عند الفهرس 0 يضيف صفًا في أعلى ورقة العمل.
تحتوي ورقات عمل Excel على 1,048,576 صفًّا كحد أقصى؛ ومحاولة الإدراج خارج هذا الحد ستؤدي إلى

PutInsertWorksheetRow API

PUT https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/cells/rows/{rowIndex}

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

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

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

اسم المعامل	النوع	الموقع	الوصف
name	string	path	اسم ملف المصنف.
sheetName	string	path	اسم ورقة العمل.
rowIndex	integer	path	الفهرس الذي يبدأ من الصفر حيث سيتم إدراج الصف الجديد.
folder	string	query	مسار المجلد في التخزين الذي يحتوي على المصنف.
storageName	string	query	اسم مساحة التخزين في Aspose Cloud التي سيتم استخدامها.

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

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

الطلب

curl -v "https://api.aspose.cloud/v3.0/cells/test.xlsx/worksheets/Sheet1/cells/rows/10" \
  -X PUT \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <jwt token>"

ملاحظة: جميع مسارات Aspose.Cells Cloud تتطلب HTTPS. استخدم المخطط الآمن https:// عند إجراء المكالمات في بيئة الإنتاج.

الاستجابة

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

رموز حالة HTTP

الكود	المعنى	الوصف
200	OK	تم تطبيق المرشح بنجاح؛ تحتوي الاستجابة على تفاصيل العملية.
400	Bad Request	معاملات مفقودة أو غير صالحة (مثل نوع ملف غير مدعوم).
401	Unauthorized	رمز JWT غير صالح أو مفقود.
413	Payload Too Large	حجم الملف المرفوع يتجاوز الحد المسموح به.
500	Internal Server Error	خطأ داخلي غير متوقع في الخادم.

مثال على استجابة خطأ (مثلًا عندما يتجاوز الفهرس الحد المسموح به لعدد الصفوف):

{
  "Code": 400,
  "Status": "Bad Request",
  "Message": "فهرس الصف خارج النطاق المسموح. الحد الأقصى لعدد الصفوف المسموح به: 1048576."
}

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

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

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