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 con 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 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 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 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 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 adeguati per rimediare alla situazione. 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 rilevamento degli allegati.
- Nasconde o disattiva i contenuti non disponibili per un insegnante a causa di limitazioni a livello di licenza.