استبدال نص في ملف مصنف إكسل

تقوم هذه الواجهة البرمجية REST باستبدال النص في ملف مصنف إكسل.

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

POST http://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/replaceText

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

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

معاملات الطلب

اسم المعامل النوع الموقع الوصف
name string path اسم ملف المصنف.
sheetName string path اسم ورقة العمل التي تتم فيها عملية الاستبدال.
oldValue string query النص الذي يجب استبداله.
newValue string query النص الذي سيُستبدل بالقيمة القديمة.
folder string query مسار المجلد الذي يحتوي على المصنف.
storageName string query اسم خدمة التخزين التي يخزن فيها المصنف.

الاستجابة

{
    "Status":"OK",
    "Code":200,
      "Workbook": {
    "FileName": "test.xlsx",
    "Links": [
      {
        "Href": "/test.xlsx",
        "Rel": "self",
        "Title": null,
        "Type": null
      },
      {
        "Href": "/test.xlsx",
        "Rel": "alternate",
        "Title": "تنزيل كملف CSV",
        "Type": "text/csv"
      },
      {
        "Href": "/test.xlsx",
        "Rel": "alternate",
        "Title": "تنزيل كملف HTML",
        "Type": "text/html"
      },
      {
        "Href": "/test.xlsx",
        "Rel": "alternate",
        "Title": "تنزيل كملف ODS",
        "Type": "application/vnd.oasis.opendocument.spreadsheet"
      },
      {
        "Href": "/test.xlsx",
        "Rel": "alternate",
        "Title": "تنزيل كملف PDF",
        "Type": "application/pdf"
      },
      {
        "Href": "/test.xlsx",
        "Rel": "alternate",
        "Title": "تنزيل كملف نصي مقسّم بفواصل",
        "Type": "text/plain"
      },
      {
        "Href": "/test.xlsx",
        "Rel": "alternate",
        "Title": "تنزيل كصورة TIFF",
        "Type": "image/tiff"
      },
      {
        "Href": "/test.xlsx",
        "Rel": "alternate",
        "Title": "تنزيل كملف Microsoft Excel 2003",
        "Type": "application/vnd.ms-excel"
      },
      {
        "Href": "/test.xlsx",
        "Rel": "alternate",
        "Title": "تنزيل كملف Microsoft Excel 2007",
        "Type": "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet"
      },
      {
        "Href": "/test.xlsx",
        "Rel": "alternate",
        "Title": "تنزيل كملف XPS",
        "Type": "application/vnd.ms-xpsdocument"
      }
    ],
    "Worksheets": {
      "link": {
        "Href": "/worksheets",
        "Rel": "self",
        "Title": null,
        "Type": null
      }
    },
    "DefaultStyle": {
      "link": {
        "Href": "/defaultstyle",
        "Rel": "self",
        "Title": null,
        "Type": null
      }
    },
    "DocumentProperties": {
      "link": {
        "Href": "/documentproperties",
        "Rel": "self",
        "Title": null,
        "Type": null
      }
    },
    "Names": {
      "link": {
        "Href": "/names",
        "Rel": "self",
        "Title": null,
        "Type": null
      }
    },
    "Settings": {
      "link": {
        "Href": "/settings",
        "Rel": "self",
        "Title": null,
        "Type": null
      }
    },
    "IsWriteProtected": "False",
    "IsProtected": "False",
    "IsEncryption": "false",
    "Password": null
  }
}

رموز حالة HTTP

الرمز المعنى الوصف
200 نجاح (OK) تم تطبيق العامل بنجاح؛ تحتوي الاستجابة على تفاصيل العملية.
400 طلب غير صالح (Bad Request) معاملات مفقودة أو غير صالحة (مثل نوع ملف غير مدعوم).
401 غير مخوّل (Unauthorized) رمز JWT غير صالح أو مفقود.
413 حجم البيانات كبير جدًا (Payload Too Large) حجم الملف المرفوع يتجاوز الحد المسموح به.
500 خطأ داخلي في الخادم (Internal Server Error) خطأ غير متوقع في الخادم.

كيفية استخدام واجهة PostReplace API مع SDKs

مواصفات واجهة PostReplace API

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

يمكنك استخدام أداة cURL سطر الأوامر لاستدعاء خدمات Aspose.Cells بسهولة. يوضح المثال أدناه كيفية إجراء الطلب باستخدام cURL.

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

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

توضح أمثلة الكود التالية كيفية استدعاء خدمات Aspose.Cells باستخدام SDKs مختلفة: