معالجة بيانات جداول البيانات – الدمج والتقسيم والاستيراد

Aspose.Cells Cloud – خدمة قائمة على REST تتيح التعامل البرمجي مع ملفات Excel في السحابة. وهي تدعم استيراد البيانات من تنسيقات متعددة، ودمج كتب العمل، وتقسيم جداول البيانات الكبيرة.

يتيح لك قسم معالجة البيانات في واجهة برمجة تطبيقات Aspose.Cells Cloud استيراد بيانات جداول البيانات ودمجها وتقسيمها برمجيًا. استخدم النقاط النهائية (Endpoints) التالية للتعامل مع استيرادات CSV/JSON، ودمج كتب العمل، أو تقسيم الملفات الكبيرة إلى قطع أصغر سهلاً.

استيراد البيانات وإدارتها

استيراد بيانات CSV وJSON وXML إلى ملفات Excel

تتلقى عملية الاستيراد محتوى بصيغة CSV أو JSON أو XML، ثم تُنشئ ورقة عمل جديدة (أو تحدّث ورقة موجودة مسبقًا) داخل كتاب العمل المستهدف.

تفاصيل نقطة النهاية (Endpoint)

طريقة HTTP	نقطة النهاية	جسم الطلب	استجابة ناجحة
POST	`https://api.aspose.cloud/v3.0/cells/{fileName}/import`	`application/json` أو `text/csv` (حسب التنسيق)	`200 OK` مع ملف JSON يحتوي على بيانات تعريف كتاب العمل المُحدَّث
GET	`https://api.aspose.cloud/v3.0/cells/{fileName}?format=excel`	لا شيء	يُعيد ملف كتاب العمل الذي تمت معالجته

طلب cURL نموذجي (استيراد CSV)

curl -X POST "https://api.aspose.cloud/v3.0/cells/MyWorkbook.xlsx/import" \
     -H "Authorization: Bearer {access_token}" \
     -H "Content-Type: text/csv" \
     --data-binary @data.csv

استجابة JSON نموذجية

{
  "Code": 200,
  "Status": "OK",
  "Workbook": {
    "FileName": "MyWorkbook.xlsx",
    "Worksheets": 3
  }
}

المتطلبات المسبقة: يلزم وجود رمز وصول OAuth2. يجب أن يكون الملف المصدر موجودًا في مساحة تخزين Aspose Cloud أو يُزوَّد عبر تحميل متعدد الأجزاء (multipart upload).

عملية دمج الملفات

تقوم عملية الدمج بدمج كتابي عمل أو أكثر في كتاب عمل واحد مستهدف. وتُدعم في واجهة برمجة التطبيقات قوائم الملفات الصريحة، بالإضافة إلى عمليات الدمج المبنية على الأنماط داخل مجلد التخزين.

تفاصيل نقطة النهاية (Endpoint)

طريقة HTTP	نقطة النهاية	المُعطيات (Parameters)	استجابة ناجحة
POST	`https://api.aspose.cloud/v3.0/cells/merge`	`files` (مصفوفة لأسماء الملفات)، `target` (اسم كتاب العمل المستهدف اختياريًا)	`200 OK` مع ملف JSON يصف كتاب العمل المدمج
POST	`https://api.aspose.cloud/v3.0/cells/merge/remote`	`sourceFolder`، `pattern`، `target`	`200 OK` مع بيانات تعريف كتاب العمل المدمج

طلب cURL نموذجي (دمج قائمة صريحة)

curl -X POST "https://api.aspose.cloud/v3.0/cells/merge" \
     -H "Authorization: Bearer {access_token}" \
     -H "Content-Type: application/json" \
     -d '{
           "files": ["Book1.xlsx", "Book2.xlsx"],
           "target": "Combined.xlsx"
         }'

استجابة JSON نموذجية

{
  "Code": 200,
  "Status": "OK",
  "MergedWorkbook": {
    "FileName": "Combined.xlsx",
    "Worksheets": 10
  }
}

المتطلبات المسبقة: يجب أن تكون جميع كتب العمل المصدر مخزنة في نفس موقع مساحة التخزين السحابية، وأن يمتلك المستخدم المُنفِّذ صلاحيات قراءة/كتابة.

عملية تقسيم الملفات

تستخرج عملية التقسيم أوراق عمل فردية أو مجموعات من الصفوف/الأعمدة إلى ملفات كتب عمل منفصلة.

تفاصيل نقطة النهاية (Endpoint)

طريقة HTTP	نقطة النهاية	المُعطيات (Parameters)	استجابة ناجحة
POST	`https://api.aspose.cloud/v3.0/cells/{fileName}/split`	`splitBy` (مثلًا: `worksheet`)، `outputFolder`	`200 OK` مع قائمة روابط الملفات المُولَّدة
POST	`https://api.aspose.cloud/v3.0/cells/{fileName}/split/custom`	JSON للقاعدة المخصصة (حجم الصفحة، نطاق الصفوف، إلخ)	`200 OK` مع تفاصيل الملفات المُقسَّمة

طلب cURL نموذجي (تقسيم حسب ورقة العمل)

curl -X POST "https://api.aspose.cloud/v3.0/cells/BigReport.xlsx/split" \
     -H "Authorization: Bearer {access_token}" \
     -H "Content-Type: application/json" \
     -d '{
           "splitBy": "worksheet",
           "outputFolder": "Splits/"
         }'

استجابة JSON نموذجية

{
  "Code": 200,
  "Status": "OK",
  "Splits": [
    {"FileName": "BigReport_Sheet1.xlsx", "Url": "https://storage.aspose.cloud/..."},
    {"FileName": "BigReport_Sheet2.xlsx", "Url": "https://storage.aspose.cloud/..."}
  ]
}

المتطلبات المسبقة: يجب أن يكون كتاب العمل المصدر متاحًا في مساحة تخزين Aspose Cloud، وأن يمتلك المستخدم المُنفِّذ صلاحية الكتابة في المجلد الوجهة.

واجهة برمجة تطبيقات Aspose.Cells Cloud – إدارة الأوراق، الضغط وإنشاء ملفات عمل Excel