Aspose.Cells – وثائق واجهة برمجة التطبيقات لتحديث حالة الكلمات

إصدار الواجهة البرمجية: 3.0

قد يؤدي وجود نصوص غير متسقة في حالة الأحرف (أحرف كبيرة أو صغيرة) داخل الجداول المكتبية (مثل إكسل، جداول بيانات Google، CSV) إلى إحداث إحباط، خاصةً عند التعامل مع مجموعات بيانات كبيرة. وتُعد واجهة PostUpdateWordCase Web API أداةً تلقائيةً لتحويل حالات النص، مما يضمن جودة نظيفة وموحّدة للبيانات مع أقل جهد ممكن.

واجهة برمجة التطبيقات عبر الويب للجداول المكتبية – واجهة برمجة التطبيقات لتحديث حالة الكلمات

POST https://api.aspose.cloud/v3.0/cells/updatewordcase

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

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

وصف الوظيفة

تُعنى واجهة برمجة التطبيقات PostUpdateWordCase بحلّ مشكلة شائعة تتمثل في عدم اتساق حالة الأحرف في الجداول المكتبية، وهو ما قد يؤثر بشكل كبير على تحليل البيانات ومعالجتها. وتُحقّق هذه الواجهة البرمجية التحويل التلقائي لحالات الأحرف، مما يضمن أن تكون بياناتك نظيفة ومُوحّدة وجاهزة لأي تعديل أو تحليل لاحق.

• تحويل تلقائي لحالة الأحرف

  • تحويل الأحرف الكبيرة إلى صغيرة – تحويل جميع الأحرف الكبيرة إلى صغيرة.
  • تحويل الأحرف الصغيرة إلى كبيرة – تحويل جميع الأحرف الصغيرة إلى كبيرة.
  • تكبير الحرف الأول فقط – تكبير الحرف الأول من كل كلمة.
  • حالة العنوان (Title Case) – تحويل النص إلى حالة العنوان، حيث يُكبّر الحرف الأول من كل كلمة رئيسية.

• دعم تنسيقات متعددة – تعمل الواجهة البرمجية مع مجموعة واسعة من تنسيقات الجداول المكتبية، بما في ذلك إكسل، OpenOffice، JSON، CSV، وغيرها. ويجعل هذا التنوّع منها أداةً مناسبة لمختلف احتياجات معالجة البيانات.

معلمات الطلب

هيكل wordCaseOptions

{
  "Range": "A1:B10", // النطاق بالصيغة المعتادة في إكسل للمعالجة (إجباري)
  "CaseType": "Upper", // القيم المسموح بها: Upper، Lower، Capitalize، Title (إجباري)
  "IgnoreBlank": true // قيمة منطقية، اختيارية – عند التعيين إلى true، تُترك الخلايا الفارغة دون تغيير
}

مثال على جسم الطلب

{
  "Range": "A1:B10",
  "CaseType": "Upper",
  "IgnoreBlank": true
}

• النطاق (Range) – النطاق الخلوية الذي سيتم تطبيق عملية تحويل حالة الأحرف عليه (مثل A1:C5).
• نوع الحالة (CaseType) – نوع عملية التحويل. القيم المسموح بها هي: Upper (كبير)، Lower (صغير)، Capitalize (تكبير الحرف الأول فقط)، وTitle (حالة العنوان).
• تجاهل الفارغة (IgnoreBlank) – إذا كانت القيمة true، تُتجاهل الخلايا الفارغة؛ القيمة الافتراضية هي false.

الاستجابة

{
    "Status" : "OK",
    "Code" : 200,
    "Filename" : "[اسم الملف المدمج]",
    "Filesize" : [حجم الملف],
    "FileContent" : "[Base64String]"
}

• Filename – اسم الملف الذي تم معالجته.
• FileSize – حجم الملف بالبايت.
• FileContent – محتوى الملف بعد التحويل، مشفرًا بتقنية Base64.

رموز حالة HTTP

كيفية استخدام واجهة برمجة التطبيقات PostUpdateWordCase باستخدام مكتبات SDK

مواصفات واجهة برمجة التطبيقات PostUpdateWordCase

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

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

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

تُظهر الأمثلة التالية كيفية استدعاء خدمات Aspose.Cells عبر الإنترنت باستخدام مكتبات SDK مختلفة: