استبدال النص في النطاقات دفعة واحدة في ملفات إكسل السحابية – واجهة برمجة تطبيقات البحث والاستبدال

قم بإجراء استبدال دفعي للنص عبر ملفات إكسل المخزّنة في السحابة. ابحث عن نصوص محدّدة وحدّثها بفعالية ضمن النطاقات المُختارة باستخدام واجهة برمجة تطبيقات البحث والاستبدال في Aspose.Cells Cloud.

واجهة استبدال المحتوى في النطاق عن بُعد

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

PUT https://api.aspose.cloud/v4.0/cells/{name}/worksheets/{worksheet}/ranges/{cellArea}/replace/content

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

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

-H "Authorization: Bearer {access_token}"

مُعطَلات الطلب (Request Parameters)

اسم المُعطَل (Parameter Name) النوع (Type) المسار / سلسلة الاستعلام / جسم طلب HTTP الوصف
name نص (String) المسار (Path) اسم ملف المصنف المخزّن في التخزين السحابي ويُراد تعديله (مثل "report.xlsx").
searchText نص (String) سلسلة الاستعلام (Query) النص الذي سيتم البحث عنه داخل ورقة العمل ونطاق الخلية المحدّدين. يدعم المطابقة الدقيقة للنصوص.
replaceText نص (String) سلسلة الاستعلام (Query) النص الذي سيُستبدل بكلّ مرات ظهور searchText داخل النطاق المحدّد.
worksheet نص (String) المسار (Path) اسم ورقة العمل التي ستُجرى فيها عملية البحث والاستبدال.
cellArea نص (String) المسار (Path) النطاق المحدّد لخلايا (مثل "A1:D20") الذي سيتم فيه البحث والاستبدال.
folder نص (String) سلسلة الاستعلام (Query) مسار مجلد التخزين السحابي حيث يقع المصنف المصدر.
storageName نص (String) سلسلة الاستعلام (Query) (اختياري) اسم مجلد التخزين السحابي الذي يوجد فيه المصنف. وإذا حُذف، يُستخدم التخزين السحابي الافتراضي.
region نص (String) سلسلة الاستعلام (Query) (اختياري) يُعيّن الإعدادات الإقليمية (Locale) للتعامل مع النصوص، ما قد يؤثّر على حساسية الحالة (Case Sensitivity) وترميز الأحرف في عمليات البحث (مثل "en-US", "tr-TR").
password نص (String) سلسلة الاستعلام (Query) (اختياري) إذا كان المصنف محميًا بكلمة مرور، فوفّر كلمة المرور لفتح الملف وتعديله.

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

{
  "Name": "CellsCloudResponse",
  "Type": "Class",
  "Properties": [
    {
      "Name": "Code",
      "DataType": {
        "Identifier": "Integer"
      }
    },
    {
      "Name": "Status",
      "DataType": {
        "Identifier": "String"
      }
    }
  ]
}

استدعاء ناجح يُعيد حُمْلَة JSON محدّدة كما يلي:

{
  "Code": 200,
  "Status": "OK"
}

أكواد الأخطاء (Error Codes)

الكود (Code) الرسالة (Message) متى يحدث الخطأ؟
400 Bad Request URI الطلب أو مُعطَلاته غير سليمة.
401 Unauthorized نقص رمز المصادقة أو عدم صلاحيته.
404 Not Found لا يمكن العثور على المصنف المحدّد أو الوصول إليه.
500 Server Error خطأ داخلي في الخادم أثناء معالجة المصنف.

أين يجب استخدام واجهة استبدال محتوى النطاق في جدول البيانات عن بُعد؟

  • تحديث ملفات سحابية دفعيًا: تعديل محتويات ملفات إكسل متعددة مخزّنة في تخزين سحابي مثل AWS S3 وAzure Blob.
  • تعبئة قوالب السحابة ديناميكيًا: تعبئة دفعية لبيانات ديناميكية في قوالب التقارير المخزّنة في السحابة.
  • مزامنة الملفات بين المناطق الجغرافية: مزامنة اتساق محتوى ملفات إكسل المخزّنة في السحابة عبر مناطق جغرافية مختلفة.

لماذا يجب استخدام واجهة استبدال محتوى النطاق في جدول البيانات عن بُعد؟

  • مُيسّرة للمطورين: تقدّم Aspose.Cells Cloud مكتبات SDK بلغات برمجة متعددة، مما يتيح تطويرًا سريعًا مع توفر توثيق شامل. ومقارنةً ببناء حلول مخصّصة، يقلّل هذا بشكل كبير من جهد التطوير.
  • تقليل تكاليف العمالة: يقلّل الحاجة إلى تعيين موظفين متخصصين في دمج الوثائق.
  • الدفع حسب الاستخدام (Pay-per-use): لا توجد استثمارات أولية؛ تدفع فقط مقابل الاستدعاءات الفعلية لواجهة برمجة التطبيقات.
  • لا توجد تكاليف صيانة: لا حاجة لصيانة الخوادم، أو تحديث البرامج، أو التعامل مع مشاكل التوافق.
  • الحفاظ على تنسيقات إكسل المعقدة في تنسيق PDF سهل الوصول إليه عالميًا.

كيف تستخدم واجهة استبدال محتوى النطاق في جدول البيانات عن بُعد باستخدام مكتبات SDK؟

مواصفات OpenAPI

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

استخدام مكتبات SDK من Aspose.Cells Cloud

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

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