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

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

ابحث برمجيًا عن نص محدد داخل أي ملف إكسل باستخدام واجهة برمجة تطبيقات Aspose.Cells Cloud. ابحث عن نصوص أو أرقام أو صيغ في الملفات المخزَّنة في مساحة التخزين السحابية. تتيح لك هذه الواجهة القائمة على REST اكتشاف البيانات تلقائيًا، وتحليل المحتوى، وتنفيذ سير عمل مراجعة الملفات.

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

PUT https://api.aspose.cloud/v4.0/cells/{name}/search/content

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

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

-H "Authorization: Bearer {access_token}"

مُعلمات الطلب:

اسم المُعلَمة	النوع	المسار / سلسلة الاستعلام / جسم الطلب HTTP	الوصف
name	نص (String)	المسار (Path)	مطلوبة. اسم ملف إكسل (مع امتداده) الذي سيتم فيه إجراء البحث عن النص، مثل `sales_data.xlsx`.
searchText	نص (String)	سلسلة الاستعلام (Query)	مطلوبة. النص أو الرقم أو المحتوى الجزئي المطلوب العثور عليه عبر الملف أو ورقة/أوراق العمل بالكامل.
ignoringCase	منطقي (Boolean)	سلسلة الاستعلام (Query)	اختيارية. تحدد ما إذا كان البحث حساسًا لحالة الأحرف أم لا. ضع القيمة `true` لإجراء بحث غير حساس لحالة الأحرف (مثل: “Report” تطابق “REPORT”)؛ الافتراضي هو `false`.
folder	نص (String)	سلسلة الاستعلام (Query)	اختيارية. المسار إلى المجلد داخل مساحة التخزين السحابية التي تحتوي على الملف المستهدف. إذا لم تُحدَّد، يُفترض المجلد الجذري.
storageName	نص (String)	سلسلة الاستعلام (Query)	اختيارية. المعرّف المسمّى لخدمة تخزين سحابية مُعدَّة مسبقًا. إذا لم تُحدَّد، تستخدم الواجهة التخزين الافتراضي المرتبط بالحساب.
region	نص (String)	سلسلة الاستعلام (Query)	اختيارية. إعداد المنطقة (مثل: `es-ES`) الذي يُطبَّق أثناء البحث، وقد يؤثر على قواعد تسوية أو ترتيب النصوص.
password	نص (String)	سلسلة الاستعلام (Query)	اختيارية. كلمة المرور اللازمة لفك تشفير ملف إكسل المحمي بكلمة مرور. لا تُحدِّد هذه المعلمة إذا لم يكن الملف مشفرًا.

قائمة المصطلحات

searchText – النص الدقيق المطلوب العثور عليه؛ يمكن أن يكون جزءًا من النص.
ignoringCase – تجعل القيمة true البحث غير حساس لحالة الأحرف؛ والقيمة false تجعل البحث حساسًا لحالة الأحرف.
folder – المسار إلى المجلد الذي يحتوي على ملف إكسل.
storageName – معرّف إعداد تخزين مخصص.
region – رمز المنطقة الذي يؤثر في قواعد مقارنة النصوص.
password – كلمة المرور اللازمة لفك تشفير الملفات المحمية.

الاستجابة

{
  "Code": 200,
  "Status": "OK",
  "TextItems": [
    {
      "Filename": "string",
      "Worksheet": "string",
      "Position": "string",
      "Content": "string"
    }
  ]
}

تحتوي الاستجابة على قائمة بالخلايا (CellName) التي تم العثور على النص المطلوب فيها، مع اسم ورقة العمل والنص المطابق. إذا لم يُعثر على أي مطابقات، تكون المصفوفة TextItems فارغة، لكن الطلب يعود مع رمز الحالة HTTP 200 OK.

رموز الأخطاء

400 Bad Request – عنوان URI لواجهة برمجة تطبيقات Aspose.Cells Cloud غير صالح.
```
{"code":400,"message":"Invalid request URI"}
```
401 Unauthorized – رمز الوصول أو معرّف العميل أو سر العميل غير صالح.
```
{"code":401,"message":"Invalid access token"}
```
404 Not Found – ملف الملف المتبعد غير قابل للوصول.
```
{"code":404,"message":"File not found"}
```
500 Server Error – ظرف غير متوقع منع الواجهة من إكمال الطلب.
```
{"code":500,"message":"Internal server error"}
```

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

مراجعة شاملة لامتثال الملفات – امسح ملف إكسل بالكامل بسرعة لتحديد جميع المصطلحات الحساسة (مثل: “بند سري”، “بيانات داخلية”) لاختبار أمن البيانات والامتثال في المؤسسات.
استعلام الارتباطات عبر ورقات العمل – عندما تكون معلومات المشروع موزعة عبر ورقات عمل متعددة، ابحث عن رقم مشروع أو اسم عميل محدد وابحث فورًا عن جميع البيانات ذات الصلة.
التحقق من محتوى القوالب دفعة واحدة – بعد توليد التقارير تلقائيًا، امسح ملفات إكسل متعددة دفعة واحدة للتأكد من أن جميع العناصر النائبة المحددة مسبقًا (مثل {{Date}}) تم استبدالها بشكل صحيح، مما يضمن اكتمال التقرير ودقته.
أرشفة البيانات التاريخية واستخراجها – حلّل الملفات القديمة، ابحث عن رموز أحداث أو مصطلحات تجارية محددة، وافهم بسرعة المنطق التجاري التاريخي لغرض التنقيب عن البيانات.

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

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

كيف تستخدم البحث عن الروابط التالفة ضمن نطاق واجهة برمجة التطبيقات للملفات باستخدام SDKs؟

مواصفات OpenAPI

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

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

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

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