فتح دفعّة

تقوم هذه الواجهة البرمجية لواجهة REST بفتح ملفات Excel المؤهلة دفعة واحدة.

واجهة REST

POST http://api.aspose.cloud/v3.0/cells/batch/unlock

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

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

معاملات الطلب

اسم المعامل	النوع	الموقع	الوصف
BatchLockRequest		body	جسم الطلب الذي يحتوي على إعدادات الفتح.

خصائص BatchLockRequest

الاسم	النوع	الوصف	الملاحظات
SourceFolder	string	المجلد الذي يحتوي على ملفات Excel المصدر.	[اختياري]
MatchCondition	MatchConditionRequest	المعايير المستخدمة لتحديد الملفات المراد فتحها.	[اختياري]
Password	string	كلمة المرور المطبّقة على المصنفات المحمية.	[اختياري]
OutFolder	string	المجلد الوجهة للملفات المُفتَحة.	[اختياري]

خصائص MatchConditionRequest

الاسم	النوع	الوصف	الملاحظات
RegexPattern	string	التعبير النمطي لتطابق أسماء الملفات.	[اختياري]
FullMatchConditions	string[]	شروط أسماء الملفات الدقيقة المطلوب تطابقها.	[اختياري]

معامل جسم الطلب

اسم المعامل	النوع	الوصف
data	file	المحتوى الثنائي لملف المصنف المراد إنشاؤه.

الاستجابة

{
    "Name": "ResponseFile",
    "DataType": {
        "Identifier": "File",
        "Reference": "Stream",
        "Name": "file"
    }
}

رموز حالة HTTP

الرمز	المعنى	وقت الإرجاع
200 OK	تم إنشاء المصنف بنجاح	في السير الاعتيادي
201 Created	تم إنشاء المصنف (استجابة بديلة)	عندما تُعيد الواجهة البرمجية حالة الإنشاء
400 Bad Request	معاملات غير صالحة	خطأ من جانب العميل
401 Unauthorized	رمز مفقود أو غير صالح	خطأ في المصادقة
409 Conflict	الملف موجود و`isWriteOver=false`	تضارب مع ملف موجود

كيفية استخدام واجزة PostBatchLock API باستخدام SDKs

مواصفات واجهة PostBatchLock API

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

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

Request

curl -v "http://api.aspose.cloud/v3.0/cells/batch/unlock" \
  -X POST \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <jwt token>" \
  -d '{"SourceFolder":"CellsTests","OutFolder":"Output","MatchCondition":{"RegexPattern":"(^Book)(.+)(xlsx$)"},"Password":"123456"}'

Response

{
  "Code": 200,
  "Status": "OK"
}

استخدام Aspose.Cells Cloud SDKs

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

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