تجميع الأعمدة – وثائق واجهة Aspise.Cells Cloud API
Contents
[
Hide
]
تجميع الأعمدة في ورقة عمل Excel
إصدار API: v3.0
العملية: PostGroupWorksheetColumns – تجميع أعمدة ورقة العمل داخل ورقة العمل.
نظرة عامة
تتيح لك هذه الواجهة البرمجية تجميع نطاق من الأعمدة داخل ورقة عمل. يمكن إظهار الأعمدة المجمّعة أو إخفاؤها، مما يمكّنك من إنشاء أقسام قابلة للطيّ تشبه تلك الموجودة في Microsoft Excel.
المتطلبات الأساسية
- رمز وصول JWT صالح تم الحصول عليه من خدمة مصادقة Aspose Cloud.
- يجب أن يكون ملف المصنف مخزنًا في مكان يمكن لـ Aspose.Cells Cloud الوصول إليه (التخزين الافتراضي أو اسم تخزين مخصص).
- إصدار SDK المطلوب (إذا كنت تستخدم SDK): أحدث إصدار يدعم إصدار API v3.0.
المصادقة
تتطلب جميع الطلبات مصادقة باستخدام رمزBearer.
Authorization: Bearer <access_token>
للحصول على تفاصيل حول كيفية الحصول على رمز، راجع دليل مصادقة JWT.
طلب HTTP
POST https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/cells/columns/group
| المعلمة | الموقع | الإجباري | الوصف |
|---|---|---|---|
name |
المسار | نعم | اسم ملف المصنف (مثل test.xlsx). |
sheetName |
المسار | نعم | اسم ورقة العمل التي تحتوي على الأعمدة المراد تجميعها. |
firstIndex |
الاستعلام | نعم | المؤشر البادئ من الصفر (zero-based index) للعمود الأول المُراد تضمينه في المجموعة. |
lastIndex |
الاستعلام | نعم | المؤشر البادئ من الصفر (zero-based index) للعمود الأخير المُراد تضمينه في المجموعة. |
hide |
الاستعلام | لا | إذا كانت القيمة true، فستُخفى الأعمدة المجمّعة؛ وإلا ستظل ظاهرة. |
folder |
الاستعلام | لا | المسار إلى المجلد الذي يحتوي على المصنف. |
storageName |
الاستعلام | لا | اسم خدمة التخزين التي يوجد فيها الملف. |
مثال على الطلب (cURL)
curl -X POST "https://api.aspose.cloud/v3.0/cells/test.xlsx/worksheets/Sheet1/cells/columns/group?firstIndex=1&lastIndex=2&hide=true" \
-H "accept: application/json" \
-H "Authorization: Bearer <access_token>"
ملاحظة: يستخدم الطلب HTTPS لضمان تشفير الاتصال.
الاستجابة
نجاح (200)
| الحقل | النوع | الوصف |
|---|---|---|
Code |
عدد صحيح | رمز حالة HTTP (200). |
Status |
نص | الحالة النصية للعملية (OK). |
مثال
{
"Code": 200,
"Status": "OK"
}
خطأ (مثل 400 Bad Request)
| الحقل | النوع | الوصف |
|---|---|---|
Code |
عدد صحيح | رمز حالة HTTP (400، 401، 404، 500، …). |
Status |
نص | الحالة النصية (Error). |
ErrorMessage |
نص | وصف قابل للقراءة للخطأ. |
ErrorCode |
نص | مُعرّف برمجي للخطأ. |
مثال – طلب غير صالح
{
"Code": 400,
"Status": "Error",
"ErrorMessage": "مؤشر عمود غير صالح.",
"ErrorCode": "InvalidParameter"
}
أمثلة باستخدام SDK
تُظهر المقاطع التالية كيفية استدعاء عملية تجميع أعمدة ورقة العمل باستخدام SDKs المدعومة.
ملاحظات
- سلوك التجميع: تُنشئ الواجهة مجموعة أعمدة يمكن توسيعها أو طيّها داخل Excel. وعند تعيين
hide=true، تُطيّ المجموعة فورًا. - العدّ من الصفر (Zero-based indexing): يبدأ كل من
firstIndexوlastIndexمن 0؛ أول عمود في ورقة العمل يحمل المؤشر 0. - اعتبارات التخزين: إذا كان المصنف موجودًا في تخزين غير افتراضي، فقم بتوفير معلمتَي الاستعلام
folderوstorageName.
انظر أيضًا
- المصادقة – باستخدام رمز JWT
- مواصفات OpenAPI لتجميع أعمدة ورقة العمل
- SDKs لـ Aspose.Cells Cloud (GitHub)
- تجميع الصفوف في ورقة عمل Excel
الرسم التوضيحي:
{: .img-fluid alt=“لقطة شاشة تُظهر أعمدة مجمّعة في ورقة عمل Excel” }