كيفية تقسيم ملف Excel إلى ملفات متعددة باستخدام واجهة Aspose.Cells Cloud API

تقوم هذه الواجهة (REST API) بتقسيم مصنف Excel إلى ملفات متعددة بصيغ مختلفة.

المتطلبات الأساسية – لاستخدام هذه الواجهة، يجب الحصول على رمز JWT صالح، والتأكد من استخدام إصدار مدعوم من SDK، وتحقق من أن مصنفك مخزن في موقع تخزين مدعوم. كما تفرض الواجهة حدودًا لحجم الملفات مُوثَّقة في إرشادات المنصة.

واجهة PostWorkbookSplit

PUT https://api.aspose.cloud/v3.0/cells/{name}/split

الأمان والمصادقة

تُعتبر واجهات Aspose.Cells Cloud آمنة وتتطلب مصادقة تعتمد على رمز JWT.

معلمات الطلب

اسم المعلمة النوع الموقع الوصف إلزامي
files[] ملف formData ملف Excel واحد أو أكثر لـ تقسيمه. استخدم file1, file2, … في الطلب. نعم
format سلسلة Query الصيغة المطلوبة للملفات الناتجة بعد التقسيم. لا
from عدد صحيح Query فهرس ورقة العمل الابتدائي. لا
to عدد صحيح Query فهرس ورقة العمل النهائي. لا
horizontalResolution عدد صحيح Query الدقة الأفقية للصورة. لا
verticalResolution عدد صحيح Query الدقة العمودية للصورة. لا
outFolder سلسلة Query المجلد الذي ستُخزَّن فيه الملفات المُقسَّمة. لا
splitNameRule سلسلة Query قاعدة تسمية الملفات المُقسَّمة. لا
folder سلسلة Query المجلد الذي يحتوي على المصنف الأصلي. لا
storageName سلسلة Query اسم مساحة التخزين المراد استخدامها. لا

الاستجابة

{
    "Status":"OK",
    "Code":200,
    "Files": [
      {
        "Filename" : "[اسم الملف1]",
        "Filesize" : [حجم الملف],
        "FileContent" : "[Base64String]"
      },
      {
        "Filename" : "[اسم الملف2]",
        "Filesize" : [حجم الملف],
        "FileContent" : "[Base64String]"
      },
      {
        "Filename" : "[اسم الملف3]",
        "Filesize" : [حجم الملف],
        "FileContent" : "[Base64String]"
      }
    ]
}

رموز حالة HTTP

الكود المعنى الوصف
200 ناجح (OK) تطبيق الفلتر بنجاح؛ تحتوي الاستجابة على تفاصيل العملية.
400 طلب غير صالح (Bad Request) معلمات ناقصة أو غير صالحة (مثل نوع ملف غير مدعوم).
401 غير مصرّح (Unauthorized) رمز JWT غير صالح أو مفقود.
413 حمل البيانات كبير جدًا (Payload Too Large) تجاوز حجم الملف المرفوع الحد المسموح به.
500 خطأ داخلي في الخادم (Internal Server Error) خطأ غير متوقع في الخادم.

كيفية استخدام واجهة PostWorkbookSplit باستخدام SDKs

مواصفات واجهة PostWorkbookSplit

تُعرّف مواصفات OpenAPI واجهة برمجة تطبيقات عامة قابلة للوصول، وتتيح إجراء تفاعلات REST مباشرة من متصفح الويب.

يمكنك استخدام أداة سطر الأوامر cURL للوصول إلى خدمات Aspose.Cells بسهولة. يوضح المثال التالي كيفية إجراء مكالمات لواجهة Cloud API باستخدام cURL.

استخدام SDKs الخاصة بـ Aspose.Cells Cloud

يُعد استخدام SDKs أفضل طريقة لتسريع عملية التطوير، إذ تقوم SDKs بإدارة التفاصيل منخفضة المستوى، مما يتيح لك التركيز على مهام مشروعك. يُرجى مراجعة مستودع GitHub للاطلاع على قائمة كاملة بـ SDKs الخاصة بـ Aspose.Cells Cloud.

تُظهر أمثلة الكود التالية كيفية إجراء مكالمات لخدمات Aspose.Cells باستخدام SDKs مختلفة:

دمج مصنف Excel داخل مصنف آخر