L'iframe della scoperta 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 gli studenti devono interagire.
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 (in ordine di ore), Classroom consente al componente aggiuntivo di aggiungere allegati al post.
Figura 1. Visualizzazione della creazione di un compito, comprese le possibili opzioni aggiuntive che un insegnante può allegare.
Dopo che l'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 trasmessi all'URL di lancio.
Figura 2. Esempio di UI di rilevamento 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 visualizzare gli allegati, che possono scegliere di visualizzare in anteprima o rimuovere dal compito.
Figura 3. Visualizzazione della creazione di un compito con tre allegati aggiuntivi per il tipo di attività.
Considerazioni sull'UX all'interno dell'iframe
- All'apertura iniziale, il componente aggiuntivo deve richiedere all'insegnante di accedere.
- Il Single Sign-On di Google è richiesto 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.
- L'insegnante deve essere in grado di cercare o sfogliare i contenuti allegabili.
- Il componente aggiuntivo può fornire una varietà di visualizzazioni, ad esempio contenuti recenti e miei contenuti, e filtrare in base alle competenze di apprendimento.
- Il componente aggiuntivo deve consentire la creazione di un nuovo elemento allegabile dall'interno dell'iframe.
Consulta l'elenco di controllo dei requisiti per il componente aggiuntivo di Classroom per ulteriori dettagli sui requisiti dell'esperienza utente.
Visualizza lo stato di licenza all'interno dell'iframe
Se il componente aggiuntivo richiede una licenza e l'insegnante non ne ha una, deve essere presentato all'insegnante un messaggio chiaro che lo comunichi i passaggi successivi corretti per risolvere la situazione. Questo serve a evitare confusione che potrebbero derivare da restrizioni relative alle licenze.
Le consigliamo inoltre di:
- Mostra il livello di licenza dell'insegnante nell'iframe Rilevazione degli allegati.
- Nasconde o disattiva i contenuti che non sono disponibili per un insegnante a causa di limitazioni a livello di licenza.