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 (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 Ricerca 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).
Figura 2. Un esempio di UI di ricerca degli allegati in un iframe.
Considera la visualizzazione Ricerca allegati come la pagina di destinazione per gli insegnanti nel tuo plug-in. 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 materiale didattico. L'applicazione del componente aggiuntivo effettua quindi chiamate all'API Classroom per creare e allegare il componente aggiuntivo al compito.
Quando l'insegnante ha finito di selezionare e creare gli allegati, il plug-in 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 dello stream agli studenti.
Figura 3. Visualizzazione della creazione di un compito con tre allegati di componenti aggiuntivi di tipo attività.
Considerazioni sull'esperienza utente
- 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 dovrebbe 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, i miei contenuti e filtrare per abilità di apprendimento.
- Il componente aggiuntivo deve consentire di creare un nuovo elemento collegabile dall'iframe.
Per ulteriori dettagli sui requisiti relativi all'esperienza utente, consulta la lista di controllo dei requisiti per i 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 in che modo 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 relative alle licenze.