Nous nous occupons de la configuration. Ally n'est pas installé sur votre environnement ? Contactez votre représentant Blackboard ou créez un ticket sur Behind the Blackboard.
Configuration du Building Block Ally
Le Building Block d'intégration Ally est déjà installé sur votre environnement Blackboard Learn. Dans le Panneau de configuration de l'administrateur, sélectionnez Building Blocks puis Outils installés. Un conseiller technique Blackboard configure ce Building Block pour vous.
La configuration du Building Block Ally comprend les étapes suivantes :
- Rendre l'intégration disponible dans les paramètres d'intégration Ally.
- Créer un utilisateur. Cet utilisateur ne sera jamais utilisé par un individu pour se connecter. Cet utilisateur est créé pour s'exécuter sur l'intégration de l'API REST et disposera de certaines autorisations. Les noms d'utilisateur utilisés sont souvent « allyuser » ou « allyintegration ».
Ne supprimez pas l'utilisateur Ally. Si vous supprimez l'utilisateur, l'intégration ne fonctionnera pas.
- Ajouter des informations sur le fournisseur d'outils et personnaliser les paramètres. Les informations de Clé, Secret, Code client, URL et de Script personnalisé sont utilisées pour permettre aux formats alternatifs, au feed-back du professeur et aux rapports Ally de s'ouvrir dans votre environnement Learn.
Des paramètres de script personnalisé sont ajoutés pour qu'Ally fonctionne dans l'affichage d'origine.
Le code client est propre à chaque environnement. Il ne peut pas être partagé entre vos environnements de test et de production.
Quels sont les éléments ajoutés par la configuration du Building Block à votre environnement ?
Une fois le Building Block configuré, les éléments de compte, rôle et outils suivants seront ajoutés à votre environnement :
- Utilisateur d'intégration Ally
- Rôle système d'intégration Ally, attribué à l'utilisateur d'intégration Ally
- Configuration d'Ally
- Rapports Ally
En savoir plus sur la gestion des outils installés dans Blackboard Learn
À propos de l'utilisateur et du rôle système Ally
Une fois le Building Block d'intégration Ally configuré, un utilisateur d'intégration et un rôle système Ally sont ajoutés à votre environnement.
Personne ne se connecte avec ce compte utilisateur. Cet utilisateur est créé pour s'exécuter sur l'intégration de l'API REST. Le rôle d'intégration Ally est uniquement utilisé par l'utilisateur Ally et ne doit pas être attribué à un utilisateur normal. Des erreurs se produiront si un compte d'utilisateur normal tente de se connecter avec le rôle de système d'intégration Ally.
Le rôle système d'Intégration Ally ajouté à votre environnement est attribué à cet utilisateur. Le rôle système dispose d'un ensemble de privilèges qui définissent le fonctionnement de l'intégration avec l'environnement.
Ne supprimez pas l'utilisateur ou le rôle système Ally. Si vous supprimez l'utilisateur ou le rôle système, l'intégration ne fonctionnera pas.
Privilèges du rôle système d'intégration Ally
- Ajouter/Modifier un contenu sécurisé avec des scripts : permet de conserver le contenu tel qu'il a été créé par les professeurs dans le feed-back du professeur. Sans ce privilège, Ally peut accidentellement supprimer un élément du contenu qu'un professeur a ajouté.
- Panneau de configuration Cours/Communauté (Outils) > Gestion des dates : permet à Ally d'accéder à l'outil de gestion des dates dans l'affichage de cours d'origine.
- Outil de conseiller Blackboard Predict : permet à Ally d'accéder à l'outil de conseil Blackboard Predict.
- Panneau de configuration de l'administrateur (utilisateurs) > Utilisateurs > Modifier > Afficher les inscriptions à la communauté : permet à Ally d'indiquer le nombre d'étudiants pour chaque communauté.
Ally fait référence aux communautés comme des cours dans les rapports de cours et de l'établissement.
- Panneau de configuration de l'administrateur (Utilisateurs) > Utilisateurs > Modifier > Afficher les inscriptions au cours : permet à Ally d'indiquer le nombre d'étudiants pour chaque cours.
- Panneau de configuration Cours/Communauté (outils) > Tests, enquêtes et pools > Créer un test, Tests et Afficher la conception et les paramètres du test : permet à Ally d'évaluer et d'attribuer des résultats aux fichiers joints ou images incorporées dans le lien de contenu Description WYSIWYG des tests et des examens non notés. Ces privilèges fonctionnent ensemble et doivent tous être sélectionnés.
- Panneau de configuration Cours/Communauté (Outils) > Tests, enquêtes et pools > Tests > Créer un test
- Panneau de configuration Cours/Communauté (Outils) > Tests, enquêtes et pools > Tests
- Panneau de configuration Cours/Communauté (Outils) > Tests, enquêtes et pools > Tests > Afficher la conception et les paramètres de test
- Cours/Communauté (Pages de contenu) > Modifier les matériels pédagogiques : permet à Ally de mettre à jour les attributs d'image dans les descriptions d'élément de contenu.
- Accès en lecture, en écriture, en suppression, en exécution au système de fichiers du système de contenu : permet à Ally d'ajouter des fichiers à l'environnement lorsque les professeurs les téléchargent via le feed-back du professeur. Ce privilège permet également à Ally de supprimer les fichiers présentant un risque potentiel de crise d'épilepsie du feed-back du professeur.
- Accès en lecture seule au système de fichiers du système de contenu : permet à Ally de lire des fichiers en vue de leur traitement. Par exemple, les intégrations et les synchronisations de cours.
En savoir plus sur les rôles système dans les environnements Learn
Configurer l'intégration de l'API REST
Configurer l'API REST permet à Ally d'extraire du contenu et des informations sur le cours de votre environnement. Un conseiller technique Blackboard configure l'intégration de l'API REST pour vous.
La configuration de l'intégration de l'API REST comprend les étapes suivantes :
- Ajouter l'ID de l'application. L'ID de l'application est toujours le même et peut être réutilisé. ID de l'application : 85d3b720-1a00-45e4-a3ee-c2be80de7295
- Ajouter l'utilisateur de l'intégration Ally. Les noms d'utilisateur utilisés sont souvent « allyuser » ou « allyintegration ».
- Attribuer à l'API REST l'accès utilisateur final. Sélectionnez OK pour faire en sorte que l'intégration Ally joue le rôle d'utilisateur au lieu d'un seul utilisateur dans le système.
- Autoriser l'API REST à agir en tant qu'utilisateur. Sélectionner OK pour permettre à Ally la mise à jour du contenu à l'emplacement d'origine.
En savoir plus sur la configuration d'une intégration d'API REST sur un environnement Learn
Configurer le rapport de cours
Configurez le rapport de cours pour l'ajouter aux cours de votre environnement. Un conseiller technique Blackboard configure le rapport de cours pour vous.
Rejoignez le groupe d'utilisateurs Ally