نسخ المحتويات والتنسيقات من ورقة عمل أخرى.
تقوم هذه الواجهة البرمجية REST بنسخ ورقة عمل وتنسيقاتها إلى ورقة جديدة داخل نفس ملف العمل.
واجهة برمجة تطبيقات REST
POST http://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/copy
تُسرد المُعاملات المطلوبة أدناه:
| اسم المُعامل | النوع | الموقع | الوصف |
|---|---|---|---|
name |
string | path | اسم ملف ملف العمل. |
sheetName |
string | path | اسم ورقة العمل الوجهة (الورقة الجديدة). |
sourceSheet |
string | query | اسم ورقة العمل المراد نسخها. |
options |
object | body | كائن JSON يحتوي على خيارات النسخ (مثل عرض الأعمدة، الصيغ). |
sourceWorkbook |
string | query | اسم ملف العمل المصدري إذا اختلف عن ملف العمل الحالي. |
sourceFolder |
string | query | مسار المجلد الذي يُخزَّن فيه ملف العمل المصدري. |
folder |
string | query | مسار المجلد الذي سيُحفظ فيه ملف العمل الهدف. |
storageName |
string | query | اسم خدمة التخزين المراد استخدامها. |
أمثلة على الطلب والاستجابة
يُعرّف مواصفة OpenAPI واجهة برمجة قابلة للوصول بشكل عام، وتمكّنك من إجراء تفاعلات REST مباشرة من متصفح ويب.
يمكنك استخدام أداة سطر الأوامر cURL للوصول بسهولة إلى خدمات ويب Aspose.Cells. يُظهر المثال التالي كيفية إجراء المكالمات إلى واجهة Cloud API باستخدام cURL.
معالجة الأخطاء
تُعيد الواجهة رموز الحالة القياسية لبروتوكول HTTP مع جسم خطأ بصيغة JSON. تشمل الاستجابات الشائعة ما يلي:
| رمز HTTP | الوصف | مثال على جسم الخطأ بصيغة JSON |
|---|---|---|
| 400 | طلب غير صالح – مُعاملات مفقودة أو غير صالحة. | { "Code": 400, "Message": "Invalid request parameters." } |
| 401 | غير مصرّح – رمز مفقود أو غير صالح. | { "Code": 401, "Message": "Authentication failed." } |
| 404 | غير موجود – ملف العمل أو ورقة العمل أو المجلد غير موجود. | { "Code": 404, "Message": "Resource not found." } |
| 500 | خطأ داخلي في الخادم – حالة غير متوقعة. | { "Code": 500, "Message": "An unexpected error occurred." } |
عائلة SDK للسحابة
يُعد استخدام SDK أفضل طريقة لتسريع عملية التطوير. فالـ SDK يتعامل مع التفاصيل منخفضة المستوى، مما يتيح لك التركيز على مهام مشروعك. يُرجى الاطلاع على مستودع GitHub للاطّلاع على قائمة كاملة بـ SDKs الخاصة بـ Aspose.Cells Cloud.
تُظهر أمثلة الكود التالية كيفية إجراء المكالمات إلى خدمات ويب Aspose.Cells باستخدام SDKs مختلفة: