El iframe de descubrimiento de archivos adjuntos es la vista inicial que se muestra a un profesor cuando abre un complemento durante la creación de una tarea de Classroom. Un archivo adjunto es el contenido o la actividad con la que deseas que los estudiantes interactúen.
Desde un curso de Classroom, un profesor crea una publicación nueva (por ejemplo, una tarea, un anuncio o una pregunta) y selecciona un complemento de la lista desplegable de complementos. Durante un período breve (en horas), Classroom permite que el complemento agregue archivos adjuntos a la publicación.
Figura 1: Vista de la creación de una tarea que incluye las posibles opciones de complementos que puede adjuntar un profesor.
Una vez que un profesor selecciona un complemento, Classroom crea un iframe de descubrimiento de archivos adjuntos y carga la URL de inicio del complemento. Todos los parámetros de búsqueda de iframe relevantes se pasan a la URL de inicio.
Figura 2: Ejemplo de una IU de descubrimiento de archivos adjuntos en un iframe
El profesor usa la aplicación web del socio, dentro de un iframe, para seleccionar un
archivo adjunto. La app realiza llamadas a la API de Classroom para adjuntar el archivo adjunto a la tarea. Cuando el profesor termina de seleccionar los archivos adjuntos, el
complemento envía una carga útil de postMessage para solicitar que se cierre el iframe.
Se cerrará el iframe y el profesor ahora podrá ver los archivos adjuntos de los que puede elegir obtener una vista previa de ellos o quitarlos de la tarea.
Figura 3: Vista de la creación de una tarea con tres archivos adjuntos de tipo de actividad.
Consideraciones de UX dentro del iframe
- Durante la apertura inicial, el complemento debe pedirle al profesor que acceda.
- El inicio de sesión único de Google es obligatorio para todas las llamadas a la API de Classroom. Si tu producto tiene un sistema de acceso independiente, debes vincular las cuentas.
- Los profesores deben poder obtener una vista previa de un archivo adjunto dentro del iframe antes de hacer su selección final.
- Los profesores deben poder buscar o explorar contenido que se pueda adjuntar.
- El complemento puede ofrecer una variedad de vistas, como contenido reciente o mi contenido, y filtrar por habilidades de aprendizaje.
- El complemento debe proporcionar la capacidad de crear un nuevo elemento que se pueda adjuntar desde el iframe.
Consulta la lista de tareas de requisitos de complementos de Classroom para obtener más detalles sobre los requisitos de UX.
Cómo mostrar el estado de la licencia en el iframe
Si el complemento requiere una licencia y el profesor no la tiene, se debe presentar un mensaje claro al profesor que le informe los pasos que se deben seguir para solucionar la situación. Esto es para evitar cualquier confusión que pueda surgir debido a las restricciones de licencias.
También recomendamos que tu complemento cumpla con las siguientes condiciones:
- Muestra el nivel de licencia del profesor dentro del iframe de descubrimiento de adjuntos.
- Oculta o inhabilita el contenido que no está disponible para los profesores debido a restricciones del nivel de licencia.