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 interagiscano.
Da 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 (Figura 1).
Figura 1. Visualizzazione della creazione di un compito, incluse le possibili opzioni di componenti aggiuntivi che un insegnante può allegare.
Una volta 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 avvio (Figura 2).
Figura 2. Un esempio di UI di rilevamento degli allegati in un iframe.
Considera la visualizzazione di rilevamento degli allegati come la pagina di destinazione per gli insegnanti nel tuo componente aggiuntivo. In genere, l'insegnante utilizza l'applicazione web del partner all'interno dell'iframe per selezionare i contenuti da allegare all'elemento dello stream. L'applicazione del componente aggiuntivo potrebbe limitare i contenuti visualizzati a seconda che l'elemento dello stream sia un annuncio, un compito o un materiale del corso. L'applicazione del componente aggiuntivo effettua quindi chiamate all'API Classroom per creare e allegare l'allegato al compito.
Al termine della selezione e della creazione degli allegati, il componente aggiuntivo invia un payload postMessage che richiede la chiusura dell'iframe. L'iframe si chiude e l'insegnante vede gli allegati, che potrebbe scegliere di visualizzare in anteprima o rimuovere dal compito (Figura 3). L'insegnante completa il flusso di creazione assegnando l'elemento dello stream ai suoi studenti.
Figura 3. Visualizzazione della creazione di un compito con tre allegati di componenti aggiuntivi di tipo attività.
Considerazioni sull'esperienza utente
- Alla prima apertura, il componente aggiuntivo deve chiedere all'insegnante di accedere.
- L'accesso singolo di 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 allegabili.
- Il componente aggiuntivo può fornire una serie di visualizzazioni, ad esempio contenuti recenti, i miei contenuti e filtro per competenze di apprendimento.
- Il componente aggiuntivo deve consentire di creare un nuovo elemento allegabile dall'interno dell'iframe.
Per ulteriori dettagli sull'esperienza utente, consulta la checklist dei requisiti dei componenti aggiuntivi di Classroom.
Stato delle licenze
Se il tuo componente aggiuntivo richiede una licenza per il tuo prodotto, deve essere visualizzato un messaggio chiaro che spieghi come un insegnante senza licenza può risolvere la situazione. Valuta anche la possibilità di nascondere o disattivare i contenuti non disponibili per un insegnante a causa di limitazioni di licenza.