L'iframe di Ricerca allegati è la visualizzazione iniziale mostrata a un insegnante quando apre un componente aggiuntivo durante la creazione di un compito di Classroom. Un allegato è il contenuto o l'attività con cui vuoi che gli studenti interagiscano.
All'interno di un corso di Classroom, un insegnante crea un nuovo post (ad esempio un compito, un annuncio o una domanda) e seleziona un componente aggiuntivo dall'elenco a discesa dei componenti aggiuntivi. Per un breve periodo di tempo (nell'ordine di alcune ore), Classroom consente al componente aggiuntivo di aggiungere allegati al post.
Figura 1. Visualizzazione della creazione di un compito, incluse le possibili opzioni di componenti aggiuntivi che un insegnante può allegare.
Quando un insegnante seleziona un componente aggiuntivo, Classroom crea un iframe di Discovery degli allegati e carica l'URL di lancio del componente aggiuntivo. Eventuali parametri di query dell'iframe pertinenti vengono trasmessi all'URL di lancio.
Figura 2. Un esempio di UI di ricerca 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 plug-in invia un payload postMessage che richiede la chiusura dell'iframe.
L'iframe si chiude e l'insegnante può visualizzare gli allegati, che può scegliere di visualizzare in anteprima o rimuovere dal compito.
Figura 3. Visualizzazione della creazione di un compito con tre allegati di componenti aggiuntivi di tipo attività.
Considerazioni sull'esperienza utente all'interno dell'iframe
- All'apertura iniziale, il componente aggiuntivo deve chiedere all'insegnante di accedere.
- L'accesso singolo a Google è obbligatorio per tutte le chiamate all'API Classroom. Se il tuo 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 che possono essere allegati.
- Il componente aggiuntivo può fornire una serie di visualizzazioni, come contenuti recenti, miei contenuti e filtrare per abilità di apprendimento.
- Il componente aggiuntivo deve fornire la possibilità di creare un nuovo elemento collegabile dall'iframe.
Per ulteriori dettagli sui requisiti UX, consulta la lista di controllo dei requisiti per i componenti aggiuntivi di Classroom.
Mostrare lo stato della licenza all'interno dell'iframe
Se il componente aggiuntivo richiede una licenza e l'insegnante non ne ha una, deve essere visualizzato un messaggio chiaro che lo informi della procedura da seguire per risolvere il problema. Questo serve a evitare qualsiasi confusione che potrebbe sorgere a causa delle limitazioni di licenza.
Inoltre, abbiamo consigliato che il tuo componente aggiuntivo:
- Mostra il livello di licenza dell'insegnante nell'iframe di Ricerca degli allegati.
- Nasconde o disattiva i contenuti non disponibili per un insegnante a causa di limitazioni a livello di licenza.