L'iframe di rilevamento degli 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 gli studenti devono interagire.
All'interno di un corso Classroom, un insegnante crea un nuovo post (ad esempio, un compito, un annuncio o una domanda) e seleziona un componente aggiuntivo dal menu 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.
Quando 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 individuazione degli allegati in un iframe.
Considera la visualizzazione Rilevamento 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 al proprio elemento del flusso. L'applicazione del componente aggiuntivo potrebbe limitare i contenuti mostrati a seconda che l'elemento del flusso sia un annuncio, un compito o materiale del corso. L'applicazione componente aggiuntivo effettua quindi chiamate all'API Classroom per creare e allegare l'allegato al compito.
Quando l'insegnante ha finito di selezionare e creare gli 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 può scegliere di visualizzare in anteprima o rimuovere dal
compito (Figura 3). L'insegnante completa il flusso di creazione assegnando
l'elemento del flusso 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.
- Il Single Sign-On di Google è obbligatorio per tutte le chiamate API di Classroom. Se il tuo prodotto ha un sistema di accesso separato, devi collegare gli account.
- Un insegnante deve poter visualizzare l'anteprima di un allegato all'interno dell'iframe prima di effettuare la selezione finale.
- Un insegnante dovrebbe 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 fornire la possibilità di creare un nuovo elemento allegabile dall'iframe.
Per ulteriori dettagli sui requisiti dell'esperienza utente, consulta l'elenco di controllo dei requisiti dei componenti aggiuntivi di Classroom.
Stato delle licenze
Se il tuo componente aggiuntivo richiede una licenza per il tuo prodotto, deve essere mostrato un messaggio chiaro che spieghi come un insegnante senza licenza può risolvere la situazione. Valuta anche la possibilità di nascondere o disattivare i contenuti che non sono disponibili per un insegnante a causa di limitazioni di licenza.