كيفية دمج الخلايا في ورقة عمل Excel – واجهة Aspose.Cells Cloud API (الإصدار 3.0)
تقوم واجهة Aspose.Cells Cloud REST API بدمج كتلة مستطيلة من الخلايا في خلية واحدة تمتد عبر الصفوف والأعمدة المحددة.
المتطلبات المسبقة
- رمز JWT صالح للمصادقة.
- يجب أن تكون المصنف موجودًا مسبقًا في مجلد التخزين المحدد.
- يجب إعداد إعدادات التخزين (اسم المجلد واسم التخزين) في حسابك على Aspose.Cloud.
واجهة PostWorksheetMerge
POST https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/cells/merge
الأمان والمصادقة
تُعتبر واجهات Aspose.Cells Cloud آمنة وتتطلب مصادقة تعتمد على رمز JWT.
معاملات الطلب
| الاسم | النوع | الموقع | الوصف |
|---|---|---|---|
| name | string | path | اسم المصنف. |
| sheetName | string | path | اسم ورقة العمل. |
| startRow | integer | query | الفهرس الصفر-based للصف الأول (0 = الصف الأول). |
| startColumn | integer | query | الفهرس الصفر-based للعمود الأول (0 = العمود الأول). |
| totalRows | integer | query | عدد الصفوف المراد دمجها. |
| totalColumns | integer | query | عدد الأعمدة المراد دمجها. |
| folder | string | query | المجلد الذي يحتوي على المصنف. |
| storageName | string | query | اسم التخزين. |
لا يُطلب أي جسم للطلب في هذه العملية.
الاستجابة
ترجع كائن CellsCloudResponse.
{
"Status":"OK",
"Code":200
}
رموز حالة HTTP
| الرمز | المعنى | الوصف |
|---|---|---|
| 200 | OK (نجاح) | تمت تطبيق التصفية بنجاح؛ تحتوي الاستجابة على تفاصيل العملية. |
| 400 | Bad Request (طلب غير صالح) | معاملات مفقودة أو غير صالحة (مثل نوع ملف غير مدعوم). |
| 401 | Unauthorized (غير مُخوّل) | رمز JWT غير صالح أو مفقود. |
| 413 | Payload Too Large (حمولة كبيرة جدًا) | تجاوز حجم الملف المرفوع الحد المسموح به. |
| 500 | Internal Server Error (خطأ داخلي في الخادم) | خطأ غير متوقع في الخادم. |
كيفية استخدام واجهة PostWorksheetMerge باستخدام SDKs
مواصفات واجهة PostWorksheetMerge
تُعرّف مواصفات OpenAPI واجهة برمجة تطبيقات عامة قابلة للوصول، وتتيح لك إجراء تفاعلات REST مباشرة من متصفح الويب.
يمكنك استخدام أداة cURL سطر الأوامر للوصول بسهولة إلى خدمات Aspose.Cells عبر الويب. يوضح المثال التالي كيفية إجراء مكالمات إلى واجهة Cloud API باستخدام cURL.
استخدام SDKs الخاصة بـ Aspose.Cells Cloud
يُعد استخدام SDK الطريقة الأفضل لتسريع عملية التطوير. فتتولى SDK إدارة التفاصيل من المستوى المنخفض، مما يسمح لك بالتركيز على مهام مشروعك. يُرجى الاطلاع على مستودع GitHub للحصول على قائمة كاملة بـ SDKs الخاصة بـ Aspose.Cells Cloud.
تُظهر أمثلة الكود التالية كيفية إجراء مكالمات إلى خدمات Aspose.Cells عبر SDKs مختلفة: