إضافة فاصل صفحات أفقي – Aspose.Cells Cloud API
تقوم واجهة Add Horizontal Page Break بإدخال فاصل صفحات أفقي داخل ورقة عمل Excel.
المتطلبات المسبقة والمصادقة
يلزم وجود رمز مميز (JWT token) صالح لجميع الاستدعاءات إلى واجهة Aspose.Cells Cloud API. احصل على الرمز المميز عبر سير عمل OAuth 2.0 الموصوف في دليل المصادقة، وشُمُله في رأس الطلب كالتالي: Authorization: Bearer <jwt token>. يجب أن يكون الملف المُ workbooks الهدف مخزنًا في موقع متاح لواجهة API (التخزين الافتراضي أو storageName مخصص تحدده).
PutHorizontalPageBreak API
PUT https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/horizontalpagebreaks
الأمان والمصادقة
تتطلب واجهات Aspose.Cells Cloud API مصادقة تعتمد على رمز مميز JWT لتكون آمنة.
معاملات الطلب
| اسم المعامل | النوع | الموقع | الوصف |
|---|---|---|---|
| name | string | path | اسم ملف Excel. |
| sheetName | string | path | اسم ورقة العمل التي سيتم إضافة الفاصل فيها. |
| cellname | string | query | مرجع الخلية (مثل A1) الذي يُشير إلى بداية الفاصل. |
| row | integer | query | فهرس الصف (بدءًا من الصفر) للفاصل. |
| column | integer | query | فهرس العمود (بدءًا من الصفر) للفاصل. |
| startColumn | integer | query | العمود الابتدائي لنطاق عند إدخال فاصل. |
| endColumn | integer | query | العمود النهائي لنطاق عند إدخال فاصل. |
| folder | string | query | مسار المجلد الذي يحتوي على ملف Excel. |
| storageName | string | query | اسم مساحة التخزين في Aspose Cloud. |
تُعرّف مواصفات OpenAPI واجهة عامة قابلة للوصول تسمح لك بإجراء تفاعلات REST مباشرة من متصفح ويب.
يمكنك استخدام أداة سطر الأوامر cURL للوصول إلى خدمات ويب Aspose.Cells بسهولة. يُظهر المثال التالي كيفية استدعاء الواجهة باستخدام cURL.
مثال على استجابة خطأ عند غياب أو فساد رمز JWT:
{
"Code": 401,
"Status": "Unauthorized",
"Message": "رمز JWT غير صالح أو مفقود."
}
رموز حالة HTTP
| الرمز | المعنى | الوصف |
|---|---|---|
| 200 | OK (نجاح) | تم تطبيق التصفية بنجاح؛ تحتوي الاستجابة على تفاصيل العملية. |
| 400 | Bad Request (طلب غير صالح) | معاملات مفقودة أو غير صالحة (مثل نوع ملف غير مدعوم). |
| 401 | Unauthorized (غير مصرّح) | رمز JWT غير صالح أو مفقود. |
| 413 | Payload Too Large (حمولة كبيرة جدًا) | تجاوز حجم الملف المرفوع الحد المسموح. |
| 500 | Internal Server Error (خطأ داخلي في الخادم) | خطأ غير متوقع في الخادم. |
لمزيد من التفاصيل حول العمليات ذات الصلة، راجع صفحات الواجهة الخاصة بـ Get Horizontal Page Breaks و Delete Horizontal Page Break.
عائلة SDK للسحابة
استخدام SDK هو أسرع طريقة للتطوير. تُجرّد SDK التفاصيل منخفضة المستوى، مما يسمح لك بالتركيز على مشروعك. يُرجى الاطلاع على مستودع GitHub للحصول على قائمة كاملة بـ SDKs لـ Aspose.Cells Cloud.
تُظهر أمثلة الكود التالية كيفية استدعاء خدمات ويب Aspose.Cells باستخدام SDKs مختلفة: