L'iframe di rilevamento degli allegati è la visualizzazione iniziale mostrata a un insegnante quando apre un componente aggiuntivo durante la creazione di un'attività di Classroom. Un allegato è il contenuto o l'attività con cui vuoi che gli studenti possano interagire.
All'interno di un corso di Classroom, l'insegnante crea un nuovo post (ad esempio un compito, un annuncio o una domanda) e seleziona un componente aggiuntivo dall'elenco a discesa. Per un breve periodo di tempo (nell'ordine delle ore), Classroom consente al componente aggiuntivo di aggiungere allegati al post.
Figura 1. Visualizzazione della creazione di un compito con le possibili opzioni di componenti aggiuntivi che un insegnante può allegare.
Dopo che un insegnante seleziona un componente aggiuntivo, Classroom crea un iframe di rilevamento degli allegati e carica l'URL di avvio del componente aggiuntivo. Tutti i parametri di query iframe pertinenti vengono passati all'URL di lancio.
Figura 2. Un esempio di UI di rilevamento degli allegati in un iframe.
L'insegnante utilizza l'applicazione web del partner, all'interno di un iframe, per selezionare un allegato. L'app effettua chiamate all'API Classroom
per allegare l'allegato al compito. Quando l'insegnante ha finito di selezionare gli allegati, il componente aggiuntivo invia un payload postMessage per richiedere la chiusura dell'iframe.
L'iframe si chiude e l'insegnante può ora vedere gli allegati che può scegliere di visualizzare in anteprima o rimuovere dal compito.
Figura 3. Visualizzazione della creazione di un compito con tre allegati aggiuntivi di tipo attività.
Considerazioni sull'esperienza utente nell'iframe
- All'apertura iniziale, il componente aggiuntivo deve richiedere all'insegnante di accedere.
- È richiesto l'accesso Single Sign-On di Google per tutte le chiamate all'API Classroom. Se il prodotto ha un sistema di accesso separato, devi collegare gli account.
- Un insegnante deve essere in grado di visualizzare l'anteprima di un allegato all'interno dell'iframe prima di effettuare la selezione finale.
- Un insegnante deve essere in grado di cercare o sfogliare i contenuti allegabili.
- Il componente aggiuntivo può fornire un'ampia gamma di visualizzazioni, ad esempio quelli recenti e i miei contenuti, e può filtrare i risultati per capacità di apprendimento.
- Il componente aggiuntivo deve fornire la possibilità di creare un nuovo elemento allegabile dall'interno dell'iframe.
Per ulteriori dettagli sui requisiti UX, consulta l'elenco di controllo dei requisiti del componente aggiuntivo di Classroom.
Mostra lo stato di licenza nell'iframe
Se il componente aggiuntivo richiede una licenza e l'insegnante non ne ha una, deve presentare un messaggio chiaro all'insegnante che lo comunichi sui passaggi successivi necessari per risolvere la situazione. In questo modo eviterai confusione che potrebbe derivare da restrizioni delle licenze.
Ti consigliamo inoltre di eseguire il componente aggiuntivo:
- Mostra il livello di licenza dell'insegnante nell'iframe di rilevamento degli allegati.
- Nasconde o disattiva i contenuti non disponibili per un insegnante a causa di limitazioni a livello di licenza.