نسخ الصفوف في ورقة عمل Excel v3.0
نسخ البيانات والتنسيقات من صفوف كاملة محددة في ورقة العمل.
المتطلبات الأساسية
| # | المتطلب |
|---|---|
| 1 | رمز JWT صالح. راجع دليل المصادقة. |
| 2 | يجب أن يكون ملف المصنف ({name}) موجودًا مسبقًا في المجلد / التخزين المُحدَّد. |
| 3 | يجب أن تكون ورقة العمل المستهدفة ({sheetName}) موجودة في المصنف. |
| 4 | (اختياري) معرف المجلد واسم التخزين إن لم يكن الملف في الموقع الافتراضي. |
نقطة النهاية
POST https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/cells/rows/copy
جميع معلمات المسار حساسة لحالة الأحرف.
معلمات المسار
| المعلمة | النوع | المطلوب | الوصف |
|---|---|---|---|
name |
نص | ✅ | اسم ملف المصنف (مثل test.xlsx). |
sheetName |
نص | ✅ | اسم ورقة العمل (مثل Sheet1). |
معلمات الاستعلام
| المعلمة | النوع | المطلوب | الوصف |
|---|---|---|---|
sourceRowIndex |
عدد صحيح | ✅ | المؤشر بصفر (zero-based) للصف المصدر. |
destinationRowIndex |
عدد صحيح | ✅ | المؤشر بصفر حيث سيتم وضع الصفوف المنسوخة. |
rowNumber |
عدد صحيح | ✅ | عدد الصفوف المراد نسخها. |
worksheet |
نص | ❌ | معرّف ورقة العمل؛ عادةً يساوي sheetName. |
folder |
نص | ❌ | مسار المجلد الذي يحتوي على المصنف. |
storageName |
نص | ❌ | اسم خدمة التخزين. |
مثال على الطلب (cURL)
curl -v "https://api.aspose.cloud/v3.0/cells/test.xlsx/worksheets/Sheet1/cells/rows/copy?sourceRowIndex=1&destinationRowIndex=12&rowNumber=10" \
-X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-H "Authorization: Bearer <jwt token>"
ملاحظة
استبدل<jwt token>برمز JWT صالح تم الحصول عليه من خدمة المصادقة.
الاستجابة الناجحة
| الرمز | الوصف |
|---|---|
| 200 | تم نسخ الصفوف بنجاح. |
{
"Code": 200,
"Status": "OK"
}
يحتوي جسم الاستجابة على مثيل من CellsCloudResponse.
معالجة الأخطاء
| رمز HTTP | المعنى | مثال على جسم الاستجابة |
|---|---|---|
| 400 | طلب غير صالح – معلمات مفقودة أو غير صحيحة. | { "Code": 400, "Message": "Invalid sourceRowIndex." } |
| 401 | غير مصادق عليه – رمز JWT غير صالح أو مفقود. | { "Code": 401, "Message": "Authentication failed." } |
| 404 | غير موجود – المصنف أو ورقة العمل غير موجودين. | { "Code": 404, "Message": "File not found." } |
| 500 | خطأ داخلي في الخادم – حالة غير متوقعة في الخادم. | { "Code": 500, "Message": "An unexpected error occurred." } |
إرشادات المعالجة
- 400 – تحقق من وجود جميع معلمات الاستعلام المطلوبة وصحتها.
- 401 – أعد توليد أو حدّث رمز JWT.
- 404 – تأكد من أسماء المصنف وورقة العمل، وتحقق من وجود الملف في المجلد/التخزين المحدَّد.
- 500 – أعد المحاولة بعد تأخير قصير؛ إن استمرت المشكلة، تواصل مع دعم Aspose.
أمثلة باستخدام SDKs
توضح المقاطع التالية كيفية استدعاء عملية نسخ الصفوف باستخدام SDKs الرسمية لـ Aspose.Cells Cloud.
| اللغة | المثال |
|---|---|
| C# | عرض الكودcsharp\nusing Aspose.Cells.Cloud.SDK.Api;\nusing Aspose.Cells.Cloud.SDK.Model;\n\nvar api = new CellsApi("clientId", "clientSecret");\nawait api.PostCopyWorksheetRowsAsync(name: "test.xlsx", sheetName: "Sheet1", sourceRowIndex: 1, destinationRowIndex: 12, rowNumber: 10);\n |
| Java | عرض الكودjava\nCellsApi api = new CellsApi("clientId", "clientSecret");\napi.postCopyWorksheetRows("test.xlsx", "Sheet1", 1, 12, 10, null, null, null);\n |
| Python | عرض الكودpython\nfrom asposecellscloud import CellsApi\napi = CellsApi(client_id='clientId', client_secret='clientSecret')\napi.post_copy_worksheet_rows(name='test.xlsx', sheet_name='Sheet1', source_row_index=1, destination_row_index=12, row_number=10)\n |
| Node.js | عرض الكودjavascript\nconst { CellsApi } = require('asposecellscloud');\nconst api = new CellsApi('clientId', 'clientSecret');\nawait api.postCopyWorksheetRows('test.xlsx', 'Sheet1', 1, 12, 10);\n |
| Go | عرض الكودgo\nimport \"github.com/asposecellscloud/aspose-cells-cloud-go/v3\"\napi := cells.NewCellsApiClient("clientId", "clientSecret")\n_, err := api.PostCopyWorksheetRows(context.Background(), "test.xlsx", "Sheet1", 1, 12, 10, nil, nil, nil)\n |
| PHP | عرض الكودphp\nuse Aspose\Cells\CellsApi;\n$api = new CellsApi('clientId', 'clientSecret');\n$api->postCopyWorksheetRows('test.xlsx', 'Sheet1', 1, 12, 10);\n |
| Ruby | عرض الكودruby\nrequire 'aspose_cells_cloud'\napi = AsposeCellsCloud::CellsApi.new('clientId', 'clientSecret')\napi.post_copy_worksheet_rows('test.xlsx', 'Sheet1', 1, 12, 10)\n |
| Perl | عرض الكودperl\nuse Aspose::Cells::CellsApi;\nmy $api = Aspose::Cells::CellsApi->new('clientId', 'clientSecret');\n$api->postCopyWorksheetRows(name => 'test.xlsx', sheetName => 'Sheet1', sourceRowIndex => 1, destinationRowIndex => 12, rowNumber => 10);\n |
تتوفر ملفات المصدر الكاملة في مستودع Aspose‑Cells‑Cloud على GitHub.
انظر أيضًا
تم إنشاء هذه الصفحة في {{DATE}}. للحصول على أحدث إصدار من هذه الواجهة، راجع مواصفات OpenAPI.