استبدال نص في ملف مصنف إكسل
Contents
[
Hide
]
تقوم هذه الواجهة البرمجية 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 مختلفة: