Documentation –

Developer-Guide: إضافة صف فارغ إلى ورقة عمل Excel

Mon, 01 Jan 0001 00:00:00 +0000

تقوم هذه الواجهة البرمجية 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 مختلفة:

Developer-Guide: إضافة صفوف متعددة إلى ورقة عمل Excel

Mon, 01 Jan 0001 00:00:00 +0000

تقوم هذه الواجهة البرمجية REST بإضافة عدة صفوف جديدة إلى ورقة عمل Excel.

PutInsertWorksheetRows API

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

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

تُعدّ واجهات برمجة تطبيقات Aspose.Cells Cloud آمنة وتشترط المصادقة باستخدام رمز مميز JWT.

معلمات الطلب

اسم المعلمة	النوع	الموقع	الوصف
name	نص (string)	المسار (path)	اسم المصنف (الملف).
sheetName	نص (string)	المسار (path)	اسم ورقة العمل.
startrow	عدد صحيح (integer)	الاستعلام (query)	فهرس أول صف سيتم إدراجه (يبدأ من الصفر).
totalRows	عدد صحيح (integer)	الاستعلام (query)	عدد الصفوف المراد إدراجه.
updateReference	منطقي (boolean)	الاستعلام (query)	ما إذا كان سيتم تحديث مراجع الخلايا بعد الإدراج (`true` أو `false`).
folder	نص (string)	الاستعلام (query)	المجلد الذي يحتوي على المستند.
storageName	نص (string)	الاستعلام (query)	اسم وحدة التخزين.

المتطلبات المسبقة
يجب أن يكون المصنف موجودًا مسبقًا في وحدة التخزين (أو المجلد) المحددة قبل تنفيذ هذه العملية.

المصادقة
تتطلب الواجهة البرمجية وجود رمز مميز JWT صالح. يُدرج في رأس الطلب Authorization كما هو موضح في مثال cURL أدناه.

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

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

الطلب

curl -v "https://api.aspose.cloud/v3.0/cells/test.xlsx/worksheets/Sheet1/cells/rows?startrow=1&totalRows=11&updateReference=true" \
  -X PUT \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <jwt token>"

ملاحظة: لا تتطلب هذه العملية PUT وجود جسم طلب؛ يمكن إرسال كائن JSON فارغ ({}) إذا اشترطت مكتبة العميل وجود حمل بيانات.

الاستجابة

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

رموز الاستجابة الممكنة

200 OK – أُدخلت الصفوف بنجاح.
400 Bad Request – معلمات غير صالحة (مثل: فهرس صف سالب).
401 Unauthorized – رمز JWT مفقود أو غير صالح.
404 Not Found – المصنف أو ورقة العمل المحددة غير موجودة.
500 Internal Server Error – خطأ في الخادم غير متوقع.

للمزيد من العمليات على الصفوف، راجع الصفحات ذات الصلة: حذف الصفوف، الحصول على بيانات الصفوف، و نسخ الصفوف.

مجموعة أدوات Cloud SDK

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

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