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 (alrededor de horas), Classroom permite que el complemento agregue archivos adjuntos a la publicación.
Figura 1: Vista de la creación de una tarea, incluidas 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 lanzamiento del complemento. Cualquier parámetro de consulta de iframe relevante se pasa a la URL de lanzamiento.
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 a la tarea. Cuando el profesor termina de seleccionar los archivos adjuntos, el complemento envía una carga útil postMessage que solicita que se cierre el iframe.
Se cerrará el iframe y el profesor podrá ver los archivos adjuntos que puede obtener una vista previa o quitar de la tarea.
Figura 3: Vista de la creación de una tarea con tres archivos adjuntos de complementos de tipo de actividad
Consideraciones de UX dentro del iframe
- En la apertura inicial, el complemento debe solicitarle al profesor que acceda.
- Se requiere el Acceso único con Google 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 la selección final.
- Un profesor debe poder buscar o explorar contenido que se pueda adjuntar.
- El complemento puede proporcionar 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 del complemento de Classroom para obtener más detalles sobre los requisitos de UX.
Cómo mostrar el estado de la licencia dentro del iframe
Si el complemento requiere una licencia y el profesor no tiene una, se le debe presentar un mensaje claro en el que se le informen los próximos pasos adecuados 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 los siguientes requisitos:
- Muestra el nivel de licencia del profesor en el iframe de descubrimiento de archivos adjuntos.
- Oculta o inhabilita el contenido que no está disponible para los profesores debido a restricciones en el nivel de las licencias.