منظّف بيانات Excel - قص الأحرف والمسافات وفواصل الأسطر تلقائيًا - عبر الإنترنت، وباستخدام رمز مختصر

قص الأحرف غير الضرورية والمسافات الإضافية وفواصل الأسطر من خلايا Excel تلقائيًا باستخدام واجهة برمجة تطبيقات (API) “قص الأحرف” في Aspose.Cells Cloud. نظّف إدخالات البيانات واحتفظ باتساق التنسيق عبر جداولك.

نظرة عامة

  • قص المسافات في البداية والنهاية

    • إزالة المسافات الإضافية في بداية ونهاية النص
    • تحسين مظهر البيانات وتنظيمه وزيادة قابلية قراءته

  • معالجة المسافات الإضافية بين الكلمات

    • إزالة المسافات الزائدة بين الكلمات
    • حل مشكلة ارتباك التنسيق الناتج عن دمج بيانات من مصادر متعددة

  • إزالة المسافات الخاصة

    • إزالة المسافات غير القابلة للفصل (Non-breaking spaces) بوضوح
    • ضمان دقة واتساق البيانات

  • إدارة فواصل الأسطر

    • إزالة فواصل الأسطر الزائدة أو جميعها
    • الحفاظ على تنظيم محتوى الخلايا ومظهر احترافي

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

قبل استدعاء واجهة برمجة التطبيقات، تأكد من امتلاكك حساب Aspose Cloud صالح، ومعرّف عميل (client_id) وسر عميل (client_secret) ورمز وصول (access token) يشمل النطاق Cells.

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

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

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

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

-H "Authorization: Bearer {access_token}"

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

اسم المعامل النوع المسار / سلسلة الاستعلام / جسم HTTP الوصف
Spreadsheet ملف FormData ملف جدول البيانات المراد معالجته. تشمل التنسيقات المدعومة: XLSX وXLS وODS وCSV وما إلى ذلك.
trimContent نص Query يحدّد الأحرف أو السلاسل النصية المحددة المراد قصّها من محتوى الخلايا. يمكن أن يكون حرفًا واحدًا أو عدة أحرف أو نمطًا مخصصًا.
trimLeading منطقي (Boolean) Query عندما تكون القيمة true، يُزيل الأحرف المحددة من بداية محتوى كل خلية.
trimTrailing منطقي (Boolean) Query عندما تكون القيمة true، يُزيل الأحرف المحددة من نهاية محتوى كل خلية.
trimSpaceBetweenWordTo1 منطقي (Boolean) Query عندما تكون القيمة true، يُقلل المسافات المتتالية المتعددة بين الكلمات إلى مسافة واحدة داخل كل خلية.
trimNonBreakingSpaces منطقي (Boolean) Query عندما تكون القيمة true، يزيل أحرف المسافة غير القابلة للفصل (Unicode U+00A0) من محتوى الخلية.
removeExtraLineBreaks منطقي (Boolean) Query عندما تكون القيمة true، يُقلل فواصل الأسطر المتتالية المتعددة إلى فاصلة أسطر واحدة داخل كل خلية.
removeAllLineBreaks منطقي (Boolean) Query عندما تكون القيمة true، يزيل جميع أحرف فواصل الأسطر من محتوى الخلية.
worksheet نص Query (اختياري) اسم ورقة العمل التي سيتم تطبيق قص النصوص عليها. إذا تم حذفها، يُطبّق الإجراء على الورقة الأولى.
range نص Query (اختياري) نطاق الخلايا الذي سيتم تطبيق قص النصوص عليه (مثلاً: "A1:C10"). إذا تم حذفه، يُطبّق الإجراء على جميع الخلايا المستخدمة في ورقة العمل المحددة.
outPath نص Query (اختياري) مسار مجلد مستودع السحابة حيث سيُحفظ ملف جدول البيانات بعد المعالجة. إذا تم حذفه، يُحفظ الملف في المجلد الأصلي.
outStorageName نص Query اسم مستودع السحابة الذي سيُخزّن فيه ملف الإخراج.
region نص Query (اختياري) يعيّن الإعدادات الإقليمية لمعالجة النص، والتي قد تؤثر على معالجة المسافات وفواصل الأسطر للغات معيّنة (مثل "en-US" و"ar-SA").
password نص Query (اختياري) إذا كان ملف جدول البيانات المرفوع مُحميًا بكلمة مرور، قدم كلمة المرور لفتح الملف ومعالجته.

الاستجابة

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

مثال على نجاح العملية (HTTP 200): تُعيد واجهة برمجة التطبيقات تدفق ملف يحتوي على جدول البيانات بعد قص النصوص.

أكواد الخطأ

  • 400 طلب غير صالح (Bad Request): عنوان URI لواجهة برمجة تطبيقات Aspose.Cells Cloud غير صالح.
  • 401 غير مصرّح (Unauthorized): رمز وصول غير صالح. أو معرّف عميل وسر عميل غير صالحين.
  • 404 غير موجود (Not Found): ملف جدول البيانات غير قابل للوصول.
  • 500 خطأ في الخادم (Server Error): حدث استثناء في جدول البيانات أثناء الحصول على بيانات الحساب.

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

  • توحيد إدخال المستخدم: تنظيف بيانات الجداول التي أدخلها المستخدم يدويًا، وإزالة المسافات وفواصل الأسطر الزائدة.
  • الحفاظ على قاعدة بيانات العملاء: تنظيف المسافات الزائدة ومشاكل التنسيق في أسماء العملاء والعناوين وتفاصيل الاتصال.
  • تنظيف التقارير الآلية: تنظيف تنسيق مصدر البيانات قبل توليد التقارير الآلية.
  • التحضير لترحيل البيانات: تنظيف مشكلات التنسيق قبل نقل البيانات إلى النظام الجديد.

لماذا يجب استخدام واجهة برمجة التطبيقات “قص الأحرف”؟

  • خفض تكاليف العمالة: إزالة الجهود اليدوية المُرهقة والمستهلكة للوقت في تنظيف البيانات
  • خفض تكلفة الأخطاء: تجنّب أخطاء التحليل الناتجة عن مشكلات التنسيق
  • الدفع حسب الاستخدام: لا توجد رسوم ثابتة، وتُحسب التكاليف وفقًا للحجم الفعلي للمعالجة
  • لا استثمار في البنية التحتية: لا حاجة للحفاظ على خوادم أو برامج
  • دعم تنسيقات متعددة: يدعم معالجة تنسيقات متعددة مثل XLSX وXLS وCSV وODS وما إلى ذلك
  • سهولة للمطورين: تُوفّر Aspose.Cells Cloud مكتبات SDK بلغات برمجة متعددة، مما يُسهّل التطوير السريع ويأتي مع وثائق شاملة. مقارنةً بإنشاء حلول مخصصة لعرض الرسوم البيانية، فإن هذا يقلّل بشكل كبير من حجم العمل التطويري.
  • فعّالة من حيث التكلفة: يمكنك إزالة الأحرف المكررة دون رفع جدول البيانات أولاً، مما يوفر مساحة التخزين ويقلّل التكاليف.

مواصفات OpenAPI

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

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

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

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