كيفية نقل أوراق العمل في إكسل – إعادة ترتيب ترتيب الأوراق والمواقع
انقل أوراق العمل برمجيًا داخل ملفات عمل إكسل باستخدام واجهة Aspose.Cells Cloud API. غيّر مواقع الأوراق، وأعد ترتيب علامات التبويب، وحسّن هيكل ملف العمل عبر مكالمات API عبر REST. مثالية لأتمتة تنظيم الجداول وإنشاء تخطيطات قياسية لملفات العمل.
نقل ورقة من واجهة جدول البيانات
واجهة الويب
PUT http://api.aspose.cloud/v4.0/cells/spreadsheet/move/worksheet?sheetName={sheetName}&position={position}&outPath={outPath}&outStorageName={outStorageName}®ion={region}&password={password}
الأمان والمصادقة
توفّر واجهات Aspose.Cells Cloud API أمانًا وتتطلب مصادقة مبنية على رمز JWT.
-H "Authorization: Bearer {access_token}"
معلَمات الطلب:
| اسم المعلَمة | النوع | المسار/سلسلة الاستعلام/جسم الطلب HTTP | الوصف |
|---|---|---|---|
| Spreadsheet | ملف | FormData | مطلوبة. ملف ملف عمل إكسل المصدر (.xlsx، .xls، إلخ) الذي يحتوي على الورقة التي سيتم إعادة تحديد موضعها. |
| worksheet | سلسلة | استعلام | مطلوبة. الاسم الدقيق لورقة العمل التي سيتم نقلها (مثل Summary، RawData_2024). |
| position | عدد صحيح | استعلام | مطلوبة. المؤشر الجديد (مبني على الصفر) لموقع الورقة. مثلاً، ينقل 0 الورقة إلى الموضع الأول، وينقل 2 الورقة لتكون الورقة الثالثة. |
| outPath | سلسلة | استعلام | اختيارية. مسار المجلد الوجهة في التخزين السحابي حيث سيتم حفظ ملف العمل بعد إعادة ترتيبه. إذا كانت null أو مُهملة، تُستخدم افتراضيًا مجلد الملف الأصلي. |
| outStorageName | سلسلة | استعلام | مطلوبة. اسم خدمة التخزين السحابي المُعدّ مسبقًا (مثل TeamDrive) التي سيتم حفظ الملف الناتج فيها. |
| region | سلسلة | استعلام | اختيارية. إعداد اللغة المحلية (مثل es-MX) الذي سيتم تطبيقه، وقد يؤثر على بعض قواعد التنسيق أثناء عملية الحفظ. |
| password | سلسلة | استعلام | اختيارية. كلمة المرور المطلوبة لفك تشفير ملف عمل محمي بكلمة مرور وتعديله. اتركها فارغة إذا لم يكن الملف مشفرًا. |
الاستجابة
[
{
"Name": "ResponseFile",
"DataType": {
"Identifier": "File",
"Reference": "Stream"
}
}
]
رموز حالة HTTP
| الرمز | المعنى | الوصف |
|---|---|---|
| 200 | ناجح | تم تطبيق الفلتر بنجاح؛ تحتوي الاستجابة على تفاصيل العملية. |
| 400 | طلب غير صحيح | معلمات ناقصة أو غير صالحة (مثل نوع ملف غير مدعوم). |
| 401 | غير مصرّح به | رمز JWT غير صالح أو ناقص. |
| 413 | حجم الحمولة كبير جدًا | حجم الملف المرفوع يتجاوز الحد المسموح به. |
| 500 | خطأ داخلي في الخادم | خطأ غير متوقع في الخادم. |
أين نستخدم واجهة نقل ورقة في جدول البيانات؟
- توليد تقارير معيارية: بعد توليد التقارير الشهرية أو الفصلية تلقائيًا، تُنقل ورقة العمل
SummaryأوExecutive Overviewإلى أعلى ملف العمل لضمان عرض الاستنتاجات الأساسية فور فتح الملف. - خط أنابيب معالجة البيانات: بعد معالجة أوراق البيانات الخام من مصادر بيانات مختلفة في عملية ETL، تُنقل ورقة
Processed_Dataالتي تم تنظيفها وتحويلها إلى موضع منطقي في ملف العمل (مثل الموضع الأوسط)، مما يخلق هيكلًا واضحًا للعملية مع البيانات الأصلية ونتائج التحليل. - توصيل ملفات مخصصة للمستخدم: بعد اختيار المستخدم تخطيطًا مفضّلًا عبر واجهة تكوين (مثل وضع صفحة الرسم البياني في الأعلى)، يعيد النظام تلقائيًا ترتيب ترتيب أوراق العمل داخل ملف العمل وفقًا للاختيار، ثم يُوصّل الملف المخصص.
لماذا يجب عليك استخدام واجهة نقل ورقة في جدول البيانات؟
- سهلة للمطورين: توفر Aspose.Cells Cloud مكتبات SDK بلغات متعددة، مما يُمكّن من تطوير سريع ويتضمّن وثائق شاملة. مقارنةً ببناء حلول مخصصة، تقلّل هذه المكتبات بشكل كبير من حجم العمل التطويري.
- خفض تكاليف العمالة: تقلل الحاجة إلى الموظفين المخصصين لدمج الوثائق.
- الدفع حسب الاستخدام: لا توجد استثمارات أولية؛ تدفع فقط مقابل مكالمات API التي تستخدمها فعليًا.
- لا تكاليف صيانة: لا حاجة لصيانة الخوادم، أو تحديث البرمجيات، أو التعامل مع مشكلات التوافق.
كيفية استخدام واجهة نقل ورقة في جدول البيانات مع SDKs
مواصفات واجهة نقل ورقة في جدول البيانات
توفر مواصفات واجهة نقل ورقة في جدول البيانات واجهة برمجة تطبيقات متاحة للعامة لتسهيل التفاعل المباشر مع REST من متصفح الويب.
يمكنك استخدام أداة سطر الأوامر cURL للوصول إلى خدمات Aspose.Cells عبر الويب بسهولة. يوضح المثال التالي كيفية إجراء مكالمات إلى Cloud API باستخدام cURL.
استخدام مكتبات Aspose.Cells Cloud SDKs
استخدام SDKs هو أسرع طريقة للتطوير، حيث تُجرّدك من التفاصيل منخفضة المستوى، مما يتيح لك نقل أوراق العمل في جدول البيانات باستخدام كود مختصر. يُرجى الاطلاع على مستودع GitHub للحصول على قائمة كاملة بمكتبات Aspose.Cells Cloud SDKs.
توضح أمثلة الكود التالية كيفية استدعاء خدمات Aspose.Cells عبر الويب باستخدام مكتبات SDK المختلفة: