إيجاد وإصلاح الروابط التالفة في جدول عمل Excel عن بُعد – أداة فحص روابط جداول العمل السحابية

البحث عن الروابط التالفة في جدول العمل عن بُعد عبر API

اكتشف الروابط التالفة تلقائيًا في جدول عمل Excel مخزن في التخزين السحابي. تُجري واجهة برمجة التطبيقات هذه مسحًا للنطاقات المحددة للعثور على المراجع الخارجية التالفة، والصيغ غير الصالحة، ومصادر البيانات المفقودة. تدعم مراجعة جداول العمل عن بُعد، وتشغيل فحوصات الجودة تلقائيًا، والتكامل مع موفري التخزين السحابي. واجهة برمجة تطبيقات RESTful لتشغيل أتمتة سير العمل المؤسسي.

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

PUT https://api.aspose.cloud/v4.0/cells/{name}/worksheets/{worksheet}/search/broken-links

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

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

-H "Authorization: Bearer {access_token}"

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

اسم المعلمة النوع المسار / سلسلة الاستعلام / جسم الطلب HTTP الوصف
name String المسار مطلوبة. اسم الملف (مع الامتداد) لملف Excel الذي سيتم البحث فيه عن الروابط التالفة (مثل: Annual_Report.xlsx).
worksheet String المسار مطلوبة. الاسم الدقيق لجدول العمل الذي سيتم تنفيذ عملية مسح الروابط فيه (مثل: DataSheet1).
folder String سلسلة الاستعلام اختياري. مسار الدليل داخل التخزين السحابي الخاص بك حيث يقع ملف جدول العمل المستهدف. في حال حذف هذه المعلمة، يُستخدم المجلد الجذري.
storageName String سلسلة الاستعلام اختياري. معرّف التخزين السحابي المُعدّ مسبقًا حسب تخصيصك. في حال عدم تحديده، تستخدم واجهة برمجة التطبيقات وحدة التخزين الافتراضية للحساب.
region String سلسلة الاستعلام اختياري. إعدادات الترجمة المحلية (Locale) التي سيتم تطبيقها أثناء البحث (مثل: fr-FR). قد تؤثر هذه القيمة على تفسير بعض الصيغ أو تنسيقات البيانات الإقليمية. تتضمن رموز الترجمة المحلية المدعومة: en-US، fr-FR، de-DE، es-ES، إلخ.
password String سلسلة الاستعلام اختياري. كلمة المرور اللازمة لفك تشفير جدول العمل المحمي بكلمة مرور. تُترك فارغة في حال لم يكن الملف مشفرًا.

مثال على طلب cURL

curl -X PUT "https://api.aspose.cloud/v4.0/cells/Annual_Report.xlsx/worksheets/DataSheet1/search/broken-links?folder=Reports&storageName=MyStorage" \
     -H "Authorization: Bearer {access_token}" \
     -H "Accept: application/json"

الاستجابة

{
  "Code": 200,
  "Status": "OK",
  "BrokenLinks": [
    {
      "Address": "='C:\\Data\\Source.xlsx'!A1",
      "ErrorCode": "404",
      "ErrorMessage": "Source file not found"
    }
  ]
}

كائن الاستجابة من نوع BrokenLinksResponse ويتضمّن:

  • BrokenLinks – مجموعة من عناصر BrokenLink، تصف كل منها المرجع المشكل (العنوان، رمز الخطأ، والرسالة).
  • Code – رمز الحالة الرقمي المُعاد من الخدمة.
  • Status – وصف نصي للنتيجة.

ملاحظات: لا تدعم واجهة برمجة التطبيقات تقسيم النتائج إلى صفحات. يمكن إرجاع ما يصل إلى 10,000 رابط تالف في كل طلب. الحد الأقصى لعدد الطلبات هو 100 طلب في الدقيقة لكل حساب.

رموز الأخطاء

  • 400 Bad Request – عنوان URI لواجهة برمجة تطبيقات Aspose.Cells Cloud غير صالح.
  • 401 Unauthorized – رمز الوصول غير صالح أو مفقود.
  • 404 Not Found – ملف جدول العمل غير قابل للوصول.
  • 500 Server Error – حدث خطأ أثناء جلب بيانات الحساب.

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

  • مراجعة دورية للنماذج المالية الكبيرة: قبل إصدار التقارير الشهرية أو الفصلية، قم بمسح مناطق الحسابات الرئيسية (مثل Dashboard!B5:K50) التي تحتوي على مراجع كثيرة لبيانات خارجية، للتأكد من أن جميع الروابط تشير إلى ملفات مصدر صحيحة.
  • دمج البيانات في عمليات الاندماج والاستحواذ: عند دمج ملفات جداول عمل متعددة تمثّل وحدات الأعمال، امسح جدول العمل “Overview” بعد عملية الدمج لتحديد الروابط التي أصبحت غير صالحة بسبب تغيّر مسارات ملفات المصدر أو مشاكل الصلاحيات.
  • إعداد حزم بيانات المستثمرين: قبل إنهاء المواد التقديمية التي تحتوي على مخططات وجداول مرتبطة بقواعد بيانات خارجية أو مصادر بيانات سوق، تحقق من صلاحية جميع الروابط.

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

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

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

مواصفات OpenAPI

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

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

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

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