إخفاء الصفوف في ورقة عمل Excel باستخدام Aspose.Cells Cloud API
يقوم هذا الـ REST API بإخفاء الصفوف في ورقة عمل Excel.
المتطلبات الأساسية: رمز JWT Bearer ساري المفعول تم الحصول عليه من نقطة نهاية OAuth الخاصة بـ Aspose Cloud، وملف المصنف المخزن في مستودع Aspose Cloud، واسم ورقة العمل التي تحتوي على الصفوف المراد إخفاؤها. يعمل الـ API مع ملفات Excel بصيغ XLS وXLSX وغيرها من الصيغ المدعومة.
PostHideWorksheetRows API
POST https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/cells/rows/hide
الأمان والمصادقة
تُعتبر واجهات برمجة التطبيقات (APIs) الخاصة بـ Aspose.Cells Cloud آمنة وتحتاج إلى مصادقة تعتمد على رمز JWT.
معاملات الطلب
| المعامل | النوع | الموقع | الوصف |
|---|---|---|---|
| name | سلسلة نصية | المسار | اسم ملف المصنف. |
| sheetName | سلسلة نصية | المسار | اسم ورقة العمل التي تحتوي على الصفوف المراد إخفاؤها. |
| startrow | عدد صحيح | الاستعلام | المؤشر الصفر-based للصف الأول المراد إخفاؤه. |
| totalRows | عدد صحيح | الاستعلام | عدد الصفوف المتتالية المراد إخفاؤها، ابتداءً من startrow. |
| folder | سلسلة نصية | الاستعلام | المجلد في المستودع حيث يوجد المصنف. |
| storageName | سلسلة نصية | الاستعلام | اسم خدمة التخزين. |
يُوفّر مواصفات OpenAPI واجهة برمجة تطبيقات مفتوحة ومتاحة للعامة تسمح لك بإجراء تفاعلات REST مباشرة من خلال متصفح الويب.
يمكنك استخدام أداة سطر الأوامر cURL لاستدعاء خدمات ويب Aspose.Cells. يتطلب الـ API رمز JWT Bearer تم الحصول عليه من نقطة نهاية OAuth الخاصة بـ Aspose Cloud؛ ويجب تضمينه في الرأس Authorization. يوضح المثال التالي كيفية إخفاء صف باستخدام cURL.
رموز حالة الاستجابة
| الرمز | الوصف |
|---|---|
| 200 | نجاح – تم إخفاء الصفوف |
| 400 | طلب غير صالح – معاملات غير صحيحة |
| 401 | غير مصرّح به – رمز JWT مفقود أو غير صالح |
| 404 | غير موجود – المصنف أو ورقة العمل غير موجودة |
| 500 | خطأ في الخادم – فشل في المعالجة الداخلية |
تُعيد الاستدعاءات الناجحة كائن JSON يحتوي على الحقلين Code وStatus. وفي حال حدوث خطأ، تتضمن الاستجابة حقول إضافية مثل Message ورموز الحالة HTTP المناسبة (مثل 400، 401، 404، 500).
ملاحظات: تأكد من أن قيمة startrow تقع ضمن نطاق الصفوف في ورقة العمل؛ وإلا فسيُعيد الـ API خطأ 400. وتكون مؤشرات الصفوف صفرية البداية، لذا فإن startrow=0 يشير إلى الصف الأول.
عائلة SDK للسحابة
استخدام SDK هو أسرع طريقة لدمج هذه الوظيفة في تطبيقك. وتتولى SDKs إدارة التفاصيل من المستوى المنخفض، بحيث يمكنك التركيز على المنطق التجاري. راجع مستودع GitHub للحصول على قائمة كاملة بـ SDKs الخاصة بـ Aspose.Cells Cloud.
تعرض مقاطع الكود التالية كيفية إخفاء الصفوف باستخدام مكتبات SDK مختلفة. (تشير أسماء الملفات في الأمثلة إلى “Unhide” بسبب تسمية قديمة؛ بينما يقوم الكود داخل كل مقتطف بتنفيذ عملية Hide.)