ضبط تلقائي لارتفاعات الصفوف في ملف Excel – واجهة برمجة تطبيقات Aspose.Cells Cloud
المتطلبات المسبقة
قبل استدعاء واجهة برمجة التطبيقات، احصل على رمز Bearer JWT صالح من خدمة مصادقة Aspose، وتأكد من أن ملف المصنف المستهدف مخزن في موقع دعم للتخزين (التخزين الافتراضي أو أي تخزين مخصص قمت بتكوينه).
تتيح لك هذه واجهة برمجة تطبيقات REST ضبط الصفوف تلقائيًا في ملف Excel، حيث يتم ضبط ارتفاع الصفوف تلقائيًا بعد إدخال البيانات أو تعديلها.
واجهة برمجة تطبيقات REST
POST https://api.aspose.cloud/v3.0/cells/{name}/autofitrows
تتضمن مُعطَلات الطلب ما يلي:
| اسم المُعطَل | النوع | الموقع | الوصف |
|---|---|---|---|
| name | string | path | اسم ملف المصنف. |
| autoFitterOptions | AutoFitterOptions | body | خيارات تتحكم في سلوك عملية الضبط التلقائي. |
| startRow | integer | query | فهرس الصف الأول المراد ضبطه تلقائيًا. |
| endRow | integer | query | فهرس الصف الأخير المراد ضبطه تلقائيًا. |
| firstColumn | integer | query | فهرس العمود الأول الذي يُؤخذ في الاعتبار أثناء الضبط التلقائي. |
| lastColumn | integer | query | فهرس العمود الأخير الذي يُؤخذ في الاعتبار أثناء الضبط التلقائي. |
| onlyAuto | boolean | query | إذا كانت القيمة true، فسيتم معالجة الصفوف التي تحتوي على علامة AutoFit فقط (الافتراضي false). |
| folder | string | query | مسار المجلد الذي يُخزن فيه المصنف. |
| storageName | string | query | اسم خدمة التخزين. |
AutoFitterOptions هو كائن يُحدِّد سلوك عملية الضبط التلقائي (مثل AutoFitMergedCells، IgnoreHidden).
رموز حالة HTTP
| الرمز | المعنى | الوصف |
|---|---|---|
| 200 | OK (نجاح) | تم تطبيق الضبط التلقائي بنجاح؛ يحتوي الاستجابة على تفاصيل العملية. |
| 400 | Bad Request (طلب غير صالح) | مُعطَلات مفقودة أو غير صالحة (مثل نوع ملف غير مدعوم). |
| 401 | Unauthorized (غير مصادق) | رمز JWT غير صالح أو مفقود. |
| 413 | Payload Too Large (حمولة كبيرة جدًا) | ملف مرفوع يتجاوز الحد الأقصى للحجم. |
| 500 | Internal Server Error (خطأ داخلي في الخادم) | خطأ غير متوقع في الخادم. |
يُعرّف مواصفات OpenAPI واجهة برمجة تطبيقات قابلة للوصول بشكل عام وتتيح لك إجراء تفاعلات REST مباشرة من متصفح ويب.
يمكنك استخدام أداة سطر الأوامر cURL لاستدعاء خدمات Aspose.Cells. استبدل <jwt token> برمز Bearer JWT صالح تم الحصول عليه من خدمة مصادقة Aspose.
ملاحظات
- عندما تكون القيمة
AutoFitMergedCellsهي true، تُعامل الخلايا المدمجة ككيان واحد أثناء عملية الضبط التلقائي. - عند تعيين
IgnoreHiddenإلى true، يتم تجاهل الصفوف والأعمدة المخفية والاحتفاظ بأبعادها الحالية.
عائلة SDK للسحابة
استخدام مكتبة SDK (SDK) هو أسرع طريقة لتطوير التطبيقات، حيث تُجرّد SDK التفاصيل من المستوى المنخفض، مما يتيح لك التركيز على مشروعك. راجع مستودع GitHub للحصول على قائمة كاملة بمكتبات SDK لـ Aspose.Cells Cloud.
توضح أمثلة الكود التالية كيفية استدعاء خدمات Aspose.Cells باستخدام مكتبات SDK مختلفة: