Add Comments to Your LMS via LTI 1.3

1. Connectez-vous à FastComments et allez à votre page de configuration LTI 1.3.
2. (Facultatif) Choisissez la plateforme depuis le menu déroulant Plateforme - cela définit l'étiquette d'affichage, mais Auto-détection fonctionne bien.
3. Cliquez sur Générer l’URL. Une URL d'enregistrement à usage unique apparaît (valide pendant 30 minutes).
4. Dans votre LMS, ouvrez l'écran d'enregistrement dynamique LTI 1.3 et collez l'URL dans le champ Point de terminaison d'initiation d'enregistrement de l'outil (ou équivalent). Soumettez.
5. Votre LMS appelle FastComments, échange les clés et crée l'intégration. La fenêtre contextuelle se ferme automatiquement une fois l'opération terminée.
6. De retour dans FastComments, la nouvelle configuration apparaît dans le tableau Configurations existantes. L'outil est maintenant disponible dans vos cours LMS.

FastComments LTI 1.3 a été testé avec :

• D2L Brightspace (toute version avec LTI Advantage)
• Moodle 4.0+ (External Tool plugin, LTI Advantage)
• Blackboard Learn (SaaS et Ultra)
• Sakai (versions prenant en charge LTI Advantage)
• Schoology (Enterprise, Dynamic Registration là où disponible)

Tout autre LMS qui implémente la spécification IMS LTI 1.3 Advantage avec Dynamic Registration devrait également fonctionner - sélectionnez Other LTI 1.3 platform dans le menu déroulant de la plateforme lors de la génération de votre URL d'enregistrement (obtenez-le ici).

Canvas LMS utilise un flux d'installation différent (JSON de configuration per-developer-key au lieu de Dynamic Registration). Consultez le guide d'installation dédié à Canvas LMS.

Navigate to LTI 1.3 Configuration

Connectez-vous à FastComments et allez à votre page de configuration LTI 1.3.

Si votre compte n'a pas encore accès à LTI, vous verrez "LTI not enabled for this account" - contactez l'assistance pour l'activer sur votre forfait.

Pick a Platform (Optional)

Sous Generate a Dynamic Registration URL, utilisez le menu déroulant Platform pour indiquer à FastComments à quel LMS vous vous connectez :

• D2L Brightspace
• Moodle
• Blackboard Learn
• Sakai
• Schoology
• Other LTI 1.3 platform

Vous pouvez aussi laisser sur Auto-detect. La plateforme est lue depuis l'openid-configuration de votre LMS lors de l'enregistrement ; le menu déroulant ne sert qu'à définir l'étiquette affichée pour la configuration résultante.

Generate the URL

Cliquez sur Generate URL. FastComments crée un jeton d'enregistrement à usage unique et vous affiche une URL ressemblant à :

https://fastcomments.com/lti/v1p3/register/<long-token>

Copiez-la. Cette URL :

• Est single-use - once your LMS calls it successfully, the token is consumed.
• Expire après 30 minutes si elle n'est pas utilisée.
• Doit rester privée - toute personne disposant de l'URL peut enregistrer un outil sur votre tenant pendant ces 30 minutes.

Existing Configurations

Une fois l'enregistrement terminé avec succès, la nouvelle configuration apparaît dans le tableau Existing Configurations sur la même page, avec sa Platform, son Issuer, son Client ID, et son Status. Vous pouvez supprimer des configurations depuis ce tableau si vous devez les désenregistrer.

D2L Brightspace offre l’enregistrement dynamique via l’interface d’administration LTI Advantage. Vous aurez besoin d’un accès administrateur.

Ouvrir l'écran d'enregistrement

1. Connectez-vous à votre instance Brightspace en tant qu'administrateur.
2. Accédez à Admin Tools > Manage Extensibility > LTI Advantage.
3. Cliquez sur Register Tool. (L'URL directe est https://<your-brightspace-host>/d2l/le/ltiadvantage/registrations/create.)

Collez l'URL

Vous verrez un formulaire d'enregistrement. Le champ clé est Tool initiation registration endpoint (certaines versions de Brightspace l'appellent "Tool Initiation Registration URL").

Collez l'URL d'enregistrement FastComments (obtenez-la ici) dans ce champ. Laissez les autres champs vides — ils sont remplis automatiquement par FastComments pendant la négociation d'enregistrement.

Cliquez sur Register.

Approuver l'outil

Brightspace ouvre une fenêtre contextuelle qui communique avec FastComments, échange des clés et affiche un écran de confirmation. La fenêtre contextuelle se ferme automatiquement lorsque l'enregistrement est terminé.

Le nouvel outil apparaît dans la liste des outils LTI Advantage. Par défaut, Brightspace marque les nouveaux outils comme disabled — basculez le commutateur sur enabled pour que vos cours puissent l'utiliser.

Ajouter un déploiement

Dans Brightspace, les outils LTI requièrent un deployment avant de pouvoir être utilisés dans les cours :

1. Ouvrez l'outil FastComments nouvellement enregistré.
2. Cliquez sur View Deployments > New Deployment.
3. Donnez un nom au déploiement (p. ex. "FastComments - All Courses"), choisissez les unités organisationnelles où il devrait être disponible, puis enregistrez.

Après le premier lancement via ce déploiement, FastComments attache le deployment_id à son enregistrement de configuration — les lancements ultérieurs depuis un autre déploiement sous le même client seront refusés, sauf si vous le réenregistrez.

Vous utilisez Moodle ? Nous publions également un plugin Moodle dédié pour FastComments offrant une intégration plus poussée que LTI 1.3 (hooks de synchronisation des notes, rapports d'activité approfondis, interface de configuration native Moodle). Voir le guide d'installation du plugin Moodle. Le flux LTI 1.3 ci‑dessous est le bon choix si vous voulez une inscription unique qui couvre également d'autres LMS, ou si votre administrateur Moodle n'installera pas de plugins tiers.

Moodle 4.0+ prend en charge l'enregistrement dynamique LTI 1.3 via le plugin External Tool.

Ouvrez l'écran de gestion des outils

1. Connectez-vous à Moodle en tant qu'administrateur du site.
2. Naviguez vers Site administration > Plugins > Activity modules > External tool > Manage tools.

Collez l'URL

Vous verrez une carte intitulée Tool URL. Collez l'URL d'enregistrement FastComments (obtenez-la ici) dans le champ de texte et cliquez sur Add LTI Advantage.

Moodle ouvre un écran d'enregistrement affichant l'identité de l'outil et les autorisations demandées. Vérifiez et cliquez sur Activate (ou Register, selon la version de Moodle).

La fenêtre contextuelle se ferme une fois l'enregistrement terminé ; le nouvel outil FastComments apparaît dans la liste Tools avec le statut Active.

Rendez-le disponible

Par défaut, Moodle ajoute les nouveaux outils à la liste « Course tools » mais ne les affiche pas dans le sélecteur d'activités. Pour rendre FastComments disponible dans tout le cours :

1. Cliquez sur l'icône d'engrenage de la vignette FastComments.
2. Sous Tool configuration usage, choisissez Show in activity chooser and as a preconfigured tool.
3. Enregistrez.

Les enseignants peuvent maintenant ajouter FastComments à n'importe quel cours via Add an activity or resource > FastComments.

Blackboard Learn SaaS and Ultra prennent en charge LTI 1.3 Dynamic Registration.

Open the Tool Provider Screen

1. Connectez-vous à Blackboard en tant qu'administrateur système.
2. Accédez à Administrator Panel > Integrations > LTI Tool Providers.
3. Cliquez sur Register LTI 1.3 / LTI Advantage Tool.

Si vous ne voyez que "Register LTI 1.1 Provider", votre version de Blackboard ne prend pas encore en charge LTI 1.3 - effectuez une mise à niveau ou contactez le support de Blackboard.

Paste the URL

Collez l'URL d'enregistrement FastComments (obtenez-la ici) dans le champ Client ID / Registration URL (le libellé varie selon la version de Blackboard). Soumettez.

Blackboard effectue la poignée de main d'enregistrement avec FastComments et vous affiche un écran de confirmation.

Approve and Enable

Blackboard marque par défaut les outils nouvellement enregistrés comme Approved but excluded :

1. Trouvez l'entrée FastComments dans la liste des fournisseurs d'outils.
2. Ouvrez le menu et choisissez Edit.
3. Réglez Tool Status sur Approved.
4. Sous Institution Policies, vérifiez quelles données utilisateur sont envoyées (nom, courriel, rôle). Enregistrez.

L'outil est maintenant disponible pour les enseignants lorsqu'ils ajoutent du contenu aux cours.

Sakai

Sakai prend en charge l'enregistrement dynamique LTI 1.3 sur les versions avec LTI Advantage. Depuis l'espace d'administration :

1. Connectez-vous en tant qu'administrateur Sakai et ouvrez l'Administration Workspace.
2. Choisissez External Tools > Install LTI 1.3 Tool.
3. Collez l'URL d'enregistrement FastComments (obtenez-le ici) et soumettez.
4. Approuvez l'outil lorsque l'échange est terminé.

L'outil apparaît alors sous External Tools et peut être ajouté aux sites par leurs responsables.

Schoology

Les instances Schoology Enterprise prennent en charge LTI 1.3, mais la disponibilité de l'enregistrement dynamique varie selon le déploiement. Vérifiez auprès de votre responsable de compte Schoology.

Si l'enregistrement dynamique n'est pas disponible sur votre instance Schoology, vous devrez configurer l'intégration manuellement en utilisant ces points de terminaison :

• OIDC Login URL: https://fastcomments.com/lti/v1p3/login
• Target Link URL: https://fastcomments.com/lti/v1p3/launch
• Public Keyset URL (JWKS): https://fastcomments.com/lti/v1p3/jwks
• Redirect URLs: https://fastcomments.com/lti/v1p3/launch

Après que Schoology vous a fourni un Client ID et un Deployment ID, contactez le support FastComments pour enregistrer la configuration sur votre tenant.

Autres plateformes LTI 1.3

Tout LMS qui respecte la spécification IMS LTI 1.3 Advantage devrait fonctionner avec la même URL d'enregistrement (obtenez-le ici). Recherchez un paramètre libellé "Dynamic Registration", "Tool Registration URL", "Tool initiation registration endpoint", ou similaire.

Si votre plateforme ne prend en charge que la configuration manuelle de LTI 1.3, utilisez les quatre points de terminaison énumérés dans la section Schoology ci‑dessus et contactez le support pour finaliser.

Cette page couvre l’ajout de FastComments à un cours Brightspace après qu’un administrateur a enregistré l’outil et créé un déploiement. Si l’outil n’est pas encore enregistré, consultez d’abord le guide d’enregistrement D2L.

FastComments intégré comme sujet d’unité dans Brightspace

Brightspace propose deux expériences de création de contenu : Classic Content et la New Content Experience (aussi appelée Lessons). Les deux exposent FastComments, mais les chemins de menu diffèrent. Chaque section ci‑dessous couvre les deux cas là où ils divergent.

Locate the FastComments Tool

L’outil FastComments apparaît à deux endroits dans un éditeur de contenu de cours :

1. Le sélecteur d’activité, accessible depuis le bouton Add Existing d’un module/unité (étiqueté Add Existing Activities dans les anciennes versions de Brightspace). FastComments apparaît directement dans le sélecteur dans les versions récentes de Brightspace ; les anciennes versions l’imbriquent sous un sous‑menu External Learning Tools. Chacune des deux voies ajoute FastComments en tant que sujet autonome.
2. La boîte de dialogue Insert Stuff à l’intérieur de l’éditeur HTML, sous LTI Advantage. Ceci intègre FastComments en ligne dans un sujet HTML via le flux de deep linking LTI.

Si FastComments n’apparaît dans aucun des deux sélecteurs, le déploiement n’est pas activé pour l’org unit contenant le cours. Demandez à votre administrateur Brightspace d’ouvrir Admin Tools > Manage Extensibility > LTI Advantage > FastComments tool > View Deployments, d’ouvrir le déploiement et d’ajouter l’org unit du cours (ou une org unit parente) sous Org Units.

Add FastComments as a Topic in a Module

Classic Content:

1. Ouvrez le cours et cliquez sur Content dans la barre de navigation.
2. Sélectionnez le module qui doit contenir la discussion (ou créez‑en un via Add a module).
3. Cliquez sur Add Existing (Brightspace plus ancien : Add Existing Activities > External Learning Tools).
4. Dans le sélecteur, cliquez sur FastComments. Brightspace crée un sujet dans le module et vous ramène à la vue de contenu.
5. Cliquez sur le nouveau sujet. Renommez‑le par quelque chose de descriptif comme FastComments Discussion en utilisant l’éditeur de titre en ligne.

New Content Experience (Lessons):

1. Ouvrez le cours et cliquez sur Content.
2. Ouvrez l’unité et la leçon qui doivent contenir la discussion.
3. Cliquez sur Add > Existing Activity et sélectionnez FastComments (Brightspace plus ancien : imbriqué sous External Learning Tools).
4. L’activité est ajoutée à la leçon.
5. Cliquez sur le titre de l’activité pour le renommer.

La première fois qu’un utilisateur (enseignant ou étudiant) ouvre le sujet, FastComments initialise le fil pour ce resource link. Le fil est lié à l’ID du resource link, donc renommer ou déplacer le sujet ne change pas le fil chargé.

Embed FastComments Inline in an HTML Topic

Utilisez ce flux lorsque vous voulez que les commentaires apparaissent sous une lecture, une vidéo ou autre contenu à l’intérieur de la même page de sujet plutôt que comme sujet séparé.

1. Ouvrez ou créez un sujet HTML dans le module/la leçon.
2. Cliquez sur Edit HTML pour ouvrir l’éditeur HTML de Brightspace.
3. Placez le curseur à l’endroit où le fil de commentaires doit apparaître.
4. Cliquez sur le bouton Insert Stuff (icône en forme de pièce de puzzle dans la barre d’outils de l’éditeur).
5. Dans la boîte Insert Stuff, faites défiler jusqu’à LTI Advantage et cliquez sur FastComments.
6. FastComments ouvre un sélecteur de deep linking. Confirmez l’emplacement (les options par défaut conviennent pour les discussions de contenu) ; cliquez sur Insert ou Continue.
7. Brightspace revient à l’éditeur HTML avec un bloc de remplacement représentant le lancement LTI. Cliquez sur Save and Close sur le sujet.

Lorsque le sujet se charge, Brightspace remplace le placeholder par un iframe qui lance automatiquement FastComments via LTI. Les étudiants voient le fil de discussion en ligne.

Un seul sujet HTML peut contenir plusieurs intégrations deep‑linked FastComments. Chaque intégration obtient son propre fil car chaque deep link produit un resource link ID distinct.

Module Topic vs Inline Quicklink

Choisissez l’approche module topic lorsque :

• La discussion est l’activité principale pour cette étape du module.
• Vous voulez que le sujet apparaisse dans la table des matières de Brightspace, le suivi de complétion et Class Progress.

Choisissez l’approche inline embed lorsque :

• Les commentaires doivent être sous d’autres contenus sur la même page.
• Vous ne voulez pas d’élément séparé suivi pour la complétion dans la table des matières.

Visibility, Draft, and Release Conditions

Un nouveau sujet FastComments est visible par les étudiants par défaut. Pour le masquer pendant la configuration :

1. Dans l’éditeur de contenu, cliquez sur le titre du sujet (Classic) ou sur le menu à trois points sur l’activité (New Content Experience).
2. Définissez le statut sur Draft (Classic) ou basculez Visibility sur off (New Content Experience).

Les sujets Draft sont invisibles aux étudiants. Les instructeurs et TA les voient toujours avec un badge « Draft ».

Pour restreindre le sujet à un groupe ou une section spécifique :

1. Ouvrez le sujet.
2. Cliquez sur le menu du titre du sujet > Edit Properties In-place (Classic) ou Edit > Restrictions (New Content Experience).
3. Sous Release Conditions, cliquez sur Create.
4. Choisissez Group enrollment ou Section enrollment, sélectionnez le groupe/la section, et enregistrez.

Les conditions de publication s’additionnent avec le propre mapping de rôles de FastComments. Les étudiants qui ne peuvent pas voir le sujet ne reçoivent pas de lancement LTI.

What Students See on First Launch

Lorsque qu’un étudiant clique sur le sujet (ou charge un sujet HTML avec une intégration) :

1. Brightspace effectue le lancement LTI 1.3 en arrière‑plan.
2. FastComments reçoit le nom de l’étudiant, son courriel, l’URL de son avatar et le rôle LMS, et le connecte automatiquement. Il n’y a pas d’invite de connexion FastComments.
3. Le fil de commentaires pour ce resource link se rend à l’intérieur de l’iframe Brightspace.

Mapping des rôles au lancement :

• Brightspace Administrator devient un FastComments admin pour le fil (modération complète, suppression, bannissement et accès à la configuration).
• Brightspace Instructor devient un FastComments moderator (épingler, masquer, supprimer, bannir).
• Tous les autres rôles (Learner, TeachingAssistant, etc.) deviennent des commentateurs standards.

Les commentaires sont attribués au compte Brightspace de l’étudiant. Si l’étudiant modifie son nom ou son avatar dans Brightspace, le prochain lancement LTI synchronise la modification.

Iframe Height and Resize

FastComments émet le postMessage org.imsglobal.lti.frameResize à chaque rendu de fil et lors des changements de contenu (nouveau commentaire, déploiement des réponses). Brightspace écoute ce message et ajuste la hauteur de l’iframe afin que le fil ne soit pas tronqué et qu’aucune barre de défilement interne n’apparaisse.

Si l’iframe reste à une hauteur fixe et courte :

• Confirmez que le cours est chargé via HTTPS. Le listener postMessage de Brightspace rejette les frames en contenu mixte.
• Confirmez qu’aucune extension de navigateur ne bloque le canal postMessage.
• Pour les intégrations inline dans un sujet HTML, le HTML environnant ne doit pas envelopper l’iframe dans un conteneur à hauteur fixe. Supprimez tout style inline style="height: ..." de l’élément parent.

Brightspace-Specific Gotchas

Tool not showing in the Add Existing picker. Le déploiement n’est pas activé pour l’org unit de ce cours. Un administrateur doit ajouter l’org unit (ou une parente) à la liste Org Units du déploiement. L’enregistrement de l’outil seul ne suffit pas ; le déploiement détermine quels cours voient l’outil.

deployment_id mismatch on launch. FastComments « TOFU‑pins » le premier deployment_id qu’il voit pour un enregistrement. Si un administrateur supprime le déploiement initial et en crée un nouveau, les lancements depuis le nouveau déploiement sont rejetés avec une erreur de non‑correspondance de déploiement. La solution consiste à réenregistrer FastComments (générez une nouvelle URL d’enregistrement (obtenez‑la ici) et relancez la Dynamic Registration) ; l’ancien enregistrement de configuration est remplacé.

Tool launches but shows "Invalid LTI launch". Le cours est dans une structure de tenant/org différente de celle couverte par le déploiement, ou le déploiement a été désactivé après l’enregistrement. Revérifiez Admin Tools > Manage Extensibility > LTI Advantage > FastComments > bascule Enabled et la liste des org units du déploiement.

Names and roles missing inside FastComments. Brightspace envoie des lancements LTI avec les claims NRPS (Names and Role Provisioning Services). Si un cours a été mis à niveau depuis un ancien lien LTI 1.1, le lancement peut ne pas contenir les claims name et email. Réajoutez le sujet FastComments via Add Existing (ne migrez pas l’ancien lien) afin que le lancement utilise LTI 1.3.

Embed shows a login screen instead of auto-SSO. Le sujet HTML a été inséré comme un simple <iframe> pointant vers FastComments plutôt que via Insert Stuff > LTI Advantage. Les iframes simples contournent le lancement LTI et amènent les utilisateurs sur la page publique FastComments. Supprimez l’iframe et réinsérez‑la via le flux Insert Stuff.

Une fois qu’un administrateur a enregistré FastComments en tant qu’outil LTI 1.3 Advantage et approuvé les stratégies de l’établissement, les enseignants l’ajoutent aux cours via les points de placement standard de Blackboard. Les étapes exactes diffèrent entre Ultra Course View et Original Course View, donc les deux sont couvertes ci-dessous.

Ultra Course View

Ultra Course View est la valeur par défaut dans Blackboard Learn SaaS à partir de 2026.

1. Ouvrez le cours et allez à la page Course Content.
2. Survolez ou appuyez à l’endroit où vous voulez placer le fil de commentaires dans le plan et cliquez sur le bouton violet + (Add content).
3. Choisissez Content Market. Le panneau Content Market liste tous les outils LTI approuvés et les placements Building Block pour votre établissement.
4. Trouvez la vignette FastComments et cliquez dessus. Blackboard crée un élément de contenu à la position où vous avez ouvert le menu +.
5. Par défaut, l’élément apparaît dans le plan comme une entrée « Visible to students » pour les enseignants dont le réglage personnel Hide from students est désactivé. Si votre valeur par défaut est Hidden, l’élément est créé en mode masqué et vous activez le sélecteur de visibilité sur la ligne de l’élément lorsque vous êtes prêt.
6. Pour renommer l’élément, cliquez sur le titre dans le plan et tapez une nouvelle étiquette. Le titre que les étudiants voient dans le plan est indépendant de l’identifiant de fil FastComments, donc renommer est sans risque à tout moment.

Si vous ne voyez pas Content Market comme option, votre établissement a caché le placement. Vous pouvez aussi accéder au même sélecteur via More tools dans le même menu + sous le groupe LTI Tools.

Original Course View

Original Course View est toujours pris en charge dans Learn SaaS et reste l’expérience principale pour les sites Learn 9.1 auto-hébergés sur la ligne de correctifs CU de Q4 2024.

1. Ouvrez le cours et entrez dans une Content Area (par exemple, la zone Information ou Content par défaut dans le menu du cours).
2. Activez Edit Mode avec le commutateur en haut à droite de la page.
3. Cliquez sur Build Content dans la barre d’actions.
4. Sous le sous-menu Learning Tools, cliquez sur FastComments. Le sous-menu Learning Tools est rempli à partir des placements d’outils LTI 1.3 après qu’un administrateur a enregistré l’outil. Si vous ne le voyez pas, voyez la section des pièges ci-dessous.
5. Sur le formulaire Create FastComments, définissez :
   • Name : l’étiquette que les étudiants voient dans la zone de contenu.
   • Description : texte optionnel affiché au-dessus du fil intégré.
   • Permit Users to View this Content : bascule de disponibilité Oui/Non.
   • Track Number of Views : activez si vous voulez les statistiques de vues par élément de Blackboard. FastComments exécute ses propres analyses de façon indépendante.
   • Date and Time Restrictions : fenêtres optionnelles Display After / Display Until.
6. Soumettez. L’outil apparaît comme un élément cliquable dans la zone de contenu.

Intégration à l’intérieur d’un élément ou d’un document

Dans les deux vues de cours, les enseignants intègrent FastComments en ligne dans le corps d’un Item, d’un Document ou de tout champ riche via le bouton LTI Advantage de l’éditeur de contenu.

Ultra Course View :

1. Créez ou modifiez un Document.
2. Cliquez sur Add content à l’intérieur du corps du document à l’endroit où vous voulez que le fil apparaisse.
3. Dans la barre d’outils de l’éditeur, ouvrez le menu Insert content et cliquez sur Content Market (le point d’entrée LTI Advantage / Deep Linking).
4. Choisissez FastComments. FastComments renvoie une charge utile de deep-link et Blackboard insère un bloc intégré dans le corps du document à la position du curseur.
5. Enregistrez le document. Les étudiants voient le fil rendu en ligne lorsqu’ils le font défiler.

Original Course View :

1. Modifiez n’importe quel élément avec un corps en texte riche.
2. Dans la barre d’outils de l’éditeur de contenu, cliquez sur l’icône plus Add Content et choisissez Content Market (étiqueté Add Content from External Tool dans les anciens CU de Q4 2024).
3. Choisissez FastComments. L’éditeur insère un bloc espace réservé référant la ressource deep-linkée.
4. Soumettez l’élément.

Chaque intégration deep-link produit son propre fil FastComments, donc un Item avec deux blocs FastComments intégrés aura deux fils de commentaires indépendants.

Visibilité, conditions de diffusion et restrictions de groupe

Les éléments de contenu FastComments se comportent comme tout autre élément de contenu Blackboard pour les règles de contrôle d’accès qui leur sont appliquées.

• Ultra : cliquez sur le sélecteur de visibilité sur la ligne (Visible to students, Hidden from students, Conditional availability). La disponibilité conditionnelle prend en charge les fenêtres de date/heure, les règles de performance liées aux éléments du carnet de notes, et les règles de membres liées aux groupes du cours.
• Original : ouvrez le menu contextuel de l’élément et choisissez Adaptive Release ou Adaptive Release: Advanced pour restreindre l’accès à l’outil par date, appartenance, note ou état de révision. Utilisez Set Group Availability sur l’élément pour restreindre à des groupes de cours spécifiques.

FastComments respecte la décision de contrôle d’accès de Blackboard. Si Blackboard cache l’élément à un étudiant, le lancement LTI n’a jamais lieu pour cet étudiant et il n’apparaît pas dans la vue modérateur.

Comportement dans le carnet de notes

FastComments ne renvoie pas de notes via LTI Advantage Assignment and Grade Services. Aucune colonne de notes n’est créée automatiquement pour les éléments de contenu FastComments.

Si votre locataire Blackboard est configuré pour créer automatiquement une colonne du carnet de notes pour chaque nouvel élément de contenu indépendamment des métadonnées de notation, une colonne vide apparaît quand même. Pour la masquer :

• Ultra : ouvrez le Gradebook, cliquez sur l’en-tête de colonne, choisissez Edit, et désactivez Show to students ainsi que Include in calculations. Ou utilisez Delete si votre établissement autorise la suppression de colonnes pour les éléments non notés.
• Original : ouvrez le Grade Center, cliquez sur le chevron de la colonne, choisissez Hide from Users (on/off), et éventuellement Hide from Instructor View sous Column Organization.

Ce que voient les étudiants

Quand un étudiant ouvre l’élément FastComments ou fait défiler jusqu’à un bloc intégré :

1. Blackboard lance le message LTI 1.3 vers FastComments. L’étudiant est connecté via SSO en utilisant son identité Blackboard (nom, courriel, avatar, rôle) sans voir de formulaire de connexion.
2. Le fil de commentaires se rend dans l’iframe. Le fil, les réponses, les mentions et les réactions sont tous disponibles selon les paramètres du widget de commentaires configurés dans FastComments.
3. Leurs commentaires sont attribués à leur compte Blackboard. Si l’étudiant modifie ensuite son nom ou sa photo dans Blackboard, le prochain lancement mettra à jour le profil FastComments.

Correspondance des rôles de Blackboard vers FastComments :

• System Administrator et Course Builder correspondent à FastComments admin.
• Instructor et Teaching Assistant correspondent à FastComments moderator.
• Student, Guest, et Observer correspondent à FastComments commenter.

Les modérateurs voient les contrôles de modération (épingler, masquer, bannir, supprimer) en ligne sur chaque commentaire du fil.

Portée des fils

FastComments scope chaque fil par (Blackboard host, course ID, resource link ID). Deux éléments FastComments dans le même cours produisent deux fils. Le même élément copié dans deux cours distincts (par exemple via la copie de cours) produit deux fils, parce que Blackboard émet un nouvel resource link ID lors de la copie. Pour conserver un fil partagé à travers les copies de cours, utilisez Deep Linking avec un URN de fil explicite configuré dans FastComments avant d’exécuter la copie.

Pièges spécifiques à Blackboard

La vignette FastComments est absente du menu Build Content (Original) ou du Content Market (Ultra). L’administrateur a approuvé l’outil mais laissé une stratégie d’établissement bloquant le placement pertinent. Allez dans Administrator Panel > Integrations > LTI Tool Providers, modifiez l’entrée FastComments, et confirmez que les placements Course Content Tool (Original) et Course Content Tool - allow students / Deep Linking content tool (Ultra) sont activés. Enregistrez et actualisez la page du cours.

Erreur « Tool not configured for this context » ou « Tool is not deployed » au lancement. La portée de déploiement enregistrée lors de l’enregistrement dynamique ne correspond pas au contexte institutionnel auquel appartient le cours. Dans l’entrée de fournisseur d’outils de Blackboard, vérifiez que le Deployment ID correspond à ce que FastComments affiche sur sa page de configuration LTI 1.3 pour ce locataire. S’ils diffèrent, supprimez le placement et relancez l’enregistrement dynamique depuis une URL d’enregistrement fraîche (obtenez-le ici).

La hauteur de l’iframe semble fixe ou le contenu est tronqué. Certains locataires Blackboard sont fournis avec une politique CSP stricte qui bloque le postMessage de redimensionnement d’iframe LTI par défaut. FastComments émet à la fois le message de style Canvas lti.frameResize et le message conforme à la spécification IMS org.imsglobal.lti.frameResize pour maximiser la compatibilité, mais une substitution CSP au niveau du locataire bloque le listener parent. Demandez à votre administrateur de confirmer que *.fastcomments.com figure sur la liste d’autorisation des outils LTI et qu’aucun en-tête CSP personnalisé ne filtre les événements postMessage. Le redimensionnement fonctionnera alors sans configuration supplémentaire.

La copie de cours duplique les fils. La copie de cours Blackboard génère de nouveaux resource link ID pour les placements LTI, donc les cours copiés commencent avec des fils vides. Cela est attendu. Si vous avez besoin que le cours copié hérite du fil original, configurez Deep Linking avec un URN de fil explicite avant la copie, ou contactez le support FastComments pour remapper les ID de fil en masse.

L’étudiant voit une erreur générique Blackboard au lancement. La cause est une revendication email manquante ou périmée. Confirmez que la stratégie d’établissement pour FastComments a Role, Name, et Email Address activés sous User Fields to Send. Enregistrez, puis relancez dans une nouvelle session du navigateur.

"Jeton d'enregistrement introuvable, expiré ou déjà utilisé"

Le token dans votre URL d'enregistrement (obtenez-le ici) est valide pendant 30 minutes et ne peut être utilisé qu'une seule fois. Si votre LMS a mis plus de temps, ou si l'enregistrement a été réessayé après avoir réussi, le token sera rejeté. Générez une nouvelle URL sur la page de configuration FastComments LTI 1.3 et recommencez.

"La plateforme a refusé l'enregistrement"

Votre LMS a refusé la négociation d'enregistrement. Les causes les plus courantes :

• Outil déjà enregistré avec le même nom de client. Certaines plateformes (notamment D2L) refusent une seconde inscription de "FastComments" tant que la précédente n'est pas supprimée. Supprimez l'ancien outil dans votre LMS, puis réessayez.
• Mauvais champ dans le LMS. Assurez-vous d'avoir collé l'URL dans le champ registration / tool initiation registration endpoint, et non dans le champ launch URL ou login URL.
• Le LMS ne prend pas réellement en charge l'enregistrement dynamique. Les anciennes versions de Moodle et Blackboard annoncent LTI 1.3 mais n'autorisent que la configuration manuelle. Consultez la documentation de votre plateforme.

"Échec de la récupération de la configuration de la plateforme"

FastComments n'a pas pu lire le document openid-configuration de votre LMS. C'est rare et signifie généralement que le LMS a fourni une URL de découverte mal formée ou inaccessible. Contactez le support de votre LMS.

Le lancement affiche "Configuration introuvable"

Soit la configuration dans FastComments a été supprimée, soit le lancement provenait d'une paire iss/client_id que nous ne reconnaissons pas. Si vous avez supprimé puis réenregistré, demandez à votre LMS de supprimer puis de réajouter l'outil FastComments afin qu'il obtienne le nouveau client_id.

Le lancement affiche "Déploiement non enregistré"

Vous avez lancé FastComments depuis un déploiement Brightspace/Moodle/Blackboard différent de celui dans lequel il a été lancé initialement. FastComments verrouille le deployment_id lors du premier lancement comme mesure de sécurité. Pour ajouter un nouveau déploiement sous le même client, contactez le support — nous ajouterons l'ID de déploiement à la configuration.

Le lancement affiche "Type de message non pris en charge"

Le LMS a envoyé un message LTI que FastComments ne gère pas (p. ex. LtiSubmissionReviewRequest). FastComments ne prend en charge que le lancement resource-link standard et les flux de deep-linking. Contactez-nous si vous avez besoin qu'un type de message spécifique soit ajouté.

L'iframe ne se redimensionne pas

La plupart des LMS redimensionnent automatiquement les iframes LTI. Si le vôtre ne le fait pas, vérifiez que les paramètres de lancement du LMS permettent à l'outil d'envoyer des événements postMessage à la fenêtre parente. FastComments émet des messages de redimensionnement de type Canvas (lti.frameResize) et selon la spécification IMS (org.imsglobal.lti.frameResize).