Skip to main content

تكامل Ally مع D2L Brightspace

لتحقيق التكامل بين Ally ومثيل D2L Brightspace الخاص بك، تحتاج إلى اتباع الخطوات التالية:

  1. إنشاء المستخدم والدور. يجب القيام بذلك قبل إجراء أي اتصال مع جهة اتصال Anthology Ally.

  2. التكوين الرئيسي

  3. تكوين LTI

    • تكوين العميل

    • تقرير المؤسسة

    • تقرير إمكانية وصول ذوي الاحتياجات الخاصة إلى المقرر الدراسي

إنشاء المستخدم والدور

  1. إنشاء دور جديد 

    1. من قائمة الإعدادات (أيقونة الترس)، انتقل إلى الأدوار والأذونات 

    2. ابدأ عملية إنشاء الدور عن طريق تحديد الزر إنشاء/نسخ 

    3. قم بإنشاء دور فارغ جديد عن طريق تحديد الزر بدء الحديث 

    4. إعدادات الدور: 

      • الاسم: دور Ally REST 

      • الوصف: مجموعة الأذونات للسماح ل Ally بالاتصال بأمان مع واجهات برمجة تطبيقات Brightspace REST 

      • تمكين الدور المتتالي 

        اترك خيار الميسر الأساسي معطلا لأنه قد لا تكون هناك حاجة إليه بعد الآن

      • الاسم المستعار للدور: ally 

      • لا يلزم إجراء تغييرات ضمن خيارات سلوك الأداة ، يمكن أن يظل كل شيء معطلا 

      • لا يلزم إجراء تغييرات ضمن خيارات عرض قائمة الفئة ، يمكن أن يظل كل شيء معطلا 

      • ضمن "Course Access Options" (خيارات الوصول إلى المقرر الدراسي): 

        • تمكين جميع خيارات الوصول: 

          • الوصول إلى المقررات الدراسية غير النشطة 

          • الوصول إلى المقررات الدراسية السابقة 

          • الوصول إلى المقررات الدراسية المستقبلية 

        • الأقسام والمجموعات يمكن أن تظل مضبوطة على لا شيء مما سبق 

    5. تفاعلات الدور: 

      1. ضمن "Enroll Ally REST Role" (تسجيل دور Ally REST)، حدد خانة الاختيار عند تداخل الصف "Administrator" (المسؤول) مع العمود "Organization" (منتدى المجموعة). يسمح هذا بإنشاء مستخدم بهذا الدور لاحقًا. 

      2. ضمن "Search Ally REST Role" (البحث عن دور Ally REST)، حدد خانة الاختيار عند تداخل الصف "Administrator" (المسؤول) مع العمود "Organization" (منتدى المجموعة). وهذا يسمح بالبحث عن مستخدم له هذا الدور لاحقًا. 

      3. لا توجد تغييرات إضافية ضرورية.

  2. تكوين أذونات الدور 

    بمجرد الحفظ، سيظهر دور Ally REST الجديد في أسفل قائمة الأدوار. افتح القائمة المنسدلة، وحدد "Edit Permissions" (تحرير الصلاحيات). في هذه الشاشة، يجب منح الصلاحيات التالية: 

    1. قم بالتصفية حسب أداة المحتوى وامنح الأذونات التالية في عمود عرض المقرر الدراسي: 

      • عرض محتوى المقرر الدراسي 

      • تجميع المحتوى وتنزيله 

      • تنزيل موضوعات المحتوى 

      • عرض المحتوى الذي لم يتم إصداره 

      • إدارة المحتوى 

      • إنشاء وتحرير الوحدات والموضوعات 

      • حذف الوحدات والموضوعات (ضرورية لحذف الصور التي يحتمل أن تسبب النوبات)

    2. وحدة تحكم إدارة المقرر الدراسي

      • راجع معلومات الدورة التدريبية (عرض الدورة التدريبية). هذه الصلاحية مطلوبة لكي تسترد Ally الوحدات التنظيمية للقسم.

    3. قائمة الفصول

      • لديه إمكانية وصول إلى قائمة الفصل الدراسي

    4. المناقشات 

      • عرض المناقشات (عرض الدورة التدريبية)

        يعد ذلك ضروريا لسرد الروابط لموضوع المناقشة في الدورة التدريبية وجدول المحتويات. 

    5. الاختبارات الموجزة 

      • عرض الاختبارات الموجزة (عرض الدورة)

        يعد ذلك ضروريا لإدراج الروابط إلى الاختبارات الموجزة في جدول المحتويات الخاص بالدورة التدريبية. 

    6. محرر الوحدة التنظيمية 

      • عرض محرر الوحدة التنظيمية (منتدى المجموعة)  

      • يمكن إضافة أنواع وحدات تنظيمية (منتدى المجموعة) وتحريرها.

        نحن بحاجة إلى هذا الدور لسرد الفصول الدراسية. للأسف، لا توجد صلاحية "للقراءة فقط" متاحة. لن يقوم Ally مطلقا بإنشاء معلومات نوع منتدى المجموعة أو تحريرها.

    7. الأمن 

      • الاطلاع على الأدوار والصلاحيات (منتدى المجموعة)

    8. خصوصية معلومات المستخدم

      1. راجع أسماء المستخدمين (عرض الدورة التدريبية)

        يسمح هذا الإذن ل Ally برؤية معرف المستخدم، ولكن لا شيء آخر. لا يتم تخزين هذه المعلومات مطلقًا، ولكن لأسباب فنية، من الضروري تحديد عدد الطلاب المسجلين في المقرر الدراسي.

      2. انظر الأسماء الأولى (منتدى المجموعة)

        ضروري لاسترداد اسم المستخدم وبريده الإلكتروني عند طلب المساعدة. لا يتم تخزين هذه المعلومات من طرف Ally، بل تمررها فحسب في البريد الإلكتروني المتعلق بالمساعدة.

      3. انظر أسماء العائلة (منتدى المجموعة)

        ضروري لاسترداد اسم المستخدم وبريده الإلكتروني عند طلب المساعدة. لا يتم تخزين هذه المعلومات من طرف Ally، بل تمررها فحسب في البريد الإلكتروني المتعلق بالمساعدة.

      4. راجع عناوين البريد الإلكتروني (منتدى المجموعة)

        ضروري لاسترداد اسم المستخدم وبريده الإلكتروني عند طلب المساعدة. لا يتم تخزين هذه المعلومات من طرف Ally، بل تمررها فحسب في البريد الإلكتروني المتعلق بالمساعدة.

    9. المستخدمون

      1. عرض تسجيلات المستخدمين (عرض المقرر الدراسي)

      2. البحث عن "الطالب" (عرض الدورة)

        الطالب هو الاسم الافتراضي لدور الطالب. إذا كانت مؤسستك تستخدم اسمًا مختلفًا لنوع المستخدم هذا، فقم بتمكين البحث عن '...' بدلًا من ذلك. تُعد هذه الصلاحية ضرورية لاسترداد عدد الطلاب في عرض المقرر الدراسي. يتم إخفاء هوية البيانات التي يتم إرسالها.

      3. عرض عنوان البريد الإلكتروني للمستخدمين (منتدى المجموعة)

        من الضروري استرداد البريد الإلكتروني للمستخدم عند طلب المساعدة. لا يتم تخزين هذه المعلومات من طرف Ally، بل تمررها فحسب في البريد الإلكتروني المتعلق بالمساعدة.

      4. راجع أداة إدارة المستخدم (منتدى المجموعة)

        من الضروري استرداد اسم المستخدم وبريده الإلكتروني عندما يطلب المساعدة. لا يتم تخزين هذه المعلومات من طرف Ally، بل تمررها فحسب في البريد الإلكتروني المتعلق بالمساعدة).

  3. إنشاء المستخدم

    بمجرد تكوين الدور، يمكن إنشاء مستخدم جديد باستخدام هذه المجموعة المحدودة من الأذونات. 

    1. من قائمة الإعدادات (رمز الترس)، انتقل إلى المستخدمون 

    2. بدء عملية إنشاء دور عن طريق تحديد الزر مستخدم جديد 

    3. الإعدادات: 

      • الاسم الأول: Ally 

      • اسم العائلة: مستخدم 

      • الدور: دور Ally REST 

      • اسم المستخدم: allyuser 

      • حدد "Manually set password" (تعيين كلمة المرور يدويًا)، وأدخل كلمة مرور آمنة بشكل ملائم في حقل "Password" (كلمة المرور). من الأهمية بمكان أن تكون كلمة المرور هذه آمنة بما فيه الكفاية، حيث إن تغييرها لاحقًا يتطلب إعداد كل شيء مرة أخرى.

      • احفظ المستخدم عن طريق تحديد الزر حفظ 

التكوين الرئيسي

هام

تأكد من إتمام تكوين المستخدم والدور أولًا. يتم التكوين التالي في أثناء الاتصال بإحدى جهات اتصال Anthology Ally. تأكد من جدولة موعد للاتصال الخاص بالتكوين أولًا.

  1. من قائمة "Settings" (الإعدادات) (رمز الترس)، انتقل إلى "Manage extensibility" (إدارة إمكانية الامتداد)

  2. تأكد من أنك في علامة التبويب OAuth 2.0

  3. حدد الزر تسجيل تطبيق

  4. املأ النموذج كما يلي:

    • الاسم: Ally

    • إعادة توجيه URI: <عنوان URL لإعادة التوجيه مقدم من جهة اتصال Anthology>

      على سبيل المثال https://[Ally env]/api/v1/d2l/callback?clientId=[Ally client ID]

    • النطاق: المحتوى: *: قراءة المحتوى: ملف: كتابة النواة: * :* مخصص: contentaccess: قراءة تسجيل: orgunit: قراءة

    • مطالبة بموافقة المستخدم: لا

    • تمكين الرموز المميزة للتحميل: نعم

    • أوافق على اتفاقية المطور غير التجاري: نعم

  5. حدد الزر تسجيل

  6. سيتم تقديم تفاصيل التطبيق الذي تم إنشاؤه حديثًا لك الآن. انسخ مُعرِّف العميل والمفتاح السري، وشاركهما مع جهة اتصال Anthology Ally الخاصة بك.

  7. بعد الحصول على التأكيد من Anthology Ally، حدد "Update" (تحديث)

  8. تسجيل الدخول إلى Brightspace بصفتك المستخدم allyuser

  9. انتقل إلى عنوان URL الذي وفَّرته لك جهة اتصال Anthology Ally الخاصة بك (ضمن تفاصيل التكامل بين المسؤول والعميل في Ally). على الرغم من أن عنوان URL هذا ينتهي اسم مضيفه بـ .ally.ac، فإنه ستتم إعادة توجيهك تلقائيًا إلى مثيل Brightspace الخاص بك. ستعرض Brightspace شاشة تطلب منك صلاحية التفاعل Ally مع الواجهة REST API. حدد "Accept" (قبول).

  10. إذا سارت الأمور على ما يرام ، فيجب أن يتم عرض رسالة النجاح التالية: تم إعداد تكامل REST بنجاح!

  11. من قائمة "Settings" (الإعدادات) (رمز الترس)، انتقل إلى "Config Variable Browser" (تكوين المستعرض المتغير)

  12. حدد موقع تكوينات Ally باستخدام قائمة الشجرة على اليسار: 3rdParty > Ally

    يعيش تكامل الحليف في d2l.3rdParty.Ally.*

  13. أضف قيم التكوين مع القيم التي توفرها لك جهة اتصال Blackboard

    • ClientId

    • ClientSecret (كلمة سر العميل) – ستقدم Brightspace إدخالين. استخدم كلمة سر LTI لكلا الإدخالين.

    • ScriptUrl (عنوان URL الخاص بالبرنامج النصي)

  14. من قائمة "Settings" (الإعدادات) (رمز الترس)، انتقل إلى "Organizational Tools" (الأدوات التنظيمية)

  15. ابحث عن الصف "Ally Integration" (تكامل Ally)، وبدِّل خانة الاختيار بحيث يتم تشغيل هذا الخيار

تكوين LTI

اتبع هذه الخطوة لتكوين LTI وتسجيل أدوات Ally.