ضبط حجم الصف تلقائيًا في ورقة عمل Excel باستخدام واجهة Aspose.Cells Cloud API
تقوم هذه الواجهة PostAutofitWorksheetRow في REST API بضبط حجم صف واحد تلقائيًا في ورقة عمل Excel.
الأمان والمصادقة
تعمل واجهات برمجة تطبيقات Aspose.Cells Cloud بشكل آمن وتتطلب مصادقة قائمة على رمز JWT.
واجهة برمجة التطبيقات REST
POST https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/autofitrow
معاملات الطلب
| اسم المعاملة | النوع | الموقع | الوصف |
|---|---|---|---|
| name | string | path | اسم ملف Excel. |
| sheetName | string | path | اسم ورقة العمل. |
| rowIndex | integer | query | المؤشر البادئ بالصفر لصف الذي سيتم ضبط حجمه تلقائيًا. |
| firstColumn | integer | query | مؤشر العمود الأول المُضمن في العملية. |
| lastColumn | integer | query | مؤشر العمود الأخير المُضمن في العملية. |
| autoFitterOptions | object | body | كائن يتحكم في سلوك الضبط التلقائي (مثل ما إذا كان سيتم أخذ الخلايا المدمجة أو نصوف التفاف في الاعتبار، إلخ). راجع AutoFitterOptions{:rel=“noopener” title=“يتحكم في سلوك الضبط التلقائي”}. |
| folder | string | query | المجلد المخزن فيه الملف. |
| storageName | string | query | اسم وحدة التخزين. |
مثال لمحتوى JSON لـ autoFitterOptions
{
"IsMergedCells": true,
"IsWrapped": false,
"AutoFitMergedCells": true,
"AutoFitWrappedCells": false
}
تعريفات الكيانات (Entities)
| الكيان | الوصف |
|---|---|
rowIndex |
المؤشر البادئ بالصفر لصف الهدف. |
firstColumn |
العمود الابتدائي لعملية الضبط التلقائي. |
lastColumn |
العمود النهائي لعملية الضبط التلقائي. |
autoFitterOptions |
إعدادات اختيارية تؤثر في كيفية ضبط حجم الصف تلقائيًا (خلايا مدمجة، نصوف ملتفة، إلخ). |
تُعرّف مواصفات OpenAPI واجهة برمجة تطبيقات عامة قابلة للوصول وتتيح لك إجراء تفاعلات REST مباشرة من متصفح ويب.
يمكنك استخدام أداة سطر الأوامر cURL للوصول بسهولة إلى خدمات Aspose.Cells عبر الويب. يوضح المثال التالي كيفية استدعاء الواجهة باستخدام cURL.
معالجة الأخطاء
تعيد الواجهة أكواد الحالة القياسية لـ HTTP. وتشمل ردود الأخطاء الشائعة لهذه النقطة النهائية (endpoint):
| كود HTTP | محتوى الاستجابة المثال | المعنى |
|---|---|---|
| 400 | { "Code": 400, "Message": "Row index out of range." } |
المؤشر rowIndex المُدخل خارج النطاق المسموح به في ورقة العمل. |
| 401 | { "Code": 401, "Message": "Invalid or expired token." } |
فشلت المصادقة – تحقق من رمز JWT وتأكد من أن الطلب يتم عبر بروتوكول HTTPS. |
| 404 | { "Code": 404, "Message": "File not found." } |
لا يمكن العثور على ملف Excel أو ورقة العمل المحددة. |
| 500 | { "Code": 500, "Message": "Internal server error." } |
حدثت مشكلة غير متوقعة من جانب الخادم. |
عائلة SDK السحابية
استخدام SDK هو أسرع طريقة للتطوير. حيث يُجرّد SDK التفاصيل منخفضة المستوى، مما يسمح لك بالتركيز على منطق أعمالك. راجع مستودع GitHub{:rel=“noopener noreferrer”} للحصول على قائمة كاملة بـ SDKs الخاصة بـ Aspose.Cells Cloud.
تُظهر أمثلة الكود التالية كيفية استدعاء خدمات Aspose.Cells عبر الويب باستخدام SDKs مختلفة:
انظر أيضًا: ضبط حجم العمود تلقائيًا، ضبط حجم الصفوف تلقائيًا، AutoFitterOptions.