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

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

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

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

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

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

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

-H "Authorization: Bearer {access_token}"

معلَّمات الطلب:

اسم المعلَّمة النوع المسار / سلسلة الاستعلام / جسم الطلب الوصف
Spreadsheet ملف FormData ملف جدول العمل المحلي المراد معالجته. تشمل التنسيقات المدعومة: XLSX و XLS و ODS و CSV وما إلى ذلك.
searchText نص Query النص المراد البحث عنه داخل ورقة العمل المحددة ومنطقة الخلية المحددة.
replaceText نص Query النص الذي سيُستبدل بكل تكرارات searchText داخل النطاق المحدَّد.
worksheet نص Query (اختياري) اسم ورقة العمل التي سيتم تنفيذ عملية البحث والاستبدال فيها. وإذا تُرك فارغًا، تُطبّق العملية على الورقة الأولى.
cellArea نص Query (اختياري) النطاق المحدّد للخلايا (مثل: "A1:D20" أو "B5:F15") حيث سيُجرى البحث والاستبدال. وإذا تُرك فارغًا، تُطبّق العملية على جميع الخلايا المستخدمة في ورقة العمل المحددة.
region نص Query (اختياري) يُحدّد الإعدادات المحلية لمعالجة النص، والتي قد تؤثّر على حساسية الحروف وترميز الأحرف في عمليات البحث (مثل: "en-US" أو "fr-FR").
password نص Query (اختياري) إذا كان ملف جدول العمل المُرفع محميًا بكلمة مرور، فوفّر كلمة المرور لفتح الملف ومعالجته.

الاستجابة

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

الاستجابة هي تدفّق ثنائي يحتوي على المصنف المُحدّث. احفظه بالامتداد المناسب للملف (مثل: .xlsx).

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

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

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

  • المعالجة الدفعية لملفات إكسل المحلية – أتمتة عملية البحث والاستبدال عبر العديد من المصنفات المخزنة محليًا.
  • خطوط أنابيب البيانات المحلية – دمج واجهة برمجة التطبيقات في مهام مجدولة لتعديل التقارير قبل أرشفتها أو توزيعها.
  • توليد التقارير محليًا – إدراج القيم ديناميكيًا في قوالب المصنفات دون رفعها إلى السحابة.

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

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

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

مواصفات OpenAPI

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

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

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

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