ضبط تلقائي لأعمدة في ملف إكسل
تدعم هذه الواجهة البرمجية (REST API) إجراء الضبط التلقائي للأعمدة في ملف عمل إكسل.
واجهة PostAutofitWorkbookColumns
POST https://api.aspose.cloud/v3.0/cells/{name}/autofitcolumns
معطيات الطلب هي:
| اسم المعطى | النوع | الموقع | الوصف |
|---|---|---|---|
| name | سلسلة نصية | مسار | اسم ملف ملف العمل (Workbook). |
| autoFitterOptions | كائن | جسم الطلب | خيارات تحكم في سلوك الضبط التلقائي. |
| startColumn | عدد صحيح | استعلام | الفهرس (الصفر-الأساسي) للعمود الأول المراد ضبطه تلقائيًا. |
| endColumn | عدد صحيح | استعلام | الفهرس (الصفر-الأساسي) للعمود الأخير المراد ضبطه تلقائيًا. |
| folder | سلسلة نصية | استعلام | المجلد الذي يحتوي على ملف العمل. |
| storageName | سلسلة نصية | استعلام | اسم خدمة التخزين المستخدمة. |
يُعرّف مواصفة OpenAPI{:rel=“noopener noreferrer”} واجهة برمجة قابلة للوصول العام، ويتيح لك تنفيذ تفاعلات REST مباشرة من متصفح ويب.
يمكنك استخدام أداة سطر الأوامر cURL للوصول بسهولة إلى خدمات Aspose.Cells عبر الويب. يُظهر المثال التالي كيفية استدعاء واجهة Cloud API باستخدام cURL.
المتطلبات المسبقة
قبل تنفيذ هذه العملية، تأكد من امتلاك مفتاح API صالح لـ Aspose Cloud، ورمز JWT تم توليده، ووجود ملف العمل المستهدف مسبقًا في موقع التخزين المحدد.
رموز حالة HTTP
| الرمز | المعنى | الوصف |
|---|---|---|
| 200 | ناجح (OK) | تمت تطبيق الفلتر بنجاح؛ تحتوي الاستجابة على تفاصيل العملية. |
| 400 | طلب غير صالح (Bad Request) | معطيات مفقودة أو غير صحيحة (مثل نوع ملف غير مدعوم). |
| 401 | غير مصرّح (Unauthorized) | رمز JWT غير صالح أو مفقود. |
| 413 | حجم البيانات كبير جدًا (Payload Too Large) | تجاوز حجم الملف المرفوع الحد المسموح به. |
| 500 | خطأ داخلي في الخادم (Internal Server Error) | حدث خطأ غير متوقع في الخادم. |
يمكن أن تُعيد الواجهة البرمجية رموز الحالة التالية:
| الرمز | الوصف |
|---|---|
| 200 | نجاح – تم ضبط الأعمدة تلقائيًا |
| 400 | طلب غير صالح – معطيات مفقودة أو غير صحيحة |
| 401 | غير مصرّح – رمز JWT غير صالح أو منتهٍ |
| 500 | خطأ في الخادم – فشل في المعالجة الداخلية |
عائلة SDK السحابية
يعتبر استخدام SDK الطريقة الأكثر كفاءة لتسريع عملية التطوير، إذ يتولى SDK إدارة التفاصيل من المستوى المنخفض، ما يتيح لك التركيز على المنطق الخاص بمشروعك. يُرجى الاطّلاع على مستودع GitHub{:rel=“noopener noreferrer”} للحصول على قائمة كاملة بـ SDKs الخاصة بـ Aspose.Cells Cloud.
تُظهر أمثلة الكود التالية كيفية استدعاء خدمات Aspose.Cells عبر الويب باستخدام SDKs مختلفة: