Intégrer la plateforme vidéo d'entreprise YuJa à Blackboard Learn

Ce document explique comment intégrer la plateforme vidéo d'entreprise YuJa à votre système de gestion de l'apprentissage (LMS) Blackboard. Si vous avez des questions sur l'une des étapes de ce processus, veuillez contacter votre gestionnaire de compte dédié. Pour effectuer l'intégration, vous aurez besoin d'une clé YuJa, d'un secret partagé et de l'URL de la zone. Ces éléments figurent dans votre document Zone Provisioning. Le fichier Blackboard Learn Building Block Plugin vous sera également fourni par votre gestionnaire de compte.

Configurer le LTI de la plateforme vidéo à l'aide des Building Blocks

Ajouter la plateforme vidéo comme fournisseur d'outils global

L'ajout de la plateforme vidéo comme Global Tool Provider permet aux enseignants d'accéder facilement à la plateforme vidéo depuis le site de leur cours. Suivez ces étapes pour gérer les paramètres par défaut des LTI Tool Providers. Vous pouvez remplacer ces paramètres au cas par cas, selon vos besoins.

1. Connectez-vous à Blackboard en tant qu'administrateur et accédez à la zone System Admin.

   

2. Accédez à Building Blocks → Building Blocks.

   

3. Sélectionnez LTI Tool Providers.

   

4. Sélectionnez Register Provider Domain.

   

5. Sous Provider Domain Status, saisissez les informations suivantes.

   

   • Provide Domain : l'URL de votre zone YuJa indiquée dans votre document Zone Provisioning, par exemple evergreen.yuja.com.
   • Provider Domain Status : Approved.

6. Sous Default Configuration, saisissez les informations suivantes.

   

   • Default Configuration : Set Globally.
   • Tool Provider Key : la YuJa Key indiquée dans votre document Zone Provisioning.
   • Tool Provider Secret : Shared Secret indiqué dans votre document Zone Provisioning.

7. Sous Institution Policies, saisissez les informations suivantes.

   

   • Send User Data : Send user data over any connection.
   • User Fields to Send : Role in Course, Name et Email Address.
   • Show User Acknowledgment Message : No.
8. Sélectionnez Submit pour enregistrer votre building block.

9. Sélectionnez Manage Global Properties.

   

10. Sous Feature Availability, saisissez les informations suivantes.

    

    • Enabled in Courses : Yes.
    • Enabled in Organizations : Yes.
    • Creation of Tool Provider Links : Allow links to any tool provider, but require approval for each new provider.
    • Allow configured tool providers to post grades : Yes.

11. Sous Default Configuration, saisissez les informations suivantes.

    

    • Send User Data : Send user data over only SSL.
    • User Fields to Send : Role in Course, Name et Email Address.
    • Show User Acknowledgement Message : sélectionnez Yes ou No pour choisir si un message de confirmation s'affiche lorsque l'utilisateur clique sur un lien d'outil d'apprentissage.
      • Si vous avez sélectionné Yes pour Show User Acknowledgment Message, saisissez le message de confirmation souhaité dans le champ Message Text.

    

12. Cliquez sur Submit.

Ajouter un emplacement LTI pour la plateforme vidéo

Un emplacement LTI, avec un nom et un lien, permet aux utilisateurs finaux de trouver et d'utiliser facilement la plateforme vidéo. Bien que ce ne soit pas obligatoire, il est fortement recommandé de gérer l'emplacement de l'outil. 

1. Connectez-vous à Blackboard en tant qu'administrateur et accédez à la zone System Admin.

   

2. Accédez à Building Blocks → Building Blocks.

   

3. Sélectionnez LTI Tool Providers.

   

4. Cliquez sur la flèche vers le bas à droite de votre building block YuJa pour accéder à un menu déroulant d'actions disponibles.

   

5. Sélectionnez Manage Placements.

   

6. Sélectionnez Create Placement.

   

7. Sous Placement Information, saisissez les informations suivantes.

   

   • Label : YuJa.
   • Description : saisissez une description facultative qui sera visible par les Students dans leur menu Tools et invisible pour les Instructors.
   • Handle : saisissez un identifiant unique d'un seul mot à utiliser comme entrée de base de données.
   • Availability : Yes.
   • Type : Student Tool.
   • Icon : cliquez sur Browse pour ajouter une icône pour l'outil YuJa, qui peut être téléchargée à l'adresse https://<YOUR_YUJA_DOMAIN>/P/LTI/Blackboard/yuja_basic.png

8. Dans l'URL du Tool Provider, saisissez https://<YOUR_YUJA_DOMAIN>/LMSEntry.jsp

   

9. Cliquez sur Submit.

Installer la plateforme vidéo dans tous les cours ou dans certains cours

Une fois la section Configurer le LTI de la plateforme vidéo à l'aide des Building Blocks terminée, deux options d'installation dans le LMS s'offrent à vous :

1. Enable YuJa in Future Courses - Cette option active la plateforme vidéo par défaut dans tous les futurs cours Blackboard Learn. Elle ne s'applique pas aux cours déjà existants dans Blackboard. Pour ce faire, consultez la section Installer la plateforme vidéo pour les cours futurs.
2. Enable YuJa in Select Courses – Cette option permet aux enseignants et aux administrateurs d'ajouter la plateforme vidéo à des cours précis, y compris des cours existants dans Blackboard. Pour ce faire, consultez la section Installer la plateforme vidéo pour certains cours.

Installer la plateforme vidéo pour les cours futurs

1. Connectez-vous à Blackboard en tant qu'Admin et accédez à la zone System Admin.

   

2. Accédez à Courses → Course Settings.

   

3. Sélectionnez Course Menu and Structures.

   

4. Survolez l'icône + pour ouvrir un menu déroulant et sélectionnez Tool Link.

   

5. Saisissez les informations suivantes.

   

   • Name : YuJa
   • Type : sélectionnez votre building block YuJa.
   • Available to Users : cochez la case.
6. Sélectionnez Submit.

Installer la plateforme vidéo pour certains cours

1. Connectez-vous à Blackboard en tant qu'enseignant et sélectionnez le cours auquel vous souhaitez ajouter la plateforme vidéo.

2. Activez Course Editing.

   

3. Dans le panneau Navigation, survolez l'icône + et sélectionnez Tool Link.

   

4. Saisissez les informations suivantes.

   

   • Name : YuJa
   • Type : sélectionnez votre building block YuJa.
   • Available to Users : cochez la case.
5. Sélectionnez Submit.

Accéder à la plateforme vidéo depuis Blackboard Learn

La plateforme vidéo provisionnera l'espace de groupe avec les informations fournies par le LTI, notamment le nom du cours, le nom d'utilisateur, les rôles des utilisateurs et les autorisations dans le cours. 

1. Connectez-vous à Blackboard en tant qu'Instructor ou Student et sélectionnez le cours auquel la plateforme vidéo a été ajoutée.

2. Dans le panneau Navigation, sélectionnez YuJa.

   

3. Vérifiez que vous pouvez accéder à la plateforme vidéo depuis Blackboard.

   

Installer le YuJa Media Chooser pour Blackboard Learn

Cette section explique comment intégrer le Media Chooser de la plateforme vidéo à Blackboard à l'aide de Learning Tools Interoperability (LTI). Elle suppose que vous avez déjà effectué la section Configurer le LTI de la plateforme vidéo à l'aide des Building Blocks.

Configurer l'extension YuJa Media Chooser dans Blackboard Learn

1. Connectez-vous à Blackboard en tant qu'administrateur et accédez à la zone System Admin.

   

2. Accédez à Building Blocks → Building Blocks.

   

3. Sélectionnez Installed Tools.

   

4. Sélectionnez Upload Building Blocks.

   

5. Cliquez sur Browse.

   

6. Recherchez et téléversez le fichier Blackboard Learn Building Block Plugin (.war) fourni par votre gestionnaire de compte.
7. Sélectionnez Approve pour approuver les privilèges du Blackboard Learn Building Block Plugin.

8. Une fois le téléversement terminé, sélectionnez Return.

   

9. Sur la page Return, recherchez le YuJa Media Chooser.

10. Cliquez sur la flèche vers le bas à côté du YuJa Media Chooser pour accéder à un menu déroulant d'actions disponibles et sélectionnez Settings.

    

11. Sélectionnez Settings.

    

12. Saisissez les informations suivantes.

    

    • Enter Consumer Key : saisissez la YuJa Key indiquée dans votre document Zone Provisioning.
    • Enter Organization URL : saisissez l'URL de la zone indiquée dans votre document Zone Provisioning.
    • Enable editing media before embedding : activé.
13. Sélectionnez Update Settings.

14. Accédez à la zone System Admin.

    

15. Accédez à Tools and Utilities → Tools.

    

16. Accédez à YuJa Media Chooser et saisissez les informations suivantes.

    

    • Course Tools : Availability sur On et Scope of Change sur New and existing courses.
    • Organization Tool : définissez Availability sur On et Scope of Change sur New and existing organizations.
    • Content Type : définissez Availability sur On et Scope of Change sur New and existing courses and organizations.
17. Cliquez sur Submit.

Utiliser le plugin YuJa Media Chooser dans les forums de discussion

1. Connectez-vous à Blackboard en tant qu'enseignant et sélectionnez le cours auquel vous avez ajouté la plateforme vidéo.

2. Sélectionnez Discussions dans le panneau Navigation à gauche.

   

3. Sélectionnez Create Forum.

   

4. Dans le champ Description , sélectionnez Mashups puis YuJa Media Chooser.

   

5. Depuis le YuJa Media Chooser, vous pouvez publier des vidéos, téléverser des médias ou même créer un nouvel enregistrement pour votre compte YuJa associé. Sélectionnez dans la liste la vidéo que vous souhaitez publier dans Blackboard.

   

6. Sélectionnez Insert Videos puis sélectionnez Submit pour envoyer votre Forum.

Utiliser le plugin YuJa Media Chooser dans les contenus

1. Connectez-vous à Blackboard en tant qu'enseignant et sélectionnez le cours auquel vous avez ajouté la plateforme vidéo.

2. Sélectionnez Content dans le panneau Navigation à gauche.

   

3. Activez Edit Mode.

   

4. Sélectionnez Build Content puis YuJa Media Chooser.

   

5. Depuis le YuJa Media Chooser, vous pouvez publier des vidéos, téléverser des médias ou même créer un nouvel enregistrement pour votre compte YuJa associé. Sélectionnez dans la liste la vidéo que vous souhaitez publier dans Blackboard.

   

6. Sélectionnez Insert Videos.

Facultatif - Configuration avancée pour les devoirs Blackboard

Pour les organisations qui utilisent la plateforme vidéo dans les Assignments de Blackboard, nous recommandons d'ajouter un fichier de politique pour la plateforme vidéo. Blackboard tient une liste blanche des sources iFrame autorisées et, au départ, la plateforme vidéo n'y figure pas. 

Consultez la section Customize the Policy pour plus de détails :
https://help.blackboard.com/Learn/Administrator/Hosting/Security/Key_Security_Features/System_and_Information_Integrity/Safe_HTML

1. Obtenez un fichier de politique auprès de YuJa en accédant à l'URL suivante et téléchargez le fichier XML : https://<YOUR_ZONE_URL>/Dashboard/LTI/BlackBoard/PolicyFiles/yuja-policy.xml

2. Connectez-vous à Blackboard en tant qu'administrateur et accédez à la zone System Admin.

   

3. Accédez à Security → Safe HTML Filters.

   

4. Sélectionnez Safe HTML Filter for Content Editor.

   

5. Sélectionnez Upload.

   

6. Sélectionnez Browse, téléversez le fichier XML et sélectionnez Submit. 

   

7. Cliquez sur la flèche vers le bas à côté de yuja-policy.xml pour accéder à un menu déroulant d'actions disponibles, puis sélectionnez Activate.

   

Facultatif - Configuration avancée pour ajouter le module YuJa Media Library

Cette section suppose que vous avez effectué les sections Configurer le LTI de la plateforme vidéo à l'aide des Building Blocks et Installer le YuJa Media Chooser pour Blackboard Learn.

1. Connectez-vous à Blackboard en tant qu'administrateur et accédez à la zone System Admin.

   

2. Accédez à Building Blocks → Building Blocks.

   

3. Sélectionnez LTI Tool Providers.

   

4. Cliquez sur la flèche vers le bas à droite de votre building block YuJa pour accéder à un menu déroulant d'actions disponibles.

   

5. Sélectionnez Manage Placements.

   

6. Cliquez sur la flèche vers le bas à droite de votre emplacement YuJa pour accéder à un menu déroulant d'actions disponibles.

   

7. Sélectionnez Edit.

   

8. Dans le champ Tool Provide Customer Parameters , saisissez override_lti_landing_page=media Library puis sélectionnez Submit.

   

9. Accédez à My Institutions.

   

10. Sélectionnez Add Module.

    

11. Dans le champ Search, saisissez YuJa et sélectionnez Go.

    

12. Sélectionnez Add pour ajouter le module YuJa.

    

13. Accédez à la zone System Admin.

    

14. Accédez à Communities → Tabs and Modules.

    

15. Sélectionnez Modules.

    

16. Cliquez sur la flèche vers le bas à droite de votre module YuJa Module pour accéder à un menu déroulant d'actions disponibles

    

17. Sélectionnez Edit Properties.

    

18. Sous General Properties, saisissez les informations suivantes.

    

    • Title : saisissez le titre le plus approprié pour YuJa, selon l'image de marque de votre organisation.
    • Description : saisissez une description du module.
19. Sélectionnez Submit.

20. Facultatif - Cliquez sur la flèche vers le bas à droite de votre module YuJa Module pour accéder à un menu déroulant d'actions disponibles, puis sélectionnez Edit Contents pour modifier le texte affiché dans le module.

    

Facultatif - Intégration du carnet de notes et suivi des analyses vidéo pour le YuJa Media Chooser à l'aide du Content Item Message

Le Content Item Message (CIM) est un protocole qui permet aux outils basés sur LTI de renvoyer des informations d'authentification, notamment pour les vidéos et quiz intégrés. Dans Blackboard, le CIM peut servir à intégrer du contenu à l'aide d'un flux de travail CIM défini par Blackboard. Les vidéos et quiz publiés dans Blackboard via le flux de travail CIM de Blackboard permettront de suivre les analyses et de synchroniser les résultats des notes entre le carnet de notes YuJa et le Full Grade Center de Blackboard.

Configurer le YuJa Media Chooser basé sur CIM

Cette section suppose que vous avez effectué la section Configurer le LTI de la plateforme vidéo à l'aide des Building Blocks.

1. Connectez-vous à Blackboard en tant qu'administrateur et accédez à la zone System Admin.

   

2. Accédez à Building Blocks → Building Blocks.

   

3. Sélectionnez LTI Tool Providers.

   

4. Cliquez sur la flèche vers le bas à droite de votre building block YuJa pour accéder à un menu déroulant d'actions disponibles.

   

5. Sélectionnez Manage Placements.

   

6. Sélectionnez Create Placement.

   

7. Sous Placement Information, saisissez les informations suivantes.

   

   • Label : YuJa Media Chooser CIM.
   • Handle : YuJa Media Chooser CIM.
   • Availability : Yes.
   • Type : Content-Item Message.

   Dans certaines instances de Blackboard, ce type d'emplacement porte le libellé Supports Deep Linking. Ne sélectionnez PAS Placement allows grading.

8. Dans l'URL du Tool Provider, saisissez https://<YOUR_YUJA_DOMAIN>/LMSEntry.jsp.

   

9. Cliquez sur Submit.

Intégrer une vidéo YuJa à l'aide du YuJa Media Chooser basé sur CIM

Après l'installation du CIM-Based YuJa Media Chooser, vous pouvez téléverser des médias à l'aide du flux de travail propre au CIM de Blackboard afin de suivre les analyses vidéo.

1. Connectez-vous à Blackboard en tant qu'Instructor et accédez à un cours Blackboard.

2. Sélectionnez Content dans le panneau Navigation à gauche.

   

3. Activez Edit Mode.

   

4. Sélectionnez Build Content puis YuJa Media Chooser CIM.

   

5. Sélectionnez le fichier multimédia que vous souhaitez intégrer dans Blackboard.

   

6. Vérifiez que votre média a été ajouté à la page Content de Blackboard.

   

Intégrer un quiz vidéo à l'aide du YuJa Media Chooser basé sur CIM

Après l'installation du CIM-Based YuJa Media Chooser, vous pouvez téléverser un Video Quiz YuJa à l'aide du flux de travail propre au CIM de Blackboard afin de suivre les notes des quiz vidéo dans le Full Grade Center de Blackboard.

1. Connectez-vous à Blackboard en tant qu'enseignant et accédez à un cours Blackboard.

2. Sélectionnez Content dans le panneau Navigation à gauche.

   

3. Activez Edit Mode.

   

4. Sélectionnez Build Content puis YuJa Media Chooser CIM.

   

5. Sélectionnez Quizzes pour afficher la liste des quiz vidéo auxquels vous avez accès.

   

6. Sélectionnez le quiz vidéo que vous souhaitez rendre disponible dans votre cours Blackboard et vérifiez qu'il a été ajouté à la page Content de Blackboard.

Passer un quiz vidéo à l'aide du YuJa Media Chooser basé sur CIM

Une fois le quiz vidéo inséré dans la page Content de Blackboard, les notes se synchronisent automatiquement lorsque les étudiants terminent le quiz vidéo. Voici le flux de travail que les étudiants doivent suivre pour que les notes des quiz vidéo soient correctement synchronisées avec le Full Grade Center de Blackboard.

1. Connectez-vous à Blackboard en tant qu'étudiant et accédez au cours où le quiz vidéo a été publié.

2. Sélectionnez Content dans le panneau Navigation à gauche.

   

3. Sélectionnez le quiz vidéo et soumettez toutes les réponses jusqu'à la fin.

   

4. Cliquez sur Submit pour soumettre le quiz vidéo.

Consulter les notes des quiz vidéo dans le Grade Center de Blackboard

1. Connectez-vous à Blackboard en tant qu'enseignant de votre cours, sélectionnez Grade Center, puis Full Grade Center.

   

2. Les notes du quiz vidéo seront enregistrées dans votre Gradebook Blackboard.