ESCUELA TÉCNICA SUPERIOR DE INGENIERÍAS INFORMÁTICA Y DE TELECOMUNICACIÓN

UNIVERSIDAD DE GRANADA

Pasar lista

Manual de Usuario

Antonio Aguilera Malagón

PRIMERA EJECUCIÓN

Suponiendo que se ejecuta la aplicación SWADroid por primera vez tras descargarla de Google Play

(https://play.google.com/store/apps/details?id=es.ugr.swad.swadroid), se muestra un diálogo

informando al usuario que debe introducir los datos necesarios para poder conectarse a SWAD:

1 - Primera ejecución

Si desea configurarse la aplicación, se muestra la pantalla de preferencias:

2 - Preferencias

En particular, deben introducirse los valores para los campos Usuario, Contraseña y Servidor, siendo

estos valores los mismos con los que se accede a SWAD. El valor del servidor por defecto es

swad.ugr.es:

3 - Preferencias tras introducir los datos del usuario

Una vez introducidos los datos, al salir de la pantalla de configuración (pulsando la tecla BACK)

accedemos a la pantalla principal de SWADroid. Cada vez que se modifican los datos del usuario, se

comprueban las asignaturas a las que pertenece:

4 - Obteniendo asignaturas

En este punto, pueden producirse los siguientes errores:

“No hay conexión”: la aplicación no puede comunicarse con SWAD por no estar activada la

conexión.

Verifique que el dispositivo dispone de conexión a Internet, bien por WiFi o por la red de datos.

“Error durante la conexión con el servidor”: la aplicación no puede comunicarse con SWAD con

los datos de usuario especificados.

Compruebe que los datos (usuario, contraseña, servidor) son correctos.

En caso de continuar el error, puede que se deba a que el servidor SWAD no está operativo.

Intente conectarse a él desde otro equipo para verificarlo.

5 - Posibles errores al conectar al servidor SWAD

Una vez descargados los datos de las asignaturas, se muestra la pantalla principal, en la que aparece una

lista desplegable y debajo las opciones disponibles en función del tipo de usuario:

6 - Pantalla principal de SWADroid en modo Alumno y en modo Profesor

Para obtener información sobre los menús Mensajes y Evaluación puede consultarse el manual de

usuario de SWADroid, disponible en http://www.slideshare.net/Marown/memoria-proyecto-fin-de-

carrera-swadroid (págs. 93-104), y el blog de SWADroid (http://swadroid.wordpress.com/).

Si pulsamos sobre la lista desplegable, se muestra la lista de asignaturas a las que pertenecemos:

7 - Lista de asignaturas

El menú Usuarios y la opción Pasar lista de este menú sólo estarán disponible para profesores.

8 - Pantalla principal con el menú Usuarios desplegado

PASAR LISTA

Al pulsar sobre esta opción por primera vez, se muestra un diálogo informando de que por el momento

sólo se permite utilizar esta funcionalidad con una única asignatura. Puede encontrarse más información

sobre el servicio web getGroups en http://swad.ugr.es/ws/#getGroups.

9 - Diálogo informativo de uso con una única asignatura

Si estamos seguros de tener seleccionada la asignatura adecuada y los grupos de prácticas de la

asignatura están definidos en SWAD, podemos continuar, pasando la aplicación a descargar de SWAD

los datos de los grupos de prácticas de la asignatura seleccionada:

10 - Descargando información de grupos de la asignatura desde SWAD

La gestión de los grupos (ya sean de teoría o de prácticas) debe realizarse a través de SWAD, en la

pestaña Alta/baja, opción Grupos:

11 - Vista de la opción Grupos en la pestaña Alta/baja de SWAD

Puede consultarse la documentación de SWAD para obtener información sobre los grupos:

http://swad.ugr.es/wiki/index.php/FAQ_Grupos.

En caso de que no existan grupos de prácticas, se mostrará el siguiente mensaje, no siendo posible el

acceso a la funcionalidad de Pasar lista hasta que se creen.

12 - Error producido al intentar descargar grupos de una asignatura sin grupos definidos

Una vez creados los grupos de prácticas, será necesario seleccionar la opción Limpiar base de datos del

menú que aparece al pulsar la tecla MENU del dispositivo, y volver a seleccionar la asignatura para

descargar los grupos de prácticas correctamente.

Después de obtener los grupos de prácticas se mostrará la actividad Pasar lista, que contiene toda la

funcionalidad desarrollada en el proyecto:

13 - Pantalla principal de la opción Pasar lista

Lista de asignaturas

Menú Estudiantes

Menú Pasar lista

Lista de grupos de prácticas

Menú Sesiones de prácticas

Como se puede apreciar en la imagen anterior, la información se estructura de acuerdo a lo siguiente:

Lista de asignaturas: por comodidad se repite la lista desplegable con la lista de las asignaturas

del usuario mostrada en la pantalla principal, aunque aquí aparece deshabilitada, mostrando

únicamente la asignatura seleccionada para pasar lista, a modo informativo.

Lista de grupos de prácticas: lista desplegable con los grupos de prácticas definidos para la

asignatura.

Menú “Estudiantes”: agrupa las opciones relacionadas con los estudiantes, “Actualizar” y

“Consultar estudiantes”.

Menú “Sesiones de prácticas”: agrupa las opciones relacionadas con las sesiones de prácticas,

“Nueva” y “Consultar sesiones”.

Menú “Pasar lista”: agrupa los distintos métodos desarrollados para pasar lista, “Escanear QR”

y “Modo manual”.

14 - Vistas de la opción Pasar lista con los menús Estudiantes y Sesiones de prácticas desplegados

15 - Vista de la opción Pasar lista con el menú Pasar lista desplegado

Si pulsamos sobre la lista desplegable de grupos de prácticas, se muestra la lista de grupos de prácticas

definidos en la asignatura seleccionada:

16 - Selección de grupo

MENÚ ESTUDIANTES

Cuando vaya a pasarse lista por primera vez para la asignatura seleccionada, es necesario descargar de

SWAD los datos de los estudiantes. Para ello, seleccionamos la opción Actualizar. Aparecerá un diálogo

de progreso, y si todo ha ido bien, se mostrará un mensaje con el número de estudiantes descargados:

17 - Diálogos mostrados durante y tras el proceso de descarga de los datos de los estudiantes desde SWAD

NOTA: Por el momento no es posible descargar las fotos de los estudiantes. Hasta que el servicio web

getUsers (http://swad.ugr.es/ws/#getUsers) se modifique para que también devuelva la URL de la foto

del estudiante, todos los estudiantes se mostrarán con la foto por defecto, independientemente de si

tienen definida su foto en SWAD o no.

No es necesario volver a actualizar la lista de estudiantes de la asignatura a lo largo del curso, salvo que

dicha lista se vea alterada (por ejemplo, por alta/baja de estudiantes durante el período de alteración de

matrícula).

Al seleccionar la opción Consultar estudiantes, se mostrará la lista de estudiantes de la asignatura,

ordenada alfabéticamente. Dicha lista aparecerá vacía si no se ha seleccionado la opción Actualizar

previamente.

18 - Vistas del Historial de alumnos de la asignatura (antes y después de Actualizar)

Podemos pulsar sobre los estudiantes para consultar su historial de asistencia a las sesiones de

prácticas.

Dicho historial no existirá inicialmente, ya que aún no existen sesiones de prácticas en la base de datos.

Cuando existan, se mostrarán las sesiones de prácticas existentes para todos los grupos de prácticas de

la asignatura, ordenados por grupo de prácticas y fecha y hora de la sesión de prácticas.

19 - Vistas del Historial de alumnos al consultar la asistencia (sin y con grupos definidos)

MENÚ SESIONES DE PRÁCTICAS

La opción Nueva de este menú permite crear una nueva sesión de prácticas para la asignatura y grupo

de prácticas seleccionados.

20 - Nueva sesión de prácticas

Se ha intentado agilizar al máximo posible el proceso de creación de una nueva sesión de prácticas, de

manera que sólo es necesario introducir la fecha, y las horas de inicio y de fin de la sesión, que

inicialmente tienen como valores:

Fecha de inicio: fecha actual

Fecha de fin: fecha actual

Hora de inicio: hora actual en punto (sin tener en cuenta los minutos). Por ejemplo, si la hora

actual es 19:53, este campo aparecerá como 19:00.

Hora de fin: hora actual + 1 hora. Por ejemplo, si la hora actual es 19:00, la hora de fin será

20:00.

Se incluyen dos campos de texto adicionales, que pueden rellenarse opcionalmente:

Lugar: útil para indicar el aula en la que se imparte la sesión de prácticas.

Descripción: a modo de observaciones, aquí puede comentarse si la sesión es una recuperación

de una sesión atrasada, o si se trata de un examen, por ejemplo.

Para introducir las fechas y horas se dispone de DatePickers y TimePickers:

21 - DatePicker y TimePicker para la selección de la fecha y la hora de la sesión de prácticas

Una vez completados los campos obligatorios, al pulsar el botón Crear se creará la sesión de prácticas. Si

ya existe una sesión de prácticas para esa fecha y hora (de inicio) en la base de datos, se mostrará un

mensaje indicando este error, ya que no pueden existir dos sesiones de prácticas para el mismo grupo

de prácticas al mismo tiempo, lógicamente.

22 - Mensajes obtenidos al intentar crear una nueva sesión de prácticas (si no existe ninguna al mismo tiempo, y si existe alguna)

Al seleccionar la opción Consultar sesiones, se mostrará la lista de sesiones de prácticas del grupo de

prácticas en cuestión, ordenada por fecha y hora. Dicha lista aparecerá vacía si no se ha creado ninguna

sesión hasta el momento.

23 - Vistas del Historial de sesiones (sin y con sesiones de prácticas creadas)

Para cada sesión, se muestra el estado del envío de los datos de asistencia a SWAD.

Podemos pulsar sobre las sesiones para consultar los estudiantes asistentes a dicha sesión.

Inicialmente, no existirá ningún estudiante como asistente a la sesión. Cuando se haya pasado lista,

aparecerán los estudiantes asistentes, ordenados alfabéticamente.

24 - Vistas del Historial de sesiones (sin y con asistencia de estudiantes a la sesión seleccionada)

MENÚ PASAR LISTA

Este menú agrupa los distintos métodos desarrollados para pasar lista.

ESCANEAR QR

Al seleccionar la primera opción, Escanear QR, la aplicación entra en modo escáner a la espera de

detectar algún código QR para proceder a su captura y decodificación.

25 - Vista de la pantalla en modo escáner

Si se captura un código de un estudiante perteneciente a la asignatura, se mostrarán sus datos (DNI y

nombre) y su foto (suponiendo que la haya subido a SWAD). Asimismo, se reproducirá un sonido de

éxito (si el sonido está habilitado en el dispositivo).

El tiempo de espera hasta que se vuelve a intentar detectar otro código está establecido a 3 segundos,

para que no se escanee el mismo código varias veces mientras se presenta el mensaje con los datos del

estudiante detectado. En cualquier caso, no importa que el código se capture varias veces, se anotará

como asistente una sola vez.

26 - Código QR válido decodificado

En caso de que no se disponga de los datos del estudiante correspondiente al código escaneado, o el

contenido del código no sea el adecuado, se mostrará un mensaje de error y se reproducirá un sonido

de error (igualmente, si el sonido está habilitado).

Para considerar un código como válido, su contenido deberá seguir uno de los siguientes patrones:

DNI: [a-zA-Z] [0-9]{1,16} [a-zA-Z]

Los corchetes indican que lo que contienen es opcional, y las llaves un intervalo.

El patrón puede entenderse como: 0 ó 1 letra, de 1 a 16 dígitos, y 0 ó 1 letra.

Un ejemplo de DNI válido podría ser: A123

Un ejemplo de DNI no válido sería: 1234AB

Nickname (nombre de usuario en SWAD): [a-zA-Z_0-9] {1,30}

El patrón significa: de 1 a 30 letras (mayúsculas o minúsculas), números o caracteres

subrayados

Un ejemplo de nickname válido sería: juan_lopez93

Un ejemplo de nickname no válido sería: @ juan_lopez93

27 - Código QR válido decodificado sin información asociada en la base de datos

28 - Código QR no válido

Para salir del modo escáner tras terminar de procesar los códigos de los estudiantes, debe pulsarse la

tecla BACK.

Si no se ha detectado ningún código válido, se mostrará un mensaje de error indicando este hecho. En

cambio, si se ha reconocido algún estudiante de la asignatura, se mostrará un listado con los estudiantes

detectados, ordenados alfabéticamente. Dicho listado podrá modificarse, desmarcando los checkbox

situados a la derecha de cada alumno, en caso de no querer anotar al estudiante como asistente.

29 - Vistas de la pantalla tras salir del modo escáner (sin y con estudiantes decodificados)

Los botones Enviar y Guardar realizan la misma función, consistente en guardar los datos de asistencia

en la base de datos de la aplicación, ya que el servicio web para enviar los datos a SWAD no está

disponible aun. Si se selecciona Enviar, se mostrará un mensaje indicando este hecho.

30 - Vistas de la pantalla tras seleccionar las opciones Guardar y Enviar, respectivamente

En cualquier caso, el sistema detecta si al guardar los datos existe una sesión de prácticas en curso para

la asignatura y grupo de prácticas seleccionados. En este caso, los datos de asistencia se asocian a este

grupo. En caso contrario, se muestra la lista de sesiones de prácticas disponibles para elegir una de ellas.

31 - Selección de sesión de prácticas

MODO MANUAL

La opción Modo manual del menú Pasar lista realiza la misma función que la opción Escanear QR, salvo

que omite el proceso de captura de códigos QR. En lugar de esto, muestra la lista de estudiantes de la

asignatura, permitiendo marcarlos individualmente. El resto del proceso es idéntico al descrito

anteriormente para la opción Escanear QR.

32 - Lista de estudiantes en Modo manual