تكامل Ally مع D2L Brightspace

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

1. إنشاء المستخدم والدور. يجب القيام بذلك قبل إجراء أي اتصال مع جهة اتصال Anthology Ally. 
2. التكوين الرئيسي
3. تكوين LTI
   • تكوين العميل
   • تقرير المؤسسة
   • تقرير إمكانية وصول ذوي الاحتياجات الخاصة إلى المقرر الدراسي

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

1. إنشاء دور جديد
   1. من قائمة "Settings" (الإعدادات)​​​ (رمز الترس) انتقل إلى "Roles and permissions" (الأدوار والصلاحيات) 
   2. ابدأ عملية إنشاء الدور عن طريق تحديد الزر "Create/Copy" (إنشاء/نسخ)
   3. إنشاء دور فارغ جديد عن طريق تحديد الزر "Start Fresh" (البدء من جديد)
   4. إعدادات الدور:  
      • الاسم:الدور Ally REST
      • الوصف:مجموعة الصلاحيات التي تسمح لـ Ally بالاتصال بشكل آمن بالواجهات Brightspace REST API
      • تمكين "Cascading Role" (الدور المتتالي) 
        اترك الخيار "Primary Facilitator" (الاستشاري الرئيسي) معطلًا؛ حيث إنه قد لا يكون مطلوبًا بعد الآن
      • الاسم المستعار للدور: ally 
      • لا حاجة إلى إجراء أي تغييرات ضمن "Tool Behavior Options" (خيارات سلوك الأداة)، يمكن أن يظل كل شيء معطلًا
      • لا حاجة إلى إجراء أي تغييرات ضمن "Classlist Display Options" (خيارات عرض قائمة الفصل الدراسي)، يمكن أن يظل كل شيء معطلًا
      • ضمن "Course Access Options" (خيارات الوصول إلى المقرر الدراسي):  
        • تمكين جميع خيارات الوصول:  
          • الوصول إلى المقررات الدراسية غير النشطة
          • الوصول إلى المقررات الدراسية السابقة
          • الوصول إلى المقررات الدراسية المستقبلية
        • يمكن الاحتفاظ بإعداد "Sections and  Groups" (الأقسام والمجموعات) على "None of the above"  (لا شيء مما سبق)
   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. قم بالتصفية حسب "Content tool" (أداة المحتوى) وامنح الصلاحيات التالية في العمود "Course Offering" (عرض المقرر الدراسي):  
      • عرض محتوى المقرر الدراسي
      • تجميع المحتوى وتنزيله
      • تنزيل موضوعات المحتوى
      • عرض المحتوى الذي لم يتم نشره
      • إدارة المحتوى
      • إنشاء وحدات نمطية وموضوعات وتحريرها
      • حذف الوحدات النمطية والموضوعات (هذه الصلاحية ضرورية لحذف الصور التي يمكن أن تؤدي إلى نوبة صرع)
   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.  من قائمة "Settings" (الإعدادات) (رمز الترس)، انتقل إلى "Users" (المستخدمون)
   2. ابدأ عملية إنشاء دور عن طريق تحديد الزر "New User" (مستخدم جديد)
   3. الإعدادات:  
      • الاسم الأول: Ally
      • اسم العائلة: المستخدم
      • الدور: الدور Ally REST
      • اسم المستخدم:allyuser
      • حدد "Manually set password" (تعيين كلمة المرور يدويًا)، وأدخل كلمة مرور آمنة بشكل ملائم في حقل "Password" (كلمة المرور). من الأهمية بمكان أن تكون كلمة المرور هذه آمنة بما فيه الكفاية، حيث إن تغييرها لاحقًا يتطلب إعداد كل شيء مرة أخرى.
      • قم بحفظ المستخدم عن طريق تحديد الزر "Save" (حفظ)

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

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

1. من قائمة "Settings" (الإعدادات) (رمز الترس)، انتقل إلى "Manage extensibility" (إدارة إمكانية الامتداد)
2. تأكد من أنك في علامة التبويب OAuth 2.0
3. حدد الزر "Register an App" (تسجيل تطبيق).
4. املأ النموذج كما يلي: 
   • الاسم: Ally
   • عنوان URI الخاص بإعادة التوجيه: <عنوان URI الخاص بإعادة التوجيه الذي وفَّرته لك جهة اتصال Anthology>
     على سبيل المثال https://[Ally env]/api/v1/d2l/callback?clientId=[Ally client ID]
   • النطاق: المحتوى:*:قراءة المحتوى:الملف:الكتابة الأساسية:*:* مخصص:الوصول إلى المحتوى:قراءة التسجيل:الوحدة التنظيمية:قراءة
   • المطالبة بموافقة المستخدم: لا
   • تمكين الرموز المميزة للتحديث: نعم
   • أقبل اتفاقية المطورين غير التجارية: نعم
5. حدد الزر "Register" (تسجيل)
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
    تكامل Ally يستقر في d2l.3rdParty.Ally.*
13. قم بإضافة قيم التكوين باستخدام القيم التي وفَّرتها لك جهة اتصال Blackboard الخاصة بك 
    • ClientId (مُعرِّف العميل)
    • ClientSecret (كلمة سر العميل) – ستقدم Brightspace إدخالين. استخدم كلمة سر LTI لكلا الإدخالين.
    • ScriptUrl (عنوان URL الخاص بالبرنامج النصي)
14. من قائمة "Settings" (الإعدادات) (رمز الترس)، انتقل إلى "Organizational Tools" (الأدوات التنظيمية)
15. ابحث عن الصف "Ally Integration" (تكامل Ally)، وبدِّل خانة الاختيار بحيث يتم تشغيل هذا الخيار

تكوين LTI

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