
Lingua 🇮🇹 Italiano
TLDR
Configurazione FastComments
Registra lo strumento
Aggiungi a un corso
Usa lo strumento
Sicurezza e conformità
Sondaggi
Aggiungi commenti al tuo LMS tramite LTI 1.3
FastComments si integra con qualsiasi LMS conforme a LTI 1.3 - D2L Brightspace, Moodle, Blackboard Learn, Sakai, Schoology e altri - tramite lo standard IMS LTI Dynamic Registration. Un unico URL, incollato nella schermata di registrazione del tuo LMS, mette in funzione l'intera integrazione: SSO, contesto del corso, mappatura dei ruoli e posizionamento dei contenuti. Nessun plugin da installare sul tuo server. (Canvas LMS ha la sua guida dedicata perché il suo flusso di registrazione è diverso.)
Una volta registrato, FastComments appare come Learning Tool all'interno dei tuoi corsi. Gli studenti vedono commenti in thread e una chat collaborativa accanto ai contenuti del corso, e accedono automaticamente con il loro account LMS.
Prezzi 
L'integrazione FastComments LTI 1.3 è inclusa nei piani Flex e Pro senza costi aggiuntivi. Funziona con qualsiasi LMS che supporti la specifica IMS LTI 1.3 Advantage, inclusa la Registrazione Dinamica.
Avvio rapido 
- Accedi a FastComments e vai alla tua pagina di configurazione LTI 1.3.
- (Facoltativo) Seleziona la piattaforma da cui ti connetti dal menu a discesa Platform - imposta l'etichetta di visualizzazione, ma Auto-detect funziona bene.
- Clicca su Generate URL. Apparirà un Registration URL usa e getta (valido per 30 minuti).
- 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.
- Il tuo LMS richiama FastComments, scambia le chiavi e crea l'integrazione. Il popup si chiude automaticamente al termine.
- Tornando in FastComments, la nuova configurazione appare nella tabella Existing Configurations. Lo strumento è ora disponibile nei corsi del tuo LMS.
Piattaforme supportate 
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.
Genera URL di registrazione 
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.
Registrati in D2L Brightspace 
D2L Brightspace espone la Dynamic Registration tramite l'interfaccia di amministrazione LTI Advantage. Sarà necessario l'accesso come amministratore.
Aprire la Schermata di Registrazione
- Accedi alla tua istanza Brightspace come amministratore.
- Vai su Admin Tools > Manage Extensibility > LTI Advantage.
- Clicca su Register Tool. (L'URL diretto è
https://<your-brightspace-host>/d2l/le/ltiadvantage/registrations/create.)
Incollare l'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 (lo trovi qui) in quel campo. Lascia vuoti gli altri campi - vengono compilati automaticamente da FastComments durante l'handshake di registrazione.
Clicca su Register.
Approvare lo Strumento
Brightspace apre un popup che comunica con FastComments, scambia le chiavi e mostra una schermata di conferma. Il popup si chiude da solo al termine della registrazione.
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.
Aggiungere un Deployment
In Brightspace, gli strumenti LTI necessitano di un deployment prima di poter essere utilizzati nei corsi:
- Apri lo strumento FastComments appena registrato.
- Clicca su View Deployments > New Deployment.
- Assegna un nome al deployment (es. "FastComments - All Courses"), seleziona le unità organizzative in cui deve essere disponibile e salva.
Dopo il primo avvio tramite questo deployment, FastComments fissa il deployment_id nel suo record di configurazione - gli avvii successivi da un deployment diverso sotto lo stesso client verranno rifiutati a meno che tu non effettui una nuova registrazione.
Registrati in Moodle 
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
- Accedi a Moodle come amministratore del sito.
- 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:
- Clicca l'icona dell'ingranaggio sulla scheda FastComments.
- Sotto Tool configuration usage, scegli Mostra nel selettore attività e come strumento preconfigurato.
- Salva.
Gli insegnanti ora possono aggiungere FastComments a qualsiasi corso tramite Aggiungi un'attività o una risorsa > FastComments.
Registrati in Blackboard Learn 
Blackboard Learn SaaS e Ultra supportano la registrazione dinamica LTI 1.3.
Apri la schermata del provider dello strumento
- Accedi a Blackboard come amministratore di sistema.
- Vai a Pannello di amministrazione > Integrazioni > Fornitori di strumenti LTI.
- 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:
- Trova la voce FastComments nell'elenco dei fornitori di strumenti.
- Apri il menu e scegli Modifica.
- Imposta Stato dello strumento su Approvato.
- 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.
Registrati in Sakai o Schoology 
Sakai
Sakai supporta la Registrazione Dinamica LTI 1.3 nelle release con LTI Advantage. Dalla Area di amministrazione:
- Accedi come amministratore Sakai e apri la Administration Workspace.
- Scegli External Tools > Install LTI 1.3 Tool.
- Incolla l'URL di registrazione FastComments (ottienilo qui) e invia.
- 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.
Aggiungi al contenuto del corso D2L 
Questa pagina copre l'aggiunta di FastComments a un corso Brightspace dopo che un amministratore ha registrato lo strumento e creato una distribuzione. Se lo strumento non è ancora registrato, consulta prima la guida alla registrazione D2L.
Brightspace offre due esperienze di creazione dei contenuti: Classic Content e la New Content Experience (chiamata anche Lessons). Entrambe espongono FastComments, ma i percorsi dei menu differiscono. Ogni sezione seguente copre entrambe dove divergono.
Individuare lo strumento FastComments
Lo strumento FastComments appare in due punti all'interno di un editor di contenuti del corso:
- Il selettore di attività, raggiungibile dal pulsante Add Existing di un modulo/unità (etichettato Add Existing Activities nelle versioni più vecchie di Brightspace). FastComments appare direttamente nel selettore nelle versioni attuali di Brightspace; nelle versioni più vecchie è annidato sotto un sottomenu External Learning Tools. Entrambi i percorsi aggiungono FastComments come argomento autonomo.
- La finestra di dialogo Insert Stuff all'interno dell'editor HTML, sotto LTI Advantage. Questo incorpora FastComments in linea in un argomento HTML tramite il flusso di deep linking LTI.
Se FastComments non appare in nessuno dei due selettori, la distribuzione non è abilitata per l'unità organizzativa che contiene il corso. Chiedete al vostro amministratore Brightspace di aprire Admin Tools > Manage Extensibility > LTI Advantage > strumento FastComments > View Deployments, aprire la distribuzione e aggiungere l'unità organizzativa del corso (o un'unità organizzativa padre) sotto Org Units.
Aggiungere FastComments come argomento in un modulo
Classic Content:
- Aprite il corso e fate clic su Content nella barra di navigazione.
- Selezionate il modulo che deve contenere la discussione (o createne uno tramite Add a module).
- Fate clic su Add Existing (Brightspace più vecchi: Add Existing Activities > External Learning Tools).
- Nel selettore, fate clic su FastComments. Brightspace crea un argomento nel modulo e vi riporta alla vista dei contenuti.
- Fate clic sul nuovo argomento. Rinominatelo con qualcosa di descrittivo come
FastComments Discussionusando l'editor di titolo in linea.
New Content Experience (Lessons):
- Aprite il corso e fate clic su Content.
- Aprite l'unità e la lezione che devono contenere la discussione.
- Fate clic su Add > Existing Activity e selezionate FastComments (Brightspace più vecchi: annidato sotto External Learning Tools).
- L'attività viene aggiunta alla lezione.
- Fate clic sul titolo dell'attività per rinominarla.
La prima volta che qualsiasi utente (docente o studente) apre l'argomento, FastComments inizializza il thread per quel resource link. Il thread è legato all'ID del resource link, quindi rinominare o spostare l'argomento non cambia quale thread viene caricato.
Incorporare FastComments in linea in un argomento HTML
Usate questo flusso quando volete che i commenti appaiano sotto una lettura, un video o altro contenuto nella stessa pagina dell'argomento, anziché come argomento separato.
- Aprite o create un argomento HTML nel modulo/lezione.
- Fate clic su Edit HTML per aprire l'editor HTML di Brightspace.
- Posizionate il cursore dove dovrebbe apparire il thread dei commenti.
- Fate clic sul pulsante Insert Stuff (icona a forma di pezzo di puzzle nella barra degli strumenti dell'editor).
- Nella finestra di dialogo Insert Stuff, scorrete fino a LTI Advantage e fate clic su FastComments.
- FastComments apre un selettore di deep linking. Confermate il posizionamento (le opzioni predefinite funzionano per le discussioni di contenuto); fate clic su Insert o Continue.
- Brightspace torna all'editor HTML con un blocco segnaposto che rappresenta l'avvio LTI. Fate clic su Save and Close sull'argomento.
Quando l'argomento si carica, Brightspace sostituisce il segnaposto con un iframe che avvia automaticamente FastComments tramite LTI. Gli studenti vedono il thread di discussione in linea.
Un singolo argomento HTML può contenere più incorporamenti FastComments con deep link. Ogni incorporamento ha il proprio thread perché ogni deep link produce un ID resource link distinto.
Argomento del modulo vs Quicklink in linea
Scegliete l'approccio argomento del modulo quando:
- La discussione è l'attività principale per quel passaggio nel modulo.
- Volete che l'argomento appaia nell'indice dei contenuti di Brightspace, nel tracciamento del completamento e in Class Progress.
Scegliete l'approccio incorporamento in linea quando:
- I commenti devono trovarsi sotto altro contenuto nella stessa pagina.
- Non volete un elemento separato tracciabile per il completamento nell'indice dei contenuti.
Visibilità, Bozza e Condizioni di Rilascio
Un nuovo argomento FastComments è visibile agli studenti per impostazione predefinita. Per nasconderlo durante la configurazione:
- Nell'editor dei contenuti, fate clic sul titolo dell'argomento (Classic) o sul menu a tre punti sull'attività (New Content Experience).
- Impostate lo stato su Draft (Classic) o disattivate Visibility (New Content Experience).
Gli argomenti in bozza sono invisibili agli studenti. Docenti e assistenti li vedono comunque con un badge "Draft".
Per limitare l'argomento a un gruppo o una sezione specifica:
- Aprite l'argomento.
- Fate clic sul menu del titolo dell'argomento > Edit Properties In-place (Classic) o Edit > Restrictions (New Content Experience).
- Sotto Release Conditions, fate clic su Create.
- Selezionate Group enrollment o Section enrollment, scegliete il gruppo/sezione e salvate.
Le condizioni di rilascio si combinano con la mappatura dei ruoli di FastComments. Gli studenti che non possono vedere l'argomento non ottengono un avvio LTI.
Cosa vedono gli studenti al primo avvio
Quando uno studente fa clic sull'argomento (o carica un argomento HTML con un incorporamento):
- Brightspace esegue l'avvio LTI 1.3 in background.
- FastComments riceve il nome, l'email, l'URL dell'avatar e il ruolo LMS dello studente, e lo autentica automaticamente. Non viene mostrata alcuna schermata di accesso FastComments.
- Il thread dei commenti per quel resource link viene visualizzato all'interno dell'iframe di Brightspace.
Mappatura dei ruoli all'avvio:
- L'
Administratordi Brightspace diventa un admin FastComments per il thread (accesso completo a moderazione, eliminazione, ban e configurazione). - L'
Instructordi Brightspace diventa un moderator FastComments (pin, nascondi, elimina, 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 prossimo avvio LTI sincronizza la modifica.
Bloccare l'Accesso Pubblico (Consigliato)
Per impostazione predefinita, i dati dei commenti FastComments sono leggibili pubblicamente. Chiunque indovini l'URL di un thread o un endpoint API può visualizzarne i commenti, anche al di fuori di Brightspace. Per le discussioni di corso quasi certamente vorrete limitare la visualizzazione ai soli studenti iscritti.
Aprite la vostra pagina di personalizzazione del widget e create una regola con Require SSO To View Comments abilitato, poi impostate il livello di sicurezza su Secure SSO in modo che i thread possano essere caricati solo tramite l'avvio LTI firmato.
Vedete Protezione dei thread di commenti con Single-Sign-On per la procedura completa, incluso come limitare la regola a un singolo dominio o pagina.
Altezza dell'Iframe e Ridimensionamento
FastComments emette il postMessage org.imsglobal.lti.frameResize a ogni render del thread e a ogni modifica del contenuto (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 barra di scorrimento interna.
Se l'iframe rimane a un'altezza fissa ridotta:
- Confermate che il corso sia caricato tramite HTTPS. Il listener postMessage di Brightspace rifiuta i frame con contenuto misto.
- Confermate che nessuna estensione del browser stia bloccando il canale postMessage.
- Per gli incorporamenti in linea in un argomento HTML, l'HTML circostante non deve racchiudere l'iframe in un contenitore a altezza fissa. Rimuovete qualsiasi
style="height: ..."in linea dall'elemento padre.
Particolarità Specifiche di Brightspace
Strumento non visibile nel selettore Add Existing. La distribuzione non è abilitata per l'unità organizzativa di questo corso. Un amministratore deve aggiungere l'unità organizzativa (o un'unità padre) all'elenco Org Units della distribuzione. La sola registrazione dello strumento non basta; la distribuzione definisce quali corsi vedono lo strumento.
Mancata corrispondenza di deployment_id all'avvio. FastComments blocca (TOFU) il primo deployment_id che vede per una registrazione. Se un amministratore elimina la distribuzione originale e ne crea una nuova, gli avvii dalla nuova distribuzione vengono rifiutati con un errore di mancata corrispondenza della distribuzione. La soluzione è registrare nuovamente FastComments (generare un nuovo URL di registrazione (ottenetelo qui) ed eseguire di nuovo Dynamic Registration); il vecchio record di configurazione viene sostituito.
Lo strumento si avvia ma mostra "Invalid LTI launch". Il corso si trova in una struttura tenant/org diversa da quella coperta dalla distribuzione, oppure la distribuzione è stata disabilitata dopo la registrazione. Ricontrollate l'interruttore Admin Tools > Manage Extensibility > LTI Advantage > FastComments > Enabled e l'elenco delle unità organizzative della distribuzione.
Nomi e ruoli mancanti all'interno di FastComments. Brightspace include negli avvii LTI le attestazioni Names and Role Provisioning Services (NRPS). Se un corso è stato aggiornato da un vecchio link LTI 1.1, l'avvio manca delle attestazioni name e email. Riaggiungete l'argomento FastComments tramite Add Existing (non migrate il vecchio link) in modo che l'avvio usi LTI 1.3.
L'incorporamento mostra una schermata di accesso invece dell'auto-SSO. L'argomento HTML è stato inserito come semplice <iframe> che punta a FastComments anziché tramite Insert Stuff > LTI Advantage. Gli iframe semplici saltano l'avvio LTI e portano gli utenti alla pagina pubblica di FastComments. Eliminate l'iframe e reinseritelo tramite il flusso Insert Stuff.
Aggiungi al contenuto del corso Moodle 
Questa guida spiega come aggiungere FastComments a un corso Moodle 4.x dopo che un amministratore del sito ha registrato lo strumento e lo ha impostato per essere mostrato nel selettore di attività. Se FastComments non è ancora registrato, consultare prima la guida alla registrazione di Moodle.
Aprire il corso in modalità di modifica
- Accedi a Moodle come Docente con permessi di modifica (o ruolo superiore) per il corso.
- Apri il corso.
- Attiva la Modalità modifica usando l'interruttore nell'angolo in alto a destra dell'intestazione del corso.
Moodle 4.x ha sostituito il vecchio menu a discesa "Aggiungi un'attività o una risorsa" usato nella 3.x con una finestra di selezione attività a schermo intero. Moodle 4.5 mantiene lo stesso selettore ma aggiunge una riga con elementi preferiti/stellati in alto, quindi appuntare FastComments una volta rende più veloce raggiungerlo nelle sezioni successive.
Aggiungere l'attività FastComments
- Scorri fino alla sezione del corso (argomento o settimana) a cui appartiene la discussione.
- Clicca Aggiungi un'attività o una risorsa nella parte inferiore di quella sezione.
- Nella finestra di selezione, seleziona FastComments. Se non lo vedi, passa alla sezione sulle avvertenze qui sotto.
Si apre il modulo delle impostazioni dell'attività. I campi che contano:
- Activity name (obbligatorio). Visualizzato nella pagina del corso e nel registro voti. Esempio:
Week 3 Discussion. - Activity description. Testo introduttivo facoltativo visualizzato sopra il thread di commenti.
- Show description on course page. Seleziona questa opzione se vuoi che la descrizione sia visibile senza entrare nell'attività.
- Preconfigured tool. Impostato su
FastComments(selezionato automaticamente quando lanciato dal selettore). Non modificarlo. - Launch container. Impostare su Nuova finestra. Vedi la sezione sulle avvertenze per il motivo per cui "Stessa finestra" può causare problemi in alcune installazioni Moodle.
- Tool URL, Public key, Shared secret, Custom parameters. Lasciare vuoti. La Registrazione Dinamica gestisce questi valori a livello di sito.
Scorri fino in fondo e clicca Salva e torna al corso (o Salva e visualizza per aprire subito l'attività).
L'attività appare come una riga nella sezione con l'icona FastComments. Gli studenti cliccano sulla riga per aprire il thread di commenti.
Incorporare FastComments inline nell'editor
Per un thread all'interno di una Pagina, capitolo di Book, Lezione o qualsiasi altra risorsa che utilizzi l'editor Atto o TinyMCE:
- Apri la risorsa in modalità di modifica.
- Posiziona il cursore dove deve apparire il thread.
- Nella barra degli strumenti dell'editor, clicca il pulsante LTI / Strumento esterno. In Atto è etichettato "Insert LTI Advantage content". In TinyMCE (di default in Moodle 4.3+) si trova nel menu Altro come Strumenti esterni.
- Scegli FastComments dalla lista degli strumenti.
- FastComments apre un selettore di deep-linking. Conferma il titolo del thread e clicca Incorpora.
- L'editor inserisce un blocco segnaposto LTI. Salva la risorsa.
Ogni istanza incorporata è un thread distinto indicizzato sull'ID dell'elemento di deep-linking, quindi una Pagina con tre embed di FastComments genera tre thread indipendenti.
Restrizioni di accesso e impostazioni dei gruppi
Le impostazioni standard delle attività di Moodle si applicano alle attività FastComments:
- Common module settings > Group mode. Impostare questo su Gruppi separati o Gruppi visibili non divide automaticamente FastComments in thread per gruppo. La modalità gruppi di Moodle filtra solo il registro voti e l'elenco dei membri. Per avere un thread separato per ogni gruppo, aggiungi un'attività FastComments per ogni gruppo e usa Restrict access per delimitare ciascuna.
- Restrict access > Add restriction. Supporta le condizioni standard di Moodle: Date, Grade, Group, Grouping, User profile, e insiemi di restrizioni nidificati. Usa Group per bloccare un'attività FastComments a un singolo gruppo.
- Activity completion. Imposta su Gli studenti devono visualizzare questa attività per completarla se vuoi il tracciamento del completamento. FastComments attualmente non invia un evento di completamento a Moodle oltre al lancio.
Mappatura dei ruoli
FastComments legge la claim LTI roles che Moodle invia ad ogni lancio e la mappa come segue:
- Moodle Manager o Site administrator -> FastComments admin
- Moodle Editing teacher o Non-editing teacher -> FastComments moderator
- Moodle Student -> FastComments commenter
- Moodle Guest -> sola lettura
Gli admin possono cancellare qualsiasi commento, bannare utenti e modificare le impostazioni del thread. I moderator possono cancellare e approvare i commenti all'interno del thread in cui sono entrati. I ruoli Moodle personalizzati ereditano la mappatura dall'archetipo da cui sono stati clonati.
Cosa vedono gli studenti
Gli studenti cliccano sull'attività FastComments (o scorrono fino al blocco incorporato dentro una Pagina o Book). Moodle invia la loro identità a FastComments tramite il lancio LTI:
- Nessuna schermata di login. FastComments li autentica usando l'account Moodle.
- Il loro nome visualizzato, email e avatar provengono da Moodle.
- Il thread è vincolato a
(Moodle site, course, resource link ID), quindi la stessa attività duplicata in un altro corso ottiene un thread nuovo. - Le risposte annidate, le votazioni e le notifiche funzionano come in un thread FastComments indipendente.
Limitare l'accesso pubblico (consigliato)
Per impostazione predefinita, i dati dei commenti FastComments sono leggibili pubblicamente. Chiunque possa indovinare l'URL di un thread o un endpoint API può visualizzarne i commenti, anche al di fuori di Moodle. Per le discussioni del corso quasi certamente vorrai limitare la visualizzazione agli studenti iscritti soltanto.
Apri la tua pagina di personalizzazione del widget e crea una regola con Require SSO To View Comments abilitato, quindi imposta il livello di sicurezza su Secure SSO in modo che i thread possano essere caricati solo tramite il lancio LTI firmato.
Vedi Proteggere i thread di commento con Single-Sign-On per la procedura completa, incluso come limitare la regola a un singolo dominio o pagina.
Problematiche di Moodle
FastComments non presente nel selettore di attività. L'amministratore del sito ha registrato lo strumento ma non ha impostato Tool configuration usage su Show in activity chooser and as a preconfigured tool. Correggi questo sotto Site administration > Plugins > Activity modules > External tool > Manage tools > icona a ingranaggio sulla tessera FastComments.
Il lancio fallisce o mostra un frame vuoto quando impostato su "Stessa finestra". I cookie di sessione di Moodle usano SameSite=Lax per impostazione predefinita e alcuni browser li rimuovono sulla POST cross-site che LTI 1.3 usa per il ritorno da FastComments. Imposta Launch container su Nuova finestra nell'attività. Questa è una richiesta stringente per i FastComments incorporati all'interno di una Pagina o Book, poiché il percorso di lancio incorporato dall'editor apre sempre una nuova finestra.
La claim iss è l'URL del sito Moodle, non un tenant ID. FastComments usa l'URL del sito Moodle (il valore di configurazione wwwroot) come issuer LTI. Se la tua istanza Moodle viene spostata su un nuovo dominio o cambi wwwroot, i thread FastComments esistenti rimangono legati al vecchio issuer e non corrisponderanno ai nuovi lanci. Registrare di nuovo lo strumento contro il nuovo URL e migrare i thread tramite l'admin di FastComments se necessario.
Backup e ripristino dell'attività. Effettuare il backup di un corso e ripristinarlo in un nuovo corso crea nuovi resource link ID, quindi le attività FastComments ripristinate iniziano con thread vuoti. Il corso originale mantiene i thread originali. Questo è un comportamento voluto, non un bug.
TinyMCE di default in Moodle 4.5. Moodle 4.5 viene fornito con TinyMCE come editor predefinito per le nuove installazioni. La posizione del pulsante Strumento esterno è sotto il menu Altro (...) invece che nella barra principale. I siti più vecchi che sono stati aggiornati dalla 4.1 mantengono Atto a meno che un amministratore non abbia cambiato il predefinito.
Aggiungi al contenuto del corso Blackboard 
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 inserimento 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 è l'impostazione predefinita in Blackboard Learn SaaS a partire dal 2026.
- Apri il corso e vai alla pagina Course Content.
- Passa il mouse o tocca il punto in cui vuoi che compaia il thread di commenti nella struttura e clicca il pulsante viola + (Aggiungi contenuto).
- Scegli Content Market. Il pannello Content Market elenca tutti gli strumenti LTI approvati e i placement dei Building Block per la tua istituzione.
- Trova il riquadro FastComments e cliccalo. Blackboard crea un elemento di contenuto nella posizione in cui hai aperto il menu +.
- L'elemento compare nella struttura come voce "Visible to students" per impostazione predefinita per gli insegnanti che hanno l'opzione Hide from students disattivata come preferenza personale. Se la tua impostazione predefinita è Hidden, l'elemento viene creato nascosto e puoi modificare il selettore di visibilità nella riga dell'elemento quando sei pronto.
- Per rinominare l'elemento, clicca il titolo nella struttura e digita una nuova etichetta. Il titolo che gli studenti vedono nella struttura è indipendente dall'identificatore del thread di FastComments, quindi rinominare è sicuro in qualsiasi momento.
Se non vedi Content Market come opzione, la tua istituzione ha nascosto il placement. Puoi raggiungere lo stesso selettore anche 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 principale per i siti Learn 9.1 self-hosted sulla linea di rilascio Q4 2024 CU.
- Apri il corso ed entra in una Content Area (ad esempio, l'area predefinita Information o Content nel menu del corso).
- Attiva la Edit Mode con l'interruttore in alto a destra della pagina.
- Clicca Build Content nella barra delle azioni.
- Sotto il sottomenu Learning Tools, clicca FastComments. Il sottomenu Learning Tools viene popolato dai placement degli strumenti LTI 1.3 dopo che un amministratore ha registrato lo strumento. Se non lo vedi, consulta la sezione sui problemi noti qui sotto.
- Nel modulo Create FastComments, imposta:
- Name: l'etichetta che gli studenti vedono nella content area.
- Description: testo opzionale mostrato sopra il thread incorporato.
- Permit Users to View this Content: interruttore di disponibilità Sì/No.
- Track Number of Views: attivalo se desideri le statistiche di visualizzazione per elemento di Blackboard. FastComments esegue le proprie analisi in modo indipendente.
- Date and Time Restrictions: finestre opzionali Display After / Display Until.
- Invia. Lo strumento appare come elemento cliccabile nella content area.
Incorporamento all'interno di un elemento o documento
In entrambe le visualizzazioni del corso, gli insegnanti incorporano FastComments in linea nel corpo di un Item, Document o qualsiasi campo di testo formattato tramite il pulsante LTI Advantage dell'editor di contenuti.
Ultra Course View:
- Crea o modifica un Document.
- Clicca Add content all'interno del corpo del documento dove vuoi che appaia il thread.
- Nella barra degli strumenti dell'editor, apri il menu Insert content e clicca Content Market (il punto di ingresso LTI Advantage / Deep Linking).
- Seleziona FastComments. FastComments restituisce un payload di deep link e Blackboard inserisce un blocco incorporato nel corpo del documento nella posizione del cursore.
- Salva il documento. Gli studenti vedono il thread renderizzato in linea mentre scorrono oltre.
Original Course View:
- Modifica qualsiasi elemento con un corpo di testo formattato.
- Nella barra degli strumenti dell'editor di contenuti, clicca l'icona più Add Content e scegli Content Market (etichettato Add Content from External Tool nelle versioni Q4 2024 CU più datate).
- Seleziona FastComments. L'editor inserisce un blocco segnaposto che fa riferimento alla risorsa deep-linked.
- Invia l'elemento.
Ogni incorporamento tramite 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 quanto riguarda le regole di controllo degli accessi sovrapposte.
- 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 prestazione sugli elementi del registro dei voti e regole sui membri dei 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 limitarlo a gruppi specifici del corso.
FastComments rispetta qualsiasi decisione prenda il controllo di Blackboard. Se Blackboard nasconde l'elemento a uno studente, il lancio LTI non avviene mai per quello studente e non appare nella vista del moderatore.
Comportamento del registro dei voti
FastComments non riporta voti tramite LTI Advantage Assignment and Grade Services. Nessuna colonna di voto viene creata automaticamente per gli elementi di contenuto FastComments.
Se il tuo tenant Blackboard è configurato per creare automaticamente una colonna nel registro dei 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 e Include in calculations. Oppure usa Delete se la tua istituzione consente l'eliminazione delle colonne per gli elementi non valutati.
- Original: apri il Grade Center, clicca il chevron della colonna, scegli Hide from Users (on/off) e, facoltativamente, 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:
- Blackboard lancia il messaggio LTI 1.3 verso FastComments. Lo studente accede tramite SSO utilizzando la sua identità Blackboard (nome, email, avatar, ruolo) senza vedere un modulo di accesso.
- Il thread di commenti viene renderizzato nell'iframe. Thread, risposte, menzioni e reazioni sono tutti disponibili in base alle impostazioni del widget dei commenti configurate in FastComments.
- I loro commenti sono attribuiti al loro account Blackboard. Se lo studente modifica successivamente il proprio nome o la propria foto in Blackboard, il lancio successivo aggiorna il profilo FastComments.
Mappatura dei ruoli da Blackboard a FastComments:
- System Administrator e Course Builder corrispondono a admin di FastComments.
- Instructor e Teaching Assistant corrispondono a moderator di FastComments.
- Student, Guest e Observer corrispondono a commenter di FastComments.
I moderatori vedono i controlli di moderazione (pin, nascondi, banna, elimina) in linea su ogni commento nel thread.
Bloccare l'accesso pubblico (consigliato)
Per impostazione predefinita, i dati dei commenti di FastComments sono leggibili pubblicamente. Chiunque riesca a indovinare l'URL di un thread o un endpoint API può visualizzarne i commenti, anche al di fuori di Blackboard. Per le discussioni di corso, quasi certamente vorrai limitare la visualizzazione ai soli studenti iscritti.
Apri la tua pagina di personalizzazione del widget e crea una regola con Require SSO To View Comments abilitato, quindi imposta il livello di sicurezza su Secure SSO in modo che i thread possano essere caricati solo tramite il lancio LTI firmato.
Consulta Protezione dei thread di commenti con Single-Sign-On per la guida completa, incluso come limitare la regola a un singolo dominio o pagina.
Ambito dei thread
FastComments definisce l'ambito di ogni thread tramite (host Blackboard, ID corso, ID resource link). Due elementi FastComments nello stesso corso producono due thread. Lo stesso elemento copiato in due shell di corso (ad esempio, tramite copia del corso) produce due thread, perché Blackboard genera un nuovo resource link ID durante la copia. Per mantenere un thread condiviso tra le copie del corso, usa il Deep Linking con un URN di thread esplicito configurato in FastComments prima di eseguire la copia.
Problemi specifici di Blackboard
Riquadro FastComments mancante nel menu Build Content (Original) o nel Content Market (Ultra). L'amministratore ha approvato lo strumento ma ha lasciato una policy dell'istituzione che blocca il placement pertinente. Vai a Administrator Panel > Integrations > LTI Tool Providers, modifica la voce FastComments e conferma che entrambi i placement Course Content Tool (Original) e Course Content Tool - allow students / Deep Linking content tool (Ultra) siano 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 dell'istituzione a cui appartiene il corso. Nella voce del tool provider di Blackboard, verifica che il Deployment ID corrisponda a ciò che FastComments mostra sulla sua pagina di configurazione LTI 1.3 per questo tenant. Se differiscono, elimina il placement ed esegui nuovamente la registrazione dinamica da un nuovo URL di registrazione (ottienilo qui).
L'altezza dell'iframe sembra fissa o il contenuto viene tagliato. Alcuni tenant Blackboard sono forniti con una Content Security Policy restrittiva che blocca il postMessage predefinito di ridimensionamento dell'iframe LTI. FastComments emette sia il messaggio in stile Canvas lti.frameResize sia il messaggio conforme alle specifiche IMS org.imsglobal.lti.frameResize per massimizzare la compatibilità, ma un override CSP a livello di tenant blocca il listener del genitore. Chiedi al tuo amministratore di confermare che *.fastcomments.com sia presente nella allowlist degli strumenti LTI e che nessun header CSP personalizzato stia eliminando gli eventi postMessage. Il ridimensionamento funzionerà quindi senza ulteriori configurazioni.
La copia del corso duplica i thread. La copia del corso di Blackboard genera nuovi resource link ID per i placement LTI, quindi i corsi copiati partono con thread vuoti. Questo è previsto. Se hai bisogno che il corso copiato erediti il thread originale, configura il Deep Linking con un URN di thread esplicito prima di copiare, 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 è un claim email mancante o non aggiornato. Conferma che la policy dell'istituzione per FastComments abbia Role, Name e Email Address abilitati sotto User Fields to Send. Salva, quindi esegui nuovamente il lancio in una nuova sessione del browser.
Aggiungi al contenuto del corso Sakai o Schoology 
Una volta che FastComments è registrato sulla piattaforma, gli istruttori lo aggiungono ai contenuti del corso usando i flussi standard per strumenti esterni della piattaforma. Questa pagina copre Sakai 23.x e Schoology Enterprise.
Limitare l'accesso pubblico (consigliato)
Per impostazione predefinita, i dati dei commenti di FastComments sono leggibili pubblicamente su entrambe le piattaforme. Chiunque riesca a indovinare l'URL di un thread o un endpoint API può visualizzarne i commenti, anche al di fuori di Sakai o Schoology. Per le discussioni di corso quasi certamente vorrete limitare la visualizzazione solo agli studenti iscritti.
Apri la tua pagina di personalizzazione del widget e crea una regola con Richiedi SSO per visualizzare i commenti abilitata, quindi imposta il livello di sicurezza su SSO protetto in modo che i thread possano essere caricati solo tramite il lancio LTI firmato.
Vedi Proteggere i thread di commento con Single-Sign-On per la guida completa, inclusa la modalità di limitazione della regola a un singolo dominio o pagina.
Sakai
1. Aggiungere FastComments a un sito
Il manutentore del sito abilita lo strumento per ciascun sito:
- Apri il sito e clicca Informazioni sito nella navigazione a sinistra.
- Clicca Gestisci strumenti.
- Scorri fino all'elenco Strumenti esterni e attiva FastComments.
- Clicca Continua, controlla l'elenco degli strumenti, quindi clicca Fine.
FastComments ora appare come voce nella navigazione a sinistra del sito.
2. Riordinare la voce nella navigazione a sinistra
Vai a Informazioni sito > Ordine strumenti. Trascina FastComments nella posizione desiderata e clicca Salva. Da questa schermata puoi anche rinominare l'etichetta di navigazione e nasconderla agli studenti.
3. Incorporare inline in una pagina Lessons
Per posizionare FastComments direttamente all'interno di una pagina Lessons anziché come strumento a sé stante nella navigazione a sinistra:
- Apri lo strumento Lessons nel sito.
- Clicca Aggiungi contenuto > Aggiungi strumento esterno.
- Seleziona FastComments dall'elenco.
- Se FastComments ha pubblicizzato Deep Linking durante la registrazione, Sakai apre il selettore di contenuti dello strumento in modo da poter scegliere o etichettare il thread. Se Deep Linking non è stato pubblicizzato, Sakai inserisce un link di avvio predefinito.
- Salva l'elemento Lessons.
Ogni istanza incorporata ottiene il proprio thread, limitato a quel link di risorsa.
4. Regolazioni dei permessi per l'accesso degli studenti
Sakai regola i lanci degli strumenti esterni tramite i Realms. Per confermare che gli studenti possano avviare FastComments:
- Accedi come amministratore Sakai e apri Area di amministrazione > Realms.
- Apri il realm pertinente (per esempio,
!site.template.courseo il realm specifico del sito). - Conferma che il ruolo
accessabbialti.launchabilitato e che i permessi di ruolo nel gruppo external.tools siano concessi. - Salva il realm.
Per override a livello di sito, il manutentore può regolare la visibilità dello strumento per ruolo da Informazioni sito > Ordine strumenti nascondendo o mostrando FastComments per ruolo.
5. Cosa vedono gli studenti
Gli studenti cliccano la voce FastComments nella navigazione a sinistra (o scorrono fino al blocco Lessons incorporato) e approdano direttamente nella vista a thread dei commenti. L'SSO è automatico: Sakai invia l'identità dell'utente nel lancio LTI e FastComments li autentica con il loro account Sakai.
Mappatura dei ruoli:
- Sakai
Instructor-> moderatore FastComments - Sakai
Admin(admin in Area di amministrazione) -> amministratore FastComments - Sakai
Student/access-> commentatore FastComments
6. Problemi comuni in Sakai
- Tool non visibile in Gestisci strumenti. Se FastComments non appare nell'elenco Strumenti esterni, l'amministratore Sakai deve aprire il registro strumenti (Area di amministrazione > Strumenti esterni > FastComments) e impostare Stealthed su
false. Gli strumenti stealthed sono nascosti dal selettore Gestisci strumenti per sito. - Lanci che si interrompono in browser con sessioni condivise. Il token CSRF del portale Sakai è legato alla sessione del browser. Se uno studente è connesso a due siti Sakai in tab diversi o ha una sessione scaduta, il lancio restituisce un 403. Soluzione: chiudere gli altri tab Sakai, disconnettersi, riconnettersi e rilanciare. Gli amministratori possono anche aumentare
sakai.csrf.token.cache.ttlse questo si verifica a livello di cluster. - Incorporamento in frame. Conferma che
lti.frameheightinsakai.propertiessia sufficientemente grande (600 o superiore) in modo che il thread di commenti non venga tagliato all'interno di una pagina Lessons.
Schoology
Schoology Enterprise prevede due scenari di installazione. Conferma quale si applica prima di aggiungere lo strumento a un corso.
1. Due scenari di installazione
- (a) Installazione a livello aziendale. L'Amministratore di sistema di Schoology ha installato FastComments a livello organizzazione e lo ha assegnato a tutti i corsi o a specifici template di corso. Gli istruttori saltano l'installazione e vanno direttamente a Aggiungi materiali.
- (b) Installazione autonoma da parte dell'istruttore. L'istruttore installa lo strumento in un singolo corso da Opzioni corso > Strumenti esterni > Installa app LTI. L'installazione autonoma richiede che l'Amministratore di sistema abbia prima approvato l'app FastComments a livello organizzativo.
2. Aggiungere FastComments come materiale del corso
All'interno del corso:
- Apri il corso e vai a Materiali.
- Clicca Aggiungi materiali > Aggiungi File/Link/Strumento esterno.
- Scegli Strumento esterno.
- Seleziona FastComments dall'elenco degli strumenti registrati.
- Imposta un Nome (è ciò che gli studenti vedono nell'elenco dei materiali) e un'eventuale Descrizione.
- Lascia Abilita valutazione (grade passback) DISATTIVATO. FastComments non riporta voti a Schoology, quindi abilitare il grade passback crea una colonna vuota nel registro voti.
- Clicca Invia.
Il materiale ora appare nell'elenco dei materiali del corso e apre il thread FastComments quando viene cliccato.
3. Incorporamento inline tramite l'editor Rich Text
Se l'Amministratore di sistema ha abilitato il posizionamento Deep Linking per FastComments durante la registrazione, gli istruttori possono incorporare il thread di commenti all'interno di qualsiasi campo Rich Text (istruzioni dell'assegnazione, corpi delle pagine, prompt di discussione):
- Apri l'editor Rich Text sulla pagina di destinazione.
- Clicca l'icona External Tool (pezzo di puzzle) nella barra degli strumenti.
- Scegli FastComments.
- Configura l'incorporamento nella finestra di dialogo deep-linking e clicca Inserisci.
- Salva la pagina.
Se il pulsante External Tool non appare nell'editor Rich Text, Deep Linking è disabilitato per questo strumento in questo tenant. Vedi i problemi noti qui sotto.
4. Visibilità e assegnazioni per sezione
Schoology limita la disponibilità dello strumento per sezione tramite le Opzioni corso:
- Dal corso, clicca Opzioni corso > Strumenti esterni.
- Per ciascuna app LTI installata, puoi controllare se è disponibile per tutte le sezioni del corso o per sezioni specifiche.
- Per limitare FastComments a determinate sezioni, deseleziona le sezioni che non dovrebbero vedere lo strumento.
- L'accesso a livello di sezione determina anche quali sezioni vedono la voce Aggiungi materiali > Strumento esterno per FastComments.
5. Cosa vedono gli studenti
Gli studenti cliccano il materiale FastComments (o scorrono fino all'incorporamento inline) e accedono alla discussione a thread. L'SSO è automatico tramite il lancio LTI di Schoology con il loro account Schoology.
Mappatura dei ruoli:
- Schoology
Administrator-> amministratore FastComments - Schoology
Instructor-> moderatore FastComments - Schoology
Student-> commentatore FastComments
6. Problemi comuni in Schoology
- Solo Enterprise. Gli account personali e gratuiti di Schoology non possono installare strumenti LTI 1.3. Se il tuo tenant è nel piano gratuito, l'opzione Strumenti esterni è assente dalle Opzioni corso. Effettua l'upgrade a Schoology Enterprise per usare FastComments.
- Deep Linking disabilitato per impostazione predefinita dal tenant. Alcuni tenant Schoology limitano il posizionamento Deep Linking a livello organizzazione. In questo caso, gli istruttori vedono solo il flusso Aggiungi materiali > Strumento esterno e non il pulsante External Tool nell'editor Rich Text. Per abilitare l'incorporamento inline, l'Amministratore di sistema va su Impostazioni di sistema > Integrazione > LTI 1.3 > FastComments, abilita il posizionamento Content Item / Deep Linking, quindi salva.
- Override di assegnazione per sezione. Se FastComments è assegnato a livello enterprise ma l'istruttore non lo vede in Aggiungi materiali, la sezione del corso è esclusa nell'assegnazione a livello organizzazione. Chiedi all'Amministratore di sistema di aggiungere la sezione all'assegnazione dell'app FastComments.
- Nome del materiale vs. identità del thread. Rinominare il materiale in Schoology non sposta il thread di commenti. I thread sono indicizzati sull'ID del link di risorsa LTI, quindi una rinomina mantiene lo stesso thread; eliminare e ricreare il materiale crea un nuovo thread vuoto.
Risoluzione dei problemi 
"Token di registrazione non trovato, scaduto o già utilizzato"
Il token nel tuo URL di registrazione (ottenilo qui) è valido per 30 minuti e può essere utilizzato una sola volta. Se la tua LMS ha impiegato più tempo, o se la registrazione è stata ritentata dopo aver avuto successo, il token verrà rifiutato. Genera un nuovo URL nella pagina di configurazione LTI 1.3 di FastComments e ricomincia da capo.
"Registrazione rifiutata dalla piattaforma"
La tua LMS ha rifiutato l'handshake di registrazione. Le cause più comuni:
- Strumento già registrato con lo stesso nome client. Alcune piattaforme (in particolare D2L) rifiutano una seconda registrazione di "FastComments" finché quella precedente non viene eliminata. Rimuovi il vecchio strumento nella tua LMS, poi riprova.
- Campo errato nella LMS. Assicurati di aver incollato l'URL nel campo registration / tool initiation registration endpoint, non nel campo launch URL o login URL.
- La LMS in realtà non supporta la Dynamic Registration. Le versioni più vecchie di Moodle e Blackboard dichiarano di supportare LTI 1.3 ma consentono solo la configurazione manuale. Consulta la documentazione della tua piattaforma.
"Impossibile recuperare la configurazione della piattaforma"
FastComments non è riuscito a leggere il documento openid-configuration della tua LMS. Questo è raro e di solito significa che la LMS ha fornito un URL di discovery malformato o non raggiungibile. Contatta il supporto della tua LMS.
Il lancio mostra "Configuration not found"
Oppure la configurazione in FastComments è stata eliminata, oppure il lancio proviene da una coppia iss/client_id che non riconosciamo. Se hai eliminato e registrato di nuovo, istruisci la tua LMS a rimuovere e riaggiungere lo strumento FastComments così che ottenga il nuovo client_id.
Il lancio mostra "Deployment not registered"
Hai lanciato FastComments da un deployment Brightspace/Moodle/Blackboard diverso da quello in cui è stato lanciato per la prima volta. FastComments fissa il deployment_id al primo lancio come controllo di sicurezza. Per aggiungere un nuovo deployment sotto lo stesso client, contatta il supporto: aggiungeremo l'ID del deployment alla configurazione.
Il lancio mostra "Unsupported message_type"
La LMS ha inviato un messaggio LTI che FastComments non gestisce (ad es. LtiSubmissionReviewRequest). FastComments supporta solo il lancio standard resource-link e i flussi di deep-linking. Contattaci se ti serve l'aggiunta di un tipo di messaggio specifico.
L'iframe non si ridimensiona
La maggior parte delle LMS ridimensiona automaticamente gli iframe LTI. Se la tua non lo fa, verifica che le impostazioni di lancio della LMS consentano allo strumento di inviare eventi postMessage al frame padre. FastComments emette messaggi di ridimensionamento sia in stile Canvas (lti.frameResize) sia secondo le specifiche IMS (org.imsglobal.lti.frameResize).
Minimo privilegio e minimizzazione dei dati 
L'integrazione LTI 1.3 di FastComments segue il principio dei privilegi minimi: utilizza solo i claim di lancio necessari per identificare l'utente, associare i commenti al corso e alla risorsa corretti e applicare i permessi basati sui ruoli.
Il resto di questa pagina descrive ogni claim consumato dall'integrazione, ogni servizio LTI Advantage che non richiede e ogni categoria di dati che non raccoglie. I revisori di sicurezza e procurement possono ricavare le risposte direttamente dalle tabelle seguenti.
Elementi di Dati Ricevuti dall'LMS
Ogni lancio LTI 1.3 contiene un JWT firmato dall'LMS. FastComments estrae dal JWT i seguenti claim e non utilizza nulla altro:
| Campo | Claim LTI | Scopo | Obbligatorio | Memorizzato |
|---|---|---|---|---|
| Identificatore utente | sub | Identifica l'utente in modo coerente tra i lanci, così che la stessa persona corrisponda allo stesso utente SSO FastComments | Sì | Sì, come parte di un ID SSO interno stabile |
| Nome visualizzato | name | Attribuzione mostrata accanto ai commenti dell'utente | Sì (con fallback a "LMS User" se assente) | Sì |
email | Corrispondenza account, notifiche, moderazione, corrispondenza con il supporto | Opzionale (l'integrazione funziona anche senza) | Sì, se fornita | |
| URL avatar | picture | Visualizzato sui commenti dell'utente | Opzionale | Solo l'URL; FastComments non scarica né rihosta l'immagine |
| Ruoli | https://purl.imsglobal.org/spec/lti/claim/roles | Determina se l'utente è amministratore, docente (moderatore) o studente | Sì | Flag derivati isAdmin / isModerator sulla sessione SSO |
| Contesto corso | https://purl.imsglobal.org/spec/lti/claim/context (id, title) | Associa il thread di commenti al corso LMS corretto | Sì | Sì, come parte dell'identificatore di pagina risolto |
| Resource link | https://purl.imsglobal.org/spec/lti/claim/resource_link (id) | Associa i commenti all'attività o al posizionamento dello strumento corretto all'interno del corso | Sì, se presente | Sì, come parte dell'identificatore di pagina risolto |
| Deployment ID | https://purl.imsglobal.org/spec/lti/claim/deployment_id | Instrada il lancio alla configurazione tenant FastComments corretta | Sì | Sì, sul record di configurazione LTI di FastComments |
Claim e Scope Dichiarati alla Registrazione
Durante la Dynamic Registration LTI 1.3, FastComments si registra con scope: "" (nessuno scope OAuth aggiuntivo) e dichiara solo questi claim OpenID Connect:
iss, sub, name, email, picture
Registra due tipi di messaggio:
LtiResourceLinkRequest- il lancio standard del corso in FastComments.LtiDeepLinkingRequest- consente ai docenti di inserire lo strumento FastComments all'interno di un corso.
Non vengono richiesti token di accesso aggiuntivi all'LMS.
Servizi LTI Advantage Non Richiesti
| Servizio / scope | Richiesto? | Motivo |
|---|---|---|
| Names and Role Provisioning Services (NRPS) | No | L'integrazione non necessita dell'elenco dei partecipanti al corso; l'identità dell'utente arriva con ogni lancio |
| Assignment and Grade Services (AGS) - scope lineitem, score, result | No | L'integrazione non è consapevole del registro dei voti |
| Deep Linking oltre il ritorno standard di posizionamento | Nessun dato aggiuntivo | Il deep linking viene utilizzato solo per il posizionamento dello strumento da parte dei docenti; nessun contenuto del corso viene enumerato |
Dati Non Raccolti
Oltre a LTI stesso, FastComments non richiede né riceve dall'LMS o dall'utente quanto segue:
| Categoria | Raccolta? |
|---|---|
| Voti degli studenti | No |
| Consegne di compiti | No |
| Registri di presenza | No |
| Elenchi completi dei partecipanti ai corsi | No |
| Identificatori governativi | No |
| Data di nascita | No |
| Indirizzo postale o numero di telefono | No |
| Informazioni finanziarie | No |
| Credenziali amministratore dell'LMS | No |
Limiti di Accesso
- FastComments riceve dati solo all'interno di un lancio LTI 1.3 autorizzato e firmato dalle chiavi registrate dell'LMS. L'integrazione non richiama l'LMS per ottenere informazioni aggiuntive.
- I token di lancio sono monouso e di breve durata. I token riprodotti o scaduti vengono rifiutati.
- Gli amministratori dell'LMS controllano dove lo strumento viene distribuito all'interno della loro piattaforma. D2L Brightspace, ad esempio, supporta lo scoping per org-unit per deployment e impostazioni di sicurezza per deployment, il che consente agli amministratori di limitare lo strumento a corsi o org unit specifici invece di renderlo disponibile globalmente. Moodle, Blackboard, Sakai e Schoology offrono controlli equivalenti per deployment nelle loro implementazioni LTI 1.3.
Conservazione e Archiviazione
FastComments conserva i dati derivati da LTI per la durata del servizio di commenti attivo e secondo le impostazioni di conservazione configurate dal cliente. I dati dei commenti sono archiviati in storage di produzione crittografati a riposo. In caso di chiusura dell'account o di richiesta scritta di eliminazione, FastComments elimina o anonimizza i dati del cliente secondo l'accordo applicabile.
Per i dettagli completi su archiviazione e gestione dei dati, consultare la Informativa sulla Privacy di FastComments.
Frequenza di Revisione
Qualsiasi nuova funzionalità LTI che richiederebbe claim, scope o servizi LTI Advantage aggiuntivi viene esaminata prima del rilascio per confermare che l'accesso richiesto sia necessario e proporzionato alla funzionalità che viene rilasciata.
Dichiarazione Breve per i Questionari di Sicurezza
FastComments applica il principio dei privilegi minimi e la minimizzazione dei dati alla sua integrazione LTI 1.3. L'integrazione utilizza solo i claim di lancio LTI necessari per autenticare l'utente (
sub,name,picture), determinarne il ruolo e identificare il corso e la risorsa a cui appartengono i commenti. FastComments non richiede Names and Role Provisioning Services, Assignment and Grade Services, dati del registro dei voti, presenza, elenchi completi dei partecipanti o accesso amministrativo all'LMS. Gli amministratori dell'LMS mantengono il controllo su quali org unit, corsi e deployment lo strumento è disponibile.
Aggiungi sondaggi al tuo corso LMS 
Una volta che FastComments è nel tuo corso LMS, puoi anche eseguire sondaggi live direttamente nei commenti. Attiva Enable Polls nelle impostazioni di personalizzazione del widget e appare un pulsante sondaggio nella barra degli strumenti dei commenti. I sondaggi accettano da 2 a 10 opzioni, i risultati si aggiornano in tempo reale per tutti sulla pagina, e scegli chi può creare sondaggi e se il voto richiede l'accesso. Non c'è nient'altro da installare sull'LMS.
Prova la demo dei Sondaggi Live o leggi la documentazione sui Sondaggi per configurarli.