تثبيت المكونات الإضافية لأدوات Ally وعامل التصفية والتقرير الخاصين به

تدعم Ally الإصدار Moodle 3.4 والإصدارات الأحدث.

  1. قم بتنزيل الإصدار المطلوب من أداة مسؤول Ally أو استنساخه من github.

    1. التنزيل كملف مضغوط ZIP
      1. قم بتغيير إصدار الفرع، إذا لزم الأمر.
      2. راجع ملف version.php لمعرفة ما إذا كان رقم إصدار Moodle المطلوب وإصداره ("يتطلب") يطابق إصدار Moodle لديك. أي، بالنسبة لـ Moodle 3.4

        إصدار $plugin-> = '3.4.3';

        يتطلب $plugin-> = 2017111300;

        ينبغي أن يعمل الإصدار "3.4.3" مع تثبيت Moodle 3.4. في حالة عدم تطابق هذه المعلمات مع تثبيت Moodle لديك، فقد تحتاج إلى تغيير الفرع مرة أخرى.

        المزيد عن إصدارات Moodle وأرقام الإصدارات المتوافقة

      3. تنزيل المستودع باستخدام "الاستنساخ أو التنزيل > تنزيل ملف ZIP مضغوط"
    2. استنساخ مستودع git
      1. الوصول إلى مجلد الأدوات.

        cd [moodle location]/admin/tool

      2. استنساخ المستودع
        • استخدام SSH

          git clone [email protected]:blackboard-open-source/moodle-tool_ally ally

        • استخدام HTTP

          git clone https://github.com/blackboard-open-source/moodle-tool_ally.git ally

      3. تحقق من الفرع المقابل، أي بالنسبة لـ Moodle 3.4، يعد MOODLE_34_STABLE

        git checkout MOODLE_34_STABLE

        يمكن استخدام التحقق من الفرع للحصول على التحديثات أيضًا، لذا، إذا قمت بتحديث تثبيت Moodle لديك، فستتمكن على الفور من التحقق من الفرع المقابل. في حالة عدم العثور على الفرع، فقد يكون المستودع لديك قديمًا، ويمكن إصلاح ذلك عن طريق إجراء الإحضار:

        git fetch

  2. قم بتنزيل الإصدار المطلوب من عامل تصفية Ally أو استنساخه من github.

    1. التنزيل كملف مضغوط ZIP
      1. تغيير إصدار الفرع إذا لزم الأمر
      2. راجع ملف version.php لمعرفة ما إذا كان رقم إصدار Moodle المطلوب وإصداره ("يتطلب") يطابق إصدار Moodle لديك. أي، بالنسبة لـ Moodle 3.4

        إصدار $plugin-> = '3.4.3';

        يتطلب $plugin-> = 2017111300;

        ينبغي أن يعمل الإصدار "3.4.3" مع تثبيت Moodle 3.4. في حالة عدم تطابق هذه المعلمات مع تثبيت Moodle لديك، فقد تحتاج إلى تغيير الفرع مرة أخرى.

        المزيد عن إصدارات Moodle وأرقام الإصدارات المتوافقة.

      3. تنزيل المستودع باستخدام "الاستنساخ أو التنزيل > تنزيل ملف ZIP مضغوط"
    2. استنساخ مستودع git
      1. الوصول إلى مجلد عوامل التصفية.

        cd [moodle location]/filter

      2. استنساخ المستودع
        • استخدام SSH

          git clone [email protected]:blackboard-open-source/moodle-filter_ally ally

        • استخدام http

          git clone https://github.com/blackboard-open-source/moodle-filter_ally.git ally

      3. تحقق من الفرع المقابل، أي بالنسبة لـ Moodle 3.4، يعد MOODLE_34_STABLE

        git checkout MOODLE_34_STABLE

        يمكن استخدام التحقق من الفرع للحصول على التحديثات أيضًا، لذا، إذا قمت بتحديث تثبيت Moodle لديك، فستتمكن على الفور من التحقق من الفرع المقابل. في حالة عدم العثور على الفرع، فقد يكون المستودع لديك قديمًا، ويمكن إصلاح ذلك عن طريق إجراء الإحضار:

        git fetch

  3. قم بتنزيل الإصدار المطلوب من أداة LTI لتقرير Ally من github.

    1. التنزيل كملف مضغوط ZIP
      1. تغيير إصدار الفرع إذا لزم الأمر
      2. راجع ملف version.php لمعرفة ما إذا كان رقم إصدار Moodle المطلوب وإصداره ("يتطلب") يطابق إصدار Moodle لديك. أي، بالنسبة لـ Moodle 3.4

        إصدار $plugin-> = '3.4.3';

        يتطلب $plugin-> = 2017111300;

        ينبغي أن يعمل الإصدار "3.4.3" مع تثبيت Moodle 3.4. في حالة عدم تطابق هذه المعلمات مع تثبيت Moodle لديك، فقد تحتاج إلى تغيير الفرع مرة أخرى.

        المزيد عن إصدارات Moodle وأرقام الإصدارات المتوافقة.

      3. تنزيل المستودع باستخدام "الاستنساخ أو التنزيل > تنزيل ملف ZIP مضغوط"
    2. استنساخ مستودع git
      1. الوصول إلى مجلد التقارير

        cd [moodle location]/report

      2. استنساخ المستودع
        • استخدام SSH

          git clone [email protected]:blackboard-open-source/moodle-report_allylti ally

        • استخدام HTTP

          git clone https://github.com/blackboard-open-source/moodle-report_allylti.git ally

      3. تحقق من الفرع المقابل، أي بالنسبة لـ Moodle 3.4، يعد MOODLE_34_STABLE

        git checkout MOODLE_34_STABLE

        يمكن استخدام التحقق من الفرع للحصول على التحديثات أيضًا، لذا، إذا قمت بتحديث تثبيت Moodle لديك، فستتمكن على الفور من التحقق من الفرع المقابل. في حالة عدم العثور على الفرع، فقد يكون المستودع لديك قديمًا، ويمكن إصلاح ذلك عن طريق إجراء الإحضار:

        git fetch

  4. تحقق من بنية المجلد.

    يجب تسمية دليل أداة المسؤول ally. يجب أن يحتوي على مسار كما يلي:

    [yourmoodledir]/admin/tool/ally

    يجب تسمية دليل عامل التصفية ally. يجب أن يحتوي على مسار كما يلي:

    [yourmoodledir]/filter/ally

    يجب تسمية دليل التقرير allylti. يجب أن يحتوي على مسار كما يلي:

    [yourmoodledir]/report/allylti

  5. تأكد من قابلية قراءة كل مجلد ومحتوياته من قِبل خادم الويب لديك.
  6. قم بتسجيل الدخول كمستخدم مسؤول إلى موقع Moodle لديك، وافتح صفحة المسؤول. ينبغي أن يتحقق ذلك من المكونات الإضافية الجديدة، ويقدم لك خيار ترقية قاعدة بيانات Moodle الآن. حدد هذا الزر لتثبيت المكونات الإضافية.
  7. بعد تثبيت المكونات الإضافية، انتقل إلى إدارة النظام > المكونات الإضافية > أدوات المسؤول > Ally.
  8. حدد التكوين التلقائي لخدمة ويب Ally.

    في الشاشة التالية، سيكون هناك رمز مميز لخدمة الويب وعنوان URL لاختبار خدمة الويب لـ ally.

    يجب أن يكون عنوان URL هذا متاحًا للوصول إليه مباشرة من الإنترنت حتى يتمكن Ally من استخدامه.

    في حالة النجاح، ستحتاج إلى نسخ رمز خدمة الويب لـ Ally، ورابط خدمة الويب، وتقديمه إلى المستشار الفني لـ Ally لديك عبر مشاركة IronBox التي سيتم إعدادها، ومنحك الوصول إليها عبر رابط البريد الإلكتروني. سيتم الاتصال بك بمجرد إعداد كل شيء والانتهاء منه، مع تقديم "المفتاح"، و"كلمة السر"، و"عنوان URL للتشغيل"، و"عنوان URL لتحديثات الملف"، و"معرف الوحدة التابعة".

    إذا كان مثيل Moodle الخاص بك يستخدم الحقول المخصصة المطلوبة لحسابات المستخدمين، قم بـ "تسجيل الدخول باسم" مستخدم Ally Webservice الذي يتم إنشاؤه بواسطة التكوين التلقائي للمكون الإضافي لضمان ملء هذه الحقول المخصصة وحفظها.


تكوين المكون الإضافي لـ Moodle

سيقوم المستشار الفني لـ Ally بإنشاء الوحدة التابعة لـ Ally باستخدام رمز Moodle Webservice المميز الذي تم إنشاؤه في القسم السابق، وسيزودك بتفاصيل تكوين المكون الإضافي لـ Ally.

  1. سجل الدخول كمسؤول Moodle.
  2. من إدارة الموقع، حدد المكونات الإضافية وأدوات المسؤول. حدد تكوين Ally.
  3. أدخل التفاصيل التالية
    • مؤلفو المحتوى: أدوار المستخدمين الذين يعتبروا مؤلفي المحتوى. يجب أن تتمثل في: المدير، أو منشئ المقرر الدراسي، أو المدرس (الإعدادات الافتراضية).

      لا ينبغي تغيير هذا عادةً، يرجى عدم تعيير هذا الإعداد دون استشارة المستشار الفني لـ Ally.

    • المفتاح: مفتاح LTI الذي تم توفيره بواسطة المستشار الفني لـ Ally.
    • كلمة السر: كلمة سر LTI التي تم توفيرها بواسطة المستشار الفني لـ Ally.
    • عنوان URL للتشغيل: عنوان URL لتشغيل LTI الذي تم توفيره بواسطة المستشار الفني لـ Ally.
    • عنوان URL لتحديث الملف: عنوان URL للحدث/تحديث الملف الذي تم توفيره بواسطة المستشار الفني لـ Ally. https://[AllyEnvironment].ally.ac/api/v1/events
    • معرف الوحدة التابعة: معرف الوحدة التابعة الذي تم توفيره بواسطة المستشار الفني لـ Ally.
    • نطاق السجل: بسيط
  4. احفظ التغييرات.

التقرير المؤسسي لـ Ally

بمجرد تكوين المكون الإضافي لـ Ally، ستتمكن من الوصول إلى التقرير المؤسسي الخاص بـ Ally.

لن تكون البيانات موجودة في التقرير إلا بعد حدوث مزامنة المقرر الدراسي لـ Ally وإنشاء التقرير الأولي.

للوصول إلى التقرير المؤسسي لـ Ally، انتقل إلى إدارة الموقع وحدد التقارير. حدد إمكانية وصول ذوي الاحتياجات الخاصة.

المزيد عن التقرير المؤسسي لـ Ally


عامل تصفية Ally

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

تمكين عامل تصفية Ally

  1. من إدارة الموقع، حدد المكونات الإضافية ونظرة عامة على المكونات الإضافية.
  2. انتقل إلى الأسفل إلى قسم عوامل تصفية النص، وقم بتمكين عامل تصفية Ally.
  3. انقل عامل تصفية Ally إلى أعلى قائمة عامل التصفية.

الوصول إلى واجهة مستخدم تكوين Ally

نقدم لك إرشادات حول كيفية الوصول إلى تكوين Ally أثناء الإعداد. إذا كنت لا تزال غير قادر على الوصول،  فأرسل طلبًا على Behind the Blackboard.

تكوين المقررات الدراسية في Ally


تكوين المقررات الدراسية

انتقل إلى صفحة تكوين Ally الخاصة بك، وقم بتشغيل Ally لجميع المقررات الدراسية، أو حدد مقررًا دراسيًا واحدًا تلو الآخر. فالأمر يرجع لك.

  1. اعرض عدد المقررات الدراسية التي يستخدمها Ally.
  2. قم بتشغيل Ally أو إيقاف تشغيله لجميع المقررات الدراسية الحالية. قرر مسبقًا ما إذا كنت تريد تمكينه لجميع المقررات الدراسية في المستقبل أيضًا.
  3. ابحث عن الدورات الفردية، أو قم بتصفية كل الدورات حسب التمكين والتعطيل والفصل الدراسي.
  4. قم بتشغيل Ally أو إيقاف تشغيله للمقررات الدراسية الفردية.

تشغيل Ally أو إيقاف تشغيله لمقرر دراسي فردي

عندما يكون Ally قيد التشغيل، يمكن للمدرسين والطلاب الاستفادة من درجات إمكانية وصول ذوي الاحتياجات الخاصة، وملاحظات المدرس، والتنسيقات البديلة التي يوفرها Ally.

تتم إتاحة التقرير المؤسسي لجميع المقررات الدراسية. لا يهم إذا كان Ally في مقرر دراسي أم لا. يظهر المقرر الدراسي في التقرير المؤسسي.

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

حدد تمكين أو تعطيل أسفل عمود ممكَّن لتشغيل Ally أو إيقاف تشغيله.

  • إيقاف تشغيل Ally: حدد تمكين تكامل واجهة مستخدم المقرر الدراسي لتشغيله
  • Ally قيد التشغيل: حدد تعطيل تكامل واجهة مستخدم المقرر الدراسي لإيقاف تشغيله

تشغيل Ally أو إيقاف تشغيله لجميع المقررات الدراسية

هل أنت غير متأكد ما إذا كانت جميع المقررات الدراسية تستخدم Ally أم لا؟ في الجزء العلوي من صفحة تكوين Ally، راجع عدد المقررات الدراسية التي تستخدم Ally حاليًا.

عندما يكون Ally قيد التشغيل، يمكن للمدرسين والطلاب الاستفادة من درجات إمكانية وصول ذوي الاحتياجات الخاصة، وملاحظات المدرس، والتنسيقات البديلة التي يوفرها Ally.

تتم إتاحة التقرير المؤسسي لجميع المقررات الدراسية. لا يهم إذا كان Ally في مقرر دراسي أم لا. يظهر المقرر الدراسي في التقرير المؤسسي.

يمكنك تشغيل Ally أو إيقاف تشغيله في كل مقرر دراسي حالٍ من صفحة تكوين Ally. حدد تعطيل/تمكين جميع المقررات الدراسية، وحدد تعطيل أو تمكين.

حدد التمكين في المقررات الدراسية المستقبلية إذا كنت تريد تشغيل Ally تلقائيًا في جميع المقررات الدراسية الجديدة.

في حالة عدم قيامك بتحديد هذا الخيار، لن يتم تمكين Ally المقررات الدراسية الجديدة. في حالة الرغبة في تشغيل Ally في وقت لاحق، قم بتشغيل Ally لمقررات دراسية فردية.

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


تشغيل Ally لجميع المقررات الدراسية الجديدة فقط

عندما يكون Ally قيد التشغيل، يمكن للمدرسين والطلاب الاستفادة من درجات إمكانية وصول ذوي الاحتياجات الخاصة، وملاحظات المدرس، والتنسيقات البديلة التي يوفرها Ally.

تتم إتاحة التقرير المؤسسي لجميع المقررات الدراسية. لا يهم إذا كان Ally في مقرر دراسي أم لا. يظهر المقرر الدراسي في التقرير المؤسسي.

حدد التمكين في المقررات الدراسية المستقبلية إذا كنت تريد تشغيل Ally تلقائيًا في جميع المقررات الدراسية الجديدة.

في حالة عدم قيامك بتحديد هذا الخيار، لن يتم تمكين Ally المقررات الدراسية الجديدة. في حالة الرغبة في تشغيل Ally في وقت لاحق، قم بتشغيل Ally لمقررات دراسية فردية.

تكوين إعدادات مساعدة Ally


تكوين إعدادات مساعدة مستخدم Ally

قم بتكوين رسائل المساعدة المخصصة التي يتم عرضها في التنسيقات البديلة واشتراطات ملاحظات المدرس. يمكن استخدام رسائل المساعدة المخصصة لتوجيه الطلاب والمدرسين إلى الوثائق المؤسسية الموجودة حاليًا، ومشاركة معلومات الاتصال، وما إلى ذلك. في حالة عدم تكوين أية رسالة مخصصة، تشير روابط المساعدة إلى هذه الصفحات في مساعدة Blackboard:

  • التنسيقات البديلة: تشرح هذه الصفحة كيفية استخدام التنسيقات البديلة المختلفة وأوقات استخدامها
  • مساعدة المدرس: كل ما يحتاج المدرسون معرفته عن Ally في مقرراتهم الدراسية

يمكن تكوين محتوى المساعدة المخصص في واجهة مستخدم تكوين Ally، مع استخدام تنسيق التصغير للمساعدة في تقديم رسالة منظمة يسهل الوصول إليها.

  1. انتقل إلى تكوين Ally، وحدد إعدادات المساعدة.
  2. اختر الخيار الافتراضي أو خيار "المساعدة المخصصة" لكل من مساعدة ملاحظات المدرس ومساعدة التنسيقات البديلة.
  3. إذا اخترت الخيار المخصص، فقم بتحرير الرسالة "مخصص".

    استخدم تنسيق التصغير للمساعدة في توفير رسالة منظمة (ويسهل الوصول إليها).

  4. حدد Save changes (حفظ التغييرات).

تكوين مساعده الخبراء

امنح المدرسين والطلاب وصولاً سهلاً إلى فريق خبراء وصول ذوي الاحتياجات الخاصة لديك. قم بتمكين مساعدة الخبراء لإضافة طريقة للمستخدمين لطلب المزيد من المساعدة مباشرةً من التنسيقات البديلة ولوحات ملاحظات المدرس.

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

  1. انتقل إلى تكوين Ally، وحدد إعدادات المساعدة.
  2. اختر توفير المساعدة المخصصة لكل من مساعدة ملاحظات المدرس ومساعدة التنسيقات البديلة.
  3. حدد تمكين مساعدة الخبراء.
  4. اكتب عنوان البريد الإلكتروني لفريق خبراء إمكانية وصول ذوي الاحتياجات الخاصة.
  5. حدد Save changes (حفظ التغييرات).

يحتاج مستخدم Ally API لتكامل Blackboard Learn إلى الحصول على إذن "لوحة المسؤول (المستخدمون) > المستخدمون" أو "system.user.view" للسماح لـ Ally بتضمين اسم الطالب وعنوان البريد الإلكتروني في البريد الإلكتروني لطلب المساعدة. يحتاج مستخدم Ally API لتكامل Moodle إلى الحصول على إذن "moodle/user:viewalldetails" للسماح لـ Ally بتضمين اسم الطالب وعنوان البريد الإلكتروني في البريد الإلكتروني لطلب المساعدة.

تخصيص مزايا Ally


تخصيص علامات مزايا Ally

يمكنك تشغيل بعض المزايا أو إيقاف تشغيلها لتخصيص Ally ليناسب تفضيلاتك المؤسسية.

في تكوين Ally، حدد المزايا التي تريد تمكينها.

  1. انتقل إلى تكوين Ally، وحدد المزايا.
  2. ابحث عن الميزة التي تريد تشغيلها أو إيقاف تشغيلها، وحددها.
    • تنسيق بديل للإصدار المترجم: يمكن للطلاب تنزيل تنسيق بديل مترجم لملف أصلي.
    • التنسيق البديل لـ BeeLine Reader: يمكن للطلاب تنزيل تنسيق BeeLine Reader البديل.
    • الوصول إلى ملاحظات المدرس من التقرير المؤسسي: امنح المسؤولين، وخدمات الإعاقة، ومعدي المواد التعليمية صلاحية الوصول إلى ملاحظات المدرس.
    • تكامل بيانات Ally في EesySoft: يمكن للمؤسسات التي لديها ترخيص EesySoft أن تسمح بمراقبة أكثر تفصيلاً للتفاعلات في اشتراطات التنسيقات البديلة، وملاحظات المدرس، وتقرير إمكانية وصول ذوي الاحتياجات الخاصة إلى المقرر الدراسي. يمكن للمؤسسات استخدام هذه البيانات لتقارير الاعتماد والحملات داخل EesySoft. يتم تعطيل تكامل EesySoft بشكل افتراضي.

      يتطلب هذا التكامل ترخيص EesySoft.

  3. حدد تمكين أو تعطيل لتشغيل الميزة أو إيقاف تشغيلها.