Add Comments to Your LMS via LTI 1.3

1. Accedi a FastComments e vai alla tua pagina di configurazione LTI 1.3.
2. (Facoltativo) Seleziona la piattaforma da cui ti connetti dal menu a discesa Platform - imposta l'etichetta di visualizzazione, ma Auto-detect funziona bene.
3. Clicca su Generate URL. Apparirà un Registration URL usa e getta (valido per 30 minuti).
4. Nel tuo LMS, apri la schermata di Registrazione Dinamica LTI 1.3 e incolla l'URL nel campo Tool initiation registration endpoint (o equivalente). Invia.
5. Il tuo LMS richiama FastComments, scambia le chiavi e crea l'integrazione. Il popup si chiude automaticamente al termine.
6. Tornando in FastComments, la nuova configurazione appare nella tabella Existing Configurations. Lo strumento è ora disponibile nei corsi del tuo LMS.

FastComments LTI 1.3 è stato testato con:

• D2L Brightspace (qualsiasi versione con LTI Advantage)
• Moodle 4.0+ (plugin External Tool, LTI Advantage)
• Blackboard Learn (SaaS e Ultra)
• Sakai (versioni con supporto LTI Advantage)
• Schoology (Enterprise, Dynamic Registration dove disponibile)

Qualsiasi altro LMS che implementa la specifica IMS LTI 1.3 Advantage con Dynamic Registration dovrebbe funzionare - seleziona Altra piattaforma LTI 1.3 dal menu a discesa della piattaforma quando generi la tua URL di registrazione (ottienilo qui).

Canvas LMS utilizza un flusso di configurazione diverso (per-developer-key configuration JSON invece di Dynamic Registration). Consulta la guida di installazione dedicata a Canvas LMS.

Vai alla configurazione LTI 1.3

Accedi a FastComments e vai a la tua pagina di configurazione LTI 1.3.

Se il tuo account non ha ancora accesso a LTI, vedrai "LTI non abilitato per questo account" - contatta il supporto per abilitarlo sul tuo piano.

Scegli una piattaforma (opzionale)

Sotto Genera un URL di registrazione dinamico, usa il menu a discesa Piattaforma per indicare a FastComments a quale LMS ti stai collegando:

• D2L Brightspace
• Moodle
• Blackboard Learn
• Sakai
• Schoology
• Altra piattaforma LTI 1.3

Puoi anche lasciarlo su Rilevamento automatico. La piattaforma viene letta dall'openid-configuration del tuo LMS durante la registrazione; il menu a discesa imposta solo l'etichetta di visualizzazione per la configurazione risultante.

Genera l'URL

Fai clic su Genera URL. FastComments crea un token di registrazione monouso e ti mostra un URL che appare come:

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

Copialo. Questo URL:

• È monouso - una volta che il tuo LMS lo richiama con successo, il token viene consumato.
• Scade dopo 30 minuti se non viene usato.
• Deve essere mantenuto privato - chiunque abbia l'URL può registrare uno strumento per il tuo tenant entro quei 30 minuti.

Configurazioni esistenti

Una volta che una registrazione è completata con successo, la nuova configurazione viene visualizzata nella tabella Configurazioni esistenti sulla stessa pagina, con Piattaforma, Emittente, Client ID e Stato. Puoi eliminare le configurazioni da questa tabella se mai dovessi annullare la registrazione.

D2L Brightspace espone la Registrazione Dinamica tramite l'interfaccia di amministrazione LTI Advantage. Avrai bisogno di accesso amministrativo.

Open the Registration Screen

1. Accedi alla tua istanza Brightspace come amministratore.
2. Vai a Admin Tools > Manage Extensibility > LTI Advantage.
3. Fai clic su Register Tool. (L'URL diretto è https://<your-brightspace-host>/d2l/le/ltiadvantage/registrations/create.)

Paste the URL

Vedrai un modulo di registrazione. Il campo chiave è Tool initiation registration endpoint (alcune versioni di Brightspace lo etichettano come "Tool Initiation Registration URL").

Incolla l'URL di registrazione di FastComments (ottienilo qui) in quel campo. Lascia gli altri campi vuoti - vengono compilati automaticamente da FastComments durante lo scambio di registrazione.

Fai clic su Register.

Approve the Tool

Brightspace apre una finestra pop-up che comunica con FastComments, scambia le chiavi e mostra una schermata di conferma. La finestra pop-up si chiude automaticamente quando la registrazione è completata.

Il nuovo strumento appare nell'elenco degli strumenti LTI Advantage. Per impostazione predefinita Brightspace contrassegna i nuovi strumenti come disabled - attiva l'interruttore su enabled affinché i tuoi corsi possano utilizzarlo.

Add a Deployment

In Brightspace, gli strumenti LTI necessitano di un deployment prima di poter essere utilizzati nei corsi:

1. Apri lo strumento FastComments appena registrato.
2. Fai clic su View Deployments > New Deployment.
3. Dai al deployment un nome (es. "FastComments - All Courses"), seleziona le unità organizzative in cui deve essere disponibile e salva.

Dopo il primo avvio tramite questo deployment, FastComments associa il deployment_id al suo record di configurazione - i successivi avvii da un deployment diverso sotto lo stesso client saranno rifiutati a meno che non ti registri nuovamente.

Usi Moodle? Pubbliciamo anche un plugin dedicato per Moodle per FastComments con un'integrazione più stretta rispetto a LTI 1.3 (hook di sincronizzazione dei voti, report attività più approfonditi, interfaccia delle impostazioni nativa di Moodle). Vedi la guida all'installazione del plugin Moodle. Il flusso LTI 1.3 qui sotto è la scelta giusta se vuoi una registrazione unica che copra anche altri LMS, o se l'amministratore di Moodle non installerà plugin di terze parti.

Moodle 4.0+ supporta la Registrazione Dinamica LTI 1.3 tramite il plugin External Tool.

Apri la schermata di gestione dello strumento

1. Accedi a Moodle come amministratore del sito.
2. Naviga su Site administration > Plugins > Activity modules > External tool > Manage tools.

Incolla l'URL

Vedrai una scheda etichettata URL dello strumento. Incolla l'URL di registrazione di FastComments (ottienilo qui) nel campo di testo e clicca Aggiungi LTI Advantage.

Moodle aprirà una schermata di registrazione che mostra l'identità dello strumento e le autorizzazioni richieste. Verifica e clicca Attiva (o Registra, a seconda della versione di Moodle).

La finestra popup si chiude al termine della registrazione; il nuovo strumento FastComments appare nella lista Strumenti con lo stato Attivo.

Rendilo disponibile

Per impostazione predefinita Moodle aggiunge i nuovi strumenti alla lista "strumenti del corso" ma non li mostra nel selettore di attività. Per rendere FastComments disponibile in tutto il corso:

1. Clicca l'icona dell'ingranaggio sulla scheda FastComments.
2. Sotto Tool configuration usage, scegli Mostra nel selettore attività e come strumento preconfigurato.
3. Salva.

Gli insegnanti ora possono aggiungere FastComments a qualsiasi corso tramite Aggiungi un'attività o una risorsa > FastComments.

Blackboard Learn SaaS e Ultra supportano la registrazione dinamica LTI 1.3.

Apri la schermata del provider dello strumento

1. Accedi a Blackboard come amministratore di sistema.
2. Vai a Pannello di amministrazione > Integrazioni > Fornitori di strumenti LTI.
3. Fai clic su Registra strumento LTI 1.3 / LTI Advantage.

Se vedi solo "Register LTI 1.1 Provider", la tua versione di Blackboard non supporta ancora LTI 1.3 - esegui l'aggiornamento o contatta il supporto Blackboard.

Incolla l'URL

Incolla l'URL di registrazione di FastComments (lo trovi qui) nel campo Client ID / Registration URL (la denominazione in Blackboard varia a seconda della versione). Invia.

Blackboard esegue la procedura di registrazione con FastComments e mostra una schermata di conferma.

Approva e abilita

Blackboard contrassegna gli strumenti appena registrati come Approvato ma escluso per impostazione predefinita:

1. Trova la voce FastComments nell'elenco dei fornitori di strumenti.
2. Apri il menu e scegli Modifica.
3. Imposta Stato dello strumento su Approvato.
4. Sotto Politiche dell'istituzione, verifica quali dati utente vengono inviati (nome, email, ruolo). Salva.

Lo strumento è ora disponibile per i docenti quando aggiungono contenuti ai corsi.

Sakai

Sakai supporta la Registrazione Dinamica LTI 1.3 nelle release con LTI Advantage. Dalla Area di amministrazione:

1. Accedi come amministratore Sakai e apri la Administration Workspace.
2. Scegli External Tools > Install LTI 1.3 Tool.
3. Incolla l'URL di registrazione FastComments (ottienilo qui) e invia.
4. Approva lo strumento quando l'handshake è completato.

Lo strumento apparirà quindi sotto External Tools e può essere aggiunto ai siti dai loro manutentori.

Schoology

Le istanze Schoology Enterprise supportano LTI 1.3 ma la disponibilità della Registrazione Dinamica varia in base alla distribuzione. Verifica con il tuo account manager Schoology.

Se la Registrazione Dinamica non è disponibile sulla tua istanza Schoology, dovrai configurare l'integrazione manualmente utilizzando questi endpoint:

• URL di accesso OIDC: https://fastcomments.com/lti/v1p3/login
• URL del collegamento di destinazione: https://fastcomments.com/lti/v1p3/launch
• URL del set di chiavi pubbliche (JWKS): https://fastcomments.com/lti/v1p3/jwks
• URL di reindirizzamento: https://fastcomments.com/lti/v1p3/launch

Dopo che Schoology ti fornisce un Client ID e un Deployment ID, contatta il supporto FastComments per registrare la configurazione sul tuo tenant.

Altre piattaforme LTI 1.3

Qualsiasi LMS che segua la specifica IMS LTI 1.3 Advantage dovrebbe funzionare con lo stesso URL di registrazione (ottienilo qui). Cerca un'impostazione etichettata "Registrazione Dinamica", "URL di registrazione dello strumento", "endpoint di registrazione per l'inizializzazione dello strumento" o simile.

Se la tua piattaforma supporta solo la configurazione manuale di LTI 1.3, usa i quattro endpoint elencati nella sezione Schoology sopra e contatta il supporto per finalizzare.

Questa pagina tratta l'aggiunta di FastComments a un corso Brightspace dopo che un amministratore ha registrato lo strumento e creato una deployment. Se lo strumento non è ancora registrato, consulta prima la guida di registrazione D2L.

FastComments embedded as a unit topic in Brightspace

Brightspace offre due esperienze di creazione dei contenuti: Classic Content e la New Content Experience (chiamata anche Lessons). Entrambe espongono FastComments, ma i percorsi nei menu differiscono. Ogni sezione qui sotto copre entrambe le esperienze quando divergono.

Locate the FastComments Tool

Lo strumento FastComments appare in due punti all'interno dell'editor dei contenuti di un corso:

1. Il selettore di attività, raggiungibile dal pulsante Add Existing del modulo/unità (etichettato Add Existing Activities nelle versioni precedenti di Brightspace). FastComments appare direttamente nel selettore nelle build correnti di Brightspace; nelle versioni più vecchie è annidato sotto un sottomenu External Learning Tools. Entrambe le vie aggiungono FastComments come topic autonomo.
2. La finestra di dialogo Insert Stuff all'interno dell'editor HTML, sotto LTI Advantage. Questo incorpora FastComments inline in un topic HTML tramite il flusso di deep linking LTI.

Se FastComments non appare in nessuno dei due selettori, la deployment non è abilitata per l'org unit che contiene il corso. Chiedi al tuo amministratore Brightspace di aprire Admin Tools > Manage Extensibility > LTI Advantage > FastComments tool > View Deployments, aprire la deployment e aggiungere l'org unit del corso (o un org unit padre) sotto Org Units.

Add FastComments as a Topic in a Module

Classic Content:

1. Apri il corso e clicca Content nella barra di navigazione.
2. Seleziona il modulo che deve contenere la discussione (o creane uno tramite Add a module).
3. Clicca Add Existing (Brightspace più vecchio: Add Existing Activities > External Learning Tools).
4. Nel selettore, clicca FastComments. Brightspace crea un topic nel modulo e ti riporta alla vista dei contenuti.
5. Clicca il nuovo topic. Rinominalo con qualcosa di descrittivo come FastComments Discussion usando l'editor del titolo inline.

New Content Experience (Lessons):

1. Apri il corso e clicca Content.
2. Apri l'unità e la lesson che dovrebbero contenere la discussione.
3. Clicca Add > Existing Activity e seleziona FastComments (Brightspace più vecchio: annidato sotto External Learning Tools).
4. L'attività viene aggiunta alla lesson.
5. Clicca il titolo dell'attività per rinominarla.

La prima volta che un utente (istruttore o studente) apre il topic, FastComments inizializza il thread per quel resource link. Il thread è legato all'ID del resource link, quindi rinominare o spostare il topic non modifica quale thread viene caricato.

Embed FastComments Inline in an HTML Topic

Usa questo flusso quando vuoi che i commenti appaiano sotto una lettura, un video o altro contenuto all'interno della stessa pagina del topic anziché come topic separato.

1. Apri o crea un topic HTML nel modulo/lesson.
2. Clicca Edit HTML per aprire l'editor HTML di Brightspace.
3. Posiziona il cursore dove deve apparire il thread dei commenti.
4. Clicca il pulsante Insert Stuff (icona a forma di pezzo di puzzle nella barra degli strumenti dell'editor).
5. Nella finestra Insert Stuff, scorri fino a LTI Advantage e clicca FastComments.
6. FastComments apre un selettore di deep linking. Conferma il posizionamento (le opzioni di default funzionano per le discussioni sui contenuti); clicca Insert o Continue.
7. Brightspace ritorna all'editor HTML con un blocco segnaposto che rappresenta il lancio LTI. Clicca Save and Close sul topic.

Quando il topic viene caricato, Brightspace sostituisce il segnaposto con un iframe che avvia automaticamente FastComments tramite LTI. Gli studenti vedono il thread della discussione inline.

Un singolo topic HTML può contenere più embed FastComments deep-linked. Ogni embed ottiene il proprio thread perché ogni deep link produce un resource link ID distinto.

Module Topic vs Inline Quicklink

Scegli l'approccio del module topic quando:

• La discussione è l'attività principale per quel passaggio nel modulo.
• Vuoi che il topic appaia nella table of contents di Brightspace, nel completion tracking e in Class Progress.

Scegli l'approccio inline embed quando:

• I commenti devono stare sotto altri contenuti nella stessa pagina.
• Non vuoi un elemento separato tracciabile per il completamento nella table of contents.

Visibility, Draft, and Release Conditions

Un nuovo topic FastComments è visibile agli studenti per impostazione predefinita. Per nasconderlo mentre lo configuri:

1. Nell'editor dei contenuti, clicca il titolo del topic (Classic) o il menu a tre puntini sull'attività (New Content Experience).
2. Imposta lo stato su Draft (Classic) o disattiva la Visibility (New Content Experience).

I topic in Draft sono invisibili agli studenti. I docenti e gli assistenti didattici li vedono comunque con un badge "Draft".

Per limitare il topic a un gruppo o a una sezione specifica:

1. Apri il topic.
2. Clicca il menu del titolo del topic > Edit Properties In-place (Classic) o Edit > Restrictions (New Content Experience).
3. Sotto Release Conditions, clicca Create.
4. Scegli Group enrollment o Section enrollment, seleziona il gruppo/sezione e salva.

Le condizioni di rilascio si sommano al mapping dei ruoli di FastComments. Gli studenti che non possono vedere il topic non ricevono un lancio LTI.

What Students See on First Launch

Quando uno studente clicca il topic (o carica un topic HTML con un embed):

1. Brightspace esegue il lancio LTI 1.3 in background.
2. FastComments riceve il nome dello studente, l'email, l'URL dell'avatar e il ruolo nell'LMS, e li autentica automaticamente. Non viene mostrata alcuna richiesta di login a FastComments.
3. Il thread dei commenti per quel resource link viene renderizzato all'interno dell'iframe Brightspace.

Mapping dei ruoli al lancio:

• Brightspace Administrator diventa un FastComments admin per il thread (moderazione completa, delete, ban e accesso alla configurazione).
• Brightspace Instructor diventa un FastComments moderator (pin, hide, delete, ban).
• Tutti gli altri ruoli (Learner, TeachingAssistant, ecc.) diventano commentatori standard.

I commenti sono attribuiti all'account Brightspace dello studente. Se lo studente modifica il proprio nome o avatar in Brightspace, il successivo lancio LTI sincronizza la modifica.

Iframe Height and Resize

FastComments emette il postMessage org.imsglobal.lti.frameResize ad ogni render del thread e quando il contenuto cambia (nuovo commento, espansione delle risposte). Brightspace ascolta questo messaggio e regola l'altezza dell'iframe in modo che il thread non venga tagliato e non mostri una scrollbar interna.

Se l'iframe rimane a un'altezza fissa e ridotta:

• Conferma che il corso sia caricato tramite HTTPS. Il listener postMessage di Brightspace rifiuta frame con contenuti misti.
• Conferma che nessuna estensione del browser stia bloccando il canale postMessage.
• Per gli embed inline in un topic HTML, l'HTML circostante non deve avvolgere l'iframe in un contenitore ad altezza fissa. Rimuovi qualsiasi inline style="height: ..." dall'elemento padre.

Brightspace-Specific Gotchas

Tool not showing in the Add Existing picker. La deployment non è abilitata per l'org unit di questo corso. Un amministratore deve aggiungere l'org unit (o un padre) alla lista Org Units della deployment. La sola registrazione dello strumento non basta; la deployment determina quali corsi vedono lo strumento.

deployment_id mismatch on launch. FastComments memorizza in modo TOFU il primo deployment_id che riceve per una registration. Se un amministratore elimina la deployment originale e ne crea una nuova, i lanci dalla nuova deployment vengono rifiutati con un errore di mismatch della deployment. La soluzione è re-registrare FastComments (genera una nuova registration URL (get it here) ed eseguire nuovamente la Dynamic Registration); il vecchio record di configurazione verrà sostituito.

Tool launches but shows "Invalid LTI launch". Il corso si trova in una struttura tenant/org diversa rispetto a quella coperta dalla deployment, oppure la deployment è stata disabilitata dopo la registrazione. Ricontrolla Admin Tools > Manage Extensibility > LTI Advantage > FastComments > il toggle Enabled e la lista degli org unit della deployment.

Names and roles missing inside FastComments. Brightspace include nei lanci LTI le claims di Names and Role Provisioning Services (NRPS). Se un corso è stato aggiornato da un vecchio link LTI 1.1, il lancio potrebbe mancare delle claims name e email. Riaggiungi il topic FastComments tramite Add Existing (non migrare il vecchio link) in modo che il lancio utilizzi LTI 1.3.

Embed shows a login screen instead of auto-SSO. Il topic HTML è stato inserito come un normale <iframe> che punta a FastComments invece di essere inserito tramite Insert Stuff > LTI Advantage. I normali iframe saltano il lancio LTI e portano gli utenti sulla pagina pubblica di FastComments. Elimina l'iframe e reinseriscilo tramite il flusso Insert Stuff.

Una volta che un amministratore ha registrato FastComments come strumento LTI 1.3 Advantage e ha approvato le policy dell'istituzione, gli insegnanti lo aggiungono ai corsi tramite i punti di posizionamento standard di Blackboard. I passaggi esatti differiscono tra Ultra Course View e Original Course View, quindi entrambi sono descritti di seguito.

Ultra Course View

Ultra Course View è il valore predefinito in Blackboard Learn SaaS a partire dal 2026.

1. Apri il corso e vai alla pagina Course Content.
2. Posiziona il cursore o tocca dove vuoi che il thread dei commenti appaia nell'outline e fai clic sul pulsante viola + (Aggiungi contenuto).
3. Scegli Content Market. Il pannello Content Market elenca tutti gli strumenti LTI approvati e i posizionamenti Building Block per la tua istituzione.
4. Trova la tessera FastComments e cliccala. Blackboard crea un elemento di contenuto nella posizione in cui hai aperto il menu +.
5. L'elemento appare nell'outline come voce "Visible to students" per impostazione predefinita per gli insegnanti che hanno Hide from students disattivato come impostazione personale. Se il tuo valore predefinito è Hidden, l'elemento viene creato nascosto e attivi il selettore di visibilità sulla riga dell'elemento quando sei pronto.
6. Per rinominare l'elemento, clicca il titolo nell'outline e digita un'etichetta nuova. Il titolo che gli studenti vedono nell'outline è indipendente dall'identificatore del thread FastComments, quindi rinominare è sicuro in qualsiasi momento.

Se non vedi Content Market come opzione, la tua istituzione ha nascosto il posizionamento. Puoi anche raggiungere lo stesso selettore tramite More tools nello stesso menu + sotto il gruppo LTI Tools.

Original Course View

Original Course View è ancora supportato in Learn SaaS e rimane l'esperienza primaria per i siti Learn 9.1 self-hosted sulla linea di rilascio Q4 2024 CU.

1. Apri il corso ed entra in una Content Area (ad esempio, l'area predefinita Information o Content nel menu del corso).
2. Attiva Edit Mode con l'interruttore nell'angolo in alto a destra della pagina.
3. Clicca Build Content nella barra delle azioni.
4. Nel sottomenu Learning Tools, clicca FastComments. Il sottomenu Learning Tools viene popolato dai posizionamenti degli strumenti LTI 1.3 dopo che un amministratore ha registrato lo strumento. Se non lo vedi, vedi la sezione dei problemi comuni qui sotto.
5. Nel modulo Create FastComments, imposta:
   • Name: l'etichetta che gli studenti vedono nell'area di contenuto.
   • Description: testo opzionale mostrato sopra il thread incorporato.
   • Permit Users to View this Content: interruttore di disponibilità Sì/No.
   • Track Number of Views: abilita se desideri le statistiche di visualizzazione per elemento di Blackboard. FastComments gestisce le proprie analitiche in modo indipendente.
   • Date and Time Restrictions: finestre opzionali Display After / Display Until.
6. Invia. Lo strumento appare come elemento cliccabile nell'area di contenuto.

Incorporamento all'interno di un elemento o documento

In entrambe le viste del corso, gli insegnanti incorporano FastComments inline all'interno del corpo di un Item, Documento o di qualsiasi campo rich-text tramite il pulsante LTI Advantage dell'Editor di contenuti.

Ultra Course View:

1. Crea o modifica un Document.
2. Clicca Add content all'interno del corpo del documento dove vuoi che il thread appaia.
3. Nella barra degli strumenti dell'editor, apri il menu Insert content e clicca Content Market (il punto di ingresso LTI Advantage / Deep Linking).
4. Scegli FastComments. FastComments restituisce un payload di deep-link e Blackboard inserisce un blocco incorporato nel corpo del documento nella posizione del cursore.
5. Salva il documento. Gli studenti vedono il thread renderizzato inline mentre scorrono oltre.

Original Course View:

1. Modifica qualsiasi elemento con un corpo in rich-text.
2. Nella barra degli strumenti del Content Editor, clicca sull'icona plus Add Content e scegli Content Market (etichettato Add Content from External Tool nelle CU Q4 2024 più vecchie).
3. Scegli FastComments. L'editor inserisce un blocco segnaposto che fa riferimento alla risorsa deep-linked.
4. Invia l'elemento.

Ogni embed deep-link produce il proprio thread FastComments, quindi un Item con due blocchi FastComments incorporati ha due flussi di commenti indipendenti.

Visibilità, condizioni di rilascio e restrizioni di gruppo

Gli elementi di contenuto FastComments si comportano come qualsiasi altro elemento di contenuto di Blackboard per le regole di controllo degli accessi applicate su di essi.

• Ultra: clicca il selettore di visibilità sulla riga (Visible to students, Hidden from students, Conditional availability). La disponibilità condizionale supporta finestre di data/ora, regole di performance rispetto agli elementi del registro voti e regole sui membri rispetto ai gruppi del corso.
• Original: apri il menu contestuale dell'elemento e scegli Adaptive Release o Adaptive Release: Advanced per limitare lo strumento per data, appartenenza, voto o stato di revisione. Usa Set Group Availability sull'elemento per limitarne l'accesso a gruppi specifici del corso.

FastComments rispetta qualunque limite imponga Blackboard. Se Blackboard nasconde l'elemento a uno studente, il lancio LTI non avviene mai per quello studente e lui/lei non compare nella vista dei moderatori.

Comportamento nel registro voti

FastComments non riporta voti tramite LTI Advantage Assignment and Grade Services. Nessuna colonna dei voti viene creata automaticamente per gli elementi di contenuto FastComments.

Se il tuo tenant Blackboard è configurato per creare automaticamente una colonna del registro voti per ogni nuovo elemento di contenuto indipendentemente dai metadati di valutazione, apparirà comunque una colonna vuota. Per nasconderla:

• Ultra: apri il Gradebook, clicca l'intestazione della colonna, scegli Edit, e disattiva Show to students oltre a Include in calculations. Oppure usa Delete se la tua istituzione consente la cancellazione delle colonne per elementi non valutati.
• Original: apri il Grade Center, clicca il chevron della colonna, scegli Hide from Users (on/off) e opzionalmente Hide from Instructor View sotto Column Organization.

Cosa vedono gli studenti

Quando uno studente apre l'elemento FastComments o scorre fino a un blocco incorporato:

1. Blackboard avvia il messaggio LTI 1.3 verso FastComments. Lo studente viene autenticato tramite SSO usando la sua identità Blackboard (nome, email, avatar, ruolo) senza vedere un modulo di login.
2. Il thread dei commenti viene renderizzato nell'iframe. Threading, risposte, menzioni e reazioni sono tutte disponibili in base alle impostazioni del widget dei commenti configurate in FastComments.
3. I loro commenti vengono attribuiti al loro account Blackboard. Se lo studente modifica il proprio nome o la foto in Blackboard in seguito, il prossimo lancio aggiorna il profilo FastComments.

Mapping dei ruoli da Blackboard a FastComments:

• System Administrator e Course Builder mappano a FastComments admin.
• Instructor e Teaching Assistant mappano a FastComments moderator.
• Student, Guest, e Observer mappano a FastComments commenter.

I moderatori vedono i controlli di moderazione (pin, hide, ban, delete) inline su ogni commento del thread.

Scoping dei thread

FastComments delimita ogni thread tramite (Blackboard host, course ID, resource link ID). Due elementi FastComments nello stesso corso producono due thread. Lo stesso elemento copiato in due shell di corso diverse (per esempio, tramite copia del corso) produce due thread, perché Blackboard emette un nuovo resource link ID durante la copia. Per mantenere un thread condiviso tra copie del corso, usa Deep Linking con un URN di thread esplicito configurato in FastComments prima di avviare la copia.

Problemi specifici di Blackboard

La tessera FastComments manca dal menu Build Content (Original) o da Content Market (Ultra). L'amministratore ha approvato lo strumento ma ha lasciato una policy dell'istituzione che blocca il posizionamento rilevante. Vai su Administrator Panel > Integrations > LTI Tool Providers, modifica la voce FastComments e conferma che i posizionamenti Course Content Tool (Original) e Course Content Tool - allow students / Deep Linking content tool (Ultra) sono abilitati. Salva e aggiorna la pagina del corso.

Errore "Tool not configured for this context" o "Tool is not deployed" al lancio. L'ambito di deployment registrato durante la registrazione dinamica non corrisponde al contesto istituzionale a cui appartiene il corso. Nella voce provider dello strumento di Blackboard, verifica che il Deployment ID corrisponda a quello che FastComments mostra nella sua pagina di Configurazione LTI 1.3 per questo tenant. Se differiscono, elimina il posizionamento e riesegui la registrazione dinamica da un URL di registrazione nuovo ( ottienilo qui ).

L'altezza dell'iframe sembra fissa o il contenuto viene tagliato. Alcuni tenant Blackboard vengono forniti con una Content Security Policy rigorosa che blocca il postMessage di ridimensionamento iframe LTI predefinito. FastComments invia sia il messaggio in stile Canvas lti.frameResize sia il messaggio secondo la specifica IMS org.imsglobal.lti.frameResize per massimizzare la compatibilità, ma un override CSP a livello tenant può bloccare il listener del parent. Chiedi al tuo amministratore di confermare che *.fastcomments.com sia nella allowlist degli strumenti LTI e che nessun header CSP personalizzato stia rimuovendo gli eventi postMessage. Il ridimensionamento funzionerà allora senza ulteriore configurazione.

La copia del corso duplica i thread. La copia del corso di Blackboard genera nuovi resource link ID per i posizionamenti LTI, quindi i corsi copiati iniziano con thread vuoti. Questo è previsto. Se hai bisogno che il corso copiato erediti il thread originale, configura Deep Linking con un URN di thread esplicito prima della copia, oppure contatta il supporto FastComments per rimappare gli ID dei thread in blocco.

Lo studente vede un errore generico di Blackboard al lancio. La causa è una claim email mancante o obsoleta. Conferma che la policy dell'istituzione per FastComments ha abilitato Role, Name, e Email Address sotto User Fields to Send. Salva, quindi rilancia in una nuova sessione del browser.

"Token di registrazione non trovato, scaduto o già utilizzato"

Il token nell'URL di registrazione (recuperalo qui) è valido per 30 minuti e può essere usato una sola volta. Se il tuo LMS ha impiegato più tempo, o se la registrazione è stata ripetuta dopo un successo, il token verrà rifiutato. Genera un nuovo URL nella pagina di configurazione LTI 1.3 di FastComments e riprova.

"Platform rejected registration"

Il tuo LMS ha rifiutato l'handshake di registrazione. Le cause più comuni:

• Tool already registered with the same client name. Alcune piattaforme (in particolare D2L) rifiutano una seconda registrazione di "FastComments" finché quella precedente non viene eliminata. Rimuovi il vecchio tool nel tuo LMS, quindi riprova.
• Wrong field in the LMS. Assicurati di aver incollato l'URL nel campo registration / tool initiation registration endpoint, non nel campo launch URL o login URL.
• The LMS doesn't actually support Dynamic Registration. Versioni più vecchie di Moodle e Blackboard dichiarano il supporto per LTI 1.3 ma consentono solo la configurazione manuale. Controlla la documentazione della tua piattaforma.

"Failed to fetch platform configuration"

FastComments non è riuscito a leggere il documento openid-configuration del tuo LMS. È raro e di solito significa che il LMS ha fornito un URL di discovery malformato o non raggiungibile. Contatta il supporto del tuo LMS.

Launch shows "Configuration not found"

O la configurazione in FastComments è stata eliminata, oppure l'avvio proviene da una coppia iss/client_id che non riconosciamo. Se hai eliminato e poi registrato di nuovo, istruisci il tuo LMS a rimuovere e riaggiungere lo strumento FastComments in modo che ottenga il nuovo client_id.

Launch shows "Deployment not registered"

Hai avviato FastComments da una deployment di Brightspace/Moodle/Blackboard diversa da quella in cui è stato lanciato inizialmente. FastComments fissa il deployment_id al primo avvio come controllo di sicurezza. Per aggiungere una nuova deployment sotto lo stesso client, contatta il supporto - aggiungeremo il deployment ID alla configurazione.

Launch shows "Unsupported message_type"

Il LMS ha inviato un messaggio LTI che FastComments non gestisce (es. LtiSubmissionReviewRequest). FastComments supporta solo l'avvio standard resource-link e i flussi di deep-linking. Contattaci se hai bisogno che venga aggiunto un tipo di messaggio specifico.

Iframe doesn't resize

La maggior parte dei LMS ridimensiona automaticamente gli iframe LTI. Se il tuo non lo fa, verifica che le impostazioni di avvio del LMS permettano allo strumento di inviare eventi postMessage al frame padre. FastComments emette sia messaggi di ridimensionamento in stile Canvas (lti.frameResize) sia secondo la specifica IMS (org.imsglobal.lti.frameResize) di resize.