كيفية إنشاء جداول بيانات Excel جديدة – توليد ملفات فارغة أو مبنية على قوالب
قم بإنشاء جداول بيانات Excel جديدة برمجيًا باستخدام API Aspose.Cells Cloud. قم بتوليد كتب عمل فارغة أو أنشئ ملفات من قوالب مخصصة. تتيح واجهة RESTful إنشاء ملفات Excel تلقائيًا، وهي مثالية لعملية إنشاء التقارير، وأتمتة المستندات، وسير عمل معالجة البيانات.
API إنشاء جدول بيانات
واجهة الويب API
PUT https://api.aspose.cloud/v4.0/cells/spreadsheet/create
الأمان والمصادقة
واجهات برمجة تطبيقات Aspose.Cells Cloud آمنة وتتطلب مصادقة مبنية على رمز JWT.
مُعاملات الطلب
| اسم المُعامل | النوع | الموقع | الوصف |
|---|---|---|---|
| format | نص (String) | استعلام (Query) | إلزامي. تنسيق الملف للجدول الجديد (مثل: XLSX، XLS، ODS، CSV). |
| template | نص (String) | استعلام (Query) | اختياري. اسم ملف قالب مخزن في مساحة التخزين السحابية الخاصة بك (مثل: invoice_template.xlsx). إذا تُرك فارغًا، فسيتم إنشاء كتاب عمل فارغ. |
| outPath | نص (String) | استعلام (Query) | اختياري. مسار المجلد المستهدف في مساحة التخزين السحابية لحفظ الملف المُولّد. إذا كان null أو مُهمَلًا، فسيُحفظ الجدول في الموقع الافتراضي. |
| outStorageName | نص (String) | استعلام (Query) | إلزامي. مُعرّف مساحة التخزين السحابية المُعدّة مسبقًا (مثل: MyDrive). |
| region | نص (String) | استعلام (Query) | اختياري. إعداد الإقليم (مثل: fr-FR) الذي يُحدّد تنسيقات التواريخ والأرقام والعملات الافتراضية. |
| password | نص (String) | استعلام (Query) | اختياري. كلمة المرور لملف القالب المشفر. اتركه فارغًا إذا لم يكن القالب محميًا. |
الاستجابة
[
{
"Name": "ResponseFile",
"DataType": {
"Identifier": "File",
"Reference": "Stream"
}
}
]
رموز حالة HTTP
| الرمز | المعنى | الوصف |
|---|---|---|
| 200 | ناجح (OK) | تم تطبيق الفلتر بنجاح؛ تحتوي الاستجابة على تفاصيل العملية. |
| 400 | طلب غير صالح (Bad Request) | مُعطَلات ناقصة أو غير صالحة (مثل: نوع ملف غير مدعوم). |
| 401 | غير مصادَق (Unauthorized) | رمز JWT غير صالح أو مفقود. |
| 413 | حجم الحمولة كبير جدًا (Payload Too Large) | تجاوز حجم الملف المرفوع الحد المسموح. |
| 500 | خطأ داخلي في الخادم (Internal Server Error) | خطأ غير متوقع في الخادم. |
أين يجب استخدام API إنشاء جدول البيانات؟
- تهيئة نظام إنشاء التقارير الآلي – قم بإنشاء كتاب عمل فارغ جديد أو أنشئ ملف تقرير من قالب قياسي عند بداية كل دورة أتمتة يومية/أسبوعية.
- بوابة الخدمة الذاتية للمستخدمين – اسمح للعملاء باختيار قالب (عرض أسعار، جدول زمني للمشروع، إلخ) وتنزيل ملف Excel مُخصّص فورًا.
- تصدير وتوزيع البيانات دفعة واحدة – أنشئ كتب عمل منفصلة بتنسيق موحّد لكل مجموعة بيانات مُصدَّرة، مما يبسّط التوزيع والمعالجة اللاحقة.
لعمليات لاحقة مثل إضافة أوراق عمل أو ملء الخلايا، راجع API إضافة ورقة عمل، API تحديث الخلية، وAPI تصدير كتاب العمل.
لماذا يجب استخدام API إنشاء جدول البيانات؟
- سهل الاستخدام للمطورين – يوفّر مكتبات SDK لعدة لغات ووثائق موسّعة، مما يبسّط التكامل مقارنةً ببناء حلول مخصصة.
- كفاءة العمالة – يتيح أتمتة دمج المستندات، مما يقلل الجهد اليدوي.
- نظام الدفع حسب الاستخدام – تستند الرسوم إلى استخدام API دون رسوم ترخيص مقدمة.
- خدمة مُدارة – يتم استضافة API بالكامل، ما يلغي الحاجة لصيانة الخوادم المحلية أو تحديثات البرامج.
كيفية استخدام API إنشاء جدول البيانات باستخدام SDKs
مواصفات API إنشاء جدول البيانات
تُعرّف مواصفات API إنشاء جدول البيانات واجهة برمجة تطبيقات قابلة للوصول العام، وتتيح التفاعل عبر REST مباشرةً من متصفح ويب.
يمكنك استخدام أداة سطر الأوامر cURL للوصول إلى خدمات ويب Aspose.Cells بسهولة. يُظهر المثال التالي كيفية إجراء مكالمات إلى واجهة برمجة التطبيقات السحابية باستخدام cURL.
استخدام SDKs لـ Aspose.Cells Cloud
استخدام SDK هو أسرع طريقة للتطوير، حيث يُجرّد التفاصيل من المستوى المنخفض ويسمح لك بإنشاء جدول البيانات باستخدام كود مختصر. يُرجى الاطّلاع على مستودع GitHub للحصول على قائمة كاملة بـ SDKs الخاصة بـ Aspose.Cells Cloud.
تُظهر أمثلة الكود التالية كيفية استدعاء خدمات ويب Aspose.Cells باستخدام SDKs مختلفة: