ملف طلب الدعم في واجهة برمجة تطبيقات المهام في Aspose.Cells

واجهة برمجة تطبيقات REST

واجهة برمجة التطبيقات	النوع	الوصف	رابط المورد
/cells/task/runtask	POST	تشغيل المهمة	PostRunTask

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

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

المعلَمة	النوع	مطلوبة	الوصف
TaskDescription	كائن	نعم	حاوية لتعريف مهمة واحدة.
TaskType	سلسلة نصية	نعم	نوع المهمة، مثل `ImportData` أو `SaveResult`.
Workbook.FileSourceType	سلسلة نصية	نعم	مصدر ملف ملف العمل (`CloudFileSystem` أو `InMemoryFiles`).
Workbook.FilePath	سلسلة نصية	نعم	مسار ملف ملف العمل في المصدر المُحدَّد.
ImportBatchDataOption.DestinationWorksheet	سلسلة نصية	نعم	اسم ورقة العمل الهدف لاستيراد البيانات.
ImportBatchDataOption.IsInsert	منطقي	نعم	ما إذا كانت الصفوف ستُدرج (`true`) أم تُستبدَل (`false`).
ImportBatchDataOption.Source.FileSourceType	سلسلة نصية	نعم	مصدر ملف الطلب (`RequestFiles`).
ImportBatchDataOption.Source.FilePath	سلسلة نصية	نعم	مسار ملف الطلب الذي يحتوي على البيانات المجمعة.
SaveResultTaskParameter.ResultSource	سلسلة نصية	نعم	مصدر ملف النتيجة (`InMemoryFiles`).
SaveResultTaskParameter.ResultDestination.DestinationType	سلسلة نصية	نعم	نوع الوجهة لملف النتيجة (`CloudFileSystem`).
SaveResultTaskParameter.ResultDestination.InputFile	سلسلة نصية	نعم	اسم ملف ملف العمل المدخل.
SaveResultTaskParameter.ResultDestination.OutputFile	سلسلة نصية	نعم	اسم ملف الإخراج المطلوب.

الاستجابة

الحقل	النوع	الوصف
Code	عدد صحيح	رمز حالة HTTP (مثل 200 للنجاح).
Status	سلسلة نصية	حالة العملية (`OK` أو رسالة خطأ).
Result	كائن	تفاصيل تنفيذ المهمة، بما في ذلك أي ملفات تم إنشاؤها.

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

الطلب

curl -X POST "https://api.aspose.cloud/v3.0/cells/task/runtask" \
  -H "accept: application/json" \
  -H "Content-Type: application/json" \
  -H "x-aspose-client: Containerize.Swagger" \
  -d '{
    "Tasks": [
      {
        "TaskDescription": {
          "TaskType": "ImportData",
          "ImportDataTaskParameter": {
            "Workbook": {
              "FileSourceType": "CloudFileSystem",
              "FilePath": "TaskBook.xlsx"
            },
            "ImportBatchDataOption": {
              "DestinationWorksheet": "Sheet1",
              "IsInsert": true,
              "Source": {
                "FileSourceType": "RequestFiles",
                "FilePath": "Batch_data_xml.txt"
              }
            }
          }
        }
      },
      {
        "TaskDescription": {
          "TaskType": "ImportData",
          "ImportDataTaskParameter": {
            "Workbook": {
              "FileSourceType": "InMemoryFiles",
              "FilePath": "TaskBook.xlsx"
            },
            "ImportBatchDataOption": {
              "DestinationWorksheet": "Sheet2",
              "IsInsert": true,
              "Source": {
                "FileSourceType": "RequestFiles",
                "FilePath": "Batch_data_xml_2.txt"
              }
            }
          }
        }
      },
      {
        "TaskDescription": {
          "TaskType": "SaveResult",
          "SaveResultTaskParameter": {
            "ResultSource": "InMemoryFiles",
            "ResultDestination": {
              "DestinationType": "CloudFileSystem",
              "InputFile": "TaskBook.xlsx",
              "OutputFile": "ImpDataBook.xlsx"
            }
          }
        }
      }
    ]
  }'

الاستجابة

{
  "Code": 200,
  "Status": "OK",
  "Result": {
    "GeneratedFiles": [
      {
        "FilePath": "ImpDataBook.xlsx",
        "FileUrl": "https://api.aspose.cloud/v3.0/cells/storage/file/ImpDataBook.xlsx"
      }
    ]
  }
}

لمزيد من المعلومات حول المهام ذات الصلة، راجع صفحات مهمة ImportData و مهمة SaveResult.

عائلة SDK السحابية

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

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

واجهة برمجة تطبيقات Aspose.Cells Cloud – العمل مع مهمة CellsObjectOperate (REST)