واجهة برمجة تطبيقات البحث في محتوى جداول البيانات
ابحث برمجيًا عن نصوص محددة داخل أي جدول بيانات Excel باستخدام واجهة برمجة تطبيقات Aspose.Cells Cloud. يمكن للواجهة تحديد النصوص أو الأرقام أو الصيغ في الملفات المحلية المخزنة في السحابة، مما يمكّن من أتمتة عمليات اكتشاف البيانات وتحليل المحتوى وتدقيق جداول البيانات.
واجهة برمجة التطبيقات على الويب
PUT https://api.aspose.cloud/v4.0/cells/search/content
إذا كنت تفضل استخدام HTTP الخام، يوضح مثال cURL التالي نفس الطلب:
curl -X PUT "https://api.aspose.cloud/v4.0/cells/search/content?searchText=Invoice&ignoringCase=true" \
-H "Authorization: Bearer {access_token}" \
-H "Content-Type: multipart/form-data" \
-F "spreadsheet=@/path/to/your/file.xlsx"
الأمان والمصادقة
تُعد واجهات برمجة تطبيقات Aspose.Cells Cloud آمنة وتتطلب مصادقة مبنية على رمز JWT.
-H "Authorization: Bearer {access_token}"
معاملات الطلب
| المعامل | النوع | الموقع | الوصف |
|---|---|---|---|
| spreadsheet | ملف | FormData | ملف Excel الذي سيتم البحث فيه. |
| searchText | نص (String) | Query | النص (أو القيمة العددية) الذي سيتم العثور عليه داخل المصنف. |
| ignoringCase | منطقي (Boolean) | Query | ضع القيمة true لإجراء بحث غير حساس لحالة الأحرف. |
| worksheet | نص (String) | Query | اسم ورقة العمل التي سيتم تقييد البحث فيها. إذا حُذف هذا المعامل، فسيتم مسح جميع أوراق العمل. |
| cellArea | نص (String) | Query | نطاق بنمط A‑1 (مثل A1:C10) يحدّ من منطقة البحث. |
| region | نص (String) | Query | المنطقة الجغرافية للخدمة (مثل us-east-1). |
| password | نص (String) | Query | كلمة المرور المطلوبة لفتح مصنف محمي. |
الاستجابة
تعيد الواجهة كائن SearchResult يحتوي على مصفوفة من الخلايا المطابقة. ويُزوَّد كل عنصر باسم ورقة العمل وعنوان الخلية والنص المطابق.
{
"textItems": [
{
"cellName": "A1",
"text": "المجموع",
"occurrences": 1
},
{
"cellName": "B5",
"text": "المجموع",
"occurrences": 2
}
],
"code": 200,
"status": "OK"
}
أكواد الأخطاء
- 400 طلب غير صالح (Bad Request) – URI أو معاملات الطلب غير صالحة.
- 401 غير مصرح به (Unauthorized) – رمز وصول مفقود أو غير صالح أو بيانات اعتماد عميل خاطئة.
- 404 غير موجود (Not Found) – لا يمكن الوصول إلى جدول البيانات المحدد.
- 500 خطأ داخلي في الخادم (Internal Server Error) – حدث خطأ غير متوقع في الخادم أثناء معالجة المصنف.
أين نستخدم واجهة برمجة التطبيقات للبحث في محتوى جدول البيانات؟
- تدقيق شامل للامتثال داخل المصنف – امسح المصنف كاملاً لاكتشاف المصطلحات الحساسة (مثل “بند السرية”، “بيانات داخلية”) للاختبارات الأمنية والامتثالية للبيانات.
- استعلام الارتباطات عبر الأوراق – ابحث عن رقم مشروع أو اسم عميل يظهر في أوراق عمل متعددة، مما يُسهّل التكامل السريع عبر الأوراق.
- التحقق من محتوى القوالب دفعة واحدة – بعد إنشاء التقارير، تحقق من استبدال جميع العناصر النائبة (مثل
{{Date}}) بشكل صحيح عبر دفعة من ملفات Excel. - أرشفة البيانات التاريخية واستخراجها – ابحث في ملفات Excel القديمة عن رموز أحداث محددة أو مصطلحات تجارية لتسريع عمليات التنقيب وتحليل البيانات.
لماذا يجب استخدام واجهة برمجة التطبيقات للبحث في محتوى جدول البيانات؟
- سهلة الاستخدام للمطورين – توفر SDKs للعديد من لغات البرمجة، مما يقلل جهود التطوير مقارنة ببناء حل مخصص.
- تقليل تكاليف العمالة – يُؤتمت المهام التي تتطلب عادة فحصًا يدويًا لجداول البيانات.
- الدفع حسب الاستخدام – تدفع فقط مقابل استدعاءات الواجهة التي تُجريها فعليًا.
- بدون صيانة – لا خوادم لإدارتها، ولا تحديثات برمجيات، ولا مخاوف تتعلق بالتوافق.
- الحفاظ على التنسيقات المعقدة – يمكن تصدير النتائج إلى PDF مع الحفاظ على تخطيط Excel الأصلي.
كيفية استخدام البحث عن الروابط التالفة داخل جدول البيانات باستخدام SDKs
مواصفات OpenAPI
تعرّف مواصفات OpenAPI واجهة برمجة تطبيقات قابلة للوصول العام وتتيح لك إجراء تفاعلات REST مباشرة من متصفح الويب.
استخدام SDKs لـ Aspose.Cells Cloud
استخدام SDK هو أسرع طريقة لدمج وظيفة البحث. وتُجرّد SDKs من طبقة HTTP، ما يسمح باستدعاء الواجهة بحد أدنى من الكود. راجع القائمة الكاملة لـ SDKs في مستودع GitHub.
تُظهر أمثلة الكود التالية كيفية استدعاء عملية البحث في محتوى جدول البيانات باستخدام SDKs مختلفة: