إدراج نص جماعي لملفات إكسل – إضافة بادئات ولامحات ونص مخصص للخلايا – دليل خطوة بخطوة

أدرج نصًا في خلايا إكسل متعددة في عملية واحدة. أضف بادئات أو لاحقات أو تصنيفات أو أحرف مخصصة في البداية أو النهاية أو قبل/بعد نص محدد داخل الخلايا باستخدام واجهة برمجة تطبيقات Aspose.Cells.

نظرة عامة

إدراج جماعي في استدعاء واحد للبادئات أو اللاحقات أو السلاسل المُرتبطة بموقع معين داخل كل خلية في النطاق المستهدف — بدون صيغ، بدون أعمدة مساعدة.

• أدرج نصًّا مخصصًا في أي موضع داخل كل خلية

• أربعة أوضاع لموقع الإدراج: بادئة، لاحقة، قبل/بعد نص فرعي.

• تخطي الخلايا الفارغة لتجنب الفوضى.

• تُعالِج الواجهة فقط القيم من نوع النص؛ تُحوَّل القيم الرقمية والقيمة المنطقية والصيغ أولًا إلى نص.

• الخلايا الفارغة

  • skipEmptyCells = true → تُتخطَّى الخلايا الفارغة.
  • skipEmptyCells = false → يُضاف النص إلى الخلايا الفارغة (تصبح الخلية من نوع نص).

• عدم وجود عنصر الارتباط: عندما يكون position = BeforeText | AfterText ولا يحتوي النص المُحدد selectText على أي وجود، يبقى قيمة الخلية دون تغيير.

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

PUT https://api.aspose.cloud/v4.0/cells/content/add/text

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

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

-H "Authorization: Bearer {access_token}"

معلمات الطلب لواجهة برمجة التطبيقات AddText هي:

مثال باستخدام cURL

curl -X PUT "https://api.aspose.cloud/v4.0/cells/content/add/text?text=Report&position=AtTheBeginning&skipEmptyCells=true" \
  -H "Authorization: Bearer {access_token}" \
  -F "Spreadsheet=@/path/to/workbook.xlsx" \
  -F "outPath=output/workbook_modified.xlsx"

الاستجابة

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

أكواد الأخطاء

أين نستخدم واجهة برمجة التطبيقات لإضافة نص لجداول البيانات؟

• وضع تسميات ديناميكية للتقارير: أضف عناوين ديناميكية أو علامات تواريخ أو ملاحظات إلى بيانات مالية وتقارير مبيعات تم توليدها تلقائيًا.
• تغميز الملفات دفعة واحدة: أضف شعارات الشركة أو علامات مائية لسرية المعلومات أو معلومات الإصدار إلى دفعة من ملفات إكسل.
• ملء قوالب البيانات: ملء أسماء العملاء والمبالغ وغيرها من النصوص تلقائيًا في المواقع المخصصة داخل قوالب العقود أو الفواتير.
• وضع علامات تصنيف البيانات: أضف تلقائيًا علامات تصنيف أو تصنيفات حالة (مثل “قيد المراجعة”، “تمت الموافقة”) إلى صفوف البيانات استنادًا إلى نتائج التحليل.
• توضيح جودة البيانات: أضف ملاحظات حول البيانات ذات المشكلات أثناء تنظيف البيانات.
• تنسيق النص دفعة واحدة: أضف بادئات أو لاحقات موحدة لأسماء المنتجات أو العملاء.

لماذا يجب استخدام واجهة برمجة التطبيقات لإضافة نص لجداول البيانات؟

• إضافة نص دفعي: أضف نصًّا إلى مئات الخلايا أو الملفات دفعة واحدة، مما يوفر ما يصل إلى 95٪ من الوقت مقارنة بالعمل اليدوي.
• التحكم الدقيق في الموقع: تدعم إضافة النص بدقة في ستة مواضع، بما في ذلك البداية والنهاية أو قبل/بعد نص محدد داخل الخلية.
• معالجة ذكية مشروطة: قرر ما إذا كان سيتم إضافة النص بناءً على ما إذا كانت الخلية فارغة أو تحتوي على نص محدد.
• دعم استراتيجية المواضع المتعددة:
  • AtTheBeginning: أضف نفس النص قبل محتوى جميع الخلايا المحددة.
  • AtTheEnd: أضف النص بعد محتوى جميع الخلايا المحددة.
  • BeforeText / AfterText: أضف النص قبل أو بعد الخلايا التي تحتوي على نص محدد فقط.
  • None: استبدال المحتوى الأصلي.
• التحكم الدقيق في النطاق: يسمح بتحديد ورقات عمل أو نطاقات خلايا محددة للعمليات.
• خيار التخطي الشرطي: يدعم تخطي الخلايا الفارغة لتجنب إضافة نص غير ضروري.
• مُيسّرة للمطورين: تُقدّم Aspose.Cells Cloud مكتبات SDK بلغات برمجة متعددة، مما يمكّن من تطوير سريع، وتُرفق معها وثائق شاملة. وبالمقارنة مع بناء حلول مخصصة لرسم الرسوم البيانية، فإن ذلك يقلل بشكل كبير من حجم العمل التطويري.
• فعالة من حيث التكلفة: يمكنك إلحاق نص في خلية دون رفع ملف الحساب أولاً، مما يوفر مساحة تخزين ويقلل التكاليف.

مواصفات OpenAPI

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

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

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

توضح أمثلة الكود التالية كيفية إجراء مكالمات لخدمات الويب Aspose.Cells باستخدام مكتبات SDK المختلفة: