أداة تقسيم نص إكسل – تقسيم محتوى الخلايا إلى أعمدة متعددة | Aspose.Cells Cloud

قسّم نص خلايا إكسل إلى أعمدة متعددة باستخدام قواعد تقسيم مخصصة. افصل المحتوى حسب المُفصِّل وأخرج النتائج إلى النطاقات المحددة باستخدام واجهة Aspose.Cells Cloud للتقسيم عبر الويب (Web API).

مقدمة: تقسيم النص

تقوم واجهة برمجة تطبيقات تقسيم النص (Text Segmentation API) بتقسيم محتوى الخلايا إلى خلايا متعددة بناءً على المُفصِّلات أو الأنماط أو فواصل الأسطر المحددة، ثم تُخرج النتائج إلى نطاق الهدف. وتدعم طرق تقسيم مرنة، وإخراج اتجاهي (أعمدة أو صفوف)، وخيارات للاحتفاظ بالمُفصِّلات — ما يجعلها مثالية لتحليل البيانات المتسلسلة، أو محتوى التنسيق المُشابه لملفات CSV، أو النصوص متعددة الأسطر لتحويلها إلى تنسيقات منظمة.

  • تقسيم الخلية حرفًا محددًا – قسّم محتوى الخلية إلى خلايا متعددة باختيار أي حرف كمُفصِّل (فاصلة، مسافة، فاصلة منقوطة، إلخ).
  • تقسيم الخلايا حسب سلسلة نصية – افصل الخلايا حسب أي تركيبة أحرف تحددها.
  • تقسيم النص حسب القناع (mask) – استخدم الرموز البديلة (wildcards) لتقسيم النص استنادًا إلى نمط معيّن، مما يوفر طريقة أكثر مرونة وقوة لتقسيم النص.
  • تقسيم محتوى الخلية حسب فاصل الأسطر – أنشئ عرضًا أكثر تنظيمًا من خلال التقسيم حسب فواصل الأسطر.
  • تقسيم الخلايا إلى أعمدة أو صفوف – اختر ما إذا كانت نتائج التقسيم تُكتب في أعمدة متتالية أو صفوف متتالية.
  • إزالة أو الاحتفاظ بالمُفصِّلات – حدد ما إذا كانت المُفصِّلات تُزال أو تُحتفظ بها في بداية أو نهاية الخلايا الناتجة.

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

المتطلبات المسبقة: لاستخدام هذه الواجهة، تحتاج إلى رمز وصول (access token) ساري لمنصة Aspose Cloud، ويجب رفع ملف المصنف المراد معالجته إلى مساحة التخزين السحابية لـ Aspose Cloud أو تقديمه مباشرةً في الطلب. وتدعم الواجهة تنسيقات الجداول الشائعة مثل XLSX وXLS وODS وCSV.

واجهة برمجة التطبيقات عبر الويب (Web API)

POST https://api.aspose.cloud/v4.0/cells/content/split/text

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

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

-H "Authorization: Bearer {access_token}"

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

اسم المُعلِّمة النوع الموقع مطلوبة؟ القيمة الافتراضية الوصف
spreadsheet File FormData نعم — ملف الجدول المراد معالجته. تشمل التنسيقات المدعومة XLSX وXLS وODS وCSV، إلخ.
delimiters String Query لا — حرف أو أكثر مُفصِّل يُستخدم لتقسيم النص داخل الخلايا (مثل "," أو ";" أو Space أو LineBreak أو Tab أو Pipe أو Custom).
keepDelimitersInResultingCells Boolean Query لا false إذا كانت القيمة true، فسيتم الاحتفاظ بأحرف المُفصِّل في الخلايا المنقسمة الناتجة.
keepDelimitersPosition String Query لا None مكان الاحتفاظ بالمُفصِّلات إذا كانت keepDelimitersInResultingCells تساوي true. الخيارات: None أو AtTheBeginning أو AtTheEnd أو BeforeText أو AfterText.
howToSplit String Query لا SplitToColumns طريقة تقسيم النص. الخيارات: None أو SplitToColumns أو SplitToRows.
outPositionRange String Query نعم — نطاق الهدف الذي ستُكتب فيه نتائج التقسيم (مثل "D1:F10").
worksheet String Query لا — اسم ورقة العمل التي سيتم تطبيق عملية تقسيم النص عليها. وإذا تُركت فارغة، فستُستخدم الورقة الأولى.
range String Query لا — نطاق الخلايا المصدر التي سيُطبّق عليها عملية التقسيم (مثل "A1:A10"). وإذا تُركت فارغة، فسيتم معالجة جميع الخلايا المستخدمة في الورقة.
outPath String Query لا — مسار مجلد مساحة التخزين السحابية التي سيُحفظ فيها المصنف المعالج. وإذا تُرك فارغًا، فسيُحفظ الملف في المجلد المصدر.
outStorageName String Query لا — اسم مساحة التخزين السحابية التي ستُخزّن فيها ملفات الإخراج.
region String Query لا — المنطقة المحلية (locale) لتقسيم النص، والتي قد تؤثر على تفسير المُفصِّلات وتشفير الأحرف (مثل "en-US" أو "ja-JP").
password String Query لا — كلمة المرور لفتح جدول محمي بكلمة مرور.

الاستجابة (Response)

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

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

  • 400 Bad Request – عنوان URI لواجهة Aspose.Cells Cloud غير صالح أو المُعلمات معطّلة صياغيًا.
  • 401 Unauthorized – رمز الوصول (أو client-id/secret) مفقود أو غير صالح.
  • 404 Not Found – تعذّر الوصول إلى ملف الجدول المحدد.
  • 500 Server Error – حدث خطأ داخلي أثناء معالجة الجدول.

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

تنظيف استيراد ملفات CSV وملفات النص

عند استيراد البيانات من أنظمة خارجية، غالبًا ما تُدمج الحقول في خلية واحدة:

  • استيراد بيانات أنظمة إدارة موارد المؤسسة (ERP) أو إدارة علاقات العملاء (CRM) – قسّم "John Doe;johndoe@email.com;555-1234" إلى أعمدة منفصلة للاسم والبريد الإلكتروني ورقم الهاتف.
  • تصديرات قواعد البيانات – حلّل المفاتيح المُجمّعة مثل "ORD-2024-001|Premium|Express" إلى رقم الطلب والمستوى وطريقة الشحن.
  • تحليل سجلات الأحداث (Log Files) – افصل السجلات شبه المنظمة مثل "2024-01-15 10:30:00|ERROR|ConnectionTimeout" لتسهيل التصفية.

ترحيل الأنظمة القديمة

  • تُخرج الأنظمة القديمة الحقول ذات القيم المتعددة في خلية واحدة؛ قسّمها لتتوافق مع مخططات قواعد البيانات الجديدة.
  • حوّل تصديرات الملفات المسطحة إلى جداول إكسل معيارية جاهزة لاستخدامها مع Power BI أو Tableau.

تنظيف البيانات وتوحيدها

  • توحيد المُفصِّلات – حوّل المُفصِّلات المختلطة ("A,B;C|D") إلى تنسيق موحّد باستخدام تقسيم متعدد المُفصِّلات.
  • تنظيف المسافات البيضاء – قسّم حسب المسافات لتحديد وحذف المسافات الإضافية بين الكلمات.
  • البيانات المالية – قسّم رموز المعاملات المجمّعة مثل "DEP-CHK-3847" إلى نوع المعاملة والمصدر والمرجع.
  • السجلات الطبية – حلّل بيانات المرضى مثل "Smith,Jane_F_1985" إلى الاسم الأخير والاسم الأول والجنس وسنة الميلاد.

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

  • أحرف محددة – قسّم حسب أي حرف واحد (فاصلة، فاصلة منقوطة، علامة تبويب، مسافة).
  • ** تركيبات سلسلة نصية** – استخدم مُفصِّلات متعددة الأحرف مثل || أو -> أو مُفصِّلات مخصصة.
  • فواصل الأسطر – حلّل فورًا خلايا متعددة الأسطر إلى صفوف منفصلة (العناوين، التعليقات، الأوصاف).
  • مُفصِّلات مخصصة – عرّف أي تركيبة أحرف كمُفصِّل لصيغ البيانات الخاصة.
  • مُصمّمة للمطورين – توفر Aspose.Cells Cloud مكتبات SDK بلغات برمجة متعددة، مما يُسرّع عملية التطوير ويوفر وثائق شاملة. مقارنةً بإنشاء حلول مخصصة، تقلل هذه الطريقة من جهد التطوير بشكل كبير.
  • فعالة من حيث التكلفة – يمكنك إزالة الأحرف المتكررة دون رفع المصنف مسبقًا، ما يوفر مساحة تخزين ويقلل التكاليف.

مواصفات OpenAPI

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

استخدام حزم تطوير البرمجيات (SDKs) لـ Aspose.Cells Cloud

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

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