Add Comments to Your LMS via LTI 1.3

1. Melden Sie sich bei FastComments an und gehen Sie zu Ihrer LTI 1.3 Konfigurationsseite.
2. (Optional) Wählen Sie die Plattform, von der aus Sie sich verbinden, im Platform-Dropdown aus - sie setzt das Anzeige-Label, aber Auto-detect funktioniert einwandfrei.
3. Klicken Sie auf Generate URL. Eine einmalige Registration URL erscheint (gültig für 30 Minuten, einmalig verwendbar).
4. Öffnen Sie in Ihrem LMS den Bildschirm für die LTI 1.3 Dynamic Registration und fügen Sie die URL in das Feld Tool initiation registration endpoint (oder entsprechend) ein. Absenden.
5. Ihr LMS ruft FastComments auf, tauscht Schlüssel aus und erstellt die Integration. Das Popup schließt sich automatisch, wenn der Vorgang abgeschlossen ist.
6. Zurück in FastComments erscheint die neue Konfiguration in der Tabelle Existing Configurations. Das Tool ist nun in Ihren LMS-Kursen verfügbar.

FastComments LTI 1.3 wurde getestet mit:

• D2L Brightspace (beliebige Version mit LTI Advantage)
• Moodle 4.0+ (External Tool-Plugin, LTI Advantage)
• Blackboard Learn (SaaS und Ultra)
• Sakai (Versionen mit LTI Advantage-Unterstützung)
• Schoology (Enterprise, Dynamic Registration, sofern verfügbar)

Jedes andere LMS, das die IMS LTI 1.3 Advantage-Spezifikation mit Dynamic Registration implementiert, sollte ebenfalls funktionieren - wählen Sie Other LTI 1.3 platform aus dem Plattform-Dropdown, wenn Sie Ihre Registrierungs-URL generieren (hier).

Canvas LMS verwendet einen anderen Einrichtungsablauf (per-developer-key configuration JSON statt Dynamic Registration). Siehe die dedizierte Canvas LMS-Installationsanleitung.

Navigieren Sie zur LTI 1.3-Konfiguration

Melden Sie sich bei FastComments an und gehen Sie zu Ihrer LTI 1.3-Konfigurationsseite.

If your account doesn't yet have LTI access, you'll see "LTI not enabled for this account" - contact support to enable it on your plan.

Plattform auswählen (optional)

Unter Dynamische Registrierungs-URL generieren, verwenden Sie das Plattform-Dropdown, um FastComments mitzuteilen, mit welchem LMS Sie sich verbinden:

• D2L Brightspace
• Moodle
• Blackboard Learn
• Sakai
• Schoology
• Andere LTI 1.3-Plattform

Sie können es auch auf Automatische Erkennung belassen. Die Plattform wird während der Registrierung aus der openid-configuration Ihres LMS ausgelesen; das Dropdown setzt nur das Anzeigelabel für die resultierende Konfiguration.

URL generieren

Klicken Sie auf URL generieren. FastComments erstellt ein einmaliges Registrierungstoken und zeigt Ihnen eine URL an, die wie folgt aussieht:

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

Kopieren Sie sie. Diese URL:

• Ist einmalig - sobald Ihr LMS sie erfolgreich aufruft, wird das Token verbraucht.
• Läuft nach 30 Minuten ab, wenn sie nicht verwendet wird.
• Sollte privat aufbewahrt werden - jeder mit der URL kann innerhalb dieser 30 Minuten ein Tool für Ihren Mandanten registrieren.

Bestehende Konfigurationen

Sobald eine Registrierung erfolgreich abgeschlossen ist, erscheint die neue Konfiguration in der Tabelle Bestehende Konfigurationen auf derselben Seite, mit ihrer Plattform, dem Issuer, der Client ID und dem Status. Sie können Konfigurationen aus dieser Tabelle löschen, wenn Sie sie jemals abmelden müssen.

D2L Brightspace stellt die dynamische Registrierung über die LTI Advantage-Administrationsoberfläche bereit. Sie benötigen Administratorzugriff.

Registrierungsbildschirm öffnen

1. Melden Sie sich als Administrator in Ihrer Brightspace-Instanz an.
2. Navigieren Sie zu Admin Tools > Manage Extensibility > LTI Advantage.
3. Klicken Sie auf Register Tool. (Die direkte URL ist https://<your-brightspace-host>/d2l/le/ltiadvantage/registrations/create.)

URL einfügen

Sie sehen ein Registrierungsformular. Das wichtigste Feld ist Tool initiation registration endpoint (einige Brightspace-Versionen bezeichnen es als "Tool Initiation Registration URL").

Fügen Sie die FastComments-Registrierungs-URL (hier abrufen) in dieses Feld ein. Lassen Sie die anderen Felder leer – sie werden während des Registrierungs-Handshakes von FastComments automatisch ausgefüllt.

Klicken Sie auf Register.

Tool genehmigen

Brightspace öffnet ein Popup, das mit FastComments kommuniziert, Schlüssel austauscht und einen Bestätigungsbildschirm anzeigt. Das Popup schließt sich, wenn die Registrierung abgeschlossen ist.

Das neue Tool erscheint in Ihrer LTI Advantage-Toolliste. Standardmäßig markiert Brightspace neue Tools als disabled – schalten Sie den Schalter auf enabled, damit Ihre Kurse es verwenden können.

Bereitstellung hinzufügen

In Brightspace benötigen LTI-Tools eine deployment, bevor sie in Kursen verwendet werden können:

1. Öffnen Sie das neu registrierte FastComments-Tool.
2. Klicken Sie auf View Deployments > New Deployment.
3. Geben Sie der Bereitstellung einen Namen (z. B. "FastComments - All Courses"), wählen Sie die Organisations-Einheiten aus, in denen sie verfügbar sein soll, und speichern Sie.

Nach dem ersten Start über diese Bereitstellung pinnt FastComments die deployment_id in seinen Konfigurationsdatensatz – nachfolgende Starts von einer anderen Bereitstellung unter demselben Client werden abgelehnt, es sei denn, Sie registrieren erneut.

Verwenden Sie Moodle? Wir veröffentlichen auch ein dediziertes Moodle-Plugin für FastComments mit einer engeren Integration als LTI 1.3 (Hooks zur Notensynchronisierung, umfassendere Aktivitätsberichte, native Moodle-Einstellungsoberfläche). Siehe das Moodle-Plugin-Installationshandbuch. Der untenstehende LTI 1.3-Flow ist die richtige Wahl, wenn Sie eine einzelne Registrierung wünschen, die auch andere LMS abdeckt, oder wenn Ihr Moodle-Administrator keine Drittanbieter-Plugins installieren möchte.

Moodle 4.0+ unterstützt die dynamische LTI 1.3-Registrierung über das External Tool-Plugin.

Öffnen Sie den Bildschirm zur Tool-Verwaltung

1. Melden Sie sich in Moodle als Seitenadministrator an.
2. Navigieren Sie zu Site administration > Plugins > Activity modules > External tool > Manage tools.

Fügen Sie die URL ein

Sie sehen eine Karte mit der Bezeichnung Tool URL. Fügen Sie die FastComments-Registrierungs-URL (hier abrufen) in das Textfeld ein und klicken Sie auf LTI Advantage hinzufügen.

Moodle öffnet einen Registrierungsbildschirm, der die Identität des Tools und die angeforderten Berechtigungen anzeigt. Prüfen Sie diese und klicken Sie auf Aktivieren (oder Registrieren, je nach Moodle-Version).

Das Popup schließt sich, wenn die Registrierung abgeschlossen ist; das neue FastComments-Tool erscheint in der Tools-Liste mit dem Status Active.

Verfügbar machen

Standardmäßig fügt Moodle neue Tools der Liste "Course tools" hinzu, zeigt sie aber nicht im Aktivitätsauswahl-Dialog an. Um FastComments kursweit verfügbar zu machen:

1. Klicken Sie auf das Zahnrad-Symbol auf der FastComments-Kachel.
2. Wählen Sie unter Tool configuration usage die Option Im Aktivitätsauswähler anzeigen und als vorkonfiguriertes Tool anzeigen.
3. Speichern.

Dozierende können nun FastComments zu jedem Kurs hinzufügen über Aktivität oder Material hinzufügen > FastComments.

Blackboard Learn SaaS und Ultra unterstützen die dynamische Registrierung von LTI 1.3.

Tool Provider-Bildschirm öffnen

1. Melden Sie sich bei Blackboard als Systemadministrator an.
2. Navigieren Sie zu Administrator Panel > Integrations > LTI Tool Providers.
3. Klicken Sie auf Register LTI 1.3 / LTI Advantage Tool.

Wenn Sie nur 'Register LTI 1.1 Provider' sehen, unterstützt Ihre Blackboard-Version noch kein LTI 1.3 – aktualisieren Sie oder kontaktieren Sie den Blackboard-Support.

URL einfügen

Fügen Sie die FastComments-Registrierungs-URL (hier abrufen) in das Feld Client ID / Registration URL ein (die Bezeichnungen in Blackboard variieren je nach Version). Absenden.

Blackboard führt den Registrierungs-Handshake mit FastComments durch und zeigt Ihnen eine Bestätigungsseite an.

Genehmigen und aktivieren

Blackboard markiert neu registrierte Tools standardmäßig als Approved but excluded:

1. Suchen Sie den Eintrag für FastComments in der Tool-Provider-Liste.
2. Öffnen Sie das Menü und wählen Sie Edit.
3. Setzen Sie den Tool Status auf Approved.
4. Überprüfen Sie unter Institution Policies, welche Benutzerdaten gesendet werden (Name, E-Mail, Rolle). Speichern.

Das Tool ist jetzt für Lehrende verfügbar, wenn sie Inhalte zu Kursen hinzufügen.

Sakai

Sakai unterstützt LTI 1.3 Dynamische Registrierung in Releases mit LTI Advantage. Aus dem Administration Workspace:

1. Melden Sie sich als Sakai-Administrator an und öffnen Sie den Administration Workspace.
2. Wählen Sie External Tools > Install LTI 1.3 Tool.
3. Fügen Sie die FastComments-Registrierungs-URL ein (hier abrufen) und senden Sie sie ab.
4. Genehmigen Sie das Tool, wenn der Handshake abgeschlossen ist.

Das Tool erscheint dann unter External Tools und kann von den Betreuern der Sites hinzugefügt werden.

Schoology

Schoology Enterprise-Instanzen unterstützen LTI 1.3, aber die Verfügbarkeit der Dynamischen Registrierung variiert je nach Deployment. Klären Sie dies mit Ihrem Schoology-Kundenbetreuer.

Wenn die Dynamische Registrierung in Ihrer Schoology-Instanz nicht verfügbar ist, müssen Sie die Integration manuell mit diesen Endpunkten konfigurieren:

• 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

Nachdem Schoology Ihnen eine Client ID und eine Deployment ID gegeben hat, kontaktieren Sie den FastComments-Support, um die Konfiguration in Ihrem Mandanten zu registrieren.

Andere LTI 1.3-Plattformen

Jedes LMS, das der IMS LTI 1.3 Advantage-Spezifikation folgt, sollte mit derselben Registrierungs-URL funktionieren (hier abrufen). Suchen Sie nach einer Einstellung mit der Bezeichnung "Dynamic Registration", "Tool Registration URL", "Tool initiation registration endpoint" oder ähnlichem.

Wenn Ihre Plattform nur eine manuelle LTI 1.3-Konfiguration unterstützt, verwenden Sie die vier oben im Schoology-Abschnitt aufgeführten Endpunkte und kontaktieren Sie den Support, um die Einrichtung abzuschließen.

Diese Seite beschreibt das Hinzufügen von FastComments zu einem Brightspace-Kurs, nachdem ein Administrator das Tool registriert und eine Bereitstellung erstellt hat. Wenn das Tool noch nicht registriert ist, lesen Sie zuerst die D2L-Registrierungsanleitung.

FastComments eingebettet als Themen-Einheit in Brightspace

Brightspace liefert zwei Inhaltsauthoring-Erlebnisse: Classic Content und das New Content Experience (auch Lessons genannt). Beide stellen FastComments bereit, aber die Menüpfade unterscheiden sich. Jeder Abschnitt unten behandelt beide Fälle, wo sie auseinandergehen.

FastComments-Tool finden

Das FastComments-Tool erscheint an zwei Stellen im Kursinhalt-Editor:

1. Im Aktivitätspicker, erreichbar über die Add Existing-Schaltfläche eines Moduls/einer Einheit (in älteren Brightspace-Versionen mit der Bezeichnung Add Existing Activities). In aktuellen Brightspace-Versionen zeigt der Picker FastComments direkt an; in älteren Versionen ist es unter einem Untermenü External Learning Tools verschachtelt. Beide Wege fügen FastComments als eigenständiges Thema hinzu.
2. Im Insert Stuff-Dialog des HTML-Editors, unter LTI Advantage. Dies bettet FastComments inline in ein HTML-Thema über den LTI-Deep-Linking-Flow ein.

Wenn FastComments in keinem der Picker erscheint, ist die Bereitstellung für die Organisationseinheit, die den Kurs enthält, nicht aktiviert. Bitten Sie Ihren Brightspace-Administrator, Admin Tools > Manage Extensibility > LTI Advantage > FastComments tool > View Deployments zu öffnen, die Bereitstellung zu öffnen und die Organisationseinheit des Kurses (oder eine übergeordnete Organisationseinheit) unter Org Units hinzuzufügen.

FastComments als Thema in einem Modul hinzufügen

Classic Content:

1. Öffnen Sie den Kurs und klicken Sie in der Navigationsleiste auf Content.
2. Wählen Sie das Modul aus, das die Diskussion enthalten soll (oder erstellen Sie eines über Add a module).
3. Klicken Sie auf Add Existing (älteres Brightspace: Add Existing Activities > External Learning Tools).
4. Klicken Sie im Picker auf FastComments. Brightspace erstellt ein Thema im Modul und bringt Sie zurück zur Inhaltsansicht.
5. Klicken Sie auf das neue Thema. Benennen Sie es mit dem Inline-Titel-Editor in etwas Beschreibendes um, z. B. FastComments Discussion.

New Content Experience (Lessons):

1. Öffnen Sie den Kurs und klicken Sie auf Content.
2. Öffnen Sie die Einheit und die Lesson, die die Diskussion enthalten soll.
3. Klicken Sie auf Add > Existing Activity und wählen Sie FastComments (älteres Brightspace: verschachtelt unter External Learning Tools).
4. Die Aktivität wird zur Lesson hinzugefügt.
5. Klicken Sie auf den Aktivitätstitel, um ihn umzubenennen.

Beim ersten Öffnen des Themas durch einen beliebigen Benutzer (Dozent oder Student) initialisiert FastComments den Thread für diesen Resource Link. Der Thread ist an die Resource Link ID gebunden, sodass Umbenennen oder Verschieben des Themas nicht ändert, welcher Thread geladen wird.

FastComments inline in einem HTML-Thema einbetten

Verwenden Sie diesen Ablauf, wenn Kommentare unter einer Lektüre, einem Video oder anderem Inhalt auf derselben Themenseite erscheinen sollen, anstatt als separates Thema.

1. Öffnen oder erstellen Sie ein HTML-Thema im Modul/der Lesson.
2. Klicken Sie auf Edit HTML, um den Brightspace-HTML-Editor zu öffnen.
3. Setzen Sie den Cursor an die Stelle, an der der Kommentarthread erscheinen soll.
4. Klicken Sie auf die Schaltfläche Insert Stuff (Puzzle-Symbol in der Editor-Symbolleiste).
5. Scrollen Sie im Insert Stuff-Dialog zu LTI Advantage und klicken Sie auf FastComments.
6. FastComments öffnet einen Deep-Linking-Picker. Bestätigen Sie die Platzierung (die Standardoptionen funktionieren für Inhaltsdiskussionen); klicken Sie auf Insert oder Continue.
7. Brightspace kehrt mit einem Platzhalterblock, der den LTI-Launch darstellt, zum HTML-Editor zurück. Klicken Sie auf Save and Close im Thema.

Wenn das Thema geladen wird, ersetzt Brightspace den Platzhalter durch ein iframe, das FastComments per LTI automatisch startet. Studierende sehen den Diskussions-Thread inline.

Ein einzelnes HTML-Thema kann mehrere Deep-Linked FastComments-Einbettungen enthalten. Jede Einbettung erhält ihren eigenen Thread, weil jeder Deep Link eine eigene Resource Link ID erzeugt.

Modulthema vs. Inline-Quicklink

Wählen Sie den Ansatz mit dem Modulthema, wenn:

• Die Diskussion die primäre Aktivität für diesen Schritt im Modul ist.
• Sie möchten, dass das Thema im Inhaltsverzeichnis von Brightspace, in der Abschlussverfolgung und in Class Progress erscheint.

Wählen Sie den Inline-Einbettung-Ansatz, wenn:

• Kommentare unter anderem Inhalt auf derselben Seite stehen sollen.
• Sie keinen separaten, nachverfolgbaren Eintrag im Inhaltsverzeichnis wünschen.

Sichtbarkeit, Entwurf und Freigabebedingungen

Ein neues FastComments-Thema ist standardmäßig für Studierende sichtbar. Um es während der Einrichtung zu verbergen:

1. Klicken Sie im Inhaltseditor auf den Thementitel (Classic) oder das Drei-Punkte-Menü der Aktivität (New Content Experience).
2. Setzen Sie den Status auf Draft (Classic) oder schalten Sie die Visibility (New Content Experience) aus.

Entwurfs-Themen sind für Studierende unsichtbar. Lehrende und TAs sehen sie weiterhin mit einem „Draft“-Badge.

Um das Thema auf eine bestimmte Gruppe oder Sektion zu beschränken:

1. Öffnen Sie das Thema.
2. Klicken Sie im Thementitel-Menü auf > Edit Properties In-place (Classic) oder Edit > Restrictions (New Content Experience).
3. Unter Release Conditions klicken Sie auf Create.
4. Wählen Sie Group enrollment oder Section enrollment, wählen Sie die Gruppe/Sektion aus und speichern Sie.

Freigabebedingungen werden mit der rollenbasierten Zuordnung von FastComments kombiniert. Studierende, die das Thema nicht sehen können, erhalten keinen LTI-Start.

Was Studierende beim ersten Start sehen

Wenn ein Studierender das Thema anklickt (oder ein HTML-Thema mit einer Einbettung lädt):

1. Führt Brightspace den LTI 1.3-Launch im Hintergrund aus.
2. Erhält FastComments den Namen des Studierenden, die E-Mail, die Avatar-URL und die LMS-Rolle und meldet ihn automatisch an. Es erscheint keine FastComments-Anmeldemaske.
3. Wird der Kommentarthread für diesen Resource Link im Brightspace-iframe dargestellt.

Rollen-Abbildung beim Launch:

• Brightspace Administrator wird für den Thread zu einem FastComments admin (vollständige Moderation, Löschen, Sperren und Konfigurationszugriff).
• Brightspace Instructor wird zu einem FastComments moderator (anpinnen, verbergen, löschen, sperren).
• Alle anderen Rollen (Learner, TeachingAssistant, etc.) werden zu normalen Kommentierenden.

Kommentare werden dem Brightspace-Konto des Studierenden zugewiesen. Wenn der Studierende seinen Namen oder Avatar in Brightspace ändert, synchronisiert der nächste LTI-Start die Änderung.

iframe-Höhe und Größenanpassung

FastComments sendet die PostMessage org.imsglobal.lti.frameResize bei jedem Thread-Render und bei Inhaltsänderungen (neuer Kommentar, aufklappbare Antworten). Brightspace hört auf diese Nachricht und passt die iframe-Höhe an, sodass der Thread nicht abgeschnitten wird und kein innerer Scrollbalken angezeigt wird.

Wenn das iframe auf einer festen, zu geringen Höhe bleibt:

• Bestätigen Sie, dass der Kurs über HTTPS geladen wird. Brightspace hört auf PostMessages von Mixed-Content-Frames nicht.
• Stellen Sie sicher, dass keine Browser-Erweiterung den PostMessage-Kanal blockiert.
• Bei Inline-Einbettungen in einem HTML-Thema darf das umgebende HTML das iframe nicht in einen Container mit fester Höhe einbetten. Entfernen Sie jegliches inline style="height: ..." vom übergeordneten Element.

Brightspace-spezifische Fallstricke

Tool wird im Add Existing-Picker nicht angezeigt. Die Bereitstellung ist für die Organisationseinheit dieses Kurses nicht aktiviert. Ein Administrator muss die Organisationseinheit (oder eine übergeordnete) zur Org Units-Liste der Bereitstellung hinzufügen. Die Tool-Registrierung allein reicht nicht aus; die Bereitstellung bestimmt, welche Kurse das Tool sehen.

deployment_id-Mismatch beim Start. FastComments merkt sich bei Vertrauen-durch-Erstkontakt (TOFU) die erste deployment_id, die es für eine Registrierung sieht. Wenn ein Administrator die ursprüngliche Bereitstellung löscht und eine neue erstellt, werden Starts von der neuen Bereitstellung mit einem Deployment-Mismatch-Fehler abgelehnt. Die Lösung besteht darin, FastComments neu zu registrieren (generieren Sie eine neue Registrierungs-URL (hier abrufen) und führen Sie die Dynamische Registrierung erneut aus); der alte Konfigurationsdatensatz wird ersetzt.

Tool startet, zeigt aber "Invalid LTI launch". Der Kurs befindet sich in einer anderen Mandanten-/Organisationsstruktur als die Bereitstellung abdeckt, oder die Bereitstellung wurde nach der Registrierung deaktiviert. Überprüfen Sie Admin Tools > Manage Extensibility > LTI Advantage > FastComments > Enabled-Schalter und die Org Unit-Liste der Bereitstellung.

Namen und Rollen fehlen in FastComments. Brightspace sendet LTI-Starts mit Names and Role Provisioning Services (NRPS)-Claims. Wenn ein Kurs von einem älteren LTI 1.1-Link aktualisiert wurde, fehlen dem Start name- und email-Claims. Fügen Sie das FastComments-Thema erneut über Add Existing hinzu (migrieren Sie den alten Link nicht), damit der Start LTI 1.3 verwendet.

Einbettung zeigt eine Anmeldeseite statt Auto-SSO. Das HTML-Thema wurde als einfaches <iframe> eingefügt, das auf FastComments zeigt, statt über Insert Stuff > LTI Advantage. Einfache iframes überspringen den LTI-Start und landen Benutzer auf der öffentlich zugänglichen FastComments-Seite. Löschen Sie das iframe und fügen Sie es erneut über den Insert Stuff-Workflow ein.

Sobald ein Administrator FastComments als LTI 1.3 Advantage-Tool registriert und die institutionellen Richtlinien genehmigt hat, fügen Lehrende es über die standardmäßigen Blackboard-Platzierungsstellen zu Kursen hinzu. Die genauen Schritte unterscheiden sich zwischen Ultra Course View und Original Course View, daher werden beide unten beschrieben.

Ultra Course View

Ultra Course View ist die Standardansicht in Blackboard Learn SaaS seit 2026.

1. Öffnen Sie den Kurs und gehen Sie zur Course Content-Seite.
2. Bewegen Sie den Mauszeiger oder tippen Sie an die Stelle im Gliederungsbaum, an der der Kommentar-Thread erscheinen soll, und klicken Sie auf die lila + (Add content)-Schaltfläche.
3. Wählen Sie Content Market. Das Content Market-Panel listet alle genehmigten LTI-Tools und Building Block-Platzierungen für Ihre Institution auf.
4. Finden Sie die FastComments-Kachel und klicken Sie darauf. Blackboard erstellt ein Inhaltselement an der Position, an der Sie das +-Menü geöffnet haben.
5. Das Element erscheint standardmäßig als Eintrag „Visible to students“, sofern Lehrende in ihren persönlichen Einstellungen Hide from students nicht aktiviert haben. Ist Ihre Voreinstellung Hidden, wird das Element versteckt erstellt und Sie schalten den Sichtbarkeitsregler in der Elementzeile um, wenn Sie bereit sind.
6. Um das Element umzubenennen, klicken Sie auf den Titel in der Gliederung und geben Sie ein neues Label ein. Der Titel, den Studierende in der Gliederung sehen, ist unabhängig von der FastComments-Thread-Kennung, sodass ein Umbenennen jederzeit sicher ist.

Wenn Sie Content Market nicht als Option sehen, hat Ihre Institution die Platzierung verborgen. Sie erreichen denselben Auswähler auch über More tools im selben +-Menü unter der Gruppe LTI Tools.

Original Course View

Original Course View wird in Learn SaaS weiterhin unterstützt und bleibt die primäre Erfahrung für selbstgehostete Learn 9.1-Sites auf der Q4 2024 CU-Release-Linie.

1. Öffnen Sie den Kurs und betreten Sie einen Content Area (zum Beispiel den standardmäßigen Bereich Information oder Content im Kursmenü).
2. Schalten Sie oben rechts auf der Seite den Edit Mode-Schalter ein.
3. Klicken Sie in der Aktionsleiste auf Build Content.
4. Unter dem Untermenü Learning Tools klicken Sie auf FastComments. Das Untermenü Learning Tools wird nach der Registrierung des Tools durch einen Administrator mit LTI 1.3-Toolplatzierungen gefüllt. Wenn Sie es nicht sehen, siehe den Abschnitt „gotchas“ unten.
5. Auf dem Formular Create FastComments legen Sie fest:
   • Name: das Label, das Studierende im Inhaltsbereich sehen.
   • Description: optionaler Text, der über dem eingebetteten Thread angezeigt wird.
   • Permit Users to View this Content: Ja/Nein-Verfügbarkeitsumschalter.
   • Track Number of Views: aktivieren, wenn Sie die per-Item-Ansichtsstatistiken von Blackboard nutzen möchten. FastComments führt eigene Analytics unabhängig davon aus.
   • Date and Time Restrictions: optionale Display After / Display Until-Fenster.
6. Absenden. Das Tool erscheint als klickbares Element im Inhaltsbereich.

Embedding Inside an Item or Document

In beiden Kursansichten betten Lehrende FastComments inline in den Textkörper eines Items, Dokuments oder eines beliebigen Rich-Text-Felds über die LTI Advantage-Schaltfläche des Content Editors ein.

Ultra Course View:

1. Erstellen oder bearbeiten Sie ein Document.
2. Klicken Sie im Dokumentkörper auf Add content an der Stelle, an der der Thread erscheinen soll.
3. Öffnen Sie in der Editor-Symbolleiste das Menü Insert content und klicken Sie auf Content Market (den Einstiegspunkt LTI Advantage / Deep Linking).
4. Wählen Sie FastComments. FastComments liefert eine Deep-Link-Payload und Blackboard fügt an der Cursor-Position einen eingebetteten Block in den Dokumentkörper ein.
5. Speichern Sie das Dokument. Studierende sehen den Thread inline gerendert, wenn sie daran vorbeiscrollen.

Original Course View:

1. Bearbeiten Sie ein beliebiges Item mit einem Rich-Text-Body.
2. Klicken Sie in der Symbolleiste des Content Editors auf das Plus-Symbol Add Content und wählen Sie Content Market (in älteren Q4 2024 CUs als Add Content from External Tool beschriftet).
3. Wählen Sie FastComments. Der Editor fügt einen Platzhalterblock ein, der auf die Deep-Linked-Ressource verweist.
4. Senden Sie das Item ab.

Jede Deep-Link-Einbettung erzeugt ihren eigenen FastComments-Thread, sodass ein Item mit zwei eingebetteten FastComments-Blöcken zwei unabhängige Kommentarströme hat.

Visibility, Release Conditions, and Group Restrictions

FastComments-Inhaltselemente verhalten sich wie andere Blackboard-Inhaltselemente hinsichtlich der darauf angewendeten Zugriffskontrollregeln.

• Ultra: Klicken Sie auf den Sichtbarkeitsregler in der Zeile (Visible to students, Hidden from students, Conditional availability). Conditional availability unterstützt Datums-/Uhrzeitfenster, Performance-Regeln gegen Gradebook-Items und Mitgliedsregeln gegen Kursgruppen.
• Original: Öffnen Sie das Kontextmenü des Elements und wählen Sie Adaptive Release oder Adaptive Release: Advanced, um das Tool nach Datum, Mitgliedschaft, Note oder Prüfungsstatus zu sperren. Verwenden Sie Set Group Availability am Element, um es auf bestimmte Kursgruppen zu beschränken.

FastComments respektiert, was auch immer das Blackboard-Gate entscheidet. Wenn Blackboard das Element für einen Studierenden verbirgt, findet für diese Person kein LTI-Launch statt und sie erscheint nicht in der Moderatoransicht.

Gradebook Behavior

FastComments meldet keine Noten über LTI Advantage Assignment and Grade Services zurück. Es wird keine Notenspalte automatisch für FastComments-Inhaltselemente erstellt.

Wenn Ihr Blackboard-Tenant so konfiguriert ist, dass für jedes neue Inhaltselement unabhängig von Bewertungsmetadaten automatisch eine Notenspalte erstellt wird, erscheint trotzdem eine leere Spalte. Um sie auszublenden:

• Ultra: Öffnen Sie das Gradebook, klicken Sie auf den Spaltenkopf, wählen Sie Edit und deaktivieren Sie Show to students sowie Include in calculations. Oder verwenden Sie Delete, wenn Ihre Institution das Löschen von Spalten für unbewertete Elemente erlaubt.
• Original: Öffnen Sie das Grade Center, klicken Sie auf den Chevron der Spalte, wählen Sie Hide from Users (on/off) und optional Hide from Instructor View unter Column Organization.

What Students See

Wenn eine Studentin oder ein Student das FastComments-Element öffnet oder zu einem eingebetteten Block scrollt:

1. Blackboard startet die LTI 1.3-Nachricht an FastComments. Die Studentin/der Student ist per SSO mit ihrer/seiner Blackboard-Identität (Name, E-Mail, Avatar, Rolle) angemeldet, ohne ein Anmeldeformular zu sehen.
2. Der Kommentar-Thread rendert im iframe. Threading, Antworten, Erwähnungen und Reaktionen sind je nach in FastComments konfigurierten Kommentar-Widget-Einstellungen verfügbar.
3. Ihre/seine Kommentare werden ihrem/seinem Blackboard-Konto zugeordnet. Wenn die Studentin/der Student später ihren/seinen Namen oder ihr/sein Foto in Blackboard ändert, aktualisiert der nächste Launch das FastComments-Profil.

Role-Mapping von Blackboard zu FastComments:

• System Administrator und Course Builder map to FastComments admin.
• Instructor und Teaching Assistant map to FastComments moderator.
• Student, Guest, und Observer map to FastComments commenter.

Moderators sehen Moderationskontrollen (pin, hide, ban, delete) inline an jedem Kommentar im Thread.

Thread Scoping

FastComments scopet jeden Thread nach (Blackboard host, course ID, resource link ID). Zwei FastComments-Elemente im selben Kurs erzeugen zwei Threads. Dasselbe Element, das in zwei Kurs-Instanzen kopiert wird (zum Beispiel durch Course Copy), erzeugt zwei Threads, da Blackboard beim Kopieren eine neue resource link ID ausstellt. Um einen geteilten Thread über Kurskopien hinweg beizubehalten, verwenden Sie Deep Linking mit einer expliziten Thread-URN, die in FastComments vor dem Starten der Kopie konfiguriert wird.

Blackboard-Specific Gotchas

FastComments tile missing from the Build Content menu (Original) or Content Market (Ultra). Der Administrator hat das Tool genehmigt, aber eine institutionelle Richtlinie die relevante Platzierung blockiert. Gehen Sie zu Administrator Panel > Integrations > LTI Tool Providers, bearbeiten Sie den FastComments-Eintrag und prüfen Sie, dass sowohl Course Content Tool (Original) als auch Course Content Tool - allow students / Deep Linking content tool (Ultra) Platzierungen aktiviert sind. Speichern und aktualisieren Sie die Kursseite.

"Tool not configured for this context" or "Tool is not deployed" error on launch. Der während der dynamischen Registrierung registrierte Deployment-Scope stimmt nicht mit dem Institutionskontext überein, zu dem der Kurs gehört. Überprüfen Sie im Tool-Provider-Eintrag von Blackboard, ob die Deployment ID mit der übereinstimmt, die FastComments auf seiner LTI 1.3-Configuration-Seite für diesen Tenant anzeigt. Falls sie abweichen, löschen Sie die Platzierung und führen Sie die dynamische Registrierung erneut über eine frische Registrierungs-URL aus (hier abrufen).

Iframe height looks fixed or content gets cut off. Manche Blackboard-Tenants liefern eine strikte Content Security Policy aus, die die standardmäßige LTI-iframe-resize postMessage blockiert. FastComments sendet sowohl die Canvas-Style-lti.frameResize-Nachricht als auch die IMS-Spec-Form org.imsglobal.lti.frameResize-Nachricht, um die Kompatibilität zu maximieren, aber eine Tenant-weite CSP-Überschreibung blockiert den Parent-Listener. Bitten Sie Ihren Administrator zu bestätigen, dass *.fastcomments.com auf der LTI-Tool-Allowlist steht und dass kein benutzerdefinierter CSP-Header postMessage-Events entfernt. Danach funktioniert das Resizing ohne weitere Konfiguration.

Course copy duplicates threads. Beim Blackboard Course Copy werden neue resource link IDs für LTI-Platzierungen ausgegeben, sodass kopierte Kurse mit leeren Threads starten. Das ist erwartetes Verhalten. Wenn der kopierte Kurs den ursprünglichen Thread erben soll, richten Sie Deep Linking mit einer expliziten Thread-URN vor dem Kopieren ein oder kontaktieren Sie den FastComments-Support, um Thread-IDs in großer Zahl neu zuzuordnen.

Student sees a generic Blackboard error on launch. Ursache ist ein fehlender oder veralteter email-Claim. Stellen Sie sicher, dass in der Institution Policy für FastComments unter User Fields to Send die Felder Role, Name und Email Address aktiviert sind. Speichern Sie und starten Sie dann in einer frischen Browsersitzung erneut.

"Registrierungs-Token nicht gefunden, abgelaufen oder bereits verwendet"

Das Token in Ihrer Registrierungs-URL (hier abrufen) ist 30 Minuten gültig und kann nur einmal verwendet werden. Wenn Ihr LMS länger gebraucht hat oder die Registrierung nach einem erfolgreichen Versuch erneut ausgeführt wurde, wird das Token abgelehnt. Generieren Sie eine neue URL auf der FastComments LTI 1.3 Konfigurationsseite und beginnen Sie erneut.

"Plattform hat Registrierung abgelehnt"

Ihr LMS hat den Registrierungs-Handshake abgelehnt. Die häufigsten Ursachen:

• Tool already registered with the same client name. Einige Plattformen (insbesondere D2L) lehnen eine zweite Registrierung von "FastComments" ab, bis die vorherige gelöscht wurde. Entfernen Sie das alte Tool in Ihrem LMS und versuchen Sie es erneut.
• Wrong field in the LMS. Stellen Sie sicher, dass Sie die URL in das registration / tool initiation registration endpoint-Feld eingefügt haben, nicht in das launch URL- oder login URL-Feld.
• The LMS doesn't actually support Dynamic Registration. Ältere Moodle- und Blackboard-Versionen geben LTI 1.3 an, erlauben jedoch nur manuelle Konfiguration. Prüfen Sie die Dokumentation Ihrer Plattform.

"Fehler beim Abrufen der Plattformkonfiguration"

FastComments konnte das openid-configuration-Dokument Ihres LMS nicht lesen. Das ist selten und bedeutet normalerweise, dass das LMS eine fehlerhafte oder nicht erreichbare discovery URL geliefert hat. Kontaktieren Sie den Support Ihres LMS.

Start zeigt "Konfiguration nicht gefunden"

Entweder wurde die Konfiguration in FastComments gelöscht, oder der Start kam von einem iss/client_id-Paar, das wir nicht erkennen. Wenn Sie gelöscht und neu registriert haben, weisen Sie Ihr LMS an, das FastComments-Tool zu entfernen und erneut hinzuzufügen, damit es die neue client_id erhält.

Start zeigt "Deployment nicht registriert"

Sie haben FastComments von einer Brightspace-/Moodle-/Blackboard-Bereitstellung gestartet, die sich von derjenigen unterscheidet, in der es zuerst gestartet wurde. FastComments pinnt die deployment_id beim ersten Start als Sicherheitsprüfung. Um eine neue Bereitstellung unter demselben Client hinzuzufügen, kontaktieren Sie den Support – wir fügen die deployment ID zur Konfiguration hinzu.

Start zeigt "Nicht unterstützter message_type"

Das LMS hat eine LTI-Nachricht gesendet, die FastComments nicht verarbeitet (z. B. LtiSubmissionReviewRequest). FastComments unterstützt nur die standardmäßigen resource-link-Launch- und deep-linking-Flows. Melden Sie sich bei uns, wenn Sie einen bestimmten Nachrichtentyp hinzugefügt haben möchten.

Iframe passt sich nicht an

Die meisten LMS passen LTI-Iframes automatisch an. Wenn Ihres das nicht tut, prüfen Sie, ob die Starteinstellungen des LMS es dem Tool erlauben, postMessage-Ereignisse an den übergeordneten Frame zu senden. FastComments sendet sowohl Canvas-Style- (lti.frameResize) als auch IMS-Spezifikations- (org.imsglobal.lti.frameResize) Resize-Nachrichten.