e
s
El ex o p esen ado no puede ocupa más de una línea
T abajo Fin de G ado
G ado en Ingenie ía de las Tecnologías de
Telecomunicación
In eg ación de he amien as de gami icación en
pla a o mas de Enseñanza Vi ual
Au o : Ped o Ga cía F u os
Tu o : F ancisco José Fe nández Jiménez
Dp o. Ingenie ía Telemá ica
Escuela Técnica Supe io de Ingenie ía
Uni e sidad de Se illa
Se illa, 2018
T abajo Fin de G ado
Ingenie ía de Telecomunicación
In eg ación de he amien as de gami icación en
pla a o mas de Enseñanza Vi ual
Au o :
Ped o Ga cía F u os
Tu o :
F ancisco José Fe nández Jiménez
P o eso colabo ado
Dp o. de Ingenie ía Telemá ica
Escuela Técnica Supe io de Ingenie ía
Uni e sidad de Se illa
Se illa, 2018
T abajo Fin de G ado: In eg ación de he amien as de gami icación en pla a o mas de Enseñanza
Vi ual
El ibunal nomb ado pa a juzga el T abajo a iba indicado, compues o po los siguien es miemb os:
P esiden e:
Vocales:
Sec e a io:
Acue dan o o ga le la cali icación de:
Se illa, 2018
El Sec e a io del T ibunal
Au o :
Ped o Ga cía F u os
Tu o :
F ancisco José Fe nández Jiménez
A mi amilia
A mis amigos
A mis maes os
Ag adecimien os
Es e abajo no pod ía habe se ealizado sin la ayuda de mi u o F ancisco José Fe nández Jiménez,
que ha colabo ado en el p oyec o y esuel o odas mis dudas. También me ecen una mención especial
Jesus Muñoz Calle -au o de los juegos- y F ancisco Ja ie Muñoz que accedie on a euni se conmigo
pa a cada duda o p oblema su gido con la implemen ación de los mismos e hicie on posible que odo
unciona a co ec amen e.
Po úl imo, pe o no menos impo an e, me gus a ía ag adece a mis pad es y amigos el apoyo b indado
a lo la go de odos es os años y a los p o eso es que me han ido o mando a lo la go de la ca e a, sin
los cuales ampoco pod ía es a inalizando en es os momen os.
Ped o Ga cía F u os
Se illa, 2018
3.3 A qui ec u a y uncionamien o básico de la aplicación 37
3.3.1 Es uc u a de la base de da os 39
3.3.2 Comunicación en e los juegos y la aplicación web 41
4 Implemen ación 43
4.1. Código 43
4.1.1 Documen ación 46
4.1.2 Clases 46
4.1.3 Lib e ías 48
4.1.4 Fiche os JSP 50
4.1.5 Fiche o de con igu ación: con ig.p ope ies 59
4.1.6 Desc ip o de despliegue 60
4.1.7 Fiche os Ja aSc ip 60
4.1.7.1 Fiche os usados pa a la c eación de pa idas 60
4.1.7.2 Fiche os usados pa a comunicación en e la he amien a y el juego 61
4.1.8 A chi os de e o 61
4.1.9 Fiche os CSS 62
4.2 O as uncionalidades 62
4.2.1 Elimina usua ios 62
4.2.2 Bo ado de no as 62
4.2.3 Con ol ho a io 62
4.2.4 Te mina pa ida 62
5 P ueba de ejecución 63
5.1 LMS u ilizados 63
5.1.1 Cou seSi es 63
5.1.2 Moodle 63
5.2 P uebas de uncionamien o y o os da os de in e és 64
5.3 P uebas de endimien o 67
5.4 P uebas de segu idad 67
6 Conclusiones, líneas de u u o y plani icación 68
6.1 Conclusiones 68
6.2 Líneas de u u o 68
6.3 Plani icación 69
Re e encias 70
7 Anexos 73
Anexo A. Manual de ins alación 73
7.1. P epa ación del en o no 73
7.2 Fiche o de con igu aciób "con ig.p ope ies" 73
7.3 Con igu ación pa a pode ealiza p uebas o modi icaciones 74
Anexo B. Manual de usua io 75
7.4 Ins ucciones de uso 75
7.4.1 Aplicación Web 75
7.4.1.1 C eación de un usa io 76
7.4.1.2 Subida de juegos y c eación de una pa ida 78
7.4.1.3 Eliminación de una pa ida 81
7.4.1.4 Ges ión de juegos 83
7.4.1.5 Eliminación de un usua io 86
7.4.1.6 In o mación de una pa ida y consul a de cali icaciones 88
7.4.2 In eg ación de he amien a en LMS 89
7.4.2.1 Cou seSi es 89
7.4.2.2 Moodle 90
7.4.3 Acceso a la he amien a desde el TC 91
ÍNDICE DE TABLAS
Tabla 1 Ca ac e ís icas de di e en es esiones LTI………………………………………..….……..7
Tabla 2 En ío de mensaje al TC pa a esc ibi una no a en el cuade no de cali icaciones….….……..9
Tabla 3 Ca ac e ización de los equisi os del sis ema…………………………………..…….…….14
Tabla 4 Requisi o gene al 01 “Sis ema de c eación y ges ión de he amien as LTI……...…………14
Tabla 5 Requisi o gene al 02 “Inicio de sesión”……………………………………………..……..15
Tabla 6 Requisi o gene al 03 “Exis encia de supe usua io”………………………………..……….15
Tabla 7 Requisi o gene al 04 “C eación de c edenciales LTI”…………………………..………….15
Tabla 8 Requisi o gene al 05 “Juego”………………………………………………….………...…15
Tabla 9 Requisi o gene al 06 “Cali ica usua io”……………………………………….…………..16
Tabla 10 Requisi o gene al 07 “Ve sión LTI 1.1”…………………………………….…………….16
Tabla 11 Requisi o gene al 08 “Mensajes in o ma i os”…………………………….…………..….16
Tabla 12 Requisi o gene al 09 “A anque de la aplicación”………………………………………...17
Tabla 13 Requisi o gene al 10 “Con igu ación de pa idas”…………………………………………17
Tabla 14 Requisi o gene al 11 “Sis ema ope a i o”…………………………………………..…….18
Tabla 15 Caso de uso 01 “Inicia sesión”……………………………………..…………………….18
Tabla 16 Caso de uso 02 “C ea usua ios”………………………………………………..…………19
Tabla 17 Caso de uso 03 “Elimina usua ios”………………………………………………………19
Tabla 18 Caso de uso 04 “Elegi zona ho a ia”………………………………………………..……19
Tabla 19 Caso de uso 05 “Cambia con aseña”……………………………………………………..19
Tabla 20 Caso de uso 06 “Subi juego”…………………………………………………………..…19
Tabla 21 Caso de uso 07 “Elimina juegos”………………………………………………...……….20
Tabla 22 Caso de uso 08 “Habili a /Deshabili a juegos”………………………………….……….20
Tabla 23 Caso de uso 09 “Ce a sesión”………………………………..………………………….20
Tabla 24 Caso de uso 10 “De ec a pa áme os de o ma au omá ica”……………………………….21
Tabla 25 Caso de uso 11 “C ea pa idas”……………………………………………………..……21
Tabla 26 Caso de uso 12 “Es ablece echa y ho a”………………………………………………….21
Tabla 27 Caso de uso 13 “Es ablecimien o de pa áme os LTI”……………………………………..21
Tabla 28 Caso de uso 14 “Núme o de epe iciones”…………………………………………………22
Tabla 29 Caso de uso 15 “Cla e de acceso”……………………………..………………………….22
Tabla 30 Caso de uso 16 “Subi iche o de p egun as”……………………………………..……….22
Tabla 31 Caso de uso 17 “Bo a no as”………………………………………..…………………...23
Tabla 32 Caso de uso 18 “Edi a pa idas”……………………………………………………..…...23
Tabla 33 Caso de uso 19 “In o mación de la pa ida”………………………………………………..23
Tabla 34 Caso de uso 20 “Modo Tes ”…………………………………………..…………...……..24
Tabla 35 Caso de uso 21 “Bo a pa ida”…………………………………………..…………...….24
Tabla 36 Caso de uso 22 “Te mina pa ida”……………………………………………..…………24
Tabla 37 Caso de uso 23 “Acceso a he amien a LTI desde LMS”……………………...…………..24
Tabla 38 Regla de negocio 01 “Roles de usua io”………………………………………...…………26
Tabla 39 Regla de negocio 02 “P o eso es c eado es de pa ida”………………………..……….….27
Tabla 40 Requisi os de conduc a 01 “C eación de ablas pa a comunicación LTI”……………….…27
Tabla 41 Requisi os de in o mación 01 “Almacenamien o de usua ios y pa idas”…………………..27
Tabla 42 Requisi os de in o mación 02 “Pa áme os de con igu ación LTI”………………..………28
Tabla 43 Requisi os de in o mación 03 “Fiche o de con igu ación”………………………..………29
Tabla 44 Requisi os de iabilidad 01.......................................................................................................29
Tabla 45 Requisi os de iabilidad 02 “Ve i icación de campos”……………………………………..30
Tabla 46 Requisi os de iabilidad 03 “Nomb e de pa idas y/o juegos”……………………..………30
Tabla 47 Requisi os de iabilidad 04 “Selección co ec a de echa y ho a”…………………………..30
Tabla 48 Requisi os de iabilidad 05 “Reinicio de pa idas po eca ga de con ex o”………..……...30
Tabla 49 Requisi os de usabilidad 01 “Manual de ins alación”…………………………………...…31
Tabla 50 Requisi os de usabilidad 02 “Manual de usua io”……………………………………..…..31
Tabla 51 Requisi os de usabilidad 03 “Indicaciones de uso”……………………………………..…31
Tabla 52 Requisi os de usabilidad 04 “Fiche o de p egun as”……………...………………………..32
Tabla 53 Requisi o de Man enibilidad 01 “Reu ilización”………………………………..…………32
Tabla 54 Requisi o de po abilidad 01 “Base de da os”……………………………………...………32
Tabla 55 Requisi o de po abilidad 02 “Se ido ”……………………………………..……………33
Tabla 56 Requisi o de segu idad 01 “Con ol de acceso”……………………………………...…….33
Tabla 57 Requisi o de segu idad 02 “Cambio de con aseña”…………………………..…………..33
Tabla 58 Requisi o de segu idad 03 “Codi icación de con aseña”………………………….……...33
Tabla 59 Requisi o de segu idad 04 “Con ol de sesión”………………………………………..…..34
Tabla 60 Requisi o de segu idad 05 “Con ol de acceso a pa ida”……………………..…………...34
Tabla 61 Requisi o de segu idad 06 “Ca ga de iche os de juegos”………………………………....34
Tabla 62 Requisi o de segu idad 07 “Fil os”……………………………………………………......34
Tabla 63 Res icción Técnica 01 “Sis ema ope a i o”…………………………………...………….35
Tabla 64 Res icción Técnica 02 “Ja a Run ime En i onmen 8”…………………………..………35
Tabla 65 Res icción Técnica 03 “SQLi e”…………………………………..……………………..36
Tabla 66 Res icción Técnica 04 “Se ido Tomca 8.5”………………………………… ………..36
Tabla 67 Res icción Técnica 05 “LMS”…………………………………………… ……………..36
Tabla 68 Res icción Ténica 06 “Conexión TCP”…………………………………..………………36
Tabla 69 iche o con ig.p ope ies…………………………………..……………………………....59
Tabla 70 Desc ip o de despliegue…………………………….…………..………………………...60
Tabla 71 Ejemplo de iche o p ope ies del juego es …………………….…….…………………..76
ÍNDICE DE FIGURAS
Figu a 1 LMS más popula es………………………………….......................................................6
Figu a 2 Acceso a he amien a LTI desde enlace .........................................................................10
Figu a 3 UML de inicio de sesión.................................................................................................12
Figu a 4 UML de c eación de pa idas..........................................................................................13
Figu a 5 UML de in de pa ida y en ío de cali icaciones............................................................13
Figu a 6 P incipales usos del supe usua io....................................................................................25
Figu a 7 P incipales usos del usua io p o eso .............................................................................26
Figu a 8 Rol del alumno en he amien a LTI ...............................................................................26
Figu a 9 Es uc u a gene al del sis ema ........................................................................................38
Figu a 10 Es uc u a de base de da os...........................................................................................39
Figu a 11 Comunicación en e he amien a LTI y juegos.............................................................42
Figu a 12 Es uc u a de di ec o ios de la aplicación.....................................................................37
Figu a 13 Mapa Web de supe usua io...........................................................................................44
Figu a 14 Mapa Web de usua io p o eso .....................................................................................45
Figu a 15 Mapa Web de usua io alumno......................................................................................45
Figu a 16 Lib e ías usadas en el p oyec o.....................................................................................48
Figu a 17 Menú de c eación de un usua io....................................................................................50
Figu a 18 Lis ado de los usua ios exis en es en la aplicación.......................................................51
Figu a 19 Fo mula io de c eación de pa idas...............................................................................52
Figu a 20 Menú de In o mación de una pa ida............................................................................53
Figu a 21 Menú de na egación de la aplicación...........................................................................53
Figu a 22 Menú pa a cambia con aseña......................................................................................54
Figu a 23 Menú de ges ión de juegos............................................................................................55
Figu a 24 Menú p incipal de la aplicación....................................................................................55
Figu a 25 Menú de pa idas….......................................................................................................56
Figu a 26 Menú del modo Tes .....................................................................................................56
Figu a 27 Menú de subida de juegos.............................................................................................57
Figu a 28 Menú de inicio de sesión a la aplicación.......................................................................57
Figu a 29 C edenciales de inicio de sesión in álidas....................................................................58
Figu a 30 In e az de juego ipo es ..............................................................................................58
Figu a 31 Mensaje indicando que se han sob epasado el lími e de in en os.................................59
Figu a 32 Mensaje indicando que la pa ida no es á disponible en es e momen o........................59
Figu a 33 G á ico esquemá ico de la p ueba ealizada..................................................................66
Figu a 34 Fases del p oyec o y du ación.......................................................................................69
Figu a 35 G á ico de la du ación y elaciones en e a eas...........................................................69
Figu a 36 Se ido es disponibles y es ado....................................................................................74
Figu a 37 Menú p incipal con ol de p o eso ...............................................................................75
Figu a 38 Inicio de sesión de supe usua io....................................................................................76
Figu a 39 C eación de usua io p o eso .........................................................................................77
Figu a 40 Lis a de usua ios............................................................................................................77
Figu a 41 Menú de subida de un juego..........................................................................................78
Figu a 42 Éxi o en la subida..........................................................................................................79
Figu a 43 Fo mula io de c eación de una pa ida..........................................................................80
Figu a 44 Lis a de pa idas............................................................................................................81
Figu a 45 Menú de pa idas as pulsa “BORRAR” ....................................................................82
Figu a 46 Pa ida Eliminada .........................................................................................................83
Figu a 48 Juego deshabili ado……………...................................................................................84
Figu a 49 Eliminación de juego ...................................................................................................85
Figu a 50 Juego eliminado ...........................................................................................................86
Figu a 51 Eliminación de un usua io.............................................................................................87
Figu a 52 Usua io eliminado.........................................................................................................87
Figu a 53 Cali icaciones an es de inaliza pa ida…....................................................................88
Figu a 54 Cali icaciones as e mina la pa ida...........................................................................88
Figu a 55 Con igu ación de enlace web en Cou seSi es...............................................................90
Figu a 56 Con igu ación de Moodle pa a c ea enlace LTI..........................................................90
Figu a 57 Pa ida no disponible po echa.....................................................................................91
Figu a 58 Pa ida no disponible po sob epasa el núme o de in en os.........................................91
Figu a 59 In e az de juego “Tes ”................................................................................................91
1
1 INTRODUCCIÓN
as nue as ecnologías han cambiado la isión que enía el se humano del mundo. Han pe mi ido
enómenos como la globalización e impulsado mul i ud de á eas del conocimien o como la
ingenie ía, la medicina, la a qui ec u a, la ag icul u a y po supues o la educación. Pila de odas
las ciencias.
1.1 Mo i ación
Pa a que pueda lle a se a cabo el p oceso o ma i o de una pe sona es undamen al que és a se
encuen e mo i ada y mues e in e és po el á ea en el que se es é o mando. Pe o a pesa de se el
p incipal equisi o no es el único. La al a de ecu sos o la excesi a ca ga de abajo de los p o eso es
al con a con un núme o muy ele ado de alumnos pueden di icul a mucho es a a ea. Con es e
p oyec o se p e ende acili a la labo docen e median e el uso de la gami icación.
1.2 Gami icación
La gami icación o ludi icación es una écnica basada en el uso de juegos y dinámicas elacionadas con
el ocio en si uaciones no ec ea i as. Busca inc emen a el desa ollo de compe encias y habilidades
omen ando la mo i ación y el in e és de una pe sona o g upo de pe sonas po un á ea de e minada.
En el caso del p oyec o que nos ocupa en el ámbi o educa i o.
Los juegos u ilizados pueden basa se en mul i ud de mecánicas que hagan del p oceso de ap endizaje
algo más a ac i o. Algunas de és as mecánicas pod ían se la ob ención de p emios pa a los alumnos
con mayo pun uación, p opone desa íos que al supe a se apo en cie o g ado de sa is acción
pe sonal, apela al espí i u compe i i o del alumnado median e ankings…
Va ias de las aplicaciones usadas en la ac ualidad y que ejempli ican el uso de la gami icación en el
aula se ía Kahoo [1], Plicke s [2] o Quizizz [3]. Pa a más in o mación isi a [4].
Pa a pode hace uso de es as he amien as es necesa io que an o el p o eso como los alumnos se
egis en en una web y que odo el p oceso de e aluación se desa olle en la misma. Es e sis ema puede
llega a se muy ine icien e o limi a mucho al p o eso si és e equie e del uso de juegos que se
encuen en despe digados en e las di e en es al e na i as exis en es.
La uncionalidad ex a que noso os apo amos a la ho a de ealiza es e p oyec o en e a las
he amien as de gami icación ya exis en es, es el pode in eg a los juegos en un g an núme o de
pla a o mas de enseñanza i ual, haciendo posible que odo es é cen alizado e in eg ado en un solo
luga .
L
“El u u o de la educación es a á p o undamen e signado
po la ecnologia de la in o mación enide a. Pe o más
aún, po cómo los educado es y es udian es u ilizan las
TIC pa a el ap endizaje con inuo”
- S anley Williams – Fu u e o Educa ion: Technology +
Teache s-
Es ado del a e
8
8
modelos
median e he amien a y UML.
Se icios REST
Sí
Sí
Se icios REST de ni el 3 pa a g an a iedad de a eas
se ido a se ido . En LTI 1.2 sólo se pe mi en se icios
REST implemen ados en el TC.
Tabla 1 Ca ac e ís icas de di e en es e siones LTI
Hay que des aca que desde la e sión de LTI 1.1 es posible asigna una cali icación desde el TP al
cuade no de cali icaciones del TC. Ca ac e ís ica impo an e que se u iliza á en el p oyec o pa a
e alua a los alumnos que pa icipen en las pa idas c eadas po los p o eso es.
En el abajo ealizado an e io men e po mi compañe a Lou des [6] se hace uso de es a ca ac e ís ica.
La comunicación es aba implemen ada po la lib e ía “oscelo ”. Es a lib e ía ue modi icada con el
in de co egi algunos e o es po F ancisco José Fe nández Jiménez y es la usada en es e p oyec o.
La especi icación u ilizada en es e p oyec o -LTI Basic Ou comes Se ice [22]- se basa en el en ío
de mensaje POX (Plain Old Xml) i mados con el es ánda OAu h [23] [24]. Básicamen e con el
uso de es a especi icación nos es posible ealiza ope aciones de lec u a, esc i u a y bo ado del
cuade no de cali icaciones.
El acceso al mismo se á posible g acias a la combinación de los pa áme os usua io/ ecu so, que
en el es ánda eciben el nomb e de use _id y esou ce_link_id. De es a o ma, conociendo el
iden i icado del usua io y el del ecu so asignado a dicho usua io, podemos accede a la ila y
columna del cuade no de cali icaciones del TC y ealiza cualquie a de las ope aciones desc i as
an e io men e.
Cabe des aca en es e pun o que el es ánda nos obliga a la ho a de esc ibi una no a en el cuade no de
cali icaciones del TC que és a se encuen e comp endida en e 0.0 y 1.0. Cualquie o o núme o que
no es é comp endido en e ellos nos epo a á un mensaje de ope ación allida.
En la Tabla 2, se p esen a un ejemplo del mensaje que hab ía que en ia le al TC pa a esc ibi una no a
en el cuade no de cali icaciones.
<?xml e sion = "1.0" encoding = "UTF-8"?>
<imsx_POXEn elopeReques xmlns =
"h p://www.imsglobal.o g/se ices/l i 1p1/xsd/imsoms_ 1p0">
<imsx_POXHeade >
<imsx_POXReques Heade In o>
<imsx_ e sion>V1.0</imsx_ e sion>
<imsx_messageIden i ie >1313355158804</imsx_messageIden i ie >
</imsx_POXReques Heade In o>
</imsx_POXHeade >
<imsx_POXBody>
< eplaceResul Reques >
< esul Reco d>
9
Es ado del a e
9
Tabla 2 En ío de mensaje al TC pa a esc ibi una no a en el cuade no de cali icaciones [25]
2.1.2.2 A qui ec u a LTI
An es de es ablece la es uc u a de comunicación básica de LTI ( e sión 1.0) es necesa io que el
adminis ado del TC con igu e las c edenciales de dominio pa a un TP pa icula . Es as c edenciales
se aplican a los enlaces LTI c eados di ec amen e en el sis ema TC.
Po o a pa e, el adminis ado TP c ea la combinación cla e y sec e o pa a el TC (donde el
adminis ado de TC puede solici a una cla e pa icula , a menudo el nomb e de dominio TC), el pa
cla e/sec e o debe se conocido po ambos y son usados pa a i ma el con enido de los paque es con
OAu h.
Una ez ealizado lo an e io el p oceso a segui se ía el siguien e:
1. Un usua io pincha en un enlace LTI alojado en el TC lo que desencadena la ejecución de la
he amien a.
2. El TC es ablece una se ie de pa áme os de lanzamien os (pa áme os es ánda , opcionales y
pe sonalizados) que se án pa e del mensaje de lanzamien o.
3. Se i ma el con enido con OAu h pa a asegu a su in eg idad.
4. El TC en ía el mensaje al na egado y un agmen o de código Ja aSc ip se enca ga de au o-
en ía el mensaje al TP.
5. El TP esponde con una ep esen ación de la he amien a en el na egado .
Es e p oceso pod ía esumi se en el diag ama mos ado en la Figu a 2.
<sou cedGUID>
<sou cedId>3124567</sou cedId>
</sou cedGUID>
< esul >
< esul Sco e>
<language>en</language>
< ex S ing>0.91</ ex S ing>
</ esul Sco e>
</ esul >
</ esul Reco d>
</ eplaceResul Reques >
</imsx_POXBody>
</imsx_POXEn elopeReques >
Es ado del a e
10
10
Figu a 2 Acceso a he amien a LTI desde enlace.
En nues o caso usamos LTI 1.1. El uncionamien o es el mismo que el desc i o pa a LTI 1.0 pe o
añadiendo dos pa áme os adicionales en el lanzamien o:
lis_ou come_se ice_u l: URL donde es á escuchando el se icio del TC que pe mi e la
modi icación de no as.
lis_ esul _sou ceid: alo que indica la ila y columna del cuade no de cali icaciones del
TC donde se inse a á, elimina á o edi a á una no a.
El mensaje de uel o po el TP es comple amen e asínc ono po lo que pueden pasa ho as, días, o
incluso semanas has a que se en ía la cali icación al TP. Es a ca ac e ís ica es usada en nues o
p oyec o pa a es ablece una ho a de cie e de la ac i idad, en el momen o en el que dicha ac i idad
concluye, las no as son en iadas al TC y pueden se consul adas po los alumnos.
2.1.2.3 Lib e ías y Ejemplos LTI
Desde la p opia página de IMS se apo a documen ación pa a el uso del es ánda LTI en sus dis in as
e siones [26]. En el caso de nues a aplicación pa a el in e cambio de mensajes en e el TC y el TP
es amos usando el código del au o S ephen Vicke s [27], es á p og amado en ja a (como la mayo ía
de nues o p oyec o) sopo a las e siones de LTI 1.x y p opo ciona un código de ejemplo usando el
se icio Ou come.
2.1.2.4 Implemen ación
En capí ulos pos e io es se desc ibi á el p oceso de implemen ación de nues a he amien a en los LMS
en los que se han ealizado las p uebas Cou seSi es y Moodle ambas p opiedad de BlackBoa d.
Na egado
•Con iene enlace LTI
TC
•P epa ación de
pa áme os
•Fi ma OAu h
Na egado
•Ejecu a código
Ja aSc ip
TP
•En ía ep esen ación de
la he amien a
Na egado
•Rep esen a la
he amien a
click
POST
POST
11
Es ado del a e
11
2.1.3 He amien a LTI usada en nues o p oyec o
El p oceso que acabamos de desc ibi es el que nos pe mi e la implemen ación de los juegos en
las pla a o mas de enseñanza.
En el siguien e capí ulo habla emos sob e el diseño de nues a aplicación -que eco demos- iene
como obje i o la c eación de pa idas con igu ables, con la capacidad de au oco egi se y subi
las no as au omá icamen e al cuade no de cali icaciones del LMS.
Diseño
12
12
3 DISEÑO
En es e apa ado se p o undiza á en el so wa e a implemen a y se de alla án los obje i os y
uncionalidades del mismo.
3.1 In oducción
El obje i o a la ho a de diseña la aplicación es que los p o eso es puedan au en i ica se en la
he amien a desde cualquie luga ( e Figu a 3) y c ea una pa ida.
Figu a 3 UML de inicio de sesión
Las pa idas pod án se accedida po los alumnos que el p o eso desee y en la echa ijada po el
mismo. Una ez c eada la pa ida ( e Figu a 4) el p o eso habili a á un enlace LTI en el LMS en el
que desa olle su ac i idad docen e
1
.
1
Más adelan e se de alla á como c ea enlaces LTI en los LMS en los que se han ealizado las p uebas.
13
Diseño
13
Figu a 4 UML de c eación de pa idas
Los alumnos pod án accede a la pa ida en la echa es ablecida po el p o eso . Cuando la pa ida
concluya (la pa ida puede es a ac i a desde minu os has a días y inaliza á cuando expi e el
empo izado , o an es si el p o eso decide da la po inalizada manualmen e) las no as de los alumnos
se án en iadas al cuade no de cali icaciones del TC ( e Figu a 5).
Figu a 5 UML de in de pa ida y en ío de cali icaciones
Diseño
14
14
3.2 Análisis de equisi os y especi icaciones
En es e apa ado amos a ealiza un análisis po meno izado de los equisi os que debe cumpli nues a
aplicación. El o ma o es el desc i o a con inuación:
IDENTIFICADOR
Nomb e del equisi o
Dependencias
Desc ipción
Impo ancia
P io idad
Tabla 3 ca ac e ización de los equisi os del Sis ema
Dependencias: Nomb e de el/los equisi os que son necesa ios pa a la implemen ación
de es e equisi o o que es án ín imamen e elacionados.
Desc ipción: Explicación b e e del obje i o a alcanza con ese equisi o.
Impo ancia: Indica el g ado de ele ancia que iene el equisi o pa a el clien e.
P io idad: Indica el g ado de ele ancia que iene el equisi e pa a el desa ollado .
Los equisi os de impo ancia y p io idad a ende án a es posibles alo es o g ados:
Al a: Fundamen al pa a el p oyec o.
Media: sólo se puede omi i en ocasiones donde suponga la eliminación de o o equisi o
de más impo ancia/p io idad.
Baja: Se sugie e pe o no es imp escindible.
3.2.1 Requisi os gene ales
RG-01
Sis ema de c eación y ges ión de he amien as LTI
Dependencias
RT-05
Desc ipción
Se á necesa ia la exis encia de un sis ema que nos pe mi a
inse a , edi a o elimina he amien as LTI.
Impo ancia
Al a
P io idad
Al a
Tabla 4 Requisi o gene al 01 “Sis ema de c eación y ges ión de he amien as LTI”
15
Diseño
15
RG-02
Inicio de sesión
Dependencias
RG-03, RCU-01
Desc ipción
Pa a pode accede a la aplicación web end emos que
iden i ica nos con un nomb e de usua io y con aseña.
Impo ancia
Al a
P io idad
Al a
Tabla 5 Requisi o gene al 02 “Inicio de sesión”
RG-03
Exis encia de supe usua io
Dependencias
RG-02
Desc ipción
Exis i á desde el momen o de inicio de la aplicación un supe
usua io enca gado de la ges ión del es o de usua ios (sal o el
supe usua io el es o end án ol de p o eso ).
Impo ancia
Al a
P io idad
Al a
Tabla 6 Requisi o gene al 03 “Exis encia de supe usua io”
RG-04
C eación de c edenciales LTI
Dependencias
RG-10
Desc ipción
Deben exis i los campos u ilizados pa a la co ec a
comunicación en e la he amien a LTI y el LMS, el pa
cla e/sec e o se án necesa ios pa a la c eación de una pa ida
además de o os campos elacionados con és a.
Impo ancia
Al a
P io idad
Al a
Tabla 7 Requisi o gene al 04 “C eación de c edenciales LTI”
RG-05
Juego
Dependencias
RG-10
Diseño
16
16
Desc ipción
Toda pa ida debe ene un juego, dicho juego se elegi á en el
momen o de c eación de la pa ida, cada juego cuen a con una
se ie de pa áme os, algunos opcionales modi icables y o os
ijos. El juego en cues ión de e mina á en g an medida las
ca ac e ís icas de la pa ida.
Impo ancia
Al a
P io idad
Al a
Tabla 8 Requisi o gene al 05 “Juego”
RG-06
Cali ica usua io
Dependencias
RG-07
Desc ipción
La he amien a LTI debe se capaz de asigna una pun uación a
un alumno y esc ibi lo en el cuade no de cali icaciones del TC.
Impo ancia
Al a
P io idad
Al a
Tabla 9 Requisi o gene al 06 “Cali ica usua io”
RG-07
Ve sión LTI 1.1
Dependencias
RG-06
Desc ipción
La he amien a LTI debe in eg a la e sion 1.1 ya que es la
esponsable del en ío de cali icaciones en e la he amien a y
el LMS.
Impo ancia
Al a
P io idad
Al a
Tabla 10 Requisi o gene al 07 “Ve sión LTI 1.1”
RG-08
Mensajes in o ma i os
Dependencias
RUS-03
Desc ipción
La aplicación debe no i ica al usua io en la medida de lo
posible el esul ado de las ope aciones, an o las que se ealizan
con éxi o como las que p o ocan e o .
17
Diseño
17
Impo ancia
Media
P io idad
Media
Tabla 11 Requisi o gene al 08 “Mensajes in o ma i os”
RG-09
A anque de la aplicación
Dependencias
RFIA-05
Desc ipción
Cuando el se ido a anca debe comp oba se si exis en en la
base de da os las ablas necesa ias pa a el co ec o
uncionamien o de la aplicación, si no exis en se c ean, ambién
debe comp oba se si exis e alguna pa ida en ma cha y einicia
los empo izado es o p ocede a la subida de no as si es
necesa io.
Impo ancia
Al a
P io idad
Al a
Tabla 12 Requisi o gene al 09 “A anque de la aplicación”
RG-10
Con igu ación de pa idas
Dependencias
RG-04, RG-05, RG-07
Desc ipción
Los pa áme os que engan las pa idas debe án se :
Nomb e de la pa ida
Selección de juego
Fiche o de p egun as
Cla e de en ega
Cla e
Pa áme os ijos
Pa áme os a iables
Sec e o
Nº de Repe iciones
Habili a
En ío de cali icación
Fecha de inicio
Diseño
24
24
RCU-20
Modo Tes
Dependencias
RN-01
Desc ipción
El p o eso dispond á de un modo es que le pe mi i á
comp oba que la pa ida unciona co ec amen e an es de
habili a la en el LMS y de que los alumnos puedan accede a
ellas.
Impo ancia
Media
P io idad
Media
Tabla 34 Caso de uso 20 “Modo Tes ”
RCU-21
Bo a pa ida
Dependencias
RN-01, RN-02
Desc ipción
El p o eso pod á elimina las pa idas c eadas po él mismo.
Impo ancia
Media
P io idad
Media
Tabla 35 Caso de uso 21 “Bo a pa ida”
RCU-22
Te mina pa ida
Dependencias
RN-01, RN-02
Desc ipción
El p o eso pod á da po inalizada una pa ida en cualquie
momen o pulsando un bo ón.
Impo ancia
Baja
P io idad
Baja
Tabla 36 Caso de uso 22 “Te mina pa ida”
RCU-23
Acceso a he amien a LTI desde LMS
Dependencias
RCU-13
Desc ipción
Tan o el p o eso como el alumno deben pode accede a las
25
Diseño
25
pa idas median e un enlace LTI desde el LMS.
Impo ancia
Al a
P io idad
Al a
Tabla 37 Caso de uso 23 “Acceso a he amien a LTI desde LMS”
El esquema de casos de uso se ían los obse ados en las Figu as 6, 7 y 8.
Figu a 6 P incipales usos del supe usua io
Supe usua io
C ea usua ios Cambia
con aseña Adminis a
juegos
Subi juegos Elimina
juegos Habili a /Desh
abili a Juegos
Ce a sesión Ve pa idas
Diseño
26
26
Figu a 7 P incipales usos del usua io p o eso
Figu a 8 Rol del alumno en he amien a LTI
3.2.2.2 Reglas de negocio
RN-01
Roles de usua ios
Dependencias
RN-02, RG-03
Desc ipción
Exis i án dos ipos de usua ios, el usua io supe usua io y el
usua io p o eso las acciones que pueden lle a a cabo a ían
dependiendo del ipo de usua io y ienen desc i as en las
Figu as 6 y 7
Impo ancia
Al a
P io idad
Media
Tabla 38 Regla de negocio 01 “Roles de usua ios”
P o eso
Subi juegos Cambia
con aseña Pa idas
C ea pa ida Edi a
pa ida Elimina
pa ida In o mación
de la pa ida Te mina
pa ida
Modo es Ce a sesión
Alumno Accede a
pa ida
desde LMS
Realiza el
Juego Ob iene una
cali icación Fin de la
pa ida Cali icación
en el TC
27
Diseño
27
RN-02
P o eso es c eado es de pa idas
Dependencias
RCU-17, RCU-20, RCU-21, RCU-22
Desc ipción
Sólo el p o eso c eado de una pa ida puede ealiza
modi icaciones sob e és a.
Impo ancia
Media
P io idad
Media
Tabla 39 Regla de negocio 02 “P o eso es c eado es de pa ida”
3.2.2.3 Requisi os de conduc a
RC-01
C eación de ablas pa a comunicación LTI
Dependencias
RI-02
Desc ipción
Se án necesa ias la c eación de ablas en la base de da os que
almacenen la in o mación necesa ia pa a la co ec a
comunicación en e el TC y el TP.
Impo ancia
Al a
P io idad
Al a
Tabla 40 Requisi os de conduc a 01 “C eación de ablas pa a comunicación LTI”
3.2.2.4 Requisi os de in o mación
RI-01
Almacenamien o de usua ios y pa idas
Dependencias
RG-10, RI-02
Desc ipción
La in o mación ela i a a los usua ios almacenada en la
base de da os es:
Nomb e de usua io
Con aseña
Zona ho a ia
Tipo
En cuan o a la usada pa a la c eación de una pa ida es:
Diseño
28
28
Nomb e de la pa ida
Nomb e del juego
Cla e de la pa ida
Fecha de inicio
Fecha de in
Key
Sec e o
Pa áme os ijos
Pa áme os opcionales
Fiche o de p egun as
Habili ación
Subi no a
Núme o de epe iciones
Es ado de la pa ida
Con ado
Impo ancia
Al a
P io idad
Al a
Tabla 41 Requisi os de in o mación 01 “Almacenamien o de usua ios y pa idas”
RI-02
Pa áme os de con igu ación de LTI
Dependencias
RI-01, RC-01
Desc ipción
Se á necesa io almacena en la base de da os la in o mación de
con igu ación de cada he amien a LTI.
Impo ancia
Al a
P io idad
Al a
Tabla 42 Requisi os de in o mación 02 “Pa áme os de con igu ación de LTI”
29
Diseño
29
RI-03
Fiche o de con igu ación
Dependencias
RP-02
Desc ipción
Se u iliza á un iche o de con igu ación llamado
“con ig.p ope ies” que almacena á la con igu ación inicial de
la aplicación. En dicho iche o exis i án los siguien es campos:
Base de da os (con nomb e, usua io y con aseña)
Desc i o de despliegue
Nomb e de la aplicación (debe coincidi con el nomb e
del di ec o io que la con iene)
Di ec o io donde se aloja án los juegos en el se ido
Di ec o io empo al donde se almacena á el juego
comp imido
Impo ancia
-
P io idad
Al a
Tabla 43 Requisi os de in o mación 03 “Fiche o de con igu ación”
3.2.3 Requisi os no uncionales
3.2.3.1 Fiabilidad
RFIA-01
E o du an e c eación, edición y eliminación de una pa ida o
juego
Dependencias
RG-08
Desc ipción
En la medida de lo posible se p ocu a á que cuando haya un
e o de algún ipo se uel a al es ado p e io an es del e o .
Impo ancia
Al a
P io idad
Al a
Tabla 44 Requisi os de iabilidad 01 “E o du an e c eación, edición y eliminación de una pa ida o
juego”
RFIA-02
Ve i icación de campos
Dependencias
RG-10
Diseño
30
30
Desc ipción
Se obliga á al usua io a ellena los campos conside ados como
imp escindibles an o a la ho a de c ea una pa ida como a la
ho a de subi un juego.
Impo ancia
Media
P io idad
Media
Tabla 45 Requisi os de iabilidad 02 “Ve i icación de campos”
RFIA-03
Nomb e de pa idas y/o juegos
Dependencias
RG-08
Desc ipción
Se impedi á la c eación de pa idas si ya exis e una con el
mismo nomb e, del mismo modo ampoco se pod á subi un
juego si ya exis e en el se ido .
Impo ancia
Al a
P io idad
Al a
Tabla 46 Requisi os de iabilidad 03 “Nomb e de pa idas y/o juegos”
RFIA-04
Selección co ec a de echa y ho a
Dependencias
RG-10
Desc ipción
El sis ema se asegu a á de que la echa y ho a es ablecidos sean
co ec os, no pe mi i á echas de inicio pos e io es a las de
cie e ni es ablece una echa de inicio an e io al momen o
ac ual. Todo ello se ha á eniendo en cuen a la zona ho a ia del
usua io que con igu a la pa ida.
Impo ancia
Baja
P io idad
Baja
Tabla 47 Requisi os de iabilidad 04 “Selección co ec a de echa y ho a”
RFIA-05
Reinicio de pa idas po eca ga de con ex o
Dependencias
RG-09
Desc ipción
Si el se ido cae o se p oduce una eca ga en el con ex o la
31
Diseño
31
aplicación se enca ga á de einicia las pa idas que es u ie an
en cu so y de subi las no as de las pa idas que hubie an
inalizado du an e la caída del se ido .
Impo ancia
Media
P io idad
Baja
Tabla 48 Requisi os de iabilidad 05 “Reinicio de pa idas po eca ga de con ex o”
3.2.3.2 Usabilidad
RUS-01
Manual de ins alación
Dependencias
-
Desc ipción
Se p op ociona á un manual de ins alación jun o con la
aplicación.
Impo ancia
Al a
P io idad
Media
Tabla 49 Requisi os de usabilidad 01 “Manual de ins alación”
RUS-02
Manual de usua io
Dependencias
-
Desc ipción
Se p opo ciona á un manual de usua io jun o con la aplicación.
Impo ancia
Al a
P io idad
Media
Tabla 50 Requisi os de usabilidad 02 “Manual de usua io”
RUS-03
Indicaciones de uso
Dependencias
RG-08
Desc ipción
Se p opo ciona á in o mación al usua io du an e la c eación,
eliminación o edición de una pa ida, ambién se da án pau as a
la ho a de adminis a juegos.
Diseño
32
32
Impo ancia
Media
P io idad
Baja
Tabla 51 Requisi os de usabilidad 03 “Indicaciones de uso”
RUS-04
Fiche o de p egun as
Dependencias
RG-10
Desc ipción
El usua io debe á de subi un iche o con las p egun as que
se án ca gadas po el juego.
Impo ancia
Al a
P io idad
Media
Tabla 52 Requisi os de usabilidad 04 “Fiche o de p egun as”
3.2.3.3 Man enibilidad
RM-01
Reu ilización
Dependencias
-
Desc ipción
Las pa idas debe án pode edi a se pa a ealiza se las eces que
se quie an cambiando cualquie a de los pa áme os disponibles.
An es de eu iliza una pa ida ya c eada es con enien e
elimina las cali icaciones inculadas a esa pa ida an es de su
eu ilización.
Impo ancia
Media
P io idad
Media
Tabla 53 Requisi o de Man enibilidad 01 “Reu ilización”
3.2.3.4 Po abilidad
RP-01
Base de da os
Dependencias
RI-02, RT-03
Desc ipción
El sis ema debe pode sopo a MySQL y SQLi e..
33
Diseño
33
Impo ancia
Baja
P io idad
Baja
Tabla 54 Requisi o de Po abilidad 01 “Base de da os”
RP-02
Se ido
Dependencias
RI-03
Desc ipción
Debe pode cambia se el desc ip o de despliegue, de usua io y
la u a donde se almacena án los juegos.
Impo ancia
Al a
P io idad
Al a
Tabla 55 Requisi o de Po abilidad 02 “Se ido ”
3.2.3.5 Segu idad
RS-01
Con ol de acceso
Dependencias
RS-03
Desc ipción
Se en a á a la aplicación median e una combinación de nomb e
de usua io y con aseña.
Impo ancia
Al a
P io idad
Al a
Tabla 56 Requisi o de Segu idad 01 “Con ol de acceso”
RS-02
Cambio de con aseña
Dependencias
-
Desc ipción
Todos los usua ios pueden cambia su con aseña.
Impo ancia
Al a
P io idad
Al a
Tabla 57 Requisi o de Segu idad 02 “Cambio de con aseña”
RS-03
Codi iciación de con aseña
Diseño
40
40
Todas las ablas de la Figu a 10 cuyos nomb es comiencen po “l i” (l i_use , l i_con ex …) con ienen
in o mación ela i a a la comunicación en e nues o TP y el TC en el que se implemen a nues a
he amien a. Los pa áme os más impo an es pa a que dicha comunicación pueda lle a se a cabo son:
consume _key: as la c eación de una pa ida es e pa áme o es a á o mado po los campos
“Nomb e de la pa ida” + “_” + “Cla e”. Debe á coincidi con el campo “Tecla”
3
de nues o
TC.
l i_ esou ce_id: iden i icado de la pa ida en el TC.
use _id: iden i icado del usua io en el TC.
sec e : pa áme o con igu able del TC que debe coincidi con el campo “sec e ” de nues a
pa ida.
Los pa áme os más impo an es de nues a aplicación web se hallan en la abla “pa idas” de la Figu a
10 y son los siguien es:
pa idaname: nomb e de la pa ida.
gamename: nomb e del juego.
deli e yPasswo d: cla e de acceso a la pa ida.
echa_inicio: echa de inicio de la pa ida.
echa_ in: echa de in de la pa ida.
key: cla e pa a comunicación con el TC.
sec e : sec e o pa a comunicación con el TC.
ijos: pa áme os ijos del juego. No modi icables desde el menú de con igu ación de las
pa idas.
opcionales: pa áme os a iables del juego con igu ados po el c eado de la pa ida.
p egun as: p egun as que usa á el juego pa a la e aluación de los alumnos.
enable: booleano que ale uno cuando la he amien a LTI es á habili ada
ou come: booleano que ale uno cuando el en ío de cali icaciones es á habili ado
epea : núme o de in en os que iene un alumno pa a epe i una pa ida.
s a us: in o ma sob e el es ado de la pa ida (ac i a o inalizada). Usado en la eac i ación de
los empo izado es en caso de eca ga de con ex o o caída del se ido .
coun : con ado u ilizado pa a sabe la úl ima ez que una pa ida ha sido modi icada y
desac i a el an e io Time pa a ac i a uno nue o.
4
Los usua ios egis ados en la aplicación se encuen an en la abla “use s” de la Figu a 10 y sus
3
Aunque ealmen e ecibe es e nomb e en el TC, lo más p obable es que se a e de un e o de aducción.
4
Es impo an e eco da que cada ez que una pa ida es edi ada el empo izado que con ola la du ación de la misma es eac i ado con las
nue as echas.
41
Diseño
41
campos son los siguien es:
use name: nomb e del usua io en la aplicación.
pass: con aseña de acceso a la aplicación.
imeZone: zona ho a ia del usua io.
ype: ipo de usua io (p o eso o supe usua io).
La elación en e las pa idas y los usua ios c eado es de las mismas se almacenan en la abla
“pa idas_use s” de la Figu a 10.
Los juegos subidos a la aplicación web se encuen an en la abla “games” de la Figu a 10. Sus campos
son:
ijos: pa áme os ijos del juego. No modi icables desde el menú de con igu ación de las
pa idas.
opcionales: pa áme os a iables del juego con igu ados po el c eado de la pa ida.
id: iden i icado del juego.
enable: uno cuando el juego es á habili ado, ce o en caso con a io.
3.3.2 Comunicación en e los juegos y la aplicación web
Como ya se ha mencionado cada pa ida debe ene un juego. También hemos explicado an e io men e
que los juegos deben subi se al se ido en o ma o zip y que dicho zip debe con ene dos a chi os:
A chi o HTML “juga ”: con end á el juego en cues ión. Siemp e debe á llama se “juga ”.
A chi o de ex o “p ope ies”: con end á las p opiedades o pa áme os de con igu ación del
juego en cues ión (núme o de p egun as, o den de és as…). Siemp e debe á llama se
“p ope ies”.
En el esquema del sis ema de la Figu a 9 puede obse a se que el juego es un i ame inse ado en una
página JSP. La comunicación en e el juego y la he amien a LTI que lo implemen a puede obse a se
en la Figu a 11 y comp ende las siguien es e apas:
1. Si el usua io iene acceso al juego se inicia la ca ga del mismo. Cuando es é o almen e ca gado
se lo ha á sabe a nues a he amien a.
2. Una ez la he amien a ecibe que el juego se ha ca gado, manda los pa áme os de
con igu ación
5
es ablecidos po el p o eso du an e la c eación/edición de la pa ida. Es os
pa áme os se ob ienen de la base de da os.
3. El juego p ocesa la in o mación suminis ada po la he amien a y se con igu a en
consecuencia. Una ez con igu ado, se au oen ía a nues a he amien a LTI y el alumno pod á
comenza a juga .
5
Los pa áme os de con igu ación a ia án en unción del juego seleccionado
Diseño
42
42
4. Cuando el juego inaliza se manda un mensaje a la he amien a de “ in de juego”. Además de
indica nos el inal de la pa ida es e mensaje nos dice cual es la máxima pun uación
alcanzable y los e o es y acie os que ha enido el alumno. Es a in o mación es pasada a un
Se le enca gado de calcula la pun uación ob enida
6
po el alumno y almacena la en la base
de da os.
Figu a 11 Comunicación en e he amien a LTI y juegos
6
Pa a el cálculo de las no as se hace una ponde ación sob e diez.
43
Implemen ación
43
4 IMPLEMENTACIÓN
n el apa ado an e io se ha desc i o de o ma esumida el uncionamien o básico de la aplicación.
el obje i o de es e capí ulo es explica cómo es es o posible. Pa a ello se mos a á la o ganización
del so wa e y se analiza á de o ma b e e y concisa las pa es más impo an es del mismo, po
úl imo, se mos a á la in e az de usua io que p esen a la aplicación.
4.1 Código
Figu a 12 Es uc u a de di ec o ios de la aplicación
Siguiendo la es uc u a de iche os del p oyec o podemos clasi ica el código en:
Documen ación
Clases
E
Implemen ación
44
44
Lib e ías
Fiche os Ja aSc ip
Fiche os JSP
Fiche os HTML y CSS
Base de da os
Fiche o de con igu ación
Desc ip o de despliegue
Juegos
Con el obje i o de simpli ica la desc ipción de nues a aplicación web diseña emos un mapa de
na egación donde se mues an odas las páginas/se le s con enlaces al es o de páginas/se le s que
son accesibles desde cada una de ellas. El mapa a ia á en unción del ol del usua io, así si es
supe usua io, el mapa se á el de la Figu a 13. Si po el con a io el usua io es de ipo p o eso el mapa
se á el de la Figu a 14. Po úl imo, el acceso po pa e de un alumno desde el TC se mues a en el
mapa de la Figu a 15.
Figu a 13 Mapa Web de supe usua io
cabece a.jsp - menu.jsp
pa idas.jsp
usua ios.jsp
adduse .jsp AddUse Se le .ja a
Dele eUse Se le .ja a
changepass.jsp ChangePasswo dSe le .j
a a
juegos.jsp
uploadgame.jsp UploadSe le .ja a
Selec GameSe le
login.jsp LoginSe le .ja a
elogin.jsp
cabece a.jsp - menu.jsp
45
Implemen ación
45
Figu a 14 Mapa Web de usua io p o eso
Figu a 15 Mapa Web de usua io alumno
cabece a.jsp - menu.jsp
pa idas.jsp
c ea pa ida.jsp Edi P ojec Se le .j
a a pa idas.jsp
in op ojec .jsp
Dele eP ojec Se le
.ja a
edi pa ida.jsp Edi P ojec Se le .j
a a pa idas.jsp
es pa ida.jsp Tes S uden .jsp
Dele eNo as.ja a
changepass.jsp ChangePasswo dSe
le .ja a
juegos.jsp uploadgame.jsp UploadSe le .ja a
login.jsp LoginSe le .ja a
elogin.jsp
cabece a.jsp-menu.jsp
Launch.ja a
pass.jsp passSe le .ja a S uden .jsp
S uden .jsp
E o App.jsp
No aSe le .ja a
Implemen ación
46
46
4.1.1 Documen ación
En el CD/DVD p opocionado jun o a la memo ia se incluye un di ec o io de nomb e “doc” que incluye
la documen ación del p oyec o ealizado. En ella se desc ibe b e emen e cada uno de los mé odos y
clases u ilizados.
4.1.2 Clases
En es e apa ado se comen a án las clases más ele an es pa a el uncionamien o de la aplicación,
dichas clases se encuen an con enidas en el paque e es.us.di .l i. Las clases de los paque es
o g.oscelo .l i.x.x ambién son imp escindibles pa a el uncionamien o de la misma pe o pueden se
consul adas desde la API [28], aunque como ya se dijo an e io men e es a lib e ía ue modi icada po
F ancisco José Fe nández Jiménez pa a co egi algunos e o es. Puede ob ene se más in o mación de
cada una de las clases exis en es en la documen ación p opo cionada.
AppLoade
Clase que se ejecu a con el a anque de la aplicación en el se ido , c ea á las ablas necesa ias en la
base de da os si no exis en. Es a clase se usa en el a anque pa a e i ica y es ablece los pa áme os
de inicios necesa ios pa a el co ec o uncionamien o de la aplicación.
Si el se ido se cae o se p oduce una eca ga del con ex o es a clase comp oba á el es ado de las
pa idas. Si la pa ida aún no ha inalizado eac i a á el empo izado asociado a dicha pa ida (llamada
a clase My ime , desc i a más adelan e). Si la pa ida inalizó cuando el se ido es aba caído
p ocede á al en ío inmedia o de las cali icaciones almacenadas en la base de da os al TC.
DAO
Clase u ilizada en cualquie a de los accesos a la base de da os po pa e de la aplicación. En e los
mé odos más ele an es de los que dispone se encuen an los de ges ión y adminis ación de usua ios,
pa idas y juegos.
Db
Se encuen an los mé odos necesa ios pa a la c eación e inicialización de la base de da os, así como
los que pe mi en su conexión con és a.
LoginSe le
Se le u ilizado a la ho a de inicia sesión en la aplicación.
Edi P ojec Se le
Usado en la c eación/edición de pa idas. Cada ez que una pa ida es c eada o edi ada es e se le
además de almacena la nue a in o mación en la base de da os median e el uso de mé odos de la clase
DAO, inicia un empo izado , cuando es e expi a se da á po concluida la pa ida.
MyTime
Es la clase enca gada de ges iona la du ación de una pa ida, cuando és a inaliza se ejecu a á un
47
Implemen ación
47
algo i mo que de e mina á las cali icaciones de qué pa ida y de qué alumnos han de se subidas al
cuade no de cali icaciones del TC.
P ojec Bean, Use Bean y Games
Es as es clases clases con ienen la siguien e in o mación:
P ojec Bean: Con iene odas las a iables y mé odos ela i os a una pa ida.
Use Bean: Con iene odas las a iables y mé odos ela i os al usua io.
Games: Con iene odas las a iables y mé odos ela i os a un juego.
Fil e s
Todas las clases que engan el su ijo “Fil e ” son usadas pa a que en el momen o de hace una pe ición
con la in ención de accede a una zona conside ada como de acceso es ingido –y con acceso
es ingido nos e e imos a aquellas zonas no accesibles po cualquie usua io- sea in e cep ada pa a
e i ica si el usua io iene pe misos pa a accede al ecu so solici ado.
UploadSe le
Se enca ga de la subida y descomp esión de los juegos al se ido , una ez el juego ha sido
descomp imido y almacenado co ec amen e el a chi o comp imido es eliminado.
Selec GameSe le
Se enca ga de ges iona la habili ación de los juegos. Cuando el supe usua io desea
habili a /deshabili a uno o más juegos se llama a es e se le .
No aSe le
Enca gado de calcula la no a de los alumnos. Recibe como pa áme o los pun os o ales de una pa ida
y los ob enidos po el alumno. Realiza una ponde ación sob e diez y gua da la no a en la base de da os.
Launch
Cuando el usua io del LMS hace click en el enlace LTI es a clase es in ocada median e un mé odo
POST.
Lo p ime o que hace es ob ene los da os asociados al p oyec o a pa i de la cla e que ha
ecibido. A con inuación, se gene an a ibu os de sesión asociados a cada uno de los da os que ha
ob enido. De es a mane a se pod á accede a las p opiedades de la he amien a desde cualquie
pa e en la aplicación sin necesidad de lee iche os ni de accede a la base de da os. Po úl imo,
se inicializan las ablas de los da os LTI -c eándolas si no exis en- y se gene a un obje o
ToolConsume al que se le asocian una se ie de pa áme os (cla e, sec e o, habili ación y
nomb e) un obje o ToolP o ide con los pa áme os necesa ios y se llama al mé odo execu e()
del obje o.
Implemen ación
48
48
Tes 2Ex e nS a icFolde
Los juegos y los iche os que és e equie e pa a unciona se encuen an en una pa e del se ido no
accesible median e URL. Si el usua io iene pe miso pa a accede a la pa ida es a clase en ía los
iche os pa a que el juego pueda ejecu a se. De es a o ma se impide que cualquie usua io pueda
accede a ellos poniendo una di ección URL en su na egado .
4.1.3 Lib e ías
Las lib e ías u ilizadas en es e p oyec o son:
Figu a 16 Lib e ías usadas en el p oyec o
commons-cli-1.2.ja
Lib e ía u ilizada pa a el análisis de pa áme os con los que el usua io inicia la aplicación.
commons-codec-1.10.ja
Con iene codi icaco es y decodi icaco s simples pa a a ios o ma os, como Base64 y Hexadecimal.
commons- ileupload-1.3.3.ja
Usado pa a ca ga a chi os a Se le s y aplicaciones web.
49
Implemen ación
49
commons-io-2.5.ja
En e algunas de sus aplicaciones se encuen an el il ado y compa ación de a chi os, an o mación
a endian y mucho más.
commons-lang3-3.6.ja
Usado en las clases de la je a quía ja a.lang.
commons-logging-1.2.ja
O ece una in e az común pa a c ea egis os logs.
luen -hc-4.5.3.ja
APIs pa a in e aces H pClien .
gson-2.8.2.ja
Pe mi e la se ialización y dese ialización en e obje os Ja a y su ep esen ación en no ación JSON.
h pclien -4.5.3.ja
O ece una API HTTP clien e simpli icada pa a ope aciones de ipo XMLH pReques usada po los
na egado es.
h pclien -cache-4.5.3.ja
P opo ciona una capa de almacenamien o en caché compa ible con HTTP/1.1 pa a se u ilizada con
H pClien .
h pclien -win-4.5.3.ja
Funcionalidad especí ica de H pClien pa a Windows.
h pco e-4.4.8.ja
Usado pa a c ea se icios HTTP del lado del clien e y del se ido con un impac o mínimo.
jdom-2.0.6.ja
Usado pa a manipulaciones de da os XML op imizados pa a Ja a.
jna-4.1.0.ja
P opo ciona un ácil acceso a las biblio ecas de Ja a na i as compa idas sin usa la in e az na i a de
Ja a.
joda- ime-2.9.9.ja
U ilizada pa a la con e sión de zona ho a ia.
mysql-connec o -ja a-5.1.40-bin.ja
U ilizada pa a conec a con base de da os MySQL.
oau h-20100527.ja
U ilizada pa a i ma los paque es que se en ían desde el TP al TC. Apo a segu idad.
se le -api-3.1.ja
U ilizada pa a la in eg ación de los Se le s de nues o p oyec o.
sqli e-jdbc-3.20.1.ja
U ilizada pa a conec a con base de da os SQLi e.
Implemen ación
56
56
pa idas
Página que mues a un lis ado con odas las pa idas que un usua io ha c eado. En es a página además
los p o eso es pod án elegi en e e in o mación de una pa ida, edi a la, bo a la, inaliza la,
elimina las no as asociadas o p oba las median e el modo es . Ve Figu a 25.
Figu a 25 Menú de pa idas
es pa ida
Modo de p uebas solo accesible po p o eso es pa a comp oba que la pa ida unciona co ec amen e.
En es e modo el en ío de cali icaciones es á deshabili ado. Ve Figu a 26.
Figu a 26 Menú del modo Tes
57
Implemen ación
57
uploadgame
Página desde la que se suben los juegos. Todos los usua ios pod án subi juegos
7
, pa a ello debe án
subi se en o ma o .zip y elegi un nomb e con el que se almacena á en el se ido . Ve Figu a 27.
Figu a 27 Menú de subida de juegos
E o App
Página mos ada cuando hay algún e o en la comunicación en e el TP y el TC.
login
Página usada pa a inicia sesión en la aplicación. Ve Figu a 28.
Figu a 28 Menú de inicio de sesión a la aplicación
7
Cuando un juego se sube al se ido és e es a á habili ado po de ec o.
Implemen ación
58
58
logou
Página usada pa a ce a sesión.
Pass
Página en la que el alumno end á que in oduci una cla e pa a accede a una pa ida, sólo se mues a
si la pa ida equie e de una con aseña pa a pode accede a ella.
Relogin
Página mos ada cuando las c edenciales pa a inicia sesión in oducidas son in álidas. Ve Figu a
29.
Figu a 29 C edenciales de inicio de sesión in álidas
S uden
Página mos ada cuando un alumno accede a la he amien a LTI. Se compone de una página JSP en
la que se inse a un i ame, dicho i ame se á el juego. El juego se á mos ado siemp e y cuando el
alumno que quie a accede a él enga los pe misos necesa ios. Ve Figu a 30.
Figu a 30 In e az de juego ipo es
59
Implemen ación
59
En caso de no con a con las c edenciales necesa ias pa a su acceso es a página mos a á un mensaje
indicándole po qué no se le pe mi e en a al juego. En la Figu a 31 el alumno ha sob epasado el
núme o de in en os es ablecidos po el p o eso .
Figu a 31 Mensaje indicando que se han sob epasado el lími e de in en os
En la Figu a 32 el alumno no puede accede a la pa ida po que es á ue a del plazo de la echa
es ablecida pa a esa pa ida.
Figu a 32 Mensaje indicando que la pa ida no es á disponible en es e momen o.
Tes S uden
Es a página es solo accesible po el p o eso y es la usada pa a p oba el co ec o uncionamien o de
una pa ida. Se mues a siemp e el juego seleccionado du an e la con igu ación de la pa ida sin
necesidad de in oduci c edenciales de ningún ipo. En es a página no se p oduce la e aluación de la
pe sona que ealiza el juego. La in e az es la misma que la obse ada en la Figu a 30.
No a: Es impo an e acla a en es e pun o que las echas pod ían mos a se con un o ma o dis in o a
los mos ados en las imágenes pues o que son de ipo “da e ime-local” y na egado es como Fi e ox a
echa del 27/07/2018 aún no lo han implemen ado. Las imágenes han sido cap u adas usando el
na egado Google Ch ome en su e sión 67.0.3396.99.
4.1.5 Fiche o de con igu ación: con ig.p ope ies
El iche o de con igu ación usado en el p oyec o es el siguien e:
Tabla 69 iche o con ig.p ope ies
dbHos : Equipo en el que se encuen a el se ido de bases de da os, como puede ap ecia se
se es á u ilizando el d i e pa a pode ealiza la conexión con SQLi e.
Implemen ación
60
60
dbName: Nomb e de la base de da os usada en el p oyec o.
zipPa h: Ru a donde se almacena á el iche o comp imido con el juego. Realmen e es e
iche o es empo al pues o que en el momen o en el que el juego sea descomp imido és e se á
eliminado.
gamePa h: di ec o io del se ido donde se almacena án los juegos una ez
descomp imidos.
dbUse name: usua io con el que se accede a la base de da os.
dbPasswo d: con aseña del usua io con el que se accede a la base de da os.
oo Pa h: di ec o io aíz del p oyec o.
4.1.6 Desc ip o de despliegue
Tabla 70 Desc ip o de despliegue
4.1.7 Fiche os Ja aSc ip
4.1.7.1 Fiche os usados pa a la c eación de pa idas
Se encuen an en la ca pe a Resou ces del p oyec o. Son los siguien es:
<?xml e sion="1.0" encoding="UTF-8"?>
<web-app xmlns:xsi="h p://www.w3.o g/2001/XMLSchema-ins ance" xmlns="h p://ja a.sun.com/xml/ns/ja aee"
xsi:schemaLoca ion="h p://ja a.sun.com/xml/ns/ja aee h p://ja a.sun.com/xml/ns/ja aee/web-app_2_5.xsd"
e sion="2.5">
<lis ene >
<lis ene -class>es.us.di .l i.AppLoade </lis ene -class>
</lis ene >
<se le -name>Ex e nS a icFolde </se le -name>
<se le -class>es.us.di .l i.Ex e nS a icFolde Se le </se le -class>
<ini -pa am>
<desc ip ion>Pa h o ex e n olde o se e</desc ip ion>
<pa am-name>Ex e nFolde </pa am-name>
<pa am- alue>/ mp</pa am- alue>
</ini -pa am>
</se le >
<se le -mapping>
<se le -name>Ex e nS a icFolde </se le -name>
<u l-pa e n>/ex e n/*</u l-pa e n>
</se le -mapping>
<se le >
<se le -name>Games</se le -name>
<se le -class>es.us.di .l i.Launch</se le -class>
</se le >
<se le -mapping>
<se le -name>Games</se le -name>
<u l-pa e n>/games</u l-pa e n>
</se le -mapping>
<welcome- ile-lis >
<welcome- ile>404.h ml</welcome- ile>
</welcome- ile-lis >
<e o -page>
<e o -code>404</e o -code>
<loca ion>/404.h ml</loca ion>
</e o -page>
<e o -page>
<excep ion- ype>ja a.lang.Th owable</excep ion- ype>
<loca ion>/excep ion.h ml</loca ion>
</e o -page>
</web-app>
61
Implemen ación
61
c ea pa ida
Funciones Ja aSc ip o ECMASc ip usadas du an e la c eación y edición de pa idas. En e sus usos
es á comp oba que se ha elegido un juego álido, y que, en el caso de habe lo hecho, se haga una
pe ición AJAX al se ido pa a que se ca guen los pa áme os de con igu ación ( ijos y opcionales)
del juego. También se usa pa a alida que la echa y ho a en las que se habili a á la pa ida es án
pe mi idas. Un ejemplo de echa no álida se ía aquella en el que el inicio de la pa ida ue a pos e io
a la echa de cie e.
o mCheck
Funciones usadas pa a la alidación de los campos del o mula io du an e la edición y c eación de las
pa idas..
4.1.7.2 Fiche os usados pa a comunicación en e la he amien a y el juego
En es e apa ado desc ibi emos las unciones Ja aSc ip que hacen posible la comunicación en e la
he amien a y el juego. Es e p oceso de comunicación ue desc i o an e io men e en el pun o 3.3.2.
en io- a iables.jsp
Recoge los pa áme os de con igu ación del juego de la base de da os y se los en ía (es os pa áme os
ue on es ablecidos po el p o eso du an e la c eación de la pa ida). Cuando ecibe po pa e del juego
el mensaje de in, ecoge los esul ados de la pa ida y los en ía usando AJAX a No aSe le .
Como puede ap ecia se “en io- a iables” es un jsp pues o que inco po a código ja a pa a la ob ención
de pa áme os de la base de da os y hace uso de Ja aSc ip pa a comunica se con el juego y en ia
in o mación de la pa ida a un se le que la p ocesa y es ablece una cali icación.
comunicacion
Desa ollado po Jesús Muñoz Calle. Es el enca gado de a isa nos cuando el juego es á ca gado po
comple o (pun o 1 de la Figu a 11) y p ocesa los da os de con igu ación en iados po nues a
aplicación pa a que el juego dé comienzo (pun o 3 Figu a 11).
4.1.8 A chi os de e o
En es a pa e se han eu ilizado los mensajes de e o desa ollados po F ancisco José Fe nádez
Jiménez, po lo que se ha á una b e e mención a cada uno de ellos sin en a mucho en de alles.
Cuando se p oduzcan algunos e o es de e minados el na egado mos a á los siguien es mensajes:
Si ocu e una excepción no con olada se mos a á el a chi o excep ion.h ml
Si in en amos accede a la he amien a desde el TC median e una pe ición GET en luga de
POST –el es ánda equie e del uso de és as úl imas pa a su uncionamien o- se mos a á
E o Ge .h ml
Cuando se da algún o o ipo de e o en la he amien a se mues a un mensaje con el e o
pe inen e. Po ejemplo si una página solici ada no se encuen a en el se ido se de ol e á
e o 404 no ound. El iche o es E o App.jsp
Implemen ación
62
62
4.1.9 Fiche os CSS
Se han eu ilizado los diseñados po F ancisco José Fe nández Jiménez.
E o : Usado en los mensajes de e o a iba expues os.
Fo m: Usado pa a da o ma o a los o mula ios de la aplicación
4.2 O as uncionalidades
Has a aho a hemos explicado que nues a aplicación web gene a he amien as LTI que pueden se
in eg adas en di e en es LMS. Es as he amien as son con igu adas po usua ios con ol de p o eso y
eciben el nomb e de “pa idas”. Cada pa ida inco po a á un juego al que accede án los alumnos.
También hemos hablado del ca ác e au oco ec o de las pa idas y de la subida au oma izada de
cali icaciones a la pla a o ma de enseñanza i ual donde se implemen an es as he amien as.
En es e pun o habla emos sob e algunas uncionalidades ex as que si bien no son undamen ales,
do an de mayo e sa ilidad a nues a aplicación y o ecen una mejo expe iencia de usua io.
4.2.1 Elimina usua ios
Al igual que con los juegos, el supe usua io pod á bo a al es o de usua ios. Cuando un usua io es
bo ado odas las pa idas c eadas po él son eliminadas. El mismo caso es aplicable a los juegos,
si un juego es eliminado cualquie pa ida que lo con u ie a es eliminada.
4.2.2 Bo ado de no as
Si el p o eso lo desea puede bo a odas las cali icaciones asociadas a una pa ida con solo pulsa el
bo ón “BORRAR NOTAS” de la Figu a 25.
No a: Las cali icaciones se án bo adas an o de la base de da os como de la pla a o ma de enseñanza
i ual en la que es é implemen ada la pa ida.
4.2.3 Con ol ho a io
Du an e la c eación de un usua io (Figu a 17) pod á con igu a se la zona ho a ia a la que pe enece.
La aplicación se enca ga á de la con e sion ho a ia en e las dis in as zonas. De es a o ma un p o eso
que esida en Cana ias y enga alumnos en la península al pone que una pa ida comience a las 14:00
h és a es a á disponible pa a los alumnos a pa i de las 15:00 h ho a io peninsula .
4.2.4 Te mina pa ida
Aunque las pa idas inalizan en un plazo de e minado con igu ado po el p o eso , és e puede
e mina la en cualquie momen o si así lo desea pulsando el bo ón “TERMINAR PARTIDA” de la
Figu a 25.
63
P uebas de ejecución
63
5 PRUEBAS DE EJECUCIÓN
as p uebas ealizadas han sido nume osas. Si bien es cie o que el p oyec o ha ido inco po ando
uncionalidades y nue as medidas de segu idad con el paso del iempo -lo que supone modi ica
el código en nume osas ocasiones y po an o mayo posibilidad de allos y de pasa alguna
si uación po al o- se ha p ocu ado que con cada cambio ealizado se hicie an p uebas pa a e i ica
que odo uncionaba co ec amen e. En es e pun o a a emos p incipalmen e algunas de las p uebas
ealizadas, p oblemas encon ados, los LMS u ilizados en es e p oyec o y las p uebas de segu idad.
Todos los aspec os aquí a ados han sido explicados an e io men e en el apa ado de implemen ación.
En es e pun o con i ma emos median e p uebas que el p og ama esponde sa is ac o iamen e a lo
desc i o y algunos de los p oblemas que puede mos a el p og ama bajo cie as ci cuns ancias.
5.1 LMS u ilizados
Es e p oyec o ha sido p obado en Cou seSi es [12] en su e sión 9.1 del cua o imes e de 2017 y
Moodle [14] en su e sión 3.5.
5.1.1 Cou seSi es
Los ca ac e ís icas más ele an es que nos han hecho decan a nos po es e LMS son:
G a ui o.
Pe mi e la c eación de cu sos.
Pe mi e la in eg ación de enlaces LTI.
Pe sonalizable (diseños, cu sos…).
Con iene panel de cali icaciones.
Núme o ilimi ado de cu sos.
Pe mi e in i a alumnos a cu sos median e un mensaje de co eo elec ónico de o ma g a ui a.
No iene lími es de alumnos en los cu sos.
Pe mi e inco po a p o eso es in i ados a los cu sos.
Muy popula , ampliamen e es eado y con sopo e écnico.
5.1.2 Moodle
Hemos usado un hos ing g a ui o llamado MoodleCloud, usado po pa icula es o pequeñas
ins i uciones. Moodle dispone de hos ings de pago que o ecen más se icios.
G a ui o y de código abie o.
Pe mi e la c eación de cu sos.
Pe mi e la in eg ación de enlaces LTI.
Pe sonalizable (pe mi e pe sonaliza diseños, cu sos… de la dis ibución es ánda de Moodle).
L
P uebas de ejecución
64
64
Con iene panel de cali icaciones.
Núme o de cu sos ilimi ados.
Pe mi e in i a alumnos a cu sos median e un mensaje de co eo elec ónico de o ma g a ui a.
Máximo cincuen a usua ios en o al.
doscien os Mb de espacio en disco.
Cuen a con BigBlueBu on, que pe mi e ealiza con e encias con has a seis pe sonas al mismo
iempo. Dispone de una zona donde pueden ealiza se encues as y dispone de una piza a
i ual isible y edi able po el es o de usua ios.
Muy popula , ampliamen e es eado y con sopo e écnico.
Aunque la e sión usada de Moodle se encuen a algo más limi ada que la de Cou seSi es po el hecho
de se g a ui a, nos in e eseaba u iliza o o LMS pa a asegu a nos que el es ánda u ilizado espondía
bien a o os TC. Además, Jesús Muñoz Calle –au o de los juegos- u iliza es a pla a o ma en su día a
día como p o esional de la docencia y pod ía usa en un u u o es a he amien a con sus alumnos.
No a: Du an e las p uebas se ad i ió que con e siones desac ualizadas de Moodle ( e sión 2.9 de
2015) el es ánda p esen aba p oblemas y la comunicación en e la he amien a y el LMS no e a
posible. Pa a ga an iza el uncionamien o de la aplicación en es e LMS no se ecomienda usa
e siones an e io es a la 3.5 ( e sión con la que se han ealizado las p uebas con esul ados
sa is ac o ios).
5.2 P uebas de uncionamien o ealizadas y o os da os de in e és
Las p uebas que se han ealizado y han dado esul ados sa is ac o ios han sido:
C eación y eliminación de usua ios. No se pe mi i á la exis encia de dos usua ios con el mismo
nomb e y se mos a á un mensaje de e o .
C eación, Edición y Eliminación de pa idas. El sis ema impide la c eación de dos pa idas con
el mismo nomb e y no i ica al usua io del e o median e un mensaje.
Subida, Habili ación/Deshabili ación y eliminación de juegos. El sis ema no pe mi e la subida
al se ido de dos juegos con el mismo nomb e y no i ica á al usua io con un mensaje de e o .
Tampoco se á posible subi un juego al se ido sin da le nomb e.
Modo Tes . Se ha comp obado que el p o eso puede accede a la pa ida con igu ada an es
de publica la y de que no iene que pasa po ningún ipo de con ol de iden i icación. Las
cali icaciones es án deshabili adas en es e modo.
Si el p o eso accede a la he amien a desde el LMS se habili a á el modo Tes .
Se ha comp obado que unciona la de ección ho a ia. Cambiando el eloj del sis ema la
aplicación de ec a la nue a zona ho a ia y se la sugie e au omá icamen e al usua io, además la
echa de inicio y in lími es de la pa ida se adap an a la zona ho a ia elegida po el usua io.
Se han comp obado cada uno de los campos de los o mula ios de c eación y edición de
pa idas. Si no se ellenan los campos obliga o ios no es posible en ia el o mula io. Se impide
ambién el en ío si la echa de inicio es an e io a la ac ual o pos e io a la del cie e de la
pa ida.
65
P uebas de ejecución
65
Se ha comp obado que si una pa ida iene deshabili ado el en ío de cali icaciones és a no
gua da ni en ía al TC las cali icaciones de los alumnos. También se ha comp obado que con
es a opción habili ada, el en ío se hace de o ma co ec a an o en Cou seSi es como en
Moodle.
Cuando una pa ida se c ea, a anca un empo izado . En el momen o en el que es e concluya
se e mina á la pa ida. Cuando una pa ida es edi ada el empo izado de la pa ida se eca ga
con los nue os alo es de echa in oducida.
Cuando una pa ida es edi ada se ca gan de o ma p ede e minada los campos de con igu ación
que iene la pa ida pa a acili a la edición de és a al usua io.
Se ha comp obado la ape u e y cie e de las pa idas con ho a ios de di e en es países
(Po ugal, Lond es, España, Singapu , Pa ís, El Chad…).
Se han usado dos juegos pa a las p uebas “Tes ” y “A i icie os”, ambos uncionan
co ec amen e y esponden sa is ac o iamen e a los cambios en su con igu ación (Núme o de
p egun as, o den de las p egun as…).
Se ha comp obado que si ocu e una eca ga en el con ex o, o el se ido se cae, los
empo izado es se eac i an au omá icamen e as el a anque de la aplicación. Si una pa ida
hubie a inalizado du an e es e pe iodo no se eac i a á el empo izado sino que se p ocede á
a la subida de cali icaciones di ec amen e.
Se ha comp obado el co ec o uncionamien o del menú de in o mación de las pa idas. Desde
és e pod án cosul a se los pa áme os de una pa ida así como las cali icaciones de los alumnos
que hayan pa icipado en la misma.
Se ha comp obado que unciona co ec amen e an o el bo ado de las cali icaciones asociadas
a una pa ida como el “TERMINAR PARTIDA” manual ac i ado po el p o eso c eado de
la misma.
En el caso de que e eu iliza una pa ida se ecomienda elimina las cali icaciones asociadas
a és a an es de einicia la.
El p og ama p esen e p oblemas si una misma pa ida se in eg a con el mismo nomb e en dos
LMS simul áneamen e.
Con los pa áme os de con igu ación co ec os, se han podido in eg a las pa idas en ambas
pla a o mas y han dado esul ados posi i os. Una de las p uebas más signi ica i as ealizadas
en ambos LMS se han hecho bajo las siguien es condiciones ( e diag ama de Figu a 33):
o Se han c eado dos p o eso es y cua o alumnos.
o Uno de los p o eso es (p o eso “1”) iene zona ho a ia de Po ugal, el o o (p o eso
“2”) zona ho a ia Eu opa/Mad id.
o Se han c eado es pa idas, la pa ida “1” y “2” con el juego “Tes ” la pa ida “3” con
el juego “A i icie os”. Cada una de es as pa idas con un ho a io de ape u a di e en e.
Las pa idas “1” y “3” inalizan el mismo día a la misma ho a.
o La pa ida “1” pe enece al p o eso “1”, la pa ida “2” y “3” pe enecen al p o eso
“2”.
o El alumno “1” pa icipa á en la pa ida “1” y “3”, el alumno “2” en la “1” y “2”, el
alumno “3” en la “1” y el alumno “4” en la “2” y “3”.
Con es a p ueba se p e ende condensa la mayo casuís ica posible in en ando no se excesi amen e
Re e encias
72
72
[31] Eclipse Founda ion, «Desca gas,» [En línea]. A ailable:
h ps://www.eclipse.o g/downloads/
[32] Ja a, «Desca gas» [En línea]. A ailable:
h ps://www.ja a.com/es/download/
[33] The Apache So wa e Founda ion, «Tomca documen a ion,» 3 Ma zo 2004. [En línea].
A ailable: h p:// omca .apache.o g/ omca -3.3-doc/.
[34] Db B owe o SQLi e [En línea]. A ailable:
h ps://sqli eb owse .o g/
73
Anexos
73
7 ANEXOS
Anexo A. Manual de ins alación.
Aunque el p oyec o unciona y de hecho ha sido ejecu ado con éxi o en sis emas Linux (no ol idemos
que es á basado en abajos an e io es cuya pla a o ma de uncionamien o p incipal e an sis emas
ope a i os Linux) la ealización y p uebas se han hecho en Windows 10 po an o es a guía se cen a á
en es e sis ema.
Se conside a que el lec o de es e anexo dispone de los iche os de la aplicación web, así como los
a chi os comp imidos que con ienen los juegos con los que se han ealizado las p uebas ( es y
a i icie os) disponibles desde el CD/DVD adjun o a la memo ia.
7.1 P epa ación del en o no
1. Ins alación de Eclipse
Pa a es e p oyec o se ha usado Eclipse Oxygen.2 en la e sión de diciemb e de 2017, la desca ga
de eclipse se ealiza desde su web o icial [31].
2. Ins alación de Ja a
Pa a es e p oyec o hemos usado la e sión 8 de ja a, es a e sión puede desca ga se desde su web
o icial [32].
3. Ins alación de Apache Tomca
En nues o p oyec o se ha usado la e sión 8.5, puede desca ga se desde su web o icial [33].
4. (opcional) Visualizado de base de da os.
Pa a pode e los da os almacenados en la base de da os y la es uc u a de és a he usado db b owse
o SQLi e. Desca gable desde aquí [34].
7.2 Fiche o de con igu ación “con ig.p ope ies”
An es de a anca la aplicación es necesa io con igu a el iche o si uado en WEB-INF que ecibe el
nomb e de “con ig.p ope ies”. Los pa áme os son los siguien es:
dbHos : Equipo en el que se encuen a el se ido de bases de da os, como puede ap ecia se
se es á u ilizando el d i e pa a pode ealiza la conexión con SQLi e.
dbName: Nomb e de la base de da os usada en el p oyec o.
zipPa h: Ru a donde se almacena á el iche o comp imido con el juego. Realmen e es e
iche o es empo al pues o que en el momen o en el que el juego sea descomp imido és e se á
eliminado.
gamePa h: di ec o io del se ido donde se almacena án los juegos una ez
descomp imidos.
Anexos
74
74
dbUse name: usua io con el que se accede a la base de da os.
dbPasswo d: con aseña del usua io con el que se accede a la base de da os.
oo Pa h: di ec o io aíz del p oyec o.
7.3 Con igu ación pa a pode ealiza p uebas o modi icaciones
Una ez hayamos desca gado Eclipse pulsamos “File > Impo > P ojec s om olde o A chi e” y
seleccionamos el di ec o io donde engamos almacenado el p oyec o. Si odo ha ido bien el p oyec o
impo ado debe apa ece en la pes aña “package explo e ”
Aho a que enemos el p oyec o en eclipse debemos ins ala el se ido , pa a ello debe emos i a “File
> new > se e ” y elegi emos la e sion que que amos ins ala , en nues o caso hemos usado la e sión
8.5.
Una ez hayamos hecho odos es os pasos en la pes aña “se e s” debe ía sali nos el se ido que
acabamos de ins ala . Si hacemos click de echo sob e el se ido y pulsamos en “s a ” lo a anca emos
y pod emos accede a la aplicación desde un na egado .
Figu a 36 Se ido es disponibles y es ado
75
Anexos
75
Anexo B. Manual de usua io.
7.4 Ins ucciones de uso
En es e pun o se da án pau as con el uncionamien o de la aplicación y cómo in eg a he amien as
LTI en el LMS
7.4.1 Aplicación Web
En la aplicación exis i á como usua io po de ec o un supe usua io con nomb e “supe ” y con aseña
“supe ”, siemp e es ecomendable po segu idad cambia la con aseña as inicia sesión po p ime a
ez. Los usua ios según sus oles son:
Supe usua io: pod á c ea usua ios (que end án el ol de p o eso ) asignándoles un
nomb e, con aseña y zona ho a ia. La con aseña pod á se cambiado pos e io men e po
el usua io. El supe usua io se á el único usua io con el pode de c ea y elimina usua ios.
Cuando un usua io es eliminado las pa idas asociadas a és e se án ambién eliminadas,
po ul imo el supe usua io se á el único capaz de habili a , deshabili a o elimina juegos.
P o eso : El usua io p o eso pod á ealiza las siguien es acciones:
Figu a 37 Menú p incipal con ol de p o eso
o C ea pa ida (+).
o In o mación: e pa áme os y cali icaciones de una pa ida.
o Bo a pa ida.
o Edi a pa ida.
o Modo Tes : p oba una pa ida.
o Bo a no as: elimina no as inculadas a una pa ida.
o Te mina pa ida: Finaliza manualmen e una pa ida.
Anexos
76
76
o Subi juego: Almacena un juego en el se ido . El juego debe subi se en o ma o zip y debe
con ene un a chi o h ml con el nomb e de “juga ” y un iche o de con igu ación con el nomb e
“p ope ies”.
Tabla 71 Ejemplo del iche o p ope ies del juego es
7.4.1.1 C eación de un usua io
Pa iendo de un es ado inicial en el que no exis en usua ios ni juegos ni pa idas el p ocedimien o a
segui se ía el siguien e:
1. Supe usua io inicia sesión, el nomb e po de ec o es supe y la con aseña supe .
Figu a 38 Inicio de sesión de supe usua io
2. Una ez logueados c eamos al usua io p o con con aseña p o y zona ho a ia de España.
<s a ic>
ALE=1;
</s a ic>
<dinamic>
jug1="Manolillo";CONTIPAR=0;
CONTINUARPARTIDA="";NP=5;
TIPORESPUESTA=0;TIPOCORRECCION=0;
</dinamic>
77
Anexos
77
Figu a 39 C eación de usua io p o eso
3. T as es o debe íamos isualiza el nue o usua io c eado.
Figu a 40 Lis a de usua ios
Anexos
78
78
7.4.1.2 Subida de juegos y c eación de una pa ida
1. Iniciamos sesión con el nue o usua io c eado y subimos un juego. Pa a ello pulsa emos el enlace
“Subi Juego”. Una ez pulsada la in e az se ía la siguien e:
Figu a 41 Menú de subida de un juego
Seleccionamos el a chi o del juego, le damos un nomb e y p ocedemos a la subida del juego. Si odo
ha ido bien nos debe á apa ece el siguien e mensaje:
79
Anexos
79
Figu a 42 Éxi o en la subida
2. Vol emos al menú p incipal pulsando en el enlace “pa idas” y pulsamos en el símbolo “+” que
hay a la de echa del ó ulo “Lis a de pa idas”. T as es o en a emos en el menú de con igu ación
de una pa ida:
Anexos
80
80
Figu a 43 Fo mula io de c eación de una pa ida
T as ellena los campos de con igu ación de la pa ida pulsamos en “ESTABLECER”. Si odo ha
ido bien es a acción nos edigi á a la página “pa idas” y isualiza emos la nue a pa ida c eada:
81
Anexos
81
Figu a 44 Lis a de pa idas
7.4.1.3 Eliminación de una pa ida
1. Pulsamos en el bo ón bo a de la Figu a 45. Se nos pedi á con i mación y debe emos acep a .
Anexos
88
88
7.4.1.6 In o mación de una pa ida y consul a de cali icaciones
Pa a consul a los pa áme os de una pa ida se á necesa io selecciona la y pulsa el bo ón
“INFORMACIÓN” Figu a 45.
Desde es a pa e del p og ama pod á se consul ada las cali iciaciones ob enidas po los alumnos en
esa pa ida. Exis en es posibilidades:
1. Que ningún alumno haya pa icipado en la pa ida, po an o es e apa ado es é acío.
2. Que al menos un alumno haya pa icipado pe o la pa ida aún no haya inalizado. En es e caso
se mos a án las cali icaciones p o isionales de la pa ida. Figu a 53.
Figu a 53 Cali icaciones an es de inaliza pa ida
3. Que al menos un alumno haya pa icipado en la pa ida y és a haya inalizado Figu a 54.
Figu a 54 Cali icaciones as e mina la pa ida
89
Anexos
89
7.4.2 In eg ación de he amien a en LMS
En es e apa ado se explica á cómo implemen a nues a he amien a en los dos LMS en los que se
han ealizado las p uebas.
7.4.2.1 Cou seSi es
El p ime paso es ene c eado un cu so y alumnos egis ados en él. Una ez hecho es o debe emos i
al con enido del cu so, as es o pulsa emos en “enlace web”. En es e apa ado end emos que
es ablece una se ie de pa áme os de con igu ación que pueden obse a se en la Figu a 55.
Nomb e: Nomb e con el que apa ece á el enlace web en Cou seSi es.
URL: Di ección a la que se ha á POST as hace click en el enlace LTI. En nues o caso el
desc ip o de despliegue es á con igu ado de o ma que cuan o pulsamos en el enlace se
in oque a la clase Launch.
Tecla: Debe coincidi con el consume _key de nues o p oyec o, eco demos que és e se
o ma de la siguien e mane a: “Nomb e de la pa ida” + “_” + “Cla e”
8
.
Sec e o: Debe coincidi con el con igu ado en la pa ida.
Pa áme os pe sonalizados (opcionales):
o debug= ue: Mues a mensajes de allados en caso de p oduci se un e o LTI.
o u us=@X@use .id@X@: Se u iliza pa a iden i ica al alumno po el nomb e con el
que se ha egis ado en Cou seSi es en luga de con el id de usua io.
8
Tan o el nomb e de la pa ida como la cla e son con igu ados du an e la c eación de la misma.
Anexos
90
90
Figu a 55 Con igu ación de enlace web en Cou seSi es
7.4.2.2 Moodle
P oceso muy simila al desc i o pa a Cou seSi es. Quizás el cambio más signi ica i o sea que en el
apa ado “Cus om pa ame e s” (Pa áme os pe sonalizados) la sen encia cambia. En la Figu a 56
puede obse a se el nue o o ma o que adop a.
Figu a 56 Con igu ación de Moodle pa a c ea enlace LTI
91
Anexos
91
7.4.3 Acceso a la he amien a desde el TC
Una ez la pa ida se ha con igu ado e in eg ado en el TC los alumnos debe án accede a ella desde el
enlace LTI c eado po el p o eso . En es e momen o pueden ocu i es cosas:
1. Que la pa ida no haya empezado aún o ya haya inalizado po lo que se mos a á el siguien e
mensaje.
Figu a 57 Pa ida no disponible po echa
2. Que el alumno haya excedido el núme o de in en os, en es e caso se mos a á lo siguien e.
Figu a 58 Pa ida no disponible po sob epasa el núme o de in en os
3. Que odo es é co ec o y el alumno pueda accede al juego.
Figu a 59 In e az de juego “Tes ”
Anexos
92
92
Cuando se alcanza la echa de inalización de la pa ida o el p o eso dicide e mina la pulsando el
bo ón “TERMINAR PARTIDA” (Figu a 44) la no a es en iada al cuade no de cali icaciones del
TC.
93
Anexos
93