تحويل دفعات من ملفات إكسل
تتيح هذه الواجهة البرمجية لواجهة REST التحويل الدفعي للملفات المؤهلة.
واجهة REST
POST http://api.aspose.cloud/v3.0/cells/batch/convert
الأمان والمصادقة
واجهات برمجة تطبيقات Aspose.Cells Cloud آمنة وتتطلب مصادقة تعتمد على رمز JWT.
معلمات الطلب
| اسم المعلمة | النوع | الموقع | الوصف |
|---|---|---|---|
| batchConvertRequest | كائن | الجسم | جسم الطلب الذي يحتوي على إعدادات التحويل. |
خصائص BatchConvertRequest
| الاسم | النوع | الوصف | الملاحظات |
|---|---|---|---|
| SourceFolder | سلسلة نصية | مسار المجلد الذي يحتوي على ملفات إكسل المصدر. | [اختياري] |
| MatchCondition | MatchConditionRequest | الشروط المستخدمة لاختيار الملفات للتحويل. | [اختياري] |
| Format | سلسلة نصية | التنسيق الهدف للتحويل (مثل pdf، csv). |
[اختياري] |
| OutFolder | سلسلة نصية | المجلد الوجهة التي سيتم حفظ الملفات المحولة فيها. | [اختياري] |
| SaveOptions | SaveOptions | خيارات إضافية تتحكم في كيفية حفظ الملفات. | [اختياري] |
خصائص MatchConditionRequest
| الاسم | النوع | الوصف | الملاحظات |
|---|---|---|---|
| RegexPattern | سلسلة نصية | التعبير النمطي المستخدم لتصفية أسماء الملفات. | [اختياري] |
| FullMatchConditions | سلسلة نصية[] | قائمة بشروط أسماء الملفات الدقيقة للمطابقة. | [اختياري] |
معلمة جسم الطلب
| اسم المعلمة | النوع | الوصف |
|---|---|---|
| data | ملف | المحتوى الثنائي لملف كشف العمل المطلوب إنشاؤه. |
الاستجابة
{
"Name": "ResponseFile",
"DataType": {
"Identifier": "File",
"Reference": "Stream",
"Name": "file"
}
}
رموز حالة HTTP
| الرمز | المعنى | متى يتم الإرجاع |
|---|---|---|
| 200 OK | تم إنشاء ملف كشف العمل بنجاح | التدفق الطبيعي |
| 201 Created | تم إنشاء ملف كشف العمل (استجابة بديلة) | عندما تُرجع الواجهة البرمجية حالة “تم الإنشاء” |
| 400 Bad Request | معلمات غير صالحة | خطأ من جانب العميل |
| 401 Unauthorized | رمز مفقود أو غير صالح | خطأ في المصادقة |
| 409 Conflict | الملف موجود وقيمة isWriteOver=false |
تضارب مع ملف موجود |
كيفية استخدام واجهة PostBatchConvert مع وحدات SDK
مواصفات واجهة PostBatchConvert
تُعرّف مواصفات OpenAPI واجهة برمجة تطبيقات متاحة عمومًا وتتيح لك إجراء تفاعلات REST مباشرة من خلال متصفح ويب.
يمكنك استخدام أداة سطر الأوامر cURL للوصول بسهولة إلى خدمات الويب الخاصة بـ Aspose.Cells. يُظهر المثال التالي كيفية إجراء المكالمات إلى واجهة Cloud API باستخدام cURL.
استخدام وحدات SDK الخاصة بـ Aspose.Cells Cloud
استخدام وحدة SDK هو أفضل طريقة لتسريع عملية التطوير. تتعامل وحدة SDK مع التفاصيل منخفضة المستوى وتسمح لك بالتركيز على مهام مشروعك. يُرجى الاطّلاع على مستودع GitHub للحصول على قائمة كاملة بوحدات SDK الخاصة بـ Aspose.Cells Cloud.
تُظهر أمثلة الكود التالية كيفية إجراء المكالمات إلى خدمات الويب الخاصة بـ Aspose.Cells باستخدام وحدات SDK متنوعة: