إضافة نص إلى ملف إكسل: إدراج البيانات بكفاءة باستخدام واجهة برمجة تطبيقات الجداول الإلكترونية عبر الويب
يضيف محتوى نصي إلى موقع محدد داخل جدول إكسل. يتطلب هذا الأمر كائنًا يُعرّف المحتوى النصي المراد إضافته والموقع الذي يجب إدراجه فيه.
واجهة برمجة تطبيقات إكسل: PostAddTextContent
POST http://api.aspose.cloud/v3.0/cells/addtext
الأمان والمصادقة
تُعدّ واجهات برمجة تطبيقات Aspose.Cells Cloud آمنة وتتطلب مصادقة تعتمد على رمز JWT.
وصف الوظيفة
تقوم هذه الطريقة بإضافة نص جديد بأمان إلى الخلايا المحددة، وتدعم عدة أنماط لإدراج النص ومعالجة التنسيقات.
-
إضافة نص إلى بداية الخلايا المحددة
يُضيف النص قبل محتوى جميع الخلايا المحددة، مما يضمن الاتساق في إدخال البيانات. مثالي لإضافة معرّفات أو تسميات مشتركة مثل رموز المنتجات أو الفئات أو البادئات. -
إدراج أحرف قبل أو بعد نص محدد
يضع أحرفًا قبل أو بعد النص المستهدف في الخلايا المحددة، مما يسمح لك بإنشاء محتوى منظم ومنسق بسهولة. -
إضافة نفس النص إلى نهاية كل خلية محددة
يضيف نصًا متطابقًا في نهاية عدة خلايا في عملية واحدة، مما يبسّط إدخال البيانات ويضمن مظهرًا موحدًا. -
إدراج نص قبل أو بعد عدد محدد من الأحرف
يُدرج نصًا بعد عدد معيّن من الأحرف من بداية أو نهاية كل خلية ضمن النطاق المستهدف. من الاستخدامات الشائعة تنسيق الرموز أو الطوابع الزمنية أو محدّدات مخصّصة.
معلّمات الطلب
| اسم المعلّمة | النوع | الموقع | الوصف |
|---|---|---|---|
| addTextOptions | فئة | الجسم | يُحدّد محتوى النص والموقع الذي يجب إضافة النص إليه. |
الاستجابة
{
"Filename": "xxxxxx.pdf",
"FileSize": xxxx,
"FileContent": "محتوى الملف: سلسلة مشفرة بـ base64"
}
رموز حالة HTTP
| الرمز | المعنى | الوصف |
|---|---|---|
| 200 | ناجح | تم تطبيق الفلتر بنجاح؛ تحتوي الاستجابة على تفاصيل العملية. |
| 400 | طلب غير صالح | معلمات مفقودة أو غير صالحة (مثل نوع ملف غير مدعوم). |
| 401 | غير مصرّح به | رمز JWT غير صالح أو مفقود. |
| 413 | حجم الحمولة كبير جدًا | تجاوز حجم الملف المرفوع الحد المسموح به. |
| 500 | خطأ داخلي في الخادم | حدث خطأ غير متوقع في الخادم. |
كيفية استخدام واجهة PostAddTextContent API باستخدام مكتبات SDK
مواصفات واجهة PostAddTextContent API
تُعرّف مواصفات OpenAPI واجهة برمجة تطبيقات متاحة علنًا وتتيح لك إجراء تفاعلات REST مباشرة من خلال متصفح ويب.
استخدام مكتبات SDK الخاصة بـ Aspose.Cells Cloud
استخدام مكتبة SDK هو أفضل طريقة لتسريع عملية التطوير. فتتولّى مكتبة SDK معالجة التفاصيل من المستوى المنخفض، مما يتيح لك التركيز على مهام مشروعك. يُرجى الاطّلاع على مستودع GitHub للحصول على قائمة كاملة بمكتبات SDK الخاصة بـ Aspose.Cells Cloud.
تُظهر أمثلة الكود التالية كيفية استدعاء خدمات ويب Aspose.Cells باستخدام مكتبات SDK مختلفة: