منظف بيانات Excel - تحويل النص إلى أرقام وإزالة الأحرف غير المرغوب فيها

قم بتنظيف بيانات Excel من خلال تحويل الأرقام المُخزَّنة بصيغة نصية إلى قيم عددية، واستبدال الأحرف غير المرغوب فيها وفواصل الأسطر، وتوحيد الأحرف المُعَرَّفة إلى أحرف عادية باستخدام واجهة برمجة تطبيقات Aspose.Cells.

نظرة عامة

حوّل الأرقام المخزَّنة كنصوص، ونظّف البيانات غير المرغوب فيها، واستبدل الأحرف المُعَرَّفة — كل ذلك في استدعاء واحد دون استخدام صيغ.

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

واجهة ConvertText API

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

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

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

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

-H "Authorization: Bearer {access_token}"

مُعاملات الطلب الخاصة بواجهة convertText API هي:

اسم المُعامل النوع المسار / سلسلة الاستعلام / جسم HTTP الوصف
Spreadsheet ملف FormData ملف جدول العمل الذي سيتم معالجته. تشمل التنسيقات المدعومة: XLSX، XLS، ODS، CSV، إلخ.
convertTextType نص استعلام يُحدّد نوع التحويل النصي المطلوب تطبيقه، مثل تحويل الأرقام المُخزَّنة بصيغة نصية إلى قيم عددية، أو تحويل الأحرف المُعَرَّفة إلى أشكالها غير المُعَرَّفة.
sourceCharacters نص استعلام يُحدّد الأحرف أو السلاسل النصية أو الأنماط التي سيتم استبدالها أو إزالتها من النص (مثل: "é,è,ê", "#N/A", "\\n" لفواصل الأسطر).
targetCharacters نص استعلام يُحدّد الأحرف أو السلاسل النصية البديلة التي ستُستبدَل بالحروف أو الأنماط المصدرية (مثل: "e" للحروف المُعَرَّفة، "" للإزالة، " " لفواصل الأسطر).
worksheet نص استعلام (اختياري) اسم ورقة العمل التي سيتم تطبيق تحويل النص عليها. إن لم يُحدّد، تُطبّق العملية على الورقة الأولى.
range نص استعلام (اختياري) نطاق الخلايا التي سيتم تطبيق تحويل النص عليها (مثل: "A1:C10"). إن لم يُحدّد، تُطبّق العملية على جميع الخلايا المستخدمة في الورقة المحددة.
outPath نص استعلام (اختياري) مسار مجلد تخزين السحابة الذي سيتم حفظ ملف جدول العمل المُعالَج فيه. إن لم يُحدّد، يُحفظ الملف في المجلد الأصلي.
outStorageName نص استعلام اسم تخزين السحابة الذي سيتم حفظ الملف الناتج فيه.
region نص استعلام (اختياري) يُعيّن الإعدادات الإقليمية لقواعد تحويل النص، وهو أمر بالغ الأهمية خاصةً عند التعامل مع أحرف مرتبطة بلغة معينة (مثل: "en-US", "fr-FR").
password نص استعلام (اختياري) إن كان جدول العمل المرفوع محميًا بكلمة مرور، فوفّر كلمة المرور لفتح الملف ومعالجته.

الاستجابة

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

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

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

أين نستخدم واجهة Convert Text API؟

  • تصحيح تنسيق الأرقام: تحويل الأرقام المخزَّنة كنصوص (مثل “123.45”) إلى صيغة رقمية مناسبة للعمليات الحسابية.
  • تنظيف الأحرف الخاصة: إزالة الرموز غير الضرورية أو المسافات الزائدة أو الأحرف غير المرئية من البيانات.
  • إدارة فواصل الأسطر: استبدال فواصل الأسطر في الخلايا بمسافات أو فواصل أخرى.
  • توحيد الأحرف المُعَرَّفة: تحويل الحروف المُعَرَّفة (مثل “é”، “ñ”) إلى أحرف عادية (“e”، “n”).
  • المعالجة المسبقة لملفات CSV: توحيد صيغة النص قبل استيراد ملفات CSV إلى Excel.

لماذا يجب عليك استخدام واجهة Convert Text API؟

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

مواصفات OpenAPI

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

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

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

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