تُستخدم واجهة المكون الإضافي الخاصة بـ IBulkFileRetriever بواسطة BulkManager لدعم استرداد الملفات المجمعة على الخوادم البعيدة.
تنفيذ الواجهة هو D2L.IM.IPSIS.Bulk.Handlers.IBulkFileRetrieverHandler.
توفر قائمة التكوين الآتية نقطة بداية لأي تنفيذ لحزمة التكامل لأنظمة معلومات الطالب:
حزمة التكامل لأنظمة معلومات الطالب، والقالب - أداة استرداد الملف المجمع
- BulkFileRetrieverSetLocalPathToD2LTempHandler (ترتيب الفرز = 10)
- BulkFileRetrieverUriHandler (ترتيب الفرز = 20)
BulkFileRetrieverSetLocalPathToD2LTempHandler
يعيِّن المسار المحلي إلى دليل فريد في مثيل دليل مؤقت باستخدام اسم الملف الأصلي من الطلب.
التنفيذ
D2L.IM.IPSIS.Default.Bulk.Handlers.BulkFileRetrieverSetLocalPathToD2LTempHandler
السلوك المتوقع
يقوم المعالج بتعيين مسار الحفظ المحلي إلى {D2L instance temp directory}\{generated unique directory}\{filename defined in remotefileurl}.
سلوك الخطأ
إذا لم يكن المسار المحلي موجودًا، فسيقوم المعالج بطرح استثناء وإدراج سجل خطأ في قاعدة البيانات.
ملاحظة التكوين
بما أن هذا المعالج يقوم بتعيين مسار التنزيل، فإنه يجب وضعه قبل معالج تنزيل (مثل BulkFileRetrieverUriHandler أو BulkFileRetrieverHttpsGetAcceptAllCertsHandler).
BulkFileRetrieverUriHandler
يقوم هذا المعالج بتنزيل الملفات ذات عناوين URI التي تبدأ بـ http: وhttps: وftp: وfile:.
التنفيذ
D2L.IM.IPSIS.Default.Bulk.Handlers.BulkFileRetrieverUriHandler
السلوك المتوقع
يؤدي المعالج المهام الآتية:
- يقوم بتحديث حالة IBulkFileUrl إلى قيد التنزيل.
- يقوم بتعيين اسم المستخدم وكلمة المرور إذا تم تمرير أحدهما لعنوان URI.
- ينشئ اتصال URI يدعم ftp وhttp وhttps وfile. يفترض هذا السلوك أنه لا توجد مصادقة مطلوبة للاتصال إذا لم يتم تمرير أي مصادقة في الطلب. إذا تم توفير اسم مستخدم وكلمة مرور في الطلب (تتم تعبئتها بواسطة BulkFileRetrieverRetrieveAuthenticationCredientialsHandler)، فسيستخدم النظام BasicAuth للاتصال بنقطة النهاية.
- يقوم بتنزيل الملف.
- يقوم بتحديث حالة IBulkFileUrl إلى تم التنزيل.
سلوك الخطأ
- إذا لم يكن المسار المحلي موجودًا، فسيتم طرح استثناء "المسار غير موجود" ويدرج المعالج سجل خطأ في قاعدة بيانات التسجيل.
- إذا تم استلام مجموعة اسم مستخدم وكلمة مرور غير صالحة، فسيتم طرح استثناء مصادقة ويدرج المعالج سجل خطأ في قاعدة بيانات التسجيل.
- إذا تعذر الوصول إلى عنوان URL، فسيتم طرح استثناء تنسيق URI ويدرج المعالج سجل خطأ في قاعدة بيانات التسجيل.
- إذا انتهت المهلة، فسيتم طرح استثناء انتهاء المهلة ويدرج المعالج سجل خطأ في قاعدة بيانات التسجيل.
ملاحظات التكوين
- يقوم المعالج BulkFileRetrieverUriHandler بتنزيل الملفات، ولذلك يجب وضعه بعد أي معالجات تقوم بتكوين الطلب الصادر (مثل إضافة بيانات اعتماد، وإعداد دليل التنزيل، وما إلى ذلك).
- يجب ألا يتم دمج هذا المعالج مع أي معالج آخر مسؤول عن تنزيل الملفات (BulkFileRetrieverHttpsGetAcceptAllCertsHandler).
BulkFileRetrieverHttpsGetAcceptAllCertsHandler
يقوم هذا المعالج بتنزيل الملفات التي لها URI ببادئة https وhttp وftp وfile. وإذا كان يستخدم SSL، فإنه يتجاهل كل الأخطاء في الشهادة. ويكون هذا مفيدًا لأشياء مثل الشهادات الموقعة ذاتيًا التي قد يتم استخدامها داخليًا فقط أو في بيئات التطوير.
التنفيذ
D2L.IM.IPSIS.Default.Bulk.Handlers.BulkFileRetrieverHttpsGetAcceptAllCertsHandler
السلوك المتوقع
هذه هي الفئة المحددة التي تقوم بتطبيق معالج IBulkFileRetrieverHandler. يؤدي المعالج المهام الآتية:
- يتلقى المعالج طلب IBulkFileRetriever يحتوي على BulkFileUrl.
- يقوم بتحديث حالة IBulkFileUrl إلى قيد التنزيل.
- يفترض هذا السلوك أنه لا توجد مصادقة مطلوبة للاتصال إذا لم يتم تمرير أي مصادقة في الطلب.
- يفتح اتصال https بعنوان URL البعيد الموجود في مادة IBulkFileUrl ويقوم بإجراء طلب GET.
- يقوم بتنزيل الملف وحفظه في مسار الحفظ المحلي.
- يقوم بتحديث حالة الملف إلى تم التنزيل.
سلوك الخطأ
- إذا تم تمرير مجموعة اسم مستخدم وكلمة مرور غير صالحة، فسيتم طرح استثناء مصادقة ويدرج المعالج سجل خطأ في قاعدة بيانات التسجيل.
- إذا تعذر الوصول إلى عنوان URL، فيقوم المعالج بطرح استثناء مصادقة ويدرج سجل خطأ في قاعدة بيانات التسجيل.
- إذا انتهت المهلة، فيقوم المعالج بطرح استثناء انتهاء المهلة ويدرج سجل خطأ في قاعدة بيانات التسجيل.
ملاحظات التكوين
- يقوم هذا المعالج بتنزيل الملفات بالفعل، ولذلك يجب وضعه بعد أي معالجات تقوم بتكوين الطلب الصادر (أي إضافة بيانات اعتماد، وإعداد دليل التنزيل، وما إلى ذلك).
- يجب ألا يتم دمج هذا مع أي معالج آخر مسؤول عن تنزيل الملفات (BulkFileRetrieverHttpsGetAcceptAllCertsHandler).
BulkFileRetrieverConfigVariableDefinedDownloadPathHandler
يعيِّن المسار المحلي إلى دليل محدد في بيئة الإدارة التنظيمية الخاصة بـ Desire2Learn (DOME) باستخدام اسم الملف الأصلي من الطلب.
التنفيذ
D2L.IM.IPSIS.Default.Bulk.Handlers.BulkFileRetrieverConfigVariableDefinedDownloadPathHandler
السلوك المتوقع
- إذا تم تعريف متغير التكوين، فإن المعالج يعيّن مسار الحفظ المحلي إلى {d2l.Integrations.IPSIS>LocalBulkFileDownloadPath}\{SystemId}.{TransactionId}\{filename defined in remotefileurl}
- يتم تجريد TransactionId من أي أحرف غير مسموح بها في المسارات، وكل رموز '\' .
- إذا لم يكن المسار موجودًا، فسيحاول النظام إنشاءه أولاً.
سلوك الخطأ
- إذا لم يتم تعريف متغير التكوين، فسيتم طرح استثناء.
- يمكن أيضًا طرح الاستثناءات إذا كان محرك الأقراص، على سبيل المثال، غير صالح في متغير التكوين.
ملاحظة التكوين
أول معالج في القائمة يستبدل البدائل لتحديد موقع وجهة الملف.
BulkFileRetrieverRetrieveAuthenticationCredientialsHandler
يقوم بتعيين اسم المستخدم وكلمة المرور في الطلب استنادًا إلى عنوان URL للملف والمعلومات الواردة في جدول نقاط النهاية.
التنفيذ
D2L.IM.IPSIS.Default.Bulk.Handlers.BulkFileRetrieverRetrieveAuthenticationCredientialsHandler
السلوك المتوقع
يؤدي المعالج المهام الآتية:
- يحصل على قائمة بنقاط النهاية التي تم وضع علامة عليها ضمن النوع BulkFileDownload من جدول نقطة النهاية.
- إذا كان عنوان URL الخاص بالملف البعيد يبدأ بأي من نقاط النهاية هذه (مثل "http://mysite.com/cookies/fun.xml" يبدأ بـ "http://mysite.com")، فسيحصل المعالج على بيانات الاعتماد من إدخال نقطة النهاية هذا ويطبقها على الطلب.
- إذا لم يطابق عنوان url البعيد أي نقاط نهاية، فلن يقوم المعالج بأي شيء.
القيود المعروفة
بسبب قيود النظام، يدعم النظام حاليًا نقطة نهاية BulkFileDownload واحدة فقط لكل نظام مصدر.
سلوك الخطأ
إذا عثر المعالج على أكثر من نقطة نهاية واحدة تتطابق مع عنوان url البعيد، فسيقوم بطرح BulkProcessingFailedException برسالة خطأ وصفية (بما فيها اسم الملف الذي فشل).
ملاحظة التكوين
يجب وضع هذا المعالج قبل أي معالج يقوم بتنزيل الملف بالفعل.