نسخ الأعمدة في ورقة عمل Excel باستخدام واجهة برمجة تطبيقات Aspose.Cells Cloud
تقوم هذه الواجهة البرمجية (REST API) بنسخ الأعمدة في ورقة عمل Excel. وتتيح عملية نسخ الأعمدة تكرار عمود واحد أو نطاق من الأعمدة وإدراج النسخة في موقع محدّد ضمن نفس ورقة العمل. استخدم هذه الواجهة لنسخ الأعمدة بكفاءة عند التعامل مع جداول بيانات كبيرة، وراجع العمليات ذات الصلة مثل إضافة عمود وإخفاء عمود لإكمال مهام إدارة الأعمدة الأخرى.
الأمان والمصادقة
واجهات برمجة تطبيقات Aspose.Cells Cloud آمنة وتتطلب مصادقة مبنية على رمز JWT.
واجهة برمجة التطبيقات REST
POST https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/cells/columns/copy
معلمات الطلب
| اسم المعلمة | النوع | الموقع | الوصف |
|---|---|---|---|
| name | نص (string) | مسار (path) | اسم ملف المصنف. |
| sheetName | نص (string) | مسار (path) | اسم ورقة العمل. |
| sourceColumnIndex | عدد صحيح (integer) | استعلام (query) | فهرس العمود المراد نسخه (يبدأ من الصفر). |
| destinationColumnIndex | عدد صحيح (integer) | استعلام (query) | فهرس الموضع المراد إدراج الأعمدة المنسوخة فيه (يبدأ من الصفر). |
| columnNumber | عدد صحيح (integer) | استعلام (query) | عدد الأعمدة المتتالية المراد نسخها. |
| worksheet | نص (string) | استعلام (query) | (اختياري) مُعرّف ورقة العمل يُستخدم عندما يختلف اسم ورقة العمل عن ما ورد في المسار. |
| folder | نص (string) | استعلام (query) | مسار المجلد الذي يحتوي على المصنف في مساحة التخزين السحابية لـ Aspose. |
يمكنك الاطّلاع على مواصفات OpenAPI للحصول على العقد الكاملة لهذه العملية.
مثال باستخدام cURL
curl -X POST "https://api.aspose.cloud/v3.0/cells/test.xlsx/worksheets/Sheet1/cells/columns/copy?sourceColumnIndex=1&destinationColumnIndex=12&columnNumber=10" \
-H "Authorization: Bearer $ASPOSE_TOKEN" \
-H "accept: application/json"
الاستجابة
{
"Code": 200,
"Status": "OK"
}
معالجة الأخطاء
تعيد الواجهة رموز الحالة القياسية (HTTP Status Codes) مع جسم استجابة بصيغة JSON يصف الخطأ.
| رمز الحالة | المعنى | مثال على جسم JSON |
|---|---|---|
| 400 | طلب غير صالح – معلمات غير صحيحة | { "Code": 400, "Message": "فهرس عمود غير صالح." } |
| 401 | غير مصرّح – رمز وصول مفقود أو غير صالح | { "Code": 401, "Message": "رمز الوصول غير صالح أو منتهٍ." } |
| 404 | غير موجود – المصنف أو ورقة العمل غير موجودين | { "Code": 404, "Message": "لم يتم العثور على المصنف." } |
| 500 | خطأ داخلي في الخادم – ظرف غير متوقّع | { "Code": 500, "Message": "حدث خطأ غير متوقّع." } |
كيفية استكشاف الأخطاء وحلّها: تحقّق من أن رمز الوصول ساري المفعول، وأن اسم المصنف وورقة العمل صحيحان، وأن قيم
sourceColumnIndexوdestinationColumnIndexوcolumnNumberتقع ضمن نطاق أعمدة ورقة العمل.
عائلة واجهات برمجة التطبيقات السحابية (Cloud SDK Family)
يُعدّ استخدام مكتبات SDK أفضل طريقة لتسريع عملية التطوير، إذ تُدار التفاصيل منخفضة المستوى تلقائيًا، مما يتيح لك التركيز على مهام مشروعك. يُرجى زيارة مستودع GitHub للحصول على قائمة كاملة بواجهات برمجة تطبيقات Aspose.Cells Cloud SDK.
تُظهر الأمثلة التالية كيفية إجراء مكالمات لخدمات الويب Aspose.Cells باستخدام مكتبات SDK المختلفة: