استيراد مصفوفة سلاسل نصية إلى ورقة عمل إكسل – Aspose.Cells Cloud

استيراد مصفوفة سلاسل نصية إلى ورقة عمل إكسل هو مهمة شائعة عند ملء الجداول ببيانات قائمة مُنظمة. وتُعد هذه العملية مفيدة في سيناريوهات مثل تحميل قيم الإعدادات، أو نقل البيانات من مصادر خارجية، أو تهيئة ورقات العمل بمجموعات محددة مسبقًا من السلاسل النصية.

المتطلبات المسبقة:

  • رمز JWT صالح تم الحصول عليه عبر عملية المصادقة في Aspose.Cells Cloud.
  • ملف عمل موجود (أو القدرة على إنشاء واحد) في مساحة التخزين الخاصة بك في Aspose Cloud.
  • إصدار SDK المناسب الذي يدعم نموذج ImportStringArrayOption.

تقوم هذه واجهة برمجة التطبيقات (REST API) باستيراد بيانات مصفوفة سلاسل نصية إلى ورقة عمل إكسل.

واجهة PostImportData API

POST https://api.aspose.cloud/v3.0/cells/import

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

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

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

يستخدم الطلب محتوى HTTP متعدد الأجزاء (multipart) (انظر RFC 2046 أو RFC 1341).
يحتوي الجزء الأول من جسم الطلب المتعدد على حمولة ImportStringArrayOption؛ ويحتوي الجزء الثاني على ملف بيانات المصدر.

تُوضّح الجدول التالي المعاملات المهمة:

معاملات ImportStringArrayOption ### **ImportStringArrayOption**
اسم المعاملة النوع الوصف
FirstRow int فهرس الصف الابتدائي (مبنِي على 1) حيث سيتم وضع البيانات.
FirstColumn int فهرس العمود الابتدائي (مبنِي على 1) حيث سيتم وضع البيانات.
IsVertical boolean true لإدراج البيانات عموديًا؛ false لإدراجها أفقيًا.
Data String[] المصفوفة النصية المراد استيرادها.
DestinationWorksheet string اسم ورقة العمل التي ستتلقى البيانات.
IsInsert boolean true لإدراج صفوف/أعمدة (نقل الخلايا الحالية)؛ false لكتابة البيانات فوق الخلايا الموجودة.
ImportDataType string نوع البيانات قيد الاستيراد (مثل IntArray، DoubleArray، StringArray، TwoDimensionIntArray، TwoDimensionDoubleArray، TwoDimensionStringArray، BatchData، csvData).
Source FileSource يصف مكان وجود ملف البيانات عندما تكون قيمة BatchData فارغة (مثل CloudFileSystem، LocalFile). مطلوب إذا لم تُقدَّم قيمة BatchData.

مثال

<ImportStringArrayOption>
    <DestinationWorksheet>Sheet1</DestinationWorksheet>
    <IsInsert>false</IsInsert>
    <ImportDataType>StringArray</ImportDataType>
    <FirstRow>1</FirstRow>
    <FirstColumn>1</FirstColumn>
    <IsVertical>true</IsVertical>
    <Source>
        <FileSourceType>CloudFileSystem</FileSourceType>
        <FilePath>Array_string_xml.txt</FilePath>
    </Source>
</ImportStringArrayOption>

الاستجابة

يُعيد الطلب الناجح رمز الحالة HTTP 200 مع حمولة JSON مشابهة لما يلي:

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

رموز الحالة الممكنة:

الكود المعنى
200 تم الاستيراد بنجاح
400 طلب غير صالح – بيانات مفقودة أو غير صحيحة
401 غير مصرّح به – رمز غير صالح أو مفقود
500 خطأ داخلي في الخادم

كيفية استخدام واجهة PostImportData API مع SDKs

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

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

استخدام SDKs الخاصة بـ Aspose.Cells Cloud

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

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

استيراد مصفوفة أعداد صحيحة إلى ورقة عمل إكسل